Files

weihongmin1 c4291b1dd5 OBS Util 0309 Verion

Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: weihongmin1 <weihongmin1@huawei.com>
Co-committed-by: weihongmin1 <weihongmin1@huawei.com>

2026-03-27 12:15:19 +00:00

11 KiB

Raw Blame History

Querying Bucket Properties

Function

You can use this command to query the basic properties of a bucket, including its default storage class, region, version ID, storage usage, bucket quota, whether it supports POSIX, and the number of objects in the bucket.

Command Line Structure

Windows

obsutil stat obs://bucket [-acl] [-bf=xxx] [-config=xxx]  [-payer=xxx]

macOS or Linux

./obsutil stat obs://bucket [-acl] [-bf=xxx] [-config=xxx] 
 [-payer=xxx]

Examples

In Windows, run obsutil stat obs://bucket-test to query the basic properties of the bucket-test bucket.

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
BucketType:
  OBJECTObjectNumber:
  8005
Size:
  320076506
Quota:
  0

Parameter Description

Parameter	Optional or Mandatory	Description
bucket	Mandatory	The bucket name
acl	Optional	Queries the access control policies of the bucket while querying bucket properties.
bf	Optional (additional parameter)	The display format of the used bucket capacity (in bytes). Possible values are: human-readable raw NOTE: If this parameter is not configured, the display format of the used bucket capacity (in bytes) is determined by the humanReadableFormat parameter in the configuration file.
bucket-cname	Optional (additional parameter)	The user-defined domain name bound to the bucket NOTE: This parameter is only supported by obsutil 5.7.9 and later.
config	Optional (additional parameter)	The user-defined configuration file for executing the current command. For details about parameters that can be configured, see Configuration Parameters.
payer	Optional (additional parameter)	Specifies that requester pays is enabled. Range: requester

Response

Field	Description
Bucket	The bucket name
StorageClass	The default storage class of the bucket
Location	The region where the bucket resides
ObsVersion	The version of the bucket
BucketType	The type of the bucket. OBJECT indicates a bucket for object storage. POSIX indicates a bucket used as a parallel file system.
ObjectNumber	The number of objects in the bucket
Size	The storage usage of the bucket, in bytes
Quota	The bucket quota. Value 0 indicates that no upper limit is set for the bucket quota.
Acl	The access control policy of the bucket

Parent topic: Bucket Commands

11 KiB Raw Blame History