:doc:`SecretsManager <../../secretsmanager>` / Client / stop_replication_to_replica

***************************
stop_replication_to_replica
***************************



.. py:method:: SecretsManager.Client.stop_replication_to_replica(**kwargs)

  

  Removes the link between the replica secret and the primary secret and promotes the replica to a primary secret in the replica Region.

   

  You must call this operation from the Region in which you want to promote the replica to a primary secret.

   

  Secrets Manager generates a CloudTrail log entry when you call this action. Do not include sensitive information in request parameters because it might be logged. For more information, see `Logging Secrets Manager events with CloudTrail <https://docs.aws.amazon.com/secretsmanager/latest/userguide/retrieve-ct-entries.html>`__.

   

  **Required permissions:** ``secretsmanager:StopReplicationToReplica``. For more information, see `IAM policy actions for Secrets Manager <https://docs.aws.amazon.com/secretsmanager/latest/userguide/reference_iam-permissions.html#reference_iam-permissions_actions>`__ and `Authentication and access control in Secrets Manager <https://docs.aws.amazon.com/secretsmanager/latest/userguide/auth-and-access.html>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/secretsmanager-2017-10-17/StopReplicationToReplica>`_  


  **Request Syntax**
  ::

    response = client.stop_replication_to_replica(
        SecretId='string'
    )
    
  :type SecretId: string
  :param SecretId: **[REQUIRED]** 

    The name of the secret or the replica ARN. The replica ARN is the same as the original primary secret ARN expect the Region is changed to the replica Region.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'ARN': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ARN** *(string) --* 

        The ARN of the promoted secret. The ARN is the same as the original primary secret except the Region is changed.

        
  
  **Exceptions**
  
  *   :py:class:`SecretsManager.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`SecretsManager.Client.exceptions.InvalidRequestException`

  
  *   :py:class:`SecretsManager.Client.exceptions.InvalidParameterException`

  
  *   :py:class:`SecretsManager.Client.exceptions.InternalServiceError`

  