Image Repository Digests

All images currently stored in this repository listed by their digest. Note that an image can reside in the repository without any tags (and that an image with a particular digest can have many tags).

Technically what is listed here are the manifests of the images in this repository (an image comprises of a manifest, and the layers that the manifest refers to).

Retrieve all manifest lists

SecurityaccessToken
Request
path Parameters
repository-name
required
string <repository-string>

name of repository

query Parameters
fields
string

Retrieve only requested fields from the resource

See section fields

site
string

Send the request to the specfifed site

keys
string <enumeration>

Retrieve only the keys for the list

Value: "true"
count
string <enumeration>

Retrieve only the number of elements in the list

Value: "true"
Responses
200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

503

Service Unavailable (strongbox sealed)

get/v1/state/image-registry/repositories/{repository-name}/digests
Response samples
- digest: sha256:27ca0299125baf78014065152a1bd786573e309f15ae3dea9727239966ee0f4e
  tags:
    - latest
  image-index:
    media-type: application/vnd.oci.image.index.v1+json
    annotations: {}
    manifests:
      - digest: sha256:40356c753dbef81b769a59564a7aecae47fe9aaf25ac38e484189f83c3ddb6b0
        media-type: application/vnd.oci.image.manifest.v1+json
        platform: linux/amd64
        annotations: {}
      - digest: sha256:f26a93437cc3e662fc3cc3ee598e38dd765a56f1970956f963f74ddd4443c6ec
        media-type: application/vnd.oci.image.manifest.v1+json
        platform: unknown/unknown
        annotations:
          vnd.docker.reference.type: attestation-manifest
          vnd.docker.reference.digest: sha256:40356c753dbef81b769a59564a7aecae47fe9aaf25ac38e484189f83c3ddb6b0
      - digest: sha256:6fda815f671babdff2629fefb9c4cde1238e39530b838b03a1bf242fe1fa4b59
        media-type: application/vnd.oci.image.manifest.v1+json
        platform: linux/arm64
        annotations: {}
      - digest: sha256:3a417f1a4e7509393792ed8676bb47f6fe4fb95dceb6e55fdac56f8a835e9b91
        media-type: application/vnd.oci.image.manifest.v1+json
        platform: unknown/unknown
        annotations:
          vnd.docker.reference.type: attestation-manifest
          vnd.docker.reference.digest: sha256:6fda815f671babdff2629fefb9c4cde1238e39530b838b03a1bf242fe1fa4b59
  

Retrieve a manifest list

SecurityaccessToken
Request
path Parameters
repository-name
required
string <repository-string>

name of repository

manifest-list-digest
required
string <digest>

digest of manifest-list

query Parameters
fields
string

Retrieve only requested fields from the resource

See section fields

site
string

Send the request to the specfifed site

Responses
200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

503

Service Unavailable (strongbox sealed)

get/v1/state/image-registry/repositories/{repository-name}/digests/{manifest-list-digest}
Response samples
digest: sha256:27ca0299125baf78014065152a1bd786573e309f15ae3dea9727239966ee0f4e
tags:
  - latest
image-index:
  media-type: application/vnd.oci.image.index.v1+json
  annotations: {}
  manifests:
    - digest: sha256:40356c753dbef81b769a59564a7aecae47fe9aaf25ac38e484189f83c3ddb6b0
      media-type: application/vnd.oci.image.manifest.v1+json
      platform: linux/amd64
      annotations: {}
    - digest: sha256:f26a93437cc3e662fc3cc3ee598e38dd765a56f1970956f963f74ddd4443c6ec
      media-type: application/vnd.oci.image.manifest.v1+json
      platform: unknown/unknown
      annotations:
        vnd.docker.reference.type: attestation-manifest
        vnd.docker.reference.digest: sha256:40356c753dbef81b769a59564a7aecae47fe9aaf25ac38e484189f83c3ddb6b0
    - digest: sha256:6fda815f671babdff2629fefb9c4cde1238e39530b838b03a1bf242fe1fa4b59
      media-type: application/vnd.oci.image.manifest.v1+json
      platform: linux/arm64
      annotations: {}
    - digest: sha256:3a417f1a4e7509393792ed8676bb47f6fe4fb95dceb6e55fdac56f8a835e9b91
      media-type: application/vnd.oci.image.manifest.v1+json
      platform: unknown/unknown
      annotations:
        vnd.docker.reference.type: attestation-manifest
        vnd.docker.reference.digest: sha256:6fda815f671babdff2629fefb9c4cde1238e39530b838b03a1bf242fe1fa4b59

Invoke the create-tag operation

Create a new tag referring to this digest.

SecurityaccessToken
Request
path Parameters
repository-name
required
string <repository-string>

name of repository

manifest-list-digest
required
string <digest>

digest of manifest-list

Request Body schema:
name
required
string <tag> ^[a-zA-Z0-9_][a-zA-Z0-9_.-]*$

The name of the new tag.

Responses
200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

503

Service Unavailable (strongbox sealed)

post/v1/state/image-registry/repositories/{repository-name}/digests/{manifest-list-digest}/create-tag
Request samples
name: v2
Response samples
digest: sha256:ff6bdca1701f3a8a67e328815ff2346b0e4067d32ec36b7992c1fdc001dc8517

Invoke the delete operation

Delete this digest and the image(s) it refers to.

SecurityaccessToken
Request
path Parameters
repository-name
required
string <repository-string>

name of repository

manifest-list-digest
required
string <digest>

digest of manifest-list

Request Body schema:
force
boolean
Default: false

By default a digest that has tags will not be deleted, set force to 'true' to override

Responses
204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

503

Service Unavailable (strongbox sealed)

post/v1/state/image-registry/repositories/{repository-name}/digests/{manifest-list-digest}/delete
Request samples
force: true