除了指定允许/拒绝、被授权用户、资源、动作外,桶策略还可以指定生效条件。只有当条件设置的表达式与访问请求中的值匹配时,桶策略才生效。条件是可选参数,用户可以根据业务需要选择是否使用。
例如,帐号A想要拥有帐号B向其example桶中上传的对象的完全控制权限(因为默认情况下对象由上传该对象的帐号B拥有),则可以指定上传请求中必须包含acl键,以及显式授予完全控制权限,完整的条件表达式如下:
条件运算符 键 值 StringEquals acl bucket-owner-full-control
条件由条件运算符、键、值三部分组成,最终组成一个条件表达式,决定桶策略生效的条件。条件运算符、键两者之间存在互相限制的关联关系,例如:
条件运算符选择了一个String类型的,比如StringEquals,键就只能选择String类型的,比如UserAgent。
键选择了一个Date类型,比如CurrentTime,条件运算符就只能选择Date类型的,比如DateEquals。
OBS提供如下表所示的预定义条件运算符。
类型 关键字 说明 String StringEquals 字符串匹配,简化为:streq。 StringNotEquals 字符串不匹配,简化为:strneq。 StringEqualsIgnoreCase 忽略大小写的字符串匹配,简化为:streqi。 StringNotEqualsIgnoreCase 忽略大小写的字符串不匹配,简化为:strneqi。 StringLike 宽松的区分大小写的匹配。这些值可以在字符串中的任何地方包括一个多字符匹配的通配符(*)和单字符匹配通配符(?)。简化为:strl。 StringNotLike 非宽松区分大小写的匹配。这些值可以在字符串中的任何地方包括一个多字符匹配的通配符(*)和单字符匹配通配符(?)。简化为:strnl。 Numeric NumericEquals 相等,简化为:numeq。 NumericNotEquals 不相等,简化为:numneq。 NumericLessThan 小于,简化为:numlt。 NumericLessThanEquals 小于等于,简化为:numlteq。 NumericGreaterThan 大于,简化为:numgt。 NumericGreaterThanEquals 大于等于,简化为:numgteq。 Date DateEquals 日期时间相等,简化为:dateeq。 DateNotEquals 日期时间不相等,简化为:dateneq。 DateLessThan 日期时间小于,简化为:datelt。 DateLessThanEquals 日期时间小于等于,简化为:datelteq。 DateGreaterThan 日期时间大于,简化为:dategt。 DateGreaterThanEquals 日期时间大于等于,简化为:dategteq。 Boolean Bool 严格布尔值相等。 IP address IpAddress 指定的IP或IP范围,例如x.x.x.x/24。 NotIpAddress 除指定的IP或IP范围外所有IP,例如x.x.x.x/24。
条件中可选的键包括以下三种:动作无关的通用键、与桶动作有关的键和与对象动作有关的键。
表 通用键
键 类型 描述 CurrentTime Date 服务器接收请求的时间,格式满足ISO 8601标准。 EpochTime Numeric 服务器接收请求的时间,格式为1970.01.01 00:00:00 UTC开始所经过的秒数,不考虑闰秒。 SecureTransport Bool 请求是否使用SSL加密。 SourceIp IP address 请求发起的源IP。 UserAgent String 请求的客户端软件代理程序。 Referer String 请求从哪个链接发起。
表 与桶动作有关的键
Action 可选键 描述 说明 ListBucket prefix String类型,列举以指定的字符串prefix开头的对象。 配置prefix、delimiter、max-keys后,执行List操作时需要带上符合条件的键值对信息,桶策略才生效。
例如,某桶配置了匿名用户可读的桶策略,且条件运算符=NumericEquals,键=max-keys,值=100。则匿名用户列举对象时需要在桶访问域名末尾加上?max-keys=100,才能完成对象列举,且列举的对象将是按照字典顺序的前100个对象。max-keys Numeric类型,指定返回的最大数,返回的对象列表将是按照字典顺序的最多前max-keys个对象。 ListBucketVersions prefix String类型,列举以指定的字符串prefix开头的多版本对象。 max-keys Numeric类型,指定返回的最大数,返回的对象列表将是按照字典顺序的最多前max-keys个对象。 PutBucketAcl acl String类型,设置桶ACL。修改桶ACL时在头域中可以包含的Canned ACL,取值范围为private|public-read|public-read-write|authenticated-read|bucketowner-read|bucket-owner-full-control|log-delivery-write。 无
表 与对象动作相关的键
Action 可选键 描述 PutObject acl String类型,设置对象ACL。上传对象时在头域中可以包含的Canned ACL,取值范围为private|public-read|public-read-write|authenticated-read|bucketowner-read|bucket-owner-full-control|log-delivery-write。 copysource String类型,用来指定复制对象时对象操作的源桶名以及源对象名。格式如/bucketname/keyname。 metadata-directive String类型,用来指定新对象的元数据是从元对象中复制,还是用请求中的元数据替换,取值范围为COPY|REPLACE。 PutObjectAcl acl String类型,设置对象ACL。上传对象时在头域中可以包含的Canned ACL,取值范围为private|public-read|public-read-write|authenticated-read|bucketowner-read|bucket-owner-full-control|log-delivery-write。 GetObjectVersion VersionId String类型,获取VersionId为xxx版本的对象。 GetObjectVersionAcl VersionId String类型,获取VersionId为xxx版本的对象ACL。 PutObjectVersionAcl VersionId String类型,设置VersionId。 acl String类型,设置VersionId为xxx版本的对象ACL。上传对象时在头域中可以包含的Canned ACL,取值范围为private|public-read|public-read-write|authenticated-read|bucketowner-read|bucket-owner-full-control|log-delivery-write。 DeleteObjectVersion VersionId String类型,删除VersionId为xxx版本的对象。