GetMultiRegionAccessPointPolicy
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 in the Amazon S3 User Guide.
The following actions are related to
GetMultiRegionAccessPointPolicy
:
Request Syntax
GET /v20180820/mrap/instances/name+
/policy HTTP/1.1
Host: s3-control.amazonaws.com.cn
x-amz-account-id: AccountId
URI Request Parameters
The request uses the following URI parameters.
- name
-
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 in the Amazon S3 User Guide.
Length Constraints: Maximum length of 50.
Pattern:
^[a-z0-9][-a-z0-9]{1,48}[a-z0-9]$
Required: Yes
- x-amz-account-id
-
The Amazon account ID for the owner of the Multi-Region Access Point.
Length Constraints: Maximum length of 64.
Pattern:
^\d{12}$
Required: Yes
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<GetMultiRegionAccessPointPolicyResult>
<Policy>
<Established>
<Policy>string</Policy>
</Established>
<Proposed>
<Policy>string</Policy>
</Proposed>
</Policy>
</GetMultiRegionAccessPointPolicyResult>
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in XML format by the service.
- GetMultiRegionAccessPointPolicyResult
-
Root level tag for the GetMultiRegionAccessPointPolicyResult parameters.
Required: Yes
- Policy
-
The policy associated with the specified Multi-Region Access Point.
Type: MultiRegionAccessPointPolicyDocument data type
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: