全部产品
Search
文档中心

对象存储 OSS:创建Table Bucket

更新时间:May 08, 2026

通过API级命令create-table-bucket创建一个Table Bucket。

注意事项

  • Table Bucket名称在同一地域内必须全局唯一。

命令格式

ossutil tables-api create-table-bucket --name value [--encryption-configuration value] [flags]

参数

类型

说明

--name

string

Table Bucket的名称。名称在同一地域内必须全局唯一,长度为3~63个字符,只能包含小写字母、数字和短划线(-),且必须以小写字母或数字开头和结尾。

--encryption-configuration

string

Table Bucket的服务端加密配置,JSON格式字符串。包含加密算法等信息。

说明
  • create-table-bucket命令对应API接口CreateTableBucket。关于API中的具体参数含义,请参见CreateTableBucket

  • 关于支持的全局命令行选项,请参见ossutil全局选项

--encryption-configuration

--encryption-configuration配置选项支持JSON语法:

{
  "sseAlgorithm": "AES256"
}

如果使用KMS加密,还需要指定KMS密钥ID:

{
  "sseAlgorithm": "KMS",
  "kmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
}

使用示例

  • 创建名为my-table-bucket的Table Bucket。

    ossutil tables-api create-table-bucket --name my-table-bucket
  • 创建Table Bucket并使用JSON参数配置AES256加密。

    ossutil tables-api create-table-bucket --name my-table-bucket --encryption-configuration '{"sseAlgorithm":"AES256"}'
  • 创建Table Bucket并使用配置文件指定加密配置。encryption-config.json内容如下:

    {
      "sseAlgorithm": "KMS",
      "kmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
    }

    命令示例如下:

    ossutil tables-api create-table-bucket --name my-table-bucket --encryption-configuration file://encryption-config.json