Bucket is the globally unique namespace of TOS, which is equivalent to a data container and is used to store object data. Provided to the user to create a new bucket with the specified bucket name, the newly created bucket name must be unique in TOS. This article describes how to create a bucket.

Precautions

Bucket Naming Convention As follows:

Only lowercase letters a to z, numbers, and dashes (-) can be included.

The beginning and end can only be numbers or letters.

The length must be between 3 and 63 characters.

When accessing TOS through other Volcano Engine products in the same region as TOS, it is recommended that you use the intranet endpoint. For more information on regions and endpoints, see Region and Endpoint.

Before creating a bucket, you need to ensure that your account has tos: CreateBucketpermission. You can grant appropriate permissions through IAM policies. For specific steps, see Overview.

Sample code

The following code is used to create a bucket-test.

import os​
import tos​
​
# Retrieve AKSK information from environment variables.​
ak = os.getenv('TOS_ACCESS_KEY')​
sk = os.getenv('TOS_SECRET_KEY')​
# Fill in "your endpoint" and "your region" with the corresponding Endpoint of the region where your Bucket is located. Taking the example of North China 2 (Beijing), fill in "your endpoint" with tos-cn-beijing.volces.com and "your region" with cn-beijing.​
endpoint = "your endpoint"​
region = "your region"​
bucket_name = "bucket-test"​
​
try:​
    # Create a TosClientV2 object to perform operations on buckets and objects​
    client = tos.TosClientV2(ak, sk, endpoint, region)​
    # Specify the storage class when creating a storage space, optional parameter storage_class​
    # Specify the bucket access permission when creating a storage space, optional parameter acl​
    # Specify the bucket AZ redundancy when creating a storage space, optional parameter az_redundancy​
    # Use the configuration of bucket as standard storage type, private access permission, and 3AZ data redundancy as an example.​
    client.create_bucket(bucket_name, acl=tos.ACLType.ACL_Private,​
                         storage_class=tos.StorageClassType.Storage_Class_Standard,​
                         az_redundancy=tos.AzRedundancyType.Az_Redundancy_Multi_Az)​
except tos.exceptions.TosClientError as e:​
    # Operation failed, catch client error, usually caused by invalid request parameters or network issues​
    print('fail with client error, message:{}, cause: {}'.format(e.message, e.cause))​
except tos.exceptions.TosServerError as e:​
    # Operation failed, catch server error, detailed error information can be obtained from the response​
    print('fail with server error, code: {}'.format(e.code))​
    # request id can be used to locate specific issues, it is strongly recommended to save it in the log.​
    print('error with request id: {}'.format(e.request_id))​
    print('error with message: {}'.format(e.message))​
    print('error with http code: {}'.format(e.status_code))​
    print('error with ec: {}'.format(e.ec))​
    print('error with request url: {}'.format(e.request_url))​
except Exception as e:​
    print('fail with unknown error: {}'.format(e))​