
# 设置桶属性
#### 功能说明
设置桶的存储类型、访问策略等属性。
#### 命令结构
- Windows操作系统
  ```
  obsutil chattri obs://bucket [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  ```
  
- macOS/Linux操作系统
  ```
  ./obsutil chattri obs://bucket [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  ```
  
 
#### 运行示例
- 以Windows操作系统为例，运行**obsutil chattri obs://bucket-test -acl=private** ，修改桶的访问策略为私有读写。
  ```
  obsutil chattri obs://bucket-test -acl=private
  Start at 2024-09-29 07:58:46.0506904 +0000 UTC
  Set the acl of bucket [bucket-test] to [private] successfully, request id [04050000016836C5DA6FB21F14A2A0C0]
  ```
  
 
#### 参数说明
| **参数**       | **约束**  | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|
| bucket       | 必选      | 桶名。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| sc           | 附加参数，可选 | 桶的默认存储类型。支持的值： - standard：标准存储，访问时延低、吞吐量高，适用于有大量热点文件（平均一个月多次）或小文件（小于1MB）。  - warm：低频访问存储，可用性略低于standard，适用于不频繁访问（平均一年少于12次）但在需要时也要求快速访问数据的业务场景。  - cold：归档存储，安全、持久且成本极低，适用于很少访问（平均一年访问一次）数据的业务场景。  - deep-archive：深度归档存储，适用于长期不访问（平均几年访问一次）数据的业务场景，其成本相比归档存储更低，但相应的数据恢复时间将更长，一般为数小时。   说明： 如果桶的可用区是多AZ，则不支持修改其默认存储类型为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操作系统使用双引号）。 |
| bucket-cname | 附加参数，可选 | 指定桶绑定的自定义域名 说明： Util 5.7.9版本及以上支持该参数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| config       | 附加参数，可选 | 运行当前命令时的自定义配置文件。可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| e            | 附加参数，可选 | 指定终端节点。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| i            | 附加参数，可选 | 指定用户的AK。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| k            | 附加参数，可选 | 指定用户的SK。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| t            | 附加参数，可选 | 指定用户的securitytoken。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   
![](https://support.huaweicloud.com/utiltg-obs/public_sys-resources/note_3.0-zh-cn.png)
每次命令只能选择设置sc、acl和aclXml中的一个。
