Copied.
Viewing Bucket Information
After creating a bucket on OBS Console, you can view its details, including basic bucket information, usage statistics, alarms, domain name details, basic configurations, FAQs, and others. You can also export all buckets of the current account and view their basic information in the exported Excel file.
Ways to View Bucket Information
You can use OBS console, SDKs, OBS Browser+, obsutil, or APIs to view bucket information.
Using OBS Console
- In the navigation pane of OBS Console, choose Object Storage.
- In the bucket list, click the bucket you want to operate. The Objects page is displayed.
- In the navigation pane, choose Overview.
- On the top of the page, view the bucket information, including the bucket name, storage class, data redundancy policy, region, and creation time.
Figure 1 Bucket information
Table 1 Bucket information Parameter
Description
Bucket name
Name of the bucket
Storage class
Storage class of the bucket, which can be Standard, Infrequent Access, or Archive.
Data redundancy
Data redundancy storage policy of a bucket, which can be multi-AZ storage or single-AZ storage. This setting cannot be changed after the bucket is created.
Region
Region where the bucket is located
Created
Creation time of the bucket
- In the Usage Statistics area, view the storage, traffic, and request information of the bucket. Click View Usage Analysis in the upper right corner to go to the Metrics page and view details.
Figure 2 Bucket usage statistics
Table 2 Bucket usage metrics Parameter
Description
Storage
Measures the storage occupied by all objects, Standard objects, Infrequent Access objects, and Archive objects in the bucket.
Traffic
Total Download Traffic: It measures the total download traffic for the bucket in the current month. Both intranet and Internet traffic are covered.
Download Traffic (Intranet): It measures the total intranet download traffic for the bucket in the current month.
Download Traffic (Internet): It measures the total Internet download traffic for the bucket in the current month.
Total Upload Traffic: It measures the total upload traffic for the bucket in the current month. Both intranet and Internet traffic are covered.
Upload Traffic (Intranet): It measures the total intranet upload traffic for the bucket in the current month.
Upload Traffic (Internet): It measures the total Internet upload traffic for the bucket in the current month.
Requests
Total: It measures the total number of requests (including PUT, POST, COPY, LIST, GET, HEAD, and DELETE requests) made for the bucket and the objects in it in the current month.
GET: It measures the total number of GET and HEAD requests made for the bucket and the objects in it in the current month.
PUT: It measures the total number of PUT, POST, COPY, and LIST requests made for the bucket and the objects in it in the current month.
DELETE: It measures the total number of DELETE requests made for the bucket and the objects in it in the current month.
Month-over-month growth
It compares the current month's data with the previous month's data, showing the data increase or decrease.
Take the comparison between January 2023 and February 2023 as an example.
Month-over-month (MoM) growth = (Current month's data – Previous month's data)/Previous month's data x 100%
Suppose the Standard storage in January was 60 MB and that in February was 120 MB, the MoM growth was calculated as follows: (120 – 60) ÷ 60 x 100% = 100%. This tells that the standard storage in February was doubled compared to January.
The data is not displayed in real time. There may be approximately one hour delay.
To view the number of requests and traffic statistics, you must have the CES ReadOnlyAccess permission or a higher Cloud Eye permission for the region where the bucket is located.
Usage Statistics is only available for buckets that support usage analysis.
- In the Alarms area, view the alarm severities and the alarm number of each severity. By clicking Alarm Details, you can explore more on the Alarm Records page of Cloud Eye.
Figure 3 Information about bucket alarms
Alarms is only available for buckets that support usage analysis.
- In the Domain Name Details area, view information about the endpoint, access domain name, and static website hosting domain name. You can also perform related operations by clicking buttons in the Operation column.
Figure 4 Domain name details of the bucket
- In the Basic Information area, view the bucket's basic information, including number of objects, bucket version, enterprise project, and account ID.
Figure 5 Bucket's basic information
Table 3 Parameters in the Basic Information area Parameter
Description
Objects
The total number of stored folders and objects of all versions in a bucket
Bucket Version
Version number of the bucket. 3.0 indicates the latest bucket version, and -- indicates versions earlier than 3.0.
Enterprise Project
Enterprise project that a bucket belongs to
Account ID
Unique identity of the bucket owner. It is the same as Account ID on the My Credentials page.
- In the Basic Configurations area, view the bucket's basic configurations, including logging, server-side encryption, and direct reading. You can click a card to make required configurations.
Figure 6 Basic configurations of the bucket
- In the FAQs area, view bucket-related FAQs. You can click More in the upper right corner to view more FAQs.
Figure 7 Bucket FAQs
- In the Learn More area, choose to view best practices or usage guide.
Figure 8 Learn More
Using the API
Using the GUI Tool - OBS Browser+
- Log in to OBS Browser+.
- Right-click the bucket you want to view and choose Basic Information from the shortcut menu.
- In the displayed Basic Information window, view your required information, as shown in Figure 9.
Table 4 Parameter description Parameter
Description
Bucket Name
Name of the bucket.
Bucket Type
Object storage or a parallel file system.
Region
Region where the bucket is located.
Storage Class
Storage class of the bucket. It can be Standard, Infrequent Access, or Archive.
Bucket Version
Version number of the bucket.
Used Capacity
Total capacity used by objects in the bucket.
Objects
Number of objects in the bucket.
Multi-AZ Mode
Status of the multi-AZ function.
If multi-AZ is enabled, data will be stored in multiple AZs.
Account ID
Unique identity of the bucket owner. It is the same as Account ID on the My Credentials page.
Created
Time when the bucket was created.
Using the CLI Tool - obsutil
Command Line Structure
- In Windows
obsutil stat obs://bucket [-acl] [-bf=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
- In Linux or macOS
./obsutil stat obs://bucket [-acl] [-bf=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
Examples
- Take the Windows OS as an example. Run the obsutil stat obs://bucket-test command to query the basic properties of bucket bucket-test.
obsutil stat obs://bucket-test Bucket: obs://bucket-test StorageClass: standard ObsVersion: 3.0 BucketType: OBJECT AvailableZone: multi-az ObjectNumber: 8005 Size: 320076506 Quota: 0
Parameter Description
Parameter |
Optional or Mandatory |
Description |
---|---|---|
s |
Optional (additional parameter) |
Displays simplified query result.
NOTE:
In the simplified format, the returned result contains only the bucket name. |
sc |
Optional (additional parameter) |
Queries the storage classes of the buckets when listing buckets. |
j |
Optional (additional parameter). It must be used together with sc. |
Indicates the maximum number of concurrent tasks for querying the bucket storage class. The default value is the value of defaultJobs in the configuration file.
NOTE:
The value is ensured to be greater than or equal to 1. |
du |
Optional (additional parameter) |
Quickly returns the total size of listed objects, without displaying detailed object information. This parameter can be used together with other parameters.
NOTE:
This parameter takes effect only on listing objects, but not on listing buckets. |
fs |
Optional (additional parameter) |
Specifies whether the method of listing parallel file systems is applied. If you are listing parallel file systems, you are recommended to add this parameter.
CAUTION:
|
limit |
Optional (additional parameter) |
Maximum number of buckets that can be queried. If the value is less than 0, all buckets are listed. If it is left blank, a maximum of 1000 buckets can be listed by default. |
format |
Optional (additional parameter) |
Prints a listing result in the user-defined format. Currently, the value can only be default, indicating that the listing result is displayed in one row. |
config |
Optional (additional parameter) |
User-defined configuration file for executing the current command. To learn the parameters that can be configured in this file, see |
e |
Optional (additional parameter) |
Specifies the endpoint. |
i |
Optional (additional parameter) |
Specifies the user's AK. |
k |
Optional (additional parameter) |
Specifies the user's SK. |
t |
Optional (additional parameter) |
Specifies the user's security token. |
Related Operations
Exporting a Bucket List
- In the navigation pane of OBS Console, choose Object Storage.
- Export all buckets. Specifically, click Export in the upper left corner of the bucket list.
Figure 10 Exporting all buckets
- Export the selected buckets. Specifically, select the buckets to export and click Export in the upper left corner of the bucket list.
Figure 11 Exporting the selected buckets
- Obtain the bucket list in Excel, which is automatically downloaded to your local computer.
The file lists all the buckets of the current account and includes the following information: bucket name, storage class, region, data redundancy policy, used capacity, object quantity, bucket version, enterprise project, and bucket creation time.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot