Package namespace.cloud.registry.v1beta

Interface ContainerRegistryServiceGrpc.AsyncService

All Known Implementing Classes:
ContainerRegistryServiceGrpc.ContainerRegistryServiceImplBase
Enclosing class:
ContainerRegistryServiceGrpc
public static interface ContainerRegistryServiceGrpc.AsyncService
 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).

  • Method Details

    • getImage

      default 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

      default void listImages(Registry.ListImagesRequest request, io.grpc.stub.StreamObserver<Registry.ListImagesResponse> responseObserver)
       Lists images in the registry that match the specified criteria.

    • listRepositories

      default void listRepositories(Registry.ListRepositoriesRequest request, io.grpc.stub.StreamObserver<Registry.ListRepositoriesResponse> responseObserver)
       Lists all repositories in the registry.

    • listTags

      default void listTags(Registry.ListTagsRequest request, io.grpc.stub.StreamObserver<Registry.ListTagsResponse> responseObserver)
       Lists all tags for a specific repository.

    • listTagVersions

      default 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

      default 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

      default 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

      default void listSharedImages(Registry.ListSharedImagesRequest request, io.grpc.stub.StreamObserver<Registry.ListSharedImagesResponse> responseObserver)
       Lists shared images, optionally filtered by repository and visibility.

    • updateImageLifetime

      default 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

      default 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

      default void getDefaultPolicy(com.google.protobuf.Empty request, io.grpc.stub.StreamObserver<Registry.GetDefaultPolicyResponse> responseObserver)
       Returns the current default image expiration policy.

    • updateRepositoryPolicy

      default 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

      default void getRepositoryPolicy(Registry.GetRepositoryPolicyRequest request, io.grpc.stub.StreamObserver<Registry.GetRepositoryPolicyResponse> responseObserver)
       Returns the current image expiration policy for a specific repository.