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