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

************************************
get_multi_region_access_point_policy
************************************



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

  

  .. note::

    

    This operation is not supported by directory buckets.

    

   

  Returns the access control policy of 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 ``GetMultiRegionAccessPointPolicy``:

   

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

  

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


  **Request Syntax**
  ::

    response = client.get_multi_region_access_point_policy(
        AccountId='string',
        Name='string'
    )
    
  :type AccountId: string
  :param AccountId: **[REQUIRED]** 

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

    

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

    Specifies the Multi-Region Access Point. The name of the Multi-Region Access Point is different from the alias. For more information about the distinction between the name and the alias of an Multi-Region Access Point, see `Rules for naming Amazon S3 Multi-Region Access Points <https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingMultiRegionAccessPoints.html#multi-region-access-point-naming>`__ in the *Amazon S3 User Guide*.

    

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

    
    ::

      {
          'Policy': {
              'Established': {
                  'Policy': 'string'
              },
              'Proposed': {
                  'Policy': 'string'
              }
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Policy** *(dict) --* 

        The policy associated with the specified Multi-Region Access Point.

        
        

        - **Established** *(dict) --* 

          The last established policy for the Multi-Region Access Point.

          
          

          - **Policy** *(string) --* 

            The details of the last established policy.

            
      
        

        - **Proposed** *(dict) --* 

          The proposed policy for the Multi-Region Access Point.

          
          

          - **Policy** *(string) --* 

            The details of the proposed policy.

            
      
    
  