GetNamespace - OSS Tables API - Object Storage Service: Central de Documentação do Alibaba Cloud

Permissões

API	Action	Descrição
GetNamespace	oss:GetNamespace	Recupera informações do namespace.

Sintaxe da requisição

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

Parâmetros da requisiçã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}`.
namespace	string	Sim	my_namespace	Nome do namespace.

Parâmetros da resposta

Parâmetro	Tipo	Exemplo	Descrição
namespace	array	["my_namespace"]	Nome do namespace, retornado como array.
namespaceId	string	26104520-f117-401a-9c09-94b031352251	ID exclusivo do namespace.
tableBucketId	string	9cd83fc6-5f1b-420f-b1e0-f77024b7c225	ID exclusivo do Table Bucket pai.
ownerAccountId	string	1234567890	ID da conta Alibaba Cloud do proprietário.
createdAt	string	2026-01-01T00:00:00.000000+00:00	Data e hora de criação do namespace no formato ISO 8601.
createdBy	string	1234567890	ID da conta Alibaba Cloud do criador.

Exemplos

Exemplo de requisição

GET /namespaces/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/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****

Exemplo de resposta

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

{
   "namespace": ["my_namespace"],
   "namespaceId": "ns-xxxxxxxx",
   "tableBucketId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
   "ownerAccountId": "1234567890",
   "createdAt": "2024-01-01T00:00:00.000000Z",
   "createdBy": "1234567890"
}

SDK

GetNamespace está disponível nos seguintes SDKs:

Ossutil CLI

Comando ossutil equivalente: get-namespace.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
ForbiddenException	403	O chamador não tem as permissões necessárias para esta requisição.
NotFoundException	404	O recurso solicitado não existe.