/ - Amazon Elastic Container Registry Public

Checks the availability of one or more image layers that are within a repository in a public registry. When an image is pushed to a repository, each image layer is checked to verify if it has been uploaded before. If it has been uploaded, then the image layer is skipped.

curl --location --request POST '/' \ --header 'X-Amz-Target;' \ --header 'Content-Type: application/json' \ --data-raw '{ "registryId": "string", "repositoryName": "string", "layerDigests": [] }'

Request

Header Params

X-Amz-Target

string

required

Body Params application/json

registryId

string

optional

The Amazon Web Services account ID, or registry alias, associated with the public registry that contains the image layers to check. If you do not specify a registry, the default public registry is assumed.

>= 2 characters<= 50 characters

repositoryName

string

required

The name of the repository that's associated with the image layers to check.

>= 2 characters<= 205 characters

Match pattern:

(?:[a-z0-9]+(?:[._-][a-z0-9]+)*/)*[a-z0-9]+(?:[._-][a-z0-9]+)*

layerDigests

array[string]

required

The digests of the image layers to check.

>= 1 items<= 100 items

Examples

Responses

🟢200Success

application/json

Body

layers

array[object (Layer) {4}]

optional

A list of image layer objects that correspond to the image layer references in the request.

layerDigest

string

optional

The sha256 digest of the image layer.

Match pattern:

[a-zA-Z0-9-_+.]+:[a-fA-F0-9]+

layerAvailability

enum<string>

optional

The availability status of the image layer.

Allowed values:

AVAILABLEUNAVAILABLE

layerSize

integer

optional

The size, in bytes, of the image layer.

mediaType

string

optional

The media type of the layer, such as application/vnd.docker.image.rootfs.diff.tar.gzip or application/vnd.oci.image.layer.v1.tar+gzip.

failures

array[object (LayerFailure) {3}]

optional

Any failures associated with the call.

layerDigest

string

optional

The layer digest that's associated with the failure.

>= 0 characters<= 1000 characters

failureCode

enum<string>

optional

The failure code that's associated with the failure.

Allowed values:

InvalidLayerDigestMissingLayerDigest

failureReason

string

optional

The reason for the failure.

🟠480RepositoryNotFoundException

🟠481InvalidParameterException

🟠482ServerException

🟠483RegistryNotFoundException

🟠484UnsupportedCommandException