ListNamespaces - Listar namespaces de table bucket | OSS API - Object Storage Service: Central de Documentação do Alibaba Cloud

Notas de uso

Filtre namespaces por prefixo de nome com o parâmetro prefix.
O parâmetro maxNamespaces define o número máximo de namespaces por resposta. Valor padrão: 1000.
A presença de continuationToken na resposta indica que há mais resultados disponíveis. Passe-o na próxima solicitação para paginar.

Permissões

API	Action	Descrição
ListNamespaces	oss:ListNamespaces	Lista namespaces.

Sintaxe da solicitação

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

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
tableBucketARN	String	Sim	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	ARN do table bucket. Formato: `acs:osstables:{region}:{accountId}:bucket/{bucketName}`.
continuationToken	String	Não	xxx	Token de uma resposta truncada anterior. Use-o para recuperar a próxima página.
maxNamespaces	Integer	Não	10	Número máximo de namespaces a retornar. Valores válidos: 1 a 1000. Padrão: 1000. Parâmetro de consulta.
prefix	String	Não	my_	Filtra os resultados para namespaces cujos nomes começam com este prefixo. Parâmetro de consulta.

Parâmetros da resposta

Parâmetro	Tipo	Exemplo	Descrição
namespaces	Array	-	Lista de objetos de namespace. Cada objeto contém `namespace` (array de nomes), `namespaceId`, `tableBucketId`, `ownerAccountId`, `createdAt` (timestamp de criação) e `createdBy` (ID da conta do criador).
continuationToken	String	xxx	Retornado apenas quando os resultados são truncados. Use este token para recuperar a próxima página.

Exemplos

Exemplo de solicitação

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

Exemplo de resposta

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

SDKs disponíveis:

ossutil CLI

O comando equivalente do ossutil é list-namespaces.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
BadRequestException	400	A solicitação é inválida ou malformada.
ForbiddenException	403	Acesso negado. O chamador não tem as permissões necessárias.
NotFoundException	404	O recurso solicitado não existe.