ListNamespaces - Object Storage Service - Alibaba Cloud Documentation Center

Menampilkan semua namespace dalam bucket tabel tertentu.

Usage notes

Gunakan parameter prefix untuk memfilter namespace berdasarkan awalan nama.
Gunakan parameter maxNamespaces untuk menetapkan jumlah maksimum namespace yang dikembalikan dalam satu respons. Nilai default-nya adalah 1.000.
Jika respons mencakup continuationToken, hal ini menunjukkan bahwa masih terdapat hasil tambahan. Gunakan token tersebut untuk mengambil halaman hasil berikutnya.

Permissions

API	Action	Description
ListNamespaces	oss:ListNamespaces	Menampilkan namespace.

Request syntax

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

Request parameters

Parameter	Type	Required	Example	Description
tableBucketARN	String	Yes	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	Nama Sumber Daya Alibaba Cloud (ARN) dari bucket tabel. Formatnya adalah `acs:osstables:{region}:{accountId}:bucket/{bucketName}`.
continuationToken	String	No	xxx	Jika permintaan sebelumnya mengembalikan hasil terpotong, gunakan token ini untuk mengambil halaman hasil berikutnya.
maxNamespaces	Integer	No	10	Jumlah maksimum namespace yang akan dikembalikan. Nilai yang valid: 1 hingga 1000. Nilai default: 1000. Ini adalah parameter kueri.
prefix	String	No	my_	Awalan yang harus dimiliki oleh nama namespace yang dikembalikan. Ini adalah parameter kueri.

Response parameters

Parameter	Type	Example	Description
namespaces	Array	-	Daftar objek namespace. Setiap objek mencakup detail berikut: `namespace` (nama namespace, dikembalikan dalam array), `namespaceId` (ID namespace), `tableBucketId` (ID bucket tabel induk), `ownerAccountId` (ID akun pemilik), `createdAt` (cap waktu pembuatan), dan `createdBy` (ID akun pembuat).
continuationToken	String	xxx	Bidang ini hanya dikembalikan ketika hasilnya terpotong. Gunakan token ini dalam permintaan berikutnya untuk mengambil halaman hasil selanjutnya.

Examples

Request example

GET /namespaces/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket?maxNamespaces=10 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",
   "namespaces": [
      {
         "namespace": ["my_namespace"],
         "namespaceId": "ns-xxxxxxxx",
         "tableBucketId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
         "ownerAccountId": "1234567890",
         "createdAt": "2024-01-01T00:00:00.000000Z",
         "createdBy": "1234567890"
      }
   ]
}

SDKs

Operasi ListNamespaces tersedia di SDK berikut:

ossutil CLI

Perintah ossutil yang setara adalah list-namespaces.

Error codes

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