# 查询桶属性
#### 功能说明
查询单个桶的基本属性，包括桶的默认存储类型、桶的区域、桶的版本号、桶是否支持文件接口、桶的可用区、桶中对象数量、桶的存储用量以及桶的配额。
#### 命令结构
- Windows操作系统
  ```
  obsutil stat obs://bucket [-acl] [-bf=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  ```
  
- macOS/Linux操作系统
  ```
  ./obsutil stat obs://bucket [-acl] [-bf=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  ```
  
 
#### 运行示例
- 以Windows操作系统为例，运行**obsutil stat obs://bucket-test** ，查询bucket-test桶的基本属性。
  ```
  obsutil stat obs://bucket-test
  Start at 2024-09-29 07:58:46.0506904 +0000 UTC
  Bucket:
    obs://bucket-test
  StorageClass:
    standard
  Location:
    cn-north-4 
  ObsVersion:
    3.0
  AvailableZone:
    multi-az
  BucketType:
    OBJECTObjectNumber:
    8005
  Size:
    320076506
  Quota:
    0
  ```
  
 
#### 参数说明
| **参数**       | **约束**  | **描述**                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|
| bucket       | 必选      | 桶名。                                                                                                                                                                                                                                                                                                                           |
| acl          | 可选      | 同时查询桶的访问策略。                                                                                                                                                                                                                                                                                                                   |
| bf           | 附加参数，可选 | 桶的存储用量字节数的显示格式。支持的值： - human-readable  - raw   说明： 如果未设置该参数，则桶的存储用量字节数的显示格式由配置文件中的humanReadableFormat参数决定。 |
| bucket-cname | 附加参数，可选 | 指定桶绑定的自定义域名 说明： Util 5.7.9版本及以上支持该参数。                                                                                                                                                                                                                           |
| config       | 附加参数，可选 | 运行当前命令时的自定义配置文件。可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。                                                                                                                                                                                                                             |
| e            | 附加参数，可选 | 指定终端节点。                                                                                                                                                                                                                                                                                                                       |
| i            | 附加参数，可选 | 指定用户的AK。                                                                                                                                                                                                                                                                                                                      |
| k            | 附加参数，可选 | 指定用户的SK。                                                                                                                                                                                                                                                                                                                      |
| t            | 附加参数，可选 | 指定用户的securitytoken。                                                                                                                                                                                                                                                                                                           |
   
#### 响应结果
| **字段名**       | **描述**                          |
|:---|:---|
| Bucket        | 桶名。                             |
| StorageClass  | 桶的默认存储类型。                       |
| Location      | 桶的区域位置。                         |
| ObsVersion    | 桶的版本。                           |
| AvailableZone | 桶的可用区。                          |
| BucketType    | 桶的类型，OBJECT代表对象桶；POSIX代表并行文件系统。 |
| ObjectNumber  | 桶内对象个数。                         |
| Size          | 桶的存储用量，单位：字节。                   |
| Quota         | 桶的配额值，0代表配额没有上限。                |
| Acl           | 桶的访问策略。                         |