PutBucketPolicy

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。

请求语法

PUT /?policy
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
Policy written in JSON

当您在OSS ON云盒中调用该接口时，您需要将Host替换为云盒Endpoint。更多信息，请参见云盒Endpoint。

请求头

此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

示例

• 请求示例

  PUT /?policy
  Content-Length: 230
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Thu, 17 Apr 2025 12:51:09 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  {
     "Version":"1",
     "Statement":[
     {
       "Action":[
         "oss:PutObject",
         "oss:GetObject"
      ],
      "Effect":"Deny",
      "Principal":["1234567890"],
      "Resource":["acs:oss:*:1234567890:*/*"]
     }
    ]
   }

• 返回示例

  HTTP/1.1 200 OK
  content-length: 0
  server: AliyunOSS
  x-oss-server-time: 87
  connection: keep-alive
  x-oss-request-id: 5C6E9EBD5CC26B28EE41****
  date: Thu, 21 Feb 2019 12:51:09 GMT

SDK

此接口所对应的各语言SDK如下：

• Java

• Python V2

• Go V2

• Node.js

• PHP V2

• .NET

• C++

命令行工具ossutil

PutBucketPolicy接口所对应的ossutil命令，请参见put-bucket-policy。