ListTables - Object Storage Service - Alibaba Cloud Documentation Center

Menampilkan daftar tabel dalam Table Bucket tertentu.

Usage notes

Satu permintaan mengembalikan maksimal 1.000 tabel. Anda dapat menggunakan parameter continuationToken untuk melakukan paginasi.
Gunakan parameter namespace untuk menampilkan tabel dalam namespace tertentu.
Anda dapat menggunakan parameter prefix untuk memfilter hasil berdasarkan awalan nama tabel.

Permissions

API	Action	Description
ListTables	oss:ListTables	Memberikan izin untuk menampilkan daftar tabel.

Request syntax

GET /tables/{tableBucketARN} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Request parameters

Parameter	Type	Required	Example value	Description
tableBucketARN	String	Yes	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	ARN dari Table Bucket, yang ditentukan dalam URI permintaan. Formatnya adalah `acs:osstables:{region}:{uid}:bucket/{bucketName}`.
continuationToken	String	No	xxx-continuation-token	Token paginasi. Untuk mengambil halaman berikutnya, gunakan nilai `continuationToken` dari respons sebelumnya. Abaikan parameter ini untuk permintaan awal. Ini adalah parameter kueri.
maxTables	Integer	No	100	Jumlah maksimum tabel yang akan dikembalikan. Nilai valid: 1 hingga 1.000. Nilai default: 1.000. Ini adalah parameter kueri.
namespace	String	No	my_namespace	Jika diberikan, operasi hanya mengembalikan tabel dalam namespace tersebut. Ini adalah parameter kueri.
prefix	String	No	my_	Memfilter hasil agar hanya mengembalikan tabel yang namanya diawali dengan awalan yang ditentukan. Ini adalah parameter kueri.

Response parameters

Parameter	Type	Example value	Description
tables	Array	-	Daftar tabel. Setiap elemen dalam array adalah objek yang berisi properti berikut: `name` (nama tabel), `namespace` (array nama namespace), `tableARN` (ARN tabel), `type` (jenis tabel), `createdAt` (waktu pembuatan), dan `modifiedAt` (waktu modifikasi terakhir).
continuationToken	String	xxx-continuation-token	Parameter ini hanya dikembalikan ketika hasil dipotong. Anda dapat menggunakannya dalam permintaan berikutnya untuk mendapatkan halaman hasil berikutnya.

Examples

Request example

GET /tables/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket?namespace=my_namespace HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: Thu, 10 Apr 2025 08:00:00 GMT
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",
   "tables": [
      {
         "name": "my_table",
         "namespace": ["my_namespace"],
         "tableARN": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table_id",
         "type": "customer",
         "createdAt": "2024-01-01T00:00:00.000000Z",
         "modifiedAt": "2024-06-01T00:00:00.000000Z"
      }
   ]
}

SDKs

Operasi ListTables tersedia dalam SDK berikut:

ossutil CLI

Untuk perintah ossutil yang sesuai, lihat list-tables.

Error codes

Error code	HTTP status code	Description
BadRequestException	400	Permintaan tidak valid atau rusak.
ForbiddenException	403	Pemanggil tidak memiliki izin yang diperlukan untuk melakukan permintaan ini.
NotFoundException	404	Resource yang diminta tidak ada.