Package namespace.cloud.registry.v1beta

Class ContainerRegistryServiceGrpc.ContainerRegistryServiceBlockingStub

java.lang.Object

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

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

namespace.cloud.registry.v1beta.ContainerRegistryServiceGrpc.ContainerRegistryServiceBlockingStub

Enclosing class:

ContainerRegistryServiceGrpc

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

A stub to allow clients to do limited 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.ContainerRegistryServiceBlockingStub	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.ContainerRegistryServiceBlockingStub build(io.grpc.Channel channel,
 io.grpc.CallOptions callOptions)

Specified by:

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

getImage

public Registry.GetImageResponse getImage(Registry.GetImageRequest request)

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

listImages

public Registry.ListImagesResponse listImages(Registry.ListImagesRequest request)

 Lists images in the registry that match the specified criteria.
 

listRepositories

public Registry.ListRepositoriesResponse listRepositories(Registry.ListRepositoriesRequest request)

 Lists all repositories in the registry.
 

listTags

public Registry.ListTagsResponse listTags(Registry.ListTagsRequest request)

 Lists all tags for a specific repository.
 

listTagVersions

public Registry.ListTagVersionsResponse listTagVersions(Registry.ListTagVersionsRequest request)

 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.
 

shareImage

public Registry.SharedImage shareImage(Registry.ShareImageRequest request)

 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.
 

unshareImage

public com.google.protobuf.Empty unshareImage(Registry.UnshareImageRequest request)

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

listSharedImages

public Registry.ListSharedImagesResponse listSharedImages(Registry.ListSharedImagesRequest request)

 Lists shared images, optionally filtered by repository and visibility.
 

updateImageLifetime

public Registry.UpdateImageLifetimeResponse updateImageLifetime(Registry.UpdateImageLifetimeRequest request)

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

updateDefaultPolicy

public com.google.protobuf.Empty updateDefaultPolicy(Registry.UpdateDefaultPolicyRequest request)

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

getDefaultPolicy

public Registry.GetDefaultPolicyResponse getDefaultPolicy(com.google.protobuf.Empty request)

 Returns the current default image expiration policy.
 

updateRepositoryPolicy

public com.google.protobuf.Empty updateRepositoryPolicy(Registry.UpdateRepositoryPolicyRequest request)

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

getRepositoryPolicy

public Registry.GetRepositoryPolicyResponse getRepositoryPolicy(Registry.GetRepositoryPolicyRequest request)

 Returns the current image expiration policy for a specific repository.