You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /对象存储/SDK 参考/Harmony/存储桶接口/桶基础接口/创建桶（Harmony SDK）
创建桶（Harmony SDK）
最近更新时间：2024.12.23 17:29:49首次发布时间：2024.12.23 17:29:49
我的收藏

存储桶（Bucket）是 TOS 的全局唯一的命名空间，相当于数据的容器，用来储存对象（Object）数据。新创建的桶名在 TOS 中必须是唯一的。本文介绍如何创建桶。

注意事项

  • 存储桶命名规范如下：
    • 只能包括小写字母 a~z、数字和短横线（-）。
    • 开头和结尾只能是数字或字母。
    • 长度必须在 3～63 个字符之间。
  • 通过与 TOS 同地域的其他火山引擎产品访问 TOS 时，推荐您使用内网 Endpoint。关于地域和 Endpoint 的更多信息，请参见地域和访问域名。
  • 创建存储桶前，您需要确保账号拥有 tos:CreateBucket 权限。您可以通过 IAM 策略授予相应权限，具体步骤，请参见 IAM 策略。

示例代码

创建存储桶

import { TosClient, TosClientError, TosServerError } from '@volcengine/tos_harmonyos_sdk';

// 创建客户端
const client = new TosClient({
  accessKeyId: "Provide your ak",
  accessKeySecret: "Provide your sk",
  securityToken: 'Provide your securityToken',
  region: "Provide your region", // 填写 Bucket 所在地域。以华北2（北京)为例，"Provide your region" 填写为 cn-beijing。
  endpoint: "Provide your endpoint", // 填写域名地址
});
// 存储桶名称
const bucketName = 'harmonyos-sdk-test-bucket';

function handleError(error: Error) {
  if (error instanceof TosClientError) {
    console.log('Client Err Msg:', error.message);
    console.log('Client Err Stack:', error.stack);
  } else if (error instanceof TosServerError) {
    console.log('Request ID:', error.requestId);
    console.log('Response Status Code:', error.statusCode);
    console.log('Response Header:', error.headers);
    console.log('Response Err Code:', error.code);
    console.log('Response Err Msg:', error.message);
  } else {
    console.log('unexpected exception, message: ', error);
  }
}

async function createBucket() {
  try {
    // 创建桶
    await client.createBucket({
      Bucket: bucketName,
    });
    // 列举所有桶，将列举出刚刚创建的桶
    const res = await client.listBuckets();

    // `theBucket` 即为刚刚创建的桶
    const theBucket = res.Buckets.find(it => it.Name === bucketName);
    console.log('the bucket info', theBucket.Name);
  } catch (error) {
    handleError(error);
  }
}

createBucket();

创建时指定存储类型

import { TosClient, TosClientError, TosServerError, StorageClassType } from '@volcengine/tos_harmonyos_sdk';

// 创建客户端
const client = new TosClient({
  accessKeyId: "Provide your ak",
  accessKeySecret: "Provide your sk",
  securityToken: 'Provide your securityToken',
  region: "Provide your region", // 填写 Bucket 所在地域。以华北2（北京)为例，"Provide your region" 填写为 cn-beijing。
  endpoint: "Provide your endpoint", // 填写域名地址
});
// 存储桶名称
const bucketName = 'harmonyos-sdk-test-bucket';

function handleError(error: Error) {
  if (error instanceof TosClientError) {
    console.log('Client Err Msg:', error.message);
    console.log('Client Err Stack:', error.stack);
  } else if (error instanceof TosServerError) {
    console.log('Request ID:', error.requestId);
    console.log('Response Status Code:', error.statusCode);
    console.log('Response Header:', error.headers);
    console.log('Response Err Code:', error.code);
    console.log('Response Err Msg:', error.message);
  } else {
    console.log('unexpected exception, message: ', error);
  }
}
async function createBucketWithStorageClass() {
  try {
    // 创建桶
    await client.createBucket({
      Bucket: bucketName,
      // 指定存储桶存储类型为低频存储
      StorageClass: StorageClassType.StorageClassIa,
    });
    // 列举所有桶，将列举出刚刚创建的桶
    const res = await client.headBucket({
       Bucket: bucketName,
    })
    console.log('the bucket storageClass is', res.StorageClass);
  } catch (error) {
    handleError(error);
  }
}

createBucketWithStorageClass();

创建时指定 AZ 类型

import { TosClient, TosClientError, TosServerError, StorageClassType } from '@volcengine/tos_harmonyos_sdk';

// 创建客户端
const client = new TosClient({
  accessKeyId: "Provide your ak",
  accessKeySecret: "Provide your sk",
  securityToken: 'Provide your securityToken',
  region: "Provide your region", // 填写 Bucket 所在地域。以华北2（北京)为例，"Provide your region" 填写为 cn-beijing。
  endpoint: "Provide your endpoint", // 填写域名地址
});
// 存储桶名称
const bucketName = 'harmonyos-sdk-test-bucket';

function handleError(error: Error) {
  if (error instanceof TosClientError) {
    console.log('Client Err Msg:', error.message);
    console.log('Client Err Stack:', error.stack);
  } else if (error instanceof TosServerError) {
    console.log('Request ID:', error.requestId);
    console.log('Response Status Code:', error.statusCode);
    console.log('Response Header:', error.headers);
    console.log('Response Err Code:', error.code);
    console.log('Response Err Msg:', error.message);
  } else {
    console.log('unexpected exception, message: ', error);
  }
}
async function createBucketWithAZ() {
  try {
    // 创建桶
    await client.createBucket({
      Bucket: bucketName,
      // 指定存储桶 AZ 为多 AZ
      AzRedundancy: AzRedundancyType.AzRedundancyMultiAz,
    });
    // 列举所有桶，将列举出刚刚创建的桶
    const res = await client.headBucket({
       Bucket: bucketName,
    })
    console.log('the bucket az type is', res.AzRedundancy);
  } catch (error) {
    handleError(error);
  }
}

createBucketWithAZ();

相关文档

关于创建桶的 API 文档，请参见 CreateBucket。