产品推荐：

1、安全稳定的云服务器租用，2核/2G/5M仅37元，点击抢购>>>；

2、高防物理服务器20核/16G/50M/500G防御仅350元，点击抢购>>>

3、百度智能建站（五合一网站）仅880元/年，点击抢购>>> 模板建站（PC+手机站）仅480元/年，点击抢购>>>

4、阿里云服务器2核2G3M仅99元/年、2核4G5M仅199元/年，新老同享，点击抢购>>> 

5、腾讯云服务器2核2G4M仅99元/年、新老同享，点击抢购>>>   

点击这里注册天翼云特邀VIP帐号，立即体验天翼云对象存储>>>

天翼云对象存储（经典版）I型API参考-Bucket Policy元素

下面介绍statements中的各个元素。

Version

Version是Bucket Policy语言的版本，它是个可选项，目前OOS API只允许填写2012-10-17。

"Version":"2012-10-17"

Id

Id是Bucket Policy的一个可选标识。推荐使用UUID来指明Bucket Policy。

Statement

Statement是个重要的元素，它可以包含多个元素。Statement元素可以包含一组独立的statements，每个独立的Statement是一个包含在大括号（{}）内的严格的JSON块。

"Statement":[{...},{...},{...}]

1. Sid
Sid(statement ID)是statement的一个可选标识，它可以看作是policy id的子id。

"Sid" : "1"

2. Effect

 Effect是一个必填元素，用于表示允许访问或拒绝访问，有效值只能是Allow或Deny。

"Effect":"Allow"

3.  Principal

Principal用于指定被允许或被拒绝访问的用户，Principal可以为：

l  "Principal": "*"、或"Principal": {"CTYUN":"*"}：表示所有用户；

l  "Principal": { "CTYUN": "arn:ctyun:iam:: accountId:root" }：表示根用户；

l  "Principal": { "CTYUN": "arn:ctyun:iam::accountId:user/user-name" }：表示子用户。

可以指定根用户和多个子用户,如下表示方法：

4.  Action

Action用于指定被允许或拒绝访问的操作，必填项。只有拥有相关权限的用户能执行Bucket相关写操作，以及Bucket子资源的相关操作。Action中可以配置以下权限。

与Bucket相关的OOS权限列表如下。

对象操作的 OOS 权限列表如下。

可使用通配符 (*) 来访问OOS产品提供的所有操作。例如，以下Action元素适用于所有OOS操作。

"Action": "oos:*"

还可以使用通配符 (*) 作为操作名称的一部分。例如下面的Action元素，适用于PutObject, GetObject, DeleteObject

"Action": "oos:*Object"

5. Resource

Resource是指Policy覆盖的对象或对象集合。可以使用通配符*和？，必须以arn:ctyun:oos:::bucketName/开头。例如要使Policy对于所有以image开头的Object生效，可以这样配置：

"Resource":"arn:ctyun:oos:::example-bucket/image*"

6. Condition

Condition是Statement中最复杂的一个元素，我们把它称之为condition块，虽然只有一个condition元素，但是它可以包含多个conditions，而且每个condition可以包含多个key-value对。如下图所示，condition块中的各个condition之间是逻辑与关系，condition key之间也是逻辑与关系，各个value之间是逻辑或关系。

（1）条件运算符

条件运算符是条件的“动词”形式，可指定OOS执行的比较类型。条件运算符可分为以下类别：

        1)  String Conditions

            String conditions可以允许设置string的匹配规则。

            例如，要匹配HTTP Referer头是以“http://www.mysite.com/”开头的请求，可以这样配置：

"StringLike":{
          "ctyun:Referer":[
            "http://www.mysite.com/*"
          ]
        }

         2) 布尔值条件运算符

             利用布尔值条件，用户可以通过与“正确”或“错误”的对比，来设置Condition元素。

             例如，下列声明使用 Bool 条件运算符与 ctyun:SecureTransport 键来指定必须使用 SSL 发出请求。

{
  "Version": "2012-10-17",
  "Statement": [
{
"Effect": "Allow",
"Principal":{ "CTYUN": ["*"] },
    "Action": "oos:PutObject",
    "Resource": "arn:ctyun:oos:::example_bucket/*",
    "Condition": {"Bool": {"ctyun:SecureTransport": "true"}}
  }
 ]
}

         3)  IP Address

              IP address conditions允许设置IP地址的匹配规则，与ctyun:SourceIp key配合使用。此项的值必须符合标准的CIDR格式（例如：10.52.176.0/24），参考RFC 4632

（2）  条件键