View a markdown version of this page

SetBucketAccessControlPolicy（SOAP API） - Amazon Simple Storage Service
访问控制

SetBucketAccessControlPolicy（SOAP API）

注意

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

SetBucketAccessControlPolicy 操作为现有存储桶设置访问控制策略。如果成功，则存储桶之前的访问控制策略将完全替换为指定的访问控制策略。

例

向指定的用户（通常是拥有者）授予对“quotes”存储桶的 FULL_CONTROL 访问权限。

Sample Request

<SetBucketAccessControlPolicy xmlns="https://doc.s3.amazonaws.com/2006-03-01">
  <Bucket>quotes</Bucket>
  <AccessControlList>
    <Grant>
      <Grantee xsi:type="CanonicalUser">
        <ID>a9a7b8863000e241bf9b1c61be666e9</ID>
        <DisplayName>chriscustomer</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
  <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
  <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
  <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
</SetBucketAccessControlPolicy >

Sample Response

<GetBucketAccessControlPolicyResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01">
  <GetBucketAccessControlPolicyResponse>
    <Code>200</Code>
    <Description>OK</Description>
  </GetBucketAccessControlPolicyResponse>
</GetBucketAccessControlPolicyResponse>

访问控制

您必须对存储桶拥有 WRITE_ACP 权限，才能设置存储桶的访问控制策略。