Bucket Storage Class Setting and Query
Updated at：2025-11-03
Basic workflow
- Create an instance of the BOSClient class.
- Set the storage class by running the BosClient.putBucketStorageClass method, and retrieve the storage class by executing the BosClient.getBucketStorageClass method.
Example code
Plain Text
1// Set the storage class to COLD
2let storageClass = "COLD";
3try {
4 await bosClient.putBucketStorageClass(<bucketName>, <storageClass>);
5 logger.info(`put bucket storage class success`);
6} catch (bosResponse) {
7 logger.error(`errCode: ${bosResponse.error.code}`)
8 logger.error(`requestId: ${bosResponse.error.requestId}`)
9 logger.error(`errMessage: ${bosResponse.error.message}`)
10 logger.error(`statusCode: ${bosResponse.statusCode}`)
11}
12 // Query the storage class
13try {
14 storageClass = await bosClient.getBucketStorageClass(<bucketName>);
15 logger.info(`get bucket storage class success, ${storageClass}`);
16} catch (bosResponse) {
17 logger.error(`errCode: ${bosResponse.error.code}`)
18 logger.error(`requestId: ${bosResponse.error.requestId}`)
19 logger.error(`errMessage: ${bosResponse.error.message}`)
20 logger.error(`statusCode: ${bosResponse.statusCode}`)
21}Request parameters
Parameter description
bucketName: The name of the bucket
storageClass: Storage class, supporting: STANDARD (standard storage class), STANDARD_IA (infrequent access storage), ARCHIVE (archive storage), COLD (cold storage)