:doc:`S3Control <../../s3control>` / Client / put_multi_region_access_point_policy

************************************
put_multi_region_access_point_policy
************************************



.. py:method:: S3Control.Client.put_multi_region_access_point_policy(**kwargs)

  

  .. note::

    

    This operation is not supported by directory buckets.

    

   

  Associates an access control policy with the specified Multi-Region Access Point. Each Multi-Region Access Point can have only one policy, so a request made to this action replaces any existing policy that is associated with the specified Multi-Region Access Point.

   

  This action will always be routed to the US West (Oregon) Region. For more information about the restrictions around working with Multi-Region Access Points, see `Multi-Region Access Point restrictions and limitations <https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiRegionAccessPointRestrictions.html>`__ in the *Amazon S3 User Guide*.

   

  The following actions are related to ``PutMultiRegionAccessPointPolicy``:

   

  
  * `GetMultiRegionAccessPointPolicy <https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetMultiRegionAccessPointPolicy.html>`__
   
  * `GetMultiRegionAccessPointPolicyStatus <https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetMultiRegionAccessPointPolicyStatus.html>`__
  

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/s3control-2018-08-20/PutMultiRegionAccessPointPolicy>`_  


  **Request Syntax**
  ::

    response = client.put_multi_region_access_point_policy(
        AccountId='string',
        ClientToken='string',
        Details={
            'Name': 'string',
            'Policy': 'string'
        }
    )
    
  :type AccountId: string
  :param AccountId: **[REQUIRED]** 

    The Amazon Web Services account ID for the owner of the Multi-Region Access Point.

    

  
  :type ClientToken: string
  :param ClientToken: **[REQUIRED]** 

    An idempotency token used to identify the request and guarantee that requests are unique.

    This field is autopopulated if not provided.

  
  :type Details: dict
  :param Details: **[REQUIRED]** 

    A container element containing the details of the policy for the Multi-Region Access Point.

    

  
    - **Name** *(string) --* **[REQUIRED]** 

      The name of the Multi-Region Access Point associated with the request.

      

    
    - **Policy** *(string) --* **[REQUIRED]** 

      The policy details for the ``PutMultiRegionAccessPoint`` request.

      

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

    
    ::

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

    

    - *(dict) --* 
      

      - **RequestTokenARN** *(string) --* 

        The request token associated with the request. You can use this token with `DescribeMultiRegionAccessPointOperation <https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_DescribeMultiRegionAccessPointOperation.html>`__ to determine the status of asynchronous requests.

        
  