对象存储

对象存储

产品文档

对象存储

帮助中心 > OpenAPI & SDK > 对象存储 > Put Bucket policy
搜本产品

Put Bucket Policy

描述

该操作可设置指定Bucket的policy，仅Bukcet的Owner可操作。更多Bucket Policy相关信息，请访问基于Bucket Policy的权限控制。

请求

语法


PUT /?policy HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: <date>
Authorization: <authorization string> (see Authenticating Requests (AWS Signature Version4))

Policy written in JSON

请求参数

无请求参数

请求Header

无特殊请求Header

请求元素

Body为JSON字符串，包含Policy语句。每个Policy可以有多个规则(Statement),每条规则有以下元素组成：

元素 含义 必须
Action 该条规则生效的操作，支持操作：s3:DeleteBucket、s3:ListBucket、s3:GetObject、s3:PutObject、s3:DeleteObject 是
Effect 如果匹配该规则的时候产生的效果，为Deny或者Allow 是
Resource 该规则生效的资源，格式为arn:aws:s3:${bucket}/${dir}，默认为当前Bucket 是
Principal 该规则生效的requester，JSON对象，支持通配符"*"，允许所有。例如{"AWS":["arn:aws:iam::191853487641:root"} 是
Condition 该规则生成的条件，是JSON对象，目前只支持Referer和SourceIP 否

响应

响应Header

无特殊响应Header

响应元素

无响应元素

示例

请求示例


PUT /?policy HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com 
Date: Tue, 04 Apr 2010 20:34:56 GMT  
Authorization: <authorization string>

{
"Version":"2008-10-17",
"Id":"aaaa-bbbb-cccc-dddd",
"Statement" : [
    {
        "Effect":"Allow",
        "Sid":"1", 
        "Principal" : {
            "AWS":"arn:aws:iam::191853487641:root"
        },
        "Action":["s3:*"],
        "Resource":"arn:aws:s3:::bucket/*"
    }
 ] 
}

响应示例


HTTP/1.1 200 OK  
x-amz-request-id: 656c76696e6727732SAMPLE7374  
Date: Tue, 04 Apr 2010 20:34:56 GMT  
Connection: keep-alive  
Server: JDCloudOSS
更新时间：2021-09-01 19:17:05
文档反馈 docs feedback