put_replication_configuration

put_replication_configuration(**kwargs)

Creates or updates the replication configuration for a registry. The existing replication configuration for a repository can be retrieved with the DescribeRegistry API action. The first time the PutReplicationConfiguration API is called, a service-linked IAM role is created in your account for the replication process. For more information, see Using service-linked roles for Amazon ECR in the Amazon Elastic Container Registry User Guide .

Note

When configuring cross-account replication, the destination account must grant the source account permission to replicate. This permission is controlled using a registry permissions policy. For more information, see PutRegistryPolicy.

See also: AWS API Documentation

Request Syntax

response = client.put_replication_configuration(
    replicationConfiguration={
        'rules': [
            {
                'destinations': [
                    {
                        'region': 'string',
                        'registryId': 'string'
                    },
                ],
                'repositoryFilters': [
                    {
                        'filter': 'string',
                        'filterType': 'PREFIX_MATCH'
                    },
                ]
            },
        ]
    }
)
Parameters
replicationConfiguration (dict) --

[REQUIRED]

An object representing the replication configuration for a registry.

  • rules (list) -- [REQUIRED]

    An array of objects representing the replication destinations and repository filters for a replication configuration.

    • (dict) --

      An array of objects representing the replication destinations and repository filters for a replication configuration.

      • destinations (list) -- [REQUIRED]

        An array of objects representing the destination for a replication rule.

        • (dict) --

          An array of objects representing the destination for a replication rule.

          • region (string) -- [REQUIRED]

            The Region to replicate to.

          • registryId (string) -- [REQUIRED]

            The Amazon Web Services account ID of the Amazon ECR private registry to replicate to. When configuring cross-Region replication within your own registry, specify your own account ID.

      • repositoryFilters (list) --

        An array of objects representing the filters for a replication rule. Specifying a repository filter for a replication rule provides a method for controlling which repositories in a private registry are replicated.

        • (dict) --

          The filter settings used with image replication. Specifying a repository filter to a replication rule provides a method for controlling which repositories in a private registry are replicated. If no repository filter is specified, all images in the repository are replicated.

          • filter (string) -- [REQUIRED]

            The repository filter details. When the PREFIX_MATCH filter type is specified, this value is required and should be the repository name prefix to configure replication for.

          • filterType (string) -- [REQUIRED]

            The repository filter type. The only supported value is PREFIX_MATCH , which is a repository name prefix specified with the filter parameter.

Return type
dict
Returns
Response Syntax
{
    'replicationConfiguration': {
        'rules': [
            {
                'destinations': [
                    {
                        'region': 'string',
                        'registryId': 'string'
                    },
                ],
                'repositoryFilters': [
                    {
                        'filter': 'string',
                        'filterType': 'PREFIX_MATCH'
                    },
                ]
            },
        ]
    }
}

Response Structure

  • (dict) --
    • replicationConfiguration (dict) --

      The contents of the replication configuration for the registry.

      • rules (list) --

        An array of objects representing the replication destinations and repository filters for a replication configuration.

        • (dict) --

          An array of objects representing the replication destinations and repository filters for a replication configuration.

          • destinations (list) --

            An array of objects representing the destination for a replication rule.

            • (dict) --

              An array of objects representing the destination for a replication rule.

              • region (string) --

                The Region to replicate to.

              • registryId (string) --

                The Amazon Web Services account ID of the Amazon ECR private registry to replicate to. When configuring cross-Region replication within your own registry, specify your own account ID.

          • repositoryFilters (list) --

            An array of objects representing the filters for a replication rule. Specifying a repository filter for a replication rule provides a method for controlling which repositories in a private registry are replicated.

            • (dict) --

              The filter settings used with image replication. Specifying a repository filter to a replication rule provides a method for controlling which repositories in a private registry are replicated. If no repository filter is specified, all images in the repository are replicated.

              • filter (string) --

                The repository filter details. When the PREFIX_MATCH filter type is specified, this value is required and should be the repository name prefix to configure replication for.

              • filterType (string) --

                The repository filter type. The only supported value is PREFIX_MATCH , which is a repository name prefix specified with the filter parameter.

Exceptions

  • ECR.Client.exceptions.ServerException
  • ECR.Client.exceptions.InvalidParameterException
  • ECR.Client.exceptions.ValidationException