You need to enable JavaScript to run this app.
Torch Object Storage

Torch Object Storage

Copy page
Download PDF
Common commands
Create a bucket (mb)
Copy page
Download PDF
Create a bucket (mb)
You can create buckets using the mb command.​
Command syntax​
​
Linux/macOS
Windows
​
​
​
./tosutil mb tos://bucket [-acl=xxx] [-sc=xxx] [-az=xxx] [-bt=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]​
​
​
​
Parameters​
For descriptions of common optional parameters, see Global options.​
​
Parameter​
Type​
Description​
bucket​
String​
The name for the bucket. For more information on bucket naming conventions, see Common concepts.​
-acl​
Enum​
The predefined ACL for the bucket. The options are as follows:​
  • private: The bucket is private. This is the default value.​
  • public-read: Publicly readable.​
  • public-read-write: Publicly readable and writable.​
  • authenticated-read: Authenticated users have read access.​
  • bucket-owner-read: The bucket owner has read access.​
  • bucket-owner-full-control: The bucket owner has full control.​
-sc​
Enum​
The default storage type of the bucket. The options are as follows:​
  • STANDARD: Standard Storage, which is the default value.​
  • IA: Infrequent Access Storage.​
  • ARCHIVE_FR: Flashback Archive.​
  • ARCHIVE: Archive.​
  • COLD_ARCHIVE: Cold Archive.​
  • DEEP_COLD_ARCHIVE: Deep Cold Archive.​
tip​
  • Cold Archive is only supported in China (Beijing), China (Shanghai), and China (Guangzhou).​
  • Deep Cold Archive is only supported in China (Beijing), China (Shanghai), and China (Guangzhou). Deep Cold Archive is currently in closed beta. Please contact your account manager for access.​
-az​
Enum​
Sets whether to enable multi-AZ redundancy for the bucket. The options are as follows:​
  • single-az: Single-AZ deployment. This is the default value.​
  • multi-az: Multi-AZ redundancy.​
tip​
Multi-AZ redundancy is currently in closed beta. Please contact your account manager for access. Learn more in Multi-AZ redundancy.​
-bt​
Enum​
The type of the bucket. The options are as follows:​
  • fns: A flat namespace (FNS) bucket.​
  • hns: A hierarchical namespace (HNS) bucket.​
For more information, see Bucket type.​
​
Example​
Use the following command to create a bucket named bucketname, and set its access control list (ACL) to private and its storage type to STANDARD.​
  • Command​
​
./tosutil mb tos://bucketname -acl=private -sc=STANDARD​
​
  • Output​
​
Start at 2022-10-27 09:33:41.47976 +0000 UTC​
​
Create bucket [bucketname] successfully, request id [9202485a5075b07a635a5075-ac10722e-1onzGf-CB-cb-tos-bj]​
​
​
Last updated: 2025.12.17 18:33:43