All Products
Search

This Product

    Object Storage Service:CreateTableBucket

    Document Center

    Object Storage Service:CreateTableBucket

    Last Updated:May 09, 2026

    Membuat Table Bucket.

    Catatan penggunaan

    Table Bucket merupakan wadah sumber daya tingkat teratas untuk OSS Tables yang menyimpan dan mengelola tabel dalam format Apache Iceberg. Struktur hierarkinya terdiri dari tiga tingkat: Table Bucket > namespace > tabel.

    Perhatikan hal-hal berikut saat memanggil operasi ini:

    • Satu akun Alibaba Cloud dapat membuat maksimal 10 Table Bucket dalam satu wilayah.

    • Nama Table Bucket harus unik dalam satu akun Alibaba Cloud dan wilayah yang sama.

    Izin

    API

    Action

    Description

    CreateTableBucket

    oss:CreateTableBucket

    Izin dasar untuk membuat Table Bucket.

    oss:PutTableBucketEncryption

    Diperlukan jika Anda menentukan parameter encryptionConfiguration.

    Sintaksis permintaan

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

    Parameter permintaan

    Parameter

    Type

    Required

    Example

    Description

    name

    String

    Yes

    my-table-bucket

    Nama Table Bucket. Nama harus terdiri dari 3 hingga 32 karakter dan hanya boleh berisi huruf kecil, angka, dan tanda hubung (-). Nama tidak boleh diawali atau diakhiri dengan tanda hubung. Nama tidak boleh diawali dengan oss, acs, aliyun, alibaba, atau aws.

    encryptionConfiguration

    Container

    No

    -

    Konfigurasi Enkripsi sisi server.

    sseAlgorithm

    String

    No

    AES256

    Algoritma enkripsi. Hanya AES256 yang didukung.

    Node induk: encryptionConfiguration

    kmsKeyArn

    String

    No

    -

    ARN kunci KMS. Parameter ini harus dikosongkan.

    Node induk: encryptionConfiguration

    Parameter respons

    Parameter

    Type

    Example

    Description

    arn

    String

    acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket

    ARN Table Bucket.

    Contoh

    Contoh permintaan

    Contoh berikut membuat Table Bucket bernama my-table-bucket dan mengonfigurasi Enkripsi sisi server 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"
   }
}

    Contoh respons

    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

    Anda dapat memanggil operasi CreateTableBucket menggunakan SDK berikut:

    CLI ossutil

    Untuk memanggil operasi CreateTableBucket dengan ossutil, lihat create-table-bucket.

    Kode error

    Error code

    HTTP status code

    Description

    BadRequestException

    400

    Permintaan tidak valid atau rusak.

    ForbiddenException

    403

    Pemanggil tidak memiliki izin yang diperlukan untuk operasi ini.

    ConflictException

    409

    Permintaan bertentangan dengan operasi tulis sebelumnya. Ulangi permintaan tersebut.