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:bc41182d7ef5ffc53a40b044e725193bc10142a1243f395ee852a8d9730fc2ad
  tags:
    - latest
  type: image-index
  images:
    - digest: sha256:1304f174557314a7ed9eddb4eab12fed12cb0cd9809e4c28f29af86979a3c870
    - digest: sha256:5da989a9a3a08357bc7c00bd46c3ed782e1aeefc833e0049e6834ec1dcad8a42
    - digest: sha256:0c673ee68853a04014c0c623ba5ee21ee700e1d71f7ac1160ddb2e31c6fdbb18
    - digest: sha256:ed73e2bee79b3428995b16fce4221fc715a849152f364929cdccdc83db5f3d5c
    - digest: sha256:1d96e60e5270815238e999aed0ae61d22ac6f5e5f976054b24796d0e0158b39c
    - digest: sha256:fa30af02cc8c339dd7ffecb0703cd4a3db175e56875c413464c5ba46821253a8
    - digest: sha256:c2046a6c3d2db4f75bfb8062607cc8ff47896f2d683b7f18fe6b6cf368af3c60
  

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:bc41182d7ef5ffc53a40b044e725193bc10142a1243f395ee852a8d9730fc2ad
tags:
  - latest
type: image-index
images:
  - digest: sha256:1304f174557314a7ed9eddb4eab12fed12cb0cd9809e4c28f29af86979a3c870
  - digest: sha256:5da989a9a3a08357bc7c00bd46c3ed782e1aeefc833e0049e6834ec1dcad8a42
  - digest: sha256:0c673ee68853a04014c0c623ba5ee21ee700e1d71f7ac1160ddb2e31c6fdbb18
  - digest: sha256:ed73e2bee79b3428995b16fce4221fc715a849152f364929cdccdc83db5f3d5c
  - digest: sha256:1d96e60e5270815238e999aed0ae61d22ac6f5e5f976054b24796d0e0158b39c
  - digest: sha256:fa30af02cc8c339dd7ffecb0703cd4a3db175e56875c413464c5ba46821253a8
  - digest: sha256:c2046a6c3d2db4f75bfb8062607cc8ff47896f2d683b7f18fe6b6cf368af3c60

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