---
title: "POST /#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.PutReplicationConfiguration"
method: POST
path: "/#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.PutReplicationConfiguration"
---

# POST /#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.PutReplicationConfiguration

`POST /#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.PutReplicationConfiguration`

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](https://docs.aws.amazon.com/AmazonECR/latest/userguide/using-service-linked-roles.html) in the _Amazon Elastic Container Registry User Guide_.

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.

## Headers

- `X-Amz-Target` 'AmazonEC2ContainerRegistry_V20150921.PutReplicationConfiguration', required

## Request body

- PutReplicationConfigurationRequest
  - `replicationConfiguration` object, required — An object representing the replication configuration for a registry.
    - `rules` ReplicationRule[], required — An array of objects representing the replication destinations and repository filters for a replication configuration.
      - `destinations` ReplicationDestination[], required — 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` RepositoryFilter[] — 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.
        - `filter` string, required — The repository filter details. When the <code>PREFIX_MATCH</code> filter type is specified, this value is required and should be the repository name prefix to configure replication for.
        - `filterType` 'PREFIX_MATCH', required — The repository filter type. The only supported value is <code>PREFIX_MATCH</code>, which is a repository name prefix specified with the <code>filter</code> parameter.

## Response `200`

Success

- PutReplicationConfigurationResponse
  - `replicationConfiguration` object — The contents of the replication configuration for the registry.
    - `rules` ReplicationRule[], required — An array of objects representing the replication destinations and repository filters for a replication configuration.
      - `destinations` ReplicationDestination[], required — 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` RepositoryFilter[] — 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.
        - `filter` string, required — The repository filter details. When the <code>PREFIX_MATCH</code> filter type is specified, this value is required and should be the repository name prefix to configure replication for.
        - `filterType` 'PREFIX_MATCH', required — The repository filter type. The only supported value is <code>PREFIX_MATCH</code>, which is a repository name prefix specified with the <code>filter</code> parameter.

## Other responses

- `480` — ServerException
- `481` — InvalidParameterException
- `482` — ValidationException

---

[API](https://skmtc.net/aws/apis/ecr.md) · [All operations](https://skmtc.net/aws/apis/ecr/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/ecr/versions/965cbb14e137/schema)