ListTableBuckets - Object Storage Service - Alibaba Cloud Documentation Center

Menampilkan semua table bucket di wilayah tertentu dalam Akun Alibaba Cloud Anda.

Usage notes

Gunakan parameter prefix untuk memfilter table bucket berdasarkan awalan nama.
Gunakan parameter maxBuckets untuk menentukan jumlah maksimum table bucket yang dikembalikan dalam satu respons. Nilai default-nya adalah 1.000.
Jika respons berisi continuationToken, hasilnya terpotong. Untuk mengambil halaman hasil berikutnya, sertakan token ini dalam permintaan berikutnya.

Permissions

API	Actions	Description
ListTableBuckets	oss:ListTableBuckets	Menampilkan daftar bucket tabel.

Request syntax

GET /buckets?continuationToken={continuationToken}&maxBuckets={maxBuckets}&prefix={prefix} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Request parameters

Parameter	Type	Required	Example	Description
maxBuckets	Integer	No	10	Jumlah maksimum table bucket yang akan dikembalikan. Nilai valid: 1 hingga 1.000. Nilai default: 1.000.
prefix	String	No	my-	Membatasi respons hanya pada table bucket yang namanya diawali dengan awalan yang ditentukan.
continuationToken	String	No	-	Token paginasi yang digunakan untuk mengambil halaman hasil berikutnya. Anda dapat memperoleh token ini dari respons sebelumnya yang terpotong.

Response parameters

Parameter	Type	Example	Description
tableBuckets	Array	-	Kontainer untuk daftar table bucket. Setiap elemen berisi `arn`, `createdAt`, `name`, `ownerAccountId`, `tableBucketId`, dan `type` dari sebuah table bucket.
continuationToken	String	-	Token paginasi yang dikembalikan ketika set hasil terpotong. Gunakan token ini dalam permintaan berikutnya untuk mengambil halaman hasil selanjutnya.

Examples

Request example

GET /buckets?maxBuckets=10 HTTP/1.1
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****

Response example

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


{
   "continuationToken": "xxxxx",
   "tableBuckets": [
      {
         "arn": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket",
         "createdAt": "2024-01-01T00:00:00.000000Z",
         "name": "my-table-bucket",
         "ownerAccountId": "1234567890",
         "tableBucketId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
         "type": "customer"
      }
   ]
}

SDKs

Anda dapat memanggil operasi ListTableBuckets menggunakan SDK berikut:

Ossutil command-line tool

Untuk informasi tentang perintah ossutil untuk operasi ini, lihat list-table-buckets.

Error codes

Error code	HTTP status code	Description
BadRequestException	400	Permintaan tidak valid atau rusak.
ForbiddenException	403	Pemanggil tidak memiliki otorisasi untuk melakukan operasi ini.