Package namespace.cloud.registry.v1beta

Class ContainerRegistryServiceGrpc.ContainerRegistryServiceStub

java.lang.Object

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

io.grpc.stub.AbstractAsyncStub<ContainerRegistryServiceGrpc.ContainerRegistryServiceStub>

namespace.cloud.registry.v1beta.ContainerRegistryServiceGrpc.ContainerRegistryServiceStub

Enclosing class:

ContainerRegistryServiceGrpc

public static final class ContainerRegistryServiceGrpc.ContainerRegistryServiceStub
extends io.grpc.stub.AbstractAsyncStub<ContainerRegistryServiceGrpc.ContainerRegistryServiceStub>

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

Methods inherited from class io.grpc.stub.AbstractAsyncStub

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.ContainerRegistryServiceStub build(io.grpc.Channel channel,
 io.grpc.CallOptions callOptions)

Specified by:

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

getImage

public void getImage(Registry.GetImageRequest request,
 io.grpc.stub.StreamObserver<Registry.GetImageResponse> responseObserver)

 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 void listImages(Registry.ListImagesRequest request,
 io.grpc.stub.StreamObserver<Registry.ListImagesResponse> responseObserver)

 Lists images in the registry that match the specified criteria.
 

listRepositories

public void listRepositories(Registry.ListRepositoriesRequest request,
 io.grpc.stub.StreamObserver<Registry.ListRepositoriesResponse> responseObserver)

 Lists all repositories in the registry.
 

listTags

public void listTags(Registry.ListTagsRequest request,
 io.grpc.stub.StreamObserver<Registry.ListTagsResponse> responseObserver)

 Lists all tags for a specific repository.
 

listTagVersions

public void listTagVersions(Registry.ListTagVersionsRequest request,
 io.grpc.stub.StreamObserver<Registry.ListTagVersionsResponse> responseObserver)

 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 void shareImage(Registry.ShareImageRequest request,
 io.grpc.stub.StreamObserver<Registry.SharedImage> responseObserver)

 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 void unshareImage(Registry.UnshareImageRequest request,
 io.grpc.stub.StreamObserver<com.google.protobuf.Empty> responseObserver)

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

listSharedImages

public void listSharedImages(Registry.ListSharedImagesRequest request,
 io.grpc.stub.StreamObserver<Registry.ListSharedImagesResponse> responseObserver)

 Lists shared images, optionally filtered by repository and visibility.
 

updateImageLifetime

public void updateImageLifetime(Registry.UpdateImageLifetimeRequest request,
 io.grpc.stub.StreamObserver<Registry.UpdateImageLifetimeResponse> responseObserver)

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

updateDefaultPolicy

public void updateDefaultPolicy(Registry.UpdateDefaultPolicyRequest request,
 io.grpc.stub.StreamObserver<com.google.protobuf.Empty> responseObserver)

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

getDefaultPolicy

public void getDefaultPolicy(com.google.protobuf.Empty request,
 io.grpc.stub.StreamObserver<Registry.GetDefaultPolicyResponse> responseObserver)

 Returns the current default image expiration policy.
 

updateRepositoryPolicy

public void updateRepositoryPolicy(Registry.UpdateRepositoryPolicyRequest request,
 io.grpc.stub.StreamObserver<com.google.protobuf.Empty> responseObserver)

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

getRepositoryPolicy

public void getRepositoryPolicy(Registry.GetRepositoryPolicyRequest request,
 io.grpc.stub.StreamObserver<Registry.GetRepositoryPolicyResponse> responseObserver)

 Returns the current image expiration policy for a specific repository.