全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

PUT Bucket Policy

最近更新时间:2022-12-30 15:47:29

描述

此PUT接口可以添加一个 Bucket Policy 到某个 bucket。
如果某个Bucket之前已经有Bucket Policy,新添加的Bucket Policy将完全替换旧的。
使用此接口,必须是Bucket的所有者或具有ks3:PutBucketPolicy权限。

注意:Bucket Policy 规则总大小不得超过512KB

请求

请求语法

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

注意:

请求参数

该接口不使用请求参数。

请求头部

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

请求内容

一段用于描述Bucket Policy的Json格式的字符串,包括以下元素:

名称 描述 是否必选
Effect 代表本条策略的效果,可以是允许或拒绝,对应Effect的值为Allow或者Deny。
Principal 代表授权给哪些用户和账户。
Action 代表对于指定的资源授权了哪些权限。
Resource 代表本条策略针对哪些资源起作用,可以设置为存储空间(Bucket)、对象(Object)以及相对应的子资源。
Condition 在授予权限时指定的条件。访问请求只有在满足指定条件时,访问策略才可以生效。

响应

响应头部

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

响应内容

该接口不返回响应内容。

特殊错误

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

示例

请求示例

PUT /?policy HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.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::accountID:root",
                    "krn:ksc:iam::accountID: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: KS3
X-Application-Context: application
X-Kss-Request-Id: 54a47bda18ac4e6e91de369add54218e

错误码

错误码 HTTP状态码 描述
MalformedPolicy 400 Bad Request * 策略元素Effect、Princple、Action、Resource重复或缺少 。
* 策略元素Effect的值应为Allow或Deny,否则会报错。
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈