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" }：表示子用户。

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

"Principal": {

"CTYUN": [

"arn:ctyun:iam::accountId:root",

"arn:ctyun:iam::accountId:user/user-name1",

"arn:ctyun:iam::accountId:user/user-name2"

]

}

4. Action

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

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

权限关键字	OOS 操作
oos:ListBucket	GET Bucket（List Object）、HEAD Bucket
oos:ListBucketMultipartUploads	List Multipart Uploads

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

权限	OOS操作
oos:AbortMultipartUpload	Abort Multiple Upload
oos:DeleteObject	DELETE Object
oos:GetObject	GET Object、HEAD Object
oos:ListMultipartUploadParts	List Part
oos:PutObject	PUT Object、PUT Object-Copy、POST Object、Initiate Mulitipart Upload、Upload Part、Compelete Multipart Upload、Upload Part –Copy

可使用通配符 (*) 来访问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的匹配规则。

Condition	描述
`StringEquals`	精准匹配指定的值，区分大小写。
`StringNotEquals`	与指定的值不匹配，区分大小写。
`StringEqualsIgnoreCase`	与指定的值精准匹配，不区分大小写。
`StringNotEqualsIgnoreCase`	与指定的值不匹配，不区分大小写
`StringLike`	与指定的值精准匹配；或通过填充通配符，与指定的值相似，可以包括多字符匹配的通配符 (*)或单字符匹配的通配符 (?)。区分大小写。
`StringNotLike`	与指定的值不匹配，区分大小写的无效匹配。或通过填充通配符，与指定的值也不匹配。

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

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

2) 布尔值条件运算符

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

条件运算符

说明

Bool

推荐：TOP云智能建站优惠活动，仅880元即可搭建一个后台管理五端合一的智能网站（PC网站、手机网站、百度智能小程序、微信小程序、支付宝小程序），独享百度搜索SEO优势资源，让你的网站不仅有颜值有排面，更有排名，可以实实在在为您带来效益，请点击进入TOP云智能建站>>>，或咨询在线客服了解详情。