Amazon Elastic Container Registry Public
  1. Root
Amazon Elastic Container Registry Public
  • Root
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
    • /
      POST
  1. Root

/

POST
/
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.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/' \
--header 'X-Amz-Target;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "registryId": "string",
    "repositoryName": "string",
    "layerDigests": []
}'
Response Response Example
200 - Example 1
{
    "layers": [],
    "failures": []
}

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
Next
/
Built with