Help Center/ Object Storage Service/ User Guide/ Object Management/ Managing Folders/ Analyzing a Folder
Updated on 2026-02-12 GMT+08:00
View PDF
Share

Analyzing a Folder

You can use Folder Analysis to calculate the size of a folder and the number of objects in a folder.

If you use Folder Analysis to calculate the size of a folder, you will be billed for the API calls used to list objects in the bucket. For details, see Billing Description.

Constraints

  • Only folders with no more than 1 million objects can be analyzed. If your folder contains more objects than that, use the listing objects command of obsutil for analysis.
  • It may take some time to analyze folders with a lot of objects.
  • After versioning is enabled, OBS Console can display only the number and size of current objects. It does not provide the number or size of historical versions.

Ways to Use Folder Analysis

You can use OBS Console or obsutil to analyze a folder.

Using OBS Console

  1. In the navigation pane of OBS Console, choose Buckets.
  2. In the bucket list of OBS Console, click the desired bucket to go to the Objects page.
  3. Click Analyze in the Operation column of the folder, or click in the Size column.
  4. Click Task Center on the right corner of the page, and check the analysis result on the Analyze tab.

    You can see information such as the bucket that a folder belongs to, the size of the folder, the number of objects in the folder, and the analysis status.

    Figure 1 Folder Analysis

  5. (Optional) Click Clear Records to clear the analysis results.
  6. (Optional) Click Export to export all or selected analysis results.
  7. (Optional) Select a property to filter the analysis results.

Using the CLI Tool - obsutil

  • Counting the number of objects in a folder

obsutil cannot be directly used to obtain the number and size of objects in a folder. You need to list objects.

  • Querying the folder size

Take Linux as an example. Run the ./obsutil ls obs://bucket-test/test/ -du -limit=0 command to query the total size of the current objects in the test folder of bucket bucket-test.

To query the total size of both current and historical objects, run the ./obsutil ls obs://bucket-test/test/ -v -du -limit=0 command. 
./obsutil ls obs://bucket-test/test/ -du -limit=0

Start at 2023-03-16 06:40:18.2773873 +0000 UTC

Listing objects .

Remove the -du parameter to view more information
[DU] Total prefix [test/] size: 990.85MB
  • The -du parameter is only supported by obsutil 5.4.6 and later.
Parent Topic: Managing Folders