CreateTableBucket -

注意事項

Table Bucket是OSS Tables的頂層資源容器，用於儲存和管理Apache Iceberg格式的表。Table Bucket採用三層結構：Table Bucket > Namespace > Table。

調用該介面時，有以下注意事項：

同一個阿里雲帳號在同一個地區（Region）最多建立10個Table Bucket。
Table Bucket名稱在同一個阿里雲帳號下同一地區內全域唯一。

許可權說明

API	Action	說明
CreateTableBucket	oss:CreateTableBucket	建立Table Bucket的基礎許可權。
CreateTableBucket	oss:PutTableBucketEncryption	如果指定了encryptionConfiguration，必須具備此許可權。

請求文法

PUT /buckets HTTP/1.1
Content-type: application/json
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

{
   "encryptionConfiguration": {
      "kmsKeyArn": "string",
      "sseAlgorithm": "string"
   },
   "name": "string"
}

請求參數

名稱	資料類型	是否必選	樣本值	描述
name	字串	是	my-table-bucket	Table Bucket名稱。長度為3~32個字元，只允許小寫字母、數字和連字號（-），不能以連字號開頭或結尾，不能以oss、acs、aliyun、alibaba、aws為首碼。
encryptionConfiguration	容器	否	-	服務端加密配置。
sseAlgorithm	字串	否	AES256	密碼編譯演算法，目前僅支援AES256。父節點：encryptionConfiguration
kmsKeyArn	字串	否	-	KMS密鑰ARN，目前僅支援為空白。父節點：encryptionConfiguration

響應參數

名稱	資料類型	樣本值	描述
arn	字串	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	Table Bucket的ARN。

樣本

請求樣本

以下樣本建立一個名為my-table-bucket的Table Bucket，並配置AES256服務端加密。

PUT /buckets HTTP/1.1
Content-type: application/json
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/osstables/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c****

{
   "name": "my-table-bucket",
   "encryptionConfiguration": {
      "sseAlgorithm": "AES256"
   }
}

返回樣本

HTTP/1.1 200 OK
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3
Content-Type: application/json


{
   "arn": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket"
}

SDK

CreateTableBucket介面所對應的各語言SDK如下：

命令列工具ossutil

CreateTableBucket介面所對應的ossutil命令，請參見create-table-bucket。

錯誤碼

錯誤碼	HTTP狀態代碼	描述
BadRequestException	400	請求無效或格式錯誤。
ForbiddenException	403	調用者無權執行此請求。
ConflictException	409	請求與之前的寫入操作存在衝突，請重試。