Get Bucket Policy(1) 功能说明 获取指定桶的桶策略。 请求消息样式 plaintext GET /{Bucket}?policy HTTP/1.1 Host: xxx.zos.ctyun.cn XAmzContentSha256: ContentSHA256 XAmzDate: Date Authorization: Auth String 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释: 桶的名称。 String 是 请求消息头 该请求使用公共的请求消息头,请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: Request Id ContentLength: ContentLength Date: Date Connection: KeepAlive { "Version": "20121017", "Id": "string", "Statement": [ { "Sid": "string", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam:::user/uid" }, "Action": ["s3:"], "Resource": [ "arn:aws:s3:::bucketname/", "arn:aws:s3:::bucketname" ], "Condition": { "StringEquals": { "aws:Referer": [ "xxx" ] } } } ] } 响应消息头 该请求的响应消息使用公共的响应消息头,请参见如何调用API响应结果响应消息头。 响应元素说明 参数名称 参数描述 类型 Version 参数解释: 指定桶策略的版本信息。 取值范围: 当前支持"20121017"和"20060301" 默认取值: "20121017" String Id 参数解释: 桶策略ID,桶策略的唯一标识。 String Statement 参数解释: 桶策略描述,定义完整的权限控制。 约束限制: 每条桶策略的Statement可由多条描述组成,每条描述可包含字段:Sid、Effect、Principal、Action、Resource、Condition。 Array Sid 参数解释: 本条桶策略描述的ID。 String Effect 参数解释: 桶策略的效果,即指定本条桶策略描述的权限是接受请求还是拒绝请求。 取值范围: Allow或Deny String Principal 参数解释: 被授权人,即指定本条桶策略描述所作用的用户。 约束限制: 支持通配符“”,表示所有用户和委托。 当对某个用户进行授权时,Principal格式为"AWS": "arn:aws:s3:::user/UserID" 当对某个委托进行授权时,Principal格式为"AWS": "arn:aws:s3:::role/RoleID" Object Action 参数解释: 授权操作,即指定本条桶策略描述所作用的ZOS操作。 约束限制: 以列表形式表示,可配置多条操作,以逗号间隔。支持通配符"",表示该资源能进行的所有操作。常用的Action有"s3:GetObject","s3:PutObject","s3:"等。 取值范围: 详见桶策略附录一。 Object Condition 参数解释: 条件语句,指定本条桶策略所限制的条件。可以通过Condition对ZOS资源各种策略,比如设置防盗链: "Condition": {"StringEquals":{"aws:Referer":["xxx"]},此时如果Effect为“Allow”,则允许来自"xxx"的请求;如果为“Deny”,则拒绝。 取值范围: 详见桶策略附录二。 Object
来自: