Package namespace.cloud.registry.v1beta

Class ContainerRegistryServiceGrpc.ContainerRegistryServiceFutureStub

java.lang.Object

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

io.grpc.stub.AbstractFutureStub<ContainerRegistryServiceGrpc.ContainerRegistryServiceFutureStub>

namespace.cloud.registry.v1beta.ContainerRegistryServiceGrpc.ContainerRegistryServiceFutureStub

Enclosing class:

ContainerRegistryServiceGrpc

public static final class ContainerRegistryServiceGrpc.ContainerRegistryServiceFutureStub
extends io.grpc.stub.AbstractFutureStub<ContainerRegistryServiceGrpc.ContainerRegistryServiceFutureStub>

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

Methods inherited from class io.grpc.stub.AbstractFutureStub

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

Specified by:

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

getImage

public com.google.common.util.concurrent.ListenableFuture<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 com.google.common.util.concurrent.ListenableFuture<Registry.ListImagesResponse> listImages(Registry.ListImagesRequest request)

 Lists images in the registry that match the specified criteria.
 

listRepositories

public com.google.common.util.concurrent.ListenableFuture<Registry.ListRepositoriesResponse> listRepositories(Registry.ListRepositoriesRequest request)

 Lists all repositories in the registry.
 

listTags

public com.google.common.util.concurrent.ListenableFuture<Registry.ListTagsResponse> listTags(Registry.ListTagsRequest request)

 Lists all tags for a specific repository.
 

listTagVersions

public com.google.common.util.concurrent.ListenableFuture<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 com.google.common.util.concurrent.ListenableFuture<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.common.util.concurrent.ListenableFuture<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 com.google.common.util.concurrent.ListenableFuture<Registry.ListSharedImagesResponse> listSharedImages(Registry.ListSharedImagesRequest request)

 Lists shared images, optionally filtered by repository and visibility.
 

updateImageLifetime

public com.google.common.util.concurrent.ListenableFuture<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.common.util.concurrent.ListenableFuture<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 com.google.common.util.concurrent.ListenableFuture<Registry.GetDefaultPolicyResponse> getDefaultPolicy(com.google.protobuf.Empty request)

 Returns the current default image expiration policy.
 

updateRepositoryPolicy

public com.google.common.util.concurrent.ListenableFuture<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 com.google.common.util.concurrent.ListenableFuture<Registry.GetRepositoryPolicyResponse> getRepositoryPolicy(Registry.GetRepositoryPolicyRequest request)

 Returns the current image expiration policy for a specific repository.