Returns the image tag details for a repository in a public registry.
Request Request Example
Shell
JavaScript
Java
Swift
curl--location--request POST '/' \
--header'X-Amz-Target;' \
--header'Content-Type: application/json' \
--data-raw''
Response Response Example
200 - Example 1
{"imageTagDetails":[],"nextToken":"string"}
Request
Query Params
maxResults
string
optional
Pagination limit
nextToken
string
optional
Pagination token
Header Params
X-Amz-Target
string
required
Body Params application/json
registryId
string
optional
The Amazon Web Services account ID that's associated with the public registry that contains the repository where images are described. If you do not specify a registry, the default public registry is assumed.
Match pattern:
[0-9]{12}
repositoryName
string
required
The name of the repository that contains the image tag details to describe.
The nextToken value that's returned from a previous paginated DescribeImageTags 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. If there are no more results to return, this value is null. If you specify images with imageIds, you can't use this option.
maxResults
integer
optional
The maximum number of repository results that's returned by DescribeImageTags in paginated output. When this parameter is used, DescribeImageTags only returns maxResults results in a single page along with a nextToken response element. You can see the remaining results of the initial request by sending another DescribeImageTags request with the returned nextToken value. This value can be between 1 and 1000. If this parameter isn't used, then DescribeImageTags returns up to 100 results and a nextToken value, if applicable. If you specify images with imageIds, you can't use this option.
>= 1<= 1000
Examples
Responses
🟢200Success
application/json
Body
imageTagDetails
array[object (ImageTagDetail) {3}]
optional
The image tag details for the images in the requested repository.
imageTag
string
optional
The tag that's associated with the image.
>= 1 characters<= 300 characters
createdAt
string<date-time>
optional
The time stamp that indicates when the image tag was created.
imageDetail
object
optional
An object that describes the details of an image.
nextToken
string
optional
The nextToken value to include in a future DescribeImageTags request. When the results of a DescribeImageTags request exceed maxResults, you can use this value to retrieve the next page of results. If there are no more results to return, this value is null.
