ListNamespaces - List table bucket namespaces | OSS API - Object Storage Service

Notes d'utilisation

Filtrez les namespaces par préfixe de nom à l'aide du paramètre prefix.
Le paramètre maxNamespaces définit le nombre maximal de namespaces renvoyés par réponse. La valeur par défaut est 1000.
La présence d'un continuationToken dans la réponse indique que d'autres résultats sont disponibles. Transmettez ce jeton dans la requête suivante pour paginer les résultats.

Permissions

API

Action

Description

ListNamespaces

oss:ListNamespaces

Répertorie les namespaces.

Syntaxe de la requête

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

Paramètres de requête

Parameter

Type

Required

Example

Description

tableBucketARN

String

Yes

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

L'ARN du table bucket. Format : acs:osstables:{region}:{accountId}:bucket/{bucketName}.

continuationToken

String

No

xxx

Jeton issu d'une réponse tronquée précédente. Utilisez-le pour récupérer la page suivante.

maxNamespaces

Integer

No

10

Nombre maximal de namespaces à renvoyer. Valeurs valides : 1 à 1000. Valeur par défaut : 1000. Paramètre de requête.

prefix

String

No

my_

Filtre les résultats pour ne conserver que les namespaces dont le nom commence par ce préfixe. Paramètre de requête.

Paramètres de réponse

Parameter

Type

Example

Description

namespaces

Array

-

Liste d'objets namespace. Chaque objet contient namespace (tableau de noms), namespaceId, tableBucketId, ownerAccountId, createdAt (horodatage de création) et createdBy (ID du compte créateur).

continuationToken

String

xxx

Renvoyé uniquement lorsque les résultats sont tronqués. Utilisez ce jeton pour récupérer la page suivante.

Exemples

Exemple de requête

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****

Exemple de réponse

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

SDK

SDK disponibles :

CLI ossutil

La commande ossutil équivalente est list-namespaces.

Codes d'erreur

Error code

HTTP status code

Description

BadRequestException

400

La requête n'est pas valide ou est mal formée.

ForbiddenException

403

Accès refusé. L'appelant ne dispose pas des autorisations requises.

NotFoundException

404

La ressource demandée n'existe pas.