

# GetObjectAccessControlPolicy（SOAP API）
<a name="SOAPGetObjectAccessControlPolicy"></a>

**注意**  
 Amazon S3 的 SOAP API 不适用于新客户，并将于 2025 年 8 月 31 日接近使用寿命终止（EOL）。我们建议您使用 REST API 或 Amazon SDK。

`GetObjectAccessControlPolicy` 操作提取对象的访问控制策略。

**Example**  
本示例将为“quotes”存储桶中的“Nelson”对象检索访问控制策略。  
`Sample Request`  

```
1. <GetObjectAccessControlPolicy xmlns="https://doc.s3.amazonaws.com/2006-03-01">
2.   <Bucket>quotes</Bucket>
3.   <Key>Nelson</Key>
4.   <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
5.   <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
6.   <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
7. </GetObjectAccessControlPolicy>
```
`Sample Response`  

```
 1. <AccessControlPolicy>
 2.   <Owner>
 3.     <ID>a9a7b886d6fd24a541bf9b1c61be666e9</ID>
 4.     <DisplayName>chriscustomer</DisplayName>
 5.   </Owner>
 6.   <AccessControlList>
 7.     <Grant>
 8.       <Grantee xsi:type="CanonicalUser">
 9.         <ID>a9a7b841bf9b1c61be666e9</ID>
10.         <DisplayName>chriscustomer</DisplayName>
11.       </Grantee>
12.       <Permission>FULL_CONTROL</Permission>
13.     </Grant>
14.     <Grant>
15.       <Grantee xsi:type="Group">
16.         <URI>http://acs.amazonaws.com/groups/global/AllUsers<URI>
17.       </Grantee>
18.       <Permission>READ</Permission>
19.     </Grant>
20.   </AccessControlList>
21. </AccessControlPolicy>
```

## 响应正文
<a name="SOAPGetObjectAccessControlPolicyResponseBody"></a>

响应包含存储桶的访问控制策略。有关此响应的解释，请参阅 [SOAP 访问策略](https://docs.amazonaws.cn/AmazonS3/latest/userguide/SOAPAccessPolicy.html)。

## 访问控制
<a name="SOAPGetObjectAccessControlPolicyAccessControl"></a>

您必须拥有对象的 `READ_ACP` 权限，才能检索该对象的访问控制策略。