Package namespace.cloud.registry.v1beta

Class ContainerRegistryServiceGrpc.ContainerRegistryServiceBlockingV2Stub

java.lang.Object

io.grpc.stub.AbstractStub<ContainerRegistryServiceGrpc.ContainerRegistryServiceBlockingV2Stub>

io.grpc.stub.AbstractBlockingStub<ContainerRegistryServiceGrpc.ContainerRegistryServiceBlockingV2Stub>

namespace.cloud.registry.v1beta.ContainerRegistryServiceGrpc.ContainerRegistryServiceBlockingV2Stub

Enclosing class:

ContainerRegistryServiceGrpc

public static final class ContainerRegistryServiceGrpc.ContainerRegistryServiceBlockingV2Stub
extends io.grpc.stub.AbstractBlockingStub<ContainerRegistryServiceGrpc.ContainerRegistryServiceBlockingV2Stub>

A stub to allow clients to do synchronous rpc calls to service ContainerRegistryService.

 ContainerRegistryService allows the management of container images stored in
 the workspace's private container registry (`nscr.io`). It supports listing
 images and repositories, managing tags, sharing images publicly or with
 partner accounts, and configuring image expiration policies.
 See https://namespace.so/docs/architecture/storage/container-registry for an overview.
 ## Access
 ContainerRegistryService is a global service that can be accessed at:
 ```
 https://global.namespaceapis.com:443
 ```
 ## Authentication
 Calls to the ContainerRegistryService require a *tenant token* passed as a Bearer token as
 part of each call. These are always required.
 A *tenant token* identifies both the workspace that the call operates on, but
 may also constrain the set of actions that the caller may do.
 A *tenant token* can be obtained using the
 [IAM API](https://buf.build/namespace/cloud/docs/main:namespace.cloud.iam.v1beta).
 

Nested Class Summary

Nested classes/interfaces inherited from class io.grpc.stub.AbstractStub

io.grpc.stub.AbstractStub.StubFactory<T extends io.grpc.stub.AbstractStub<T>>

Method Summary

Modifier and Type	Method	Description
protected ContainerRegistryServiceGrpc.ContainerRegistryServiceBlockingV2Stub	build(io.grpc.Channel channel, io.grpc.CallOptions callOptions)
Registry.GetDefaultPolicyResponse	getDefaultPolicy(com.google.protobuf.Empty request)	Returns the current default image expiration policy.
Registry.GetImageResponse	getImage(Registry.GetImageRequest request)	Retrieves a specific image by repository and reference (tag or digest).
Registry.GetRepositoryPolicyResponse	getRepositoryPolicy(Registry.GetRepositoryPolicyRequest request)	Returns the current image expiration policy for a specific repository.
Registry.ListImagesResponse	listImages(Registry.ListImagesRequest request)	Lists images in the registry that match the specified criteria.
Registry.ListRepositoriesResponse	listRepositories(Registry.ListRepositoriesRequest request)	Lists all repositories in the registry.
Registry.ListSharedImagesResponse	listSharedImages(Registry.ListSharedImagesRequest request)	Lists shared images, optionally filtered by repository and visibility.
Registry.ListTagsResponse	listTags(Registry.ListTagsRequest request)	Lists all tags for a specific repository.
Registry.ListTagVersionsResponse	listTagVersions(Registry.ListTagVersionsRequest request)	Lists all versions of a specific tag in a repository, ordered from newest to oldest.
Registry.SharedImage	shareImage(Registry.ShareImageRequest request)	Shares an image either publicly or with tenants of partner accounts.
com.google.protobuf.Empty	unshareImage(Registry.UnshareImageRequest request)	Removes an existing share, making the shared image reference inaccessible.
com.google.protobuf.Empty	updateDefaultPolicy(Registry.UpdateDefaultPolicyRequest request)	Updates the default image expiration policy for the workspace.
Registry.UpdateImageLifetimeResponse	updateImageLifetime(Registry.UpdateImageLifetimeRequest request)	Extends or updates the expiration of a single image.
com.google.protobuf.Empty	updateRepositoryPolicy(Registry.UpdateRepositoryPolicyRequest request)	Updates the image expiration policy for a specific repository.

Methods inherited from class io.grpc.stub.AbstractBlockingStub

newStub, newStub

Methods inherited from class io.grpc.stub.AbstractStub

getCallOptions, getChannel, withCallCredentials, withChannel, withCompression, withDeadline, withDeadlineAfter, withDeadlineAfter, withExecutor, withInterceptors, withMaxInboundMessageSize, withMaxOutboundMessageSize, withOnReadyThreshold, withOption, withWaitForReady

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

build

protected ContainerRegistryServiceGrpc.ContainerRegistryServiceBlockingV2Stub build(io.grpc.Channel channel,
 io.grpc.CallOptions callOptions)

Specified by:

build in class io.grpc.stub.AbstractStub<ContainerRegistryServiceGrpc.ContainerRegistryServiceBlockingV2Stub>

getImage

public Registry.GetImageResponse getImage(Registry.GetImageRequest request)
                                   throws io.grpc.StatusException

 Retrieves a specific image by repository and reference (tag or digest).
 ### Errors
 - If the image does not exist, a `NotFound` status is returned.
 

Throws:

io.grpc.StatusException

listImages

public Registry.ListImagesResponse listImages(Registry.ListImagesRequest request)
                                       throws io.grpc.StatusException

 Lists images in the registry that match the specified criteria.
 

Throws:

io.grpc.StatusException

listRepositories

public Registry.ListRepositoriesResponse listRepositories(Registry.ListRepositoriesRequest request)
                                                   throws io.grpc.StatusException

 Lists all repositories in the registry.
 

Throws:

io.grpc.StatusException

listTags

public Registry.ListTagsResponse listTags(Registry.ListTagsRequest request)
                                   throws io.grpc.StatusException

 Lists all tags for a specific repository.
 

Throws:

io.grpc.StatusException

listTagVersions

public Registry.ListTagVersionsResponse listTagVersions(Registry.ListTagVersionsRequest request)
                                                 throws io.grpc.StatusException

 Lists all versions of a specific tag in a repository, ordered from newest
 to oldest. A tag can point to different images over time as it is
 overwritten by new pushes.
 

Throws:

io.grpc.StatusException

shareImage

public Registry.SharedImage shareImage(Registry.ShareImageRequest request)
                                throws io.grpc.StatusException

 Shares an image either publicly or with tenants of partner accounts.
 Returns the shared image metadata, including the public image reference
 that can be used to pull the image.
 ### Errors
 - If the image does not exist, a `NotFound` status is returned.
 

Throws:

io.grpc.StatusException

unshareImage

public com.google.protobuf.Empty unshareImage(Registry.UnshareImageRequest request)
                                       throws io.grpc.StatusException

 Removes an existing share, making the shared image reference inaccessible.
 ### Errors
 - If the share does not exist, a `NotFound` status is returned.
 

Throws:

io.grpc.StatusException

listSharedImages

public Registry.ListSharedImagesResponse listSharedImages(Registry.ListSharedImagesRequest request)
                                                   throws io.grpc.StatusException

 Lists shared images, optionally filtered by repository and visibility.
 

Throws:

io.grpc.StatusException

updateImageLifetime

public Registry.UpdateImageLifetimeResponse updateImageLifetime(Registry.UpdateImageLifetimeRequest request)
                                                         throws io.grpc.StatusException

 Extends or updates the expiration of a single image.
 ### Errors
 - If the image does not exist, a `NotFound` status is returned.
 

Throws:

io.grpc.StatusException

updateDefaultPolicy

public com.google.protobuf.Empty updateDefaultPolicy(Registry.UpdateDefaultPolicyRequest request)
                                              throws io.grpc.StatusException

 Updates the default image expiration policy for the workspace.
 The policy applies to newly created images only.
 

Throws:

io.grpc.StatusException

getDefaultPolicy

public Registry.GetDefaultPolicyResponse getDefaultPolicy(com.google.protobuf.Empty request)
                                                   throws io.grpc.StatusException

 Returns the current default image expiration policy.
 

Throws:

io.grpc.StatusException

updateRepositoryPolicy

public com.google.protobuf.Empty updateRepositoryPolicy(Registry.UpdateRepositoryPolicyRequest request)
                                                 throws io.grpc.StatusException

 Updates the image expiration policy for a specific repository.
 Repository-level policies override the default policy.
 

Throws:

io.grpc.StatusException

getRepositoryPolicy

public Registry.GetRepositoryPolicyResponse getRepositoryPolicy(Registry.GetRepositoryPolicyRequest request)
                                                         throws io.grpc.StatusException

 Returns the current image expiration policy for a specific repository.
 

Throws:

io.grpc.StatusException