Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1441293181.2 KB

Describes image repositories in a registry.

post/#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.DescribeRepositories

Query parameters

maxResultsstring

Pagination limit

nextTokenstring

Pagination token

Headers

X-Amz-Target'AmazonEC2ContainerRegistry_V20150921.DescribeRepositories' required

Request body

registryIdstring

The Amazon Web Services account ID associated with the registry that contains the repositories to be described. If you do not specify a registry, the default registry is assumed.

repositoryNamesRepositoryName[]

A list of repositories to describe. If this parameter is omitted, then all repositories in a registry are described.

nextTokenstring
<p>The <code>nextToken</code> value returned from a previous paginated <code>DescribeRepositories</code> request where <code>maxResults</code> was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the <code>nextToken</code> value. This value is <code>null</code> when there are no more results to return. This option cannot be used when you specify repositories with <code>repositoryNames</code>.</p> <note> <p>This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.</p> </note>
maxResultsinteger

The maximum number of repository results returned by <code>DescribeRepositories</code> in paginated output. When this parameter is used, <code>DescribeRepositories</code> only returns <code>maxResults</code> results in a single page along with a <code>nextToken</code> response element. The remaining results of the initial request can be seen by sending another <code>DescribeRepositories</code> request with the returned <code>nextToken</code> value. This value can be between 1 and 1000. If this parameter is not used, then <code>DescribeRepositories</code> returns up to 100 results and a <code>nextToken</code> value, if applicable. This option cannot be used when you specify repositories with <code>repositoryNames</code>.

Response

Success

nextTokenstring

The <code>nextToken</code> value to include in a future <code>DescribeRepositories</code> request. When the results of a <code>DescribeRepositories</code> request exceed <code>maxResults</code>, this value can be used to retrieve the next page of results. This value is <code>null</code> when there are no more results to return.

Example response

{
  "repositories": [
    {
      "registryId": 12345678910,
      "repositoryArn": "arn:aws:ecr:us-west-2:012345678910:repository/ubuntu",
      "repositoryName": "ubuntu"
    },
    {
      "registryId": 12345678910,
      "repositoryArn": "arn:aws:ecr:us-west-2:012345678910:repository/test",
      "repositoryName": "test"
    }
  ]
}