Returns metadata about the images in a repository, including image size, image tags, and creation date.
ecr_describe_images(registryId, repositoryName, imageIds, nextToken,
maxResults, filter)
The AWS account ID associated with the registry that contains the repository in which to describe images. If you do not specify a registry, the default registry is assumed.
[required] A list of repositories to describe.
The list of image IDs for the requested repository.
The nextToken
value returned from a previous paginated
DescribeImages
request where maxResults
was used and the results
exceeded the value of that parameter. Pagination continues from the end
of the previous results that returned the nextToken
value. This value
is null
when there are no more results to return. This option cannot
be used when you specify images with imageIds
.
The maximum number of repository results returned by DescribeImages
in
paginated output. When this parameter is used, DescribeImages
only
returns maxResults
results in a single page along with a nextToken
response element. The remaining results of the initial request can be
seen by sending another DescribeImages
request with the returned
nextToken
value. This value can be between 1 and 1000. If this
parameter is not used, then DescribeImages
returns up to 100 results
and a nextToken
value, if applicable. This option cannot be used when
you specify images with imageIds
.
The filter key and value with which to filter your DescribeImages
results.
svc$describe_images( registryId = "string", repositoryName = "string", imageIds = list( list( imageDigest = "string", imageTag = "string" ) ), nextToken = "string", maxResults = 123, filter = list( tagStatus = "TAGGED"|"UNTAGGED"|"ANY" ) )
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.