registry_policies
Creates, updates, deletes, gets or lists a registry_policies resource.
Overview
| Name | registry_policies |
| Type | Resource |
| Id | aws.ecr.registry_policies |
Fields
The following fields are returned by SELECT queries:
- get_registry_policy
| Name | Datatype | Description |
|---|---|---|
policy_text | string | The JSON text of the permissions policy for a registry. |
registry_id | string | The registry ID associated with the request. (pattern: <code>[0-9]{12}</code>) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_registry_policy | select | region | Retrieves the permissions policy for a registry. | |
put_registry_policy | replace | region, policyText | Creates or updates the permissions policy for your registry. A registry policy is used to specify permissions for another Amazon Web Services account and is used when configuring cross-account replication. For more information, see Registry permissions in the Amazon Elastic Container Registry User Guide. | |
delete_registry_policy | delete | region | Deletes the registry permissions policy. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
region | string | AWS region (default: us-east-1) |
SELECT examples
- get_registry_policy
Retrieves the permissions policy for a registry.
SELECT
policy_text,
registry_id
FROM aws.ecr.registry_policies
WHERE region = '{{ region }}' -- required
;
REPLACE examples
- put_registry_policy
Creates or updates the permissions policy for your registry. A registry policy is used to specify permissions for another Amazon Web Services account and is used when configuring cross-account replication. For more information, see Registry permissions in the Amazon Elastic Container Registry User Guide.
REPLACE aws.ecr.registry_policies
SET
policyText = '{{ policyText }}'
WHERE
region = '{{ region }}' --required
AND policyText = '{{ policyText }}' --required
RETURNING
policy_text,
registry_id;
DELETE examples
- delete_registry_policy
Deletes the registry permissions policy.
DELETE FROM aws.ecr.registry_policies
WHERE region = '{{ region }}' --required
;