Object Storage Service:CreateTableBucket

注意事項

Table Bucket は OSS Tables の最上位リソースコンテナであり、Apache Iceberg フォーマットでテーブルを格納および管理します。Table Bucket は「Table Bucket > 名前空間 > テーブル」という 3 階層の構造を採用しています。

この操作を呼び出す際は、以下の点にご注意ください。

• Alibaba Cloud アカウント (root ユーザー) は、単一のリージョン内で最大 10 個の Table Bucket を作成できます。

• Table Bucket 名は、同一の Alibaba Cloud アカウントおよびリージョン内で一意である必要があります。

権限

リクエスト構文

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"
}

リクエストパラメーター

レスポンスパラメーター

使用例

リクエスト例

次の例では、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 を使用して呼び出すことができます。

• Python V2

• Go V2

• Java V2

ossutil CLI

ossutil を使用して CreateTableBucket 操作を呼び出す方法については、「create-table-bucket」をご参照ください。

エラーコード