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 the information of a bucket.
Using OBS Console
- In the navigation pane of OBS Console, choose Object Storage.
- In the bucket list of OBS Console, click the desired bucket to go to the Objects page.
- In the navigation pane, choose Overview.
- In the Usage Statistics area, view information about the storage, traffic, request, and month-over-month growth of the bucket. Click View Usage Analysis in the upper right corner to go to the Metrics page and view details.
Figure 1 Bucket usage statistics
Table 1 Bucket usage metrics
|
Parameter |
Description |
|
Storage |
Measures the storage occupied by all objects, Standard objects, Infrequent Access objects, Deep Archive, and Archive objects in the bucket. |
|
Traffic |
Total Download Traffic: It measures the total download traffic for the bucket in the last 30 days. Both intranet and Internet traffic are covered. |
|
Download Traffic (Intranet): It measures the total intranet download traffic for the bucket in the last 30 days. |
|
Download Traffic (Internet): It measures the total Internet download traffic for the bucket in the last 30 days. |
|
Total Upload Traffic: It measures the total upload traffic for the bucket in the last 30 days. Both intranet and Internet traffic are covered. |
|
Upload Traffic (Intranet): It measures the total intranet upload traffic for the bucket in the last 30 days. |
|
Upload Traffic (Internet): It measures the total Internet upload traffic for the bucket in the last 30 days. |
|
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 last 30 days. |
|
GET: It measures the total number of GET and HEAD requests made for the bucket and the objects in it in the last 30 days. |
|
PUT: It measures the total number of PUT, POST, COPY, and LIST requests made for the bucket and the objects in it in the last 30 days. |
|
DELETE: It measures the total number of DELETE requests made for the bucket and the objects in it in the last 30 days. |
|
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 × 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 × 100% = 100%. This means that the standard storage in February was double that of January. |
The data is not displayed in real time. There may be a delay of about one hour.
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 2 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 3 Domain name details of the bucket
- In the Basic Information area, view the bucket's basic information, including number of objects, bucket version, cluster type, enterprise project, and account ID.
Figure 4 Bucket's basic information
Table 2 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. |
|
Cluster Type |
Cluster where the bucket is located |
|
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 FAQs area, view bucket-related FAQs. You can click More in the upper right corner to view more FAQs.
Figure 5 Bucket FAQs
- In the Learn More area, choose to view best practices or usage guide.
Figure 6 Learn More
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 7.
Figure 7 Bucket's basic information
Table 3 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
Examples
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. |
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) |
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:
- With this method, the listing time required varies largely depending on the directory structures.
- After this parameter is enabled, marker and limit will be ignored. Then, the size of the bucket, parallel file system, or directory will be calculated.
- This parameter is only supported by obsutil 5.5.12 and later.
|
|
limit |
Optional (additional parameter) |
The 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) |
The user-defined configuration file for executing the current command. For details about parameters that can be configured, see Configuration Parameters. |
|
e |
Optional (additional parameter) |
The endpoint |
|
i |
Optional (additional parameter) |
The user's AK |
|
k |
Optional (additional parameter) |
The user's SK |
|
t |
Optional (additional parameter) |
The user's security token |
Related Operations
Exporting a Bucket List
- In the navigation pane of OBS Console, choose Object Storage.
- To export all buckets, click Export in the upper left corner of the bucket list.
Figure 8 Exporting all buckets
- To export some of the buckets, select the required buckets and click Export in the upper left corner of the bucket list.
Figure 9 Exporting the selected buckets
- Obtain the bucket list in Excel, which is automatically downloaded to your local computer.
The file lists the following bucket information: bucket name, storage class, region, data redundancy policy, used capacity, bucket version, enterprise project, and bucket creation time.