Describe Images
ecr_describe_images | R Documentation |
Returns metadata about the images in a repository¶
Description¶
Returns metadata about the images in a 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
describe_images
.
Usage¶
Arguments¶
registryId
The Amazon Web Services 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.
repositoryName
[required] The repository that contains the images to describe.
imageIds
The list of image IDs for the requested repository.
nextToken
The
nextToken
value returned from a previous paginateddescribe_images
request wheremaxResults
was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned thenextToken
value. This value isnull
when there are no more results to return. This option cannot be used when you specify images withimageIds
.maxResults
The maximum number of repository results returned by
describe_images
in paginated output. When this parameter is used,describe_images
only returnsmaxResults
results in a single page along with anextToken
response element. The remaining results of the initial request can be seen by sending anotherdescribe_images
request with the returnednextToken
value. This value can be between 1 and 1000. If this parameter is not used, thendescribe_images
returns up to 100 results and anextToken
value, if applicable. This option cannot be used when you specify images withimageIds
.filter
The filter key and value with which to filter your
describe_images
results.
Value¶
A list with the following syntax:
list(
imageDetails = list(
list(
registryId = "string",
repositoryName = "string",
imageDigest = "string",
imageTags = list(
"string"
),
imageSizeInBytes = 123,
imagePushedAt = as.POSIXct(
"2015-01-01"
),
imageScanStatus = list(
status = "IN_PROGRESS"|"COMPLETE"|"FAILED"|"UNSUPPORTED_IMAGE"|"ACTIVE"|"PENDING"|"SCAN_ELIGIBILITY_EXPIRED"|"FINDINGS_UNAVAILABLE",
description = "string"
),
imageScanFindingsSummary = list(
imageScanCompletedAt = as.POSIXct(
"2015-01-01"
),
vulnerabilitySourceUpdatedAt = as.POSIXct(
"2015-01-01"
),
findingSeverityCounts = list(
123
)
),
imageManifestMediaType = "string",
artifactMediaType = "string",
lastRecordedPullTime = as.POSIXct(
"2015-01-01"
)
)
),
nextToken = "string"
)