Put Bucket Policy

描述

此PUT接口可以添加一个 Bucket Policy 到某个 bucket。
如果某个接口之前已经有Bucket Policy，新添加的Bucket Policy将完全替换旧的。
如果要使用此接口，你需要是这个Bucket的所有者。
若接口调用成功，则返回204，如调用失败，则会返回错误码及具体的错误信息。

注意：Bucket Policy 规则总大小不得超过20KB

请求

语法

PUT /?policy HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
Policy written in JSON

注意：

• endpoint与Region对应关系
• SignatureValue签名算法

请求参数

该接口不使用请求参数。

请求头部

该接口只使用常用请求头部。获取更多信息，请点击常用请求头部。

请求内容

一段用于描述bucket policy的Json字符串。

响应头部

该接口可以使用所有常用响应头部。获取更多信息，请点击常用响应头部。

响应内容

该接口不返回相应内容。

特殊错误

该接口不返回任何特殊错误。

示例

请求示例

PUT /?policy HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyun.com
Content-Length: 225
Authorization: authorization string
Content-Md5: 8evRehlmPHkf+VuSe8k6Rg==
Date: Tue, 19 Jul 2016 09:12:54 GMT
{"Version":"2008-10-17","Statement": [{"Sid":"1","Effect":"Allow","Principal":{"KSC":["krn:ksc:iam::{userid}:root" ,krn:ksc:iam::(acountid):user/(userName)]},"Action":["ks3:*"],"Resource":["krn:ksc:ks3:::ks3-example","krn:ksc:ks3:::ks3-example/*"],"Condition":{"IpAddress": {"ksc:SourceIp": "54.240.143.1"}}}]}

响应示例

HTTP/1.1 204 No Content
Content-Length: 0
Connection: keep-alive
Date: Tue, 19 Jul 2016 09:14:23 GMT
Server: Tengine
X-Application-Context: application
X-Kss-Request-Id: 54a47bda18ac4e6e91de369add54218e