/

POST

Returns details for a public registry.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/' \
--header 'X-Amz-Target;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "nextToken": "string",
    "maxResults": 0
}'

Response Example

200 - Example 1

{
    "registries": [],
    "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

nextToken

string

optional

The nextToken value that's returned from a previous paginated DescribeRegistries 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.

maxResults

integer

optional

The maximum number of repository results that's returned by DescribeRegistries in paginated output. When this parameter is used, DescribeRegistries 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 DescribeRegistries request with the returned nextToken value. This value can be between 1 and 1000. If this parameter isn't used, then DescribeRegistries returns up to 100 results and a nextToken value, if applicable.

>= 1<= 1000

Examples

Responses

🟢200Success

application/json

Body

registries

array[object (Registry) {5}]

required

An object that contains the details for a public registry.

registryId

string

required

The Amazon Web Services account ID that's associated with the registry. If you do not specify a registry, the default public registry is assumed.

Match pattern:

[0-9]{12}

registryArn

string

required

The Amazon Resource Name (ARN) of the public registry.

>= 1 characters<= 2048 characters

registryUri

string

required

The URI of a public registry. The URI contains a universal prefix and the registry alias.

verified

boolean

required

Indicates whether the account is a verified Amazon Web Services Marketplace vendor. If an account is verified, each public repository receives a verified account badge on the Amazon ECR Public Gallery.

aliases

array[object (RegistryAlias) {4}]

required

An array of objects that represents the aliases for a public registry.

nextToken

string

optional

The nextToken value to include in a future DescribeRepositories request. If the results of a DescribeRepositories request exceed maxResults, you can use this value to retrieve the next page of results. If there are no more results, this value is null.

🟠480InvalidParameterException

🟠481UnsupportedCommandException

🟠482ServerException