更新时间:2022-05-18 GMT+08:00

设置桶属性

功能说明

设置桶的存储类型、访问策略等属性。

命令结构

  • Windows操作系统
    obsutil chattri obs://bucket [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-config=xxx] 
  • macOS/Linux操作系统
    ./obsutil chattri obs://bucket [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-config=xxx] 

运行示例

  • 以Windows操作系统为例,运行obsutil chattri obs://bucket-test -acl=private,修改桶的访问策略为私有读写。
    obsutil chattri obs://bucket-test -acl=private
    
    Set the acl of bucket [bucket-test] to [private] successfully, request id [04050000016836C5DA6FB21F14A2A0C0]

参数说明

参数

约束

描述

bucket

必选

桶名。

sc

附加参数,可选

桶的默认存储类型。支持的值:

  • standard:标准存储,访问时延低、吞吐量高,适用于有大量热点文件(平均一个月多次)或小文件(小于1MB)。
  • warm:可用性略低于standard,适用于不频繁访问(平均一年少于12次)但在需要时也要求快速访问数据的业务场景。
  • cold:安全、持久且成本极低,适用于很少访问(平均一年访问一次)数据的业务场景。

acl

附加参数,可选

桶的预定义访问策略。支持的值:

  • private
  • public-read
  • public-read-write
说明:

以上三个值分别对应:私有读写、公共读、公共读写,三种预定义访问策略。

aclXml

附加参数,可选

桶的访问策略(xml格式表示)。

<AccessControlPolicy>
    <Owner>
        <ID>ownerid</ID>
    </Owner>
    <AccessControlList>
        <Grant>
            <Grantee>
                <ID>userid</ID>
            </Grantee>
            <Permission>[WRITE|WRITE_ACP|READ|READ_ACP|FULL_CONTROL]</Permission>
        </Grant>
        <Grant>
            <Grantee>
                <Canned>Everyone</Canned>
            </Grantee>
            <Permission>[WRITE|WRITE_ACP|READ|READ_ACP|FULL_CONTROL]</Permission>
        </Grant>
    </AccessControlList>
</AccessControlPolicy>
说明:
  • Owner节点为可选,指定桶拥有者ID。
  • AccessControlList节点下的Grant子节点包含被授权的用户列表,Grantee子节点指定被授权用户的ID,Canned子节点指定被授权的用户组(当前仅支持Everyone)。
  • 可支持被授予的权限有:WRITE(写权限)、WRITE_ACP(写ACL权限)、READ(读权限)、READ_ACP(读ACL权限)和FULL_CONTROL(完全控制权限)。
须知:

由于该参数值必定含有<和>,作为命令运行时,必须使用引号转义(macOS/Linux操作系统使用单引号,Windows操作系统使用双引号)。

config

附加参数,可选

运行当前命令时的自定义配置文件,可支持的配置参数请参考配置参数说明

每次命令只能选择设置sc、acl和aclXml中的一个。