PutRegistryPolicy - Amazon Elastic Container Registry

PutRegistryPolicy

Creates or updates the permissions policy for your registry.

A registry policy is used to specify permissions for another AWS account and is used when configuring cross-account replication. For more information, see Registry permissions in the Amazon Elastic Container Registry User Guide.

Request Syntax

{ "policyText": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

policyText

The JSON policy text to apply to your registry. The policy text follows the same format as IAM policy text. For more information, see Registry permissions in the Amazon Elastic Container Registry User Guide.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 10240.

Required: Yes

Response Syntax

{ "policyText": "string", "registryId": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

policyText

The JSON policy text for your registry.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 10240.

registryId

The registry ID associated with the request.

Type: String

Pattern: [0-9]{12}

Errors

For information about the errors that are common to all actions, see Common Errors.

InvalidParameterException

The specified parameter is invalid. Review the available parameters for the API request.

HTTP Status Code: 400

ServerException

These errors are usually caused by a server-side issue.

HTTP Status Code: 500

ValidationException

There was an exception validating this request.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: