更新时间:2024-12-11 GMT+08:00

查询桶属性

功能说明

查询单个桶的基本属性,包括桶的默认存储类型、桶的区域、桶的版本号、桶是否支持文件接口、桶的可用区、桶中对象数量、桶的存储用量以及桶的配额。

命令结构

  • 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
       
    ObsVersion:
      3.0
    AvailableZone:
      multi-az
    BucketType:
      OBJECTObjectNumber:
      8005
    Size:
      320076506
    Quota:
      0

参数说明

参数

约束

描述

bucket

必选

桶名。

acl

可选

同时查询桶的访问策略。

bf

附加参数,可选

桶的存储用量字节数的显示格式。支持的值:

  • human-readable
  • raw
说明:

如果未设置该参数,则桶的存储用量字节数的显示格式由配置文件中的humanReadableFormat参数决定。

config

附加参数,可选

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

e

附加参数,可选

指定终端节点。

i

附加参数,可选

指定用户的AK。

k

附加参数,可选

指定用户的SK。

t

附加参数,可选

指定用户的securitytoken。

响应结果

字段名

描述

Bucket

桶名。

StorageClass

桶的默认存储类型。

Location

桶的区域位置。

ObsVersion

桶的版本。

AvailableZone

桶的可用区。

BucketType

桶的类型,OBJECT代表对象桶;POSIX代表并行文件系统。

ObjectNumber

桶内对象个数。

Size

桶的存储用量,单位:字节。

Quota

桶的配额值,0代表配额没有上限。

Acl

桶的访问策略。