Registry API

OCI container registry

REST API endpoints for Registry. 10 operations.

Check the registry API version

GET /v1/registry/v2/

Returns the OCI Distribution API version supported by the registry.

Auth: Bearer API key

Responses

operationId: registryVersionCheck

List the repository catalog

GET /v1/registry/v2/_catalog

Returns the catalog of repositories in the registry.

Auth: Bearer API key

Responses

operationId: getRegistryCatalog

Get a blob

GET /v1/registry/v2/{project_id}/{repository}/blobs/{digest}

Downloads an OCI blob by digest.

Auth: Bearer API key

Parameters

Responses

operationId: getRegistryBlob

Check a blob exists

HEAD /v1/registry/v2/{project_id}/{repository}/blobs/{digest}

Returns headers indicating whether an OCI blob exists.

Auth: Bearer API key

Parameters

Responses

operationId: headRegistryBlob

Start a blob upload

POST /v1/registry/v2/{project_id}/{repository}/blobs/uploads/

Begins an OCI blob upload session and returns the upload location.

Auth: Bearer API key

Parameters

Responses

operationId: startRegistryBlobUpload

Delete a manifest

DELETE /v1/registry/v2/{project_id}/{repository}/manifests/{reference}

Removes an OCI image manifest by tag or digest.

Auth: Bearer API key

Parameters

Responses

operationId: deleteRegistryManifest

Get a manifest

GET /v1/registry/v2/{project_id}/{repository}/manifests/{reference}

Returns an OCI image manifest by tag or digest.

Auth: Bearer API key

Parameters

Responses

operationId: getRegistryManifest

Check a manifest exists

HEAD /v1/registry/v2/{project_id}/{repository}/manifests/{reference}

Returns headers indicating whether an OCI manifest exists.

Auth: Bearer API key

Parameters

Responses

operationId: headRegistryManifest

Store a manifest

PUT /v1/registry/v2/{project_id}/{repository}/manifests/{reference}

Uploads an OCI image manifest under a tag or digest.

Auth: Bearer API key

Parameters

Request body

application/json (required) — schema object.

Responses

operationId: putRegistryManifest

List tags

GET /v1/registry/v2/{project_id}/{repository}/tags/list

Returns the tags available for a repository.

Auth: Bearer API key

Parameters

Responses

operationId: listRegistryTags