Amazon Elastic Container Registry
API Reference (API Version 2015-09-21)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.


An object that describes an image returned by a DescribeImages operation.



The sha256 digest of the image manifest.

Type: String

Required: No


The date and time, expressed in standard JavaScript date format, at which the current image was pushed to the repository.

Type: Timestamp

Required: No


The size, in bytes, of the image in the repository.


Beginning with Docker version 1.9, the Docker client compresses image layers before pushing them to a V2 Docker registry. The output of the docker images command shows the uncompressed image size, so it may return a larger image size than the image sizes returned by DescribeImages.

Type: Long

Required: No


The list of tags associated with this image.

Type: Array of strings

Length Constraints: Minimum length of 1. Maximum length of 300.

Required: No


The AWS account ID associated with the registry to which this image belongs.

Type: String

Pattern: [0-9]{12}

Required: No


The name of the repository to which this image belongs.

Type: String

Length Constraints: Minimum length of 2. Maximum length of 256.

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

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

On this page: