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

Torch Object Storage

  • Documentation
    • Torch Object StorageSDK ReferencePythonBucket interfaceManage bucket configurationManage bucket storage types (Python SDK)
Copy page
Download PDF
Manage bucket configuration
Manage bucket storage types (Python SDK)
Copy page
Download PDF
Manage bucket storage types (Python SDK)
Bucket is the globally unique namespace of TOS, which is equivalent to a data container and is used to store object data. TOS provides a variety of bucket storage types, which can be applied to various application scenarios. This article describes how to set the storage type of a bucket.​
Storage type description​
Bucket storage types include the following categories. For more information on storage types, see Storage Type .​
​
storage type​
describe​
storage type enumeration value​
Standard storage​
The default storage type of the bucket is suitable for various business scenarios such as social networking, sharing pictures, audio & video applications, large websites, and big data analytics, such as program downloads, mobile applications, etc.​
tos.StorageClassType.Storage_Class_Standard​
Low Frequency Storage​
It is suitable for business scenarios with low access frequency (average access frequency 1 to 2 times per month), such as hot standby data, surveillance video data, etc.​
tos.StorageClassType.Storage_Class_Ia​
archive flashback storage​
Business scenarios that require long-term preservation and are less accessible, such as archives.​
tos.StorageClassType.Storage_Class_Archive_Fr​
Intelligent Tiered Storage​
It is suitable for data with uncertain access frequency, and the access layer can be switched according to the access frequency to reduce storage costs.​
tos.StorageClassType.Storage_Class_INTELLIGENT_TIERING​
cold archive storage​
It is a cold data type and is suitable for business scenarios that require minimal access and long-term storage of data. A minimum of 180 days of storage is required; data needs to be restored before accessing cold archived data.​
tos.StorageClassType.Storage_Class_Cold_Archive​
​
Set storage type​
warning​
  • Set the bucket storage type. By default, only the bucket owner has this permission.​
  • After setting the bucket storage type, if the object storage type is not specified when uploading objects, copying objects, and initializing the shard upload task, the object inherits the bucket storage type.​
  • When creating a bucket, if the bucket storage type is not specified, the default storage type is standard storage.​
Sample code​
The following code sets the storage type of the bucket-testbucket.​
​
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)​
# Set the bucket type to IA​
client.put_bucket_storage_class(bucket_name, tos.StorageClassType.Storage_Class_Ia)​
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))​
​
Get bucket storage type​
warning​
Gets the bucket storage type. By default, only the bucket owner has this permission.​
Sample code​
The following code is used to get the storage type of the 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 TosClientV2 object to perform operations on buckets and objects​
client = tos.TosClientV2(ak, sk, endpoint, region)​
# Use the head_bucket method to retrieve the storage type of a bucket​
resp = client.head_bucket(bucket_name)​
print('bucket storage class {}'.format(resp.storage_class.value))​
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))​
​
Related documentation​
For more information on storage types, see Storage Type .​
Last updated: 2025.09.17 18:22:13