Cria um namespace em um table bucket. Um namespace é um agrupamento lógico para organizar e gerenciar tabelas.
Notas de uso
Os nomes de namespace devem ser únicos dentro de um table bucket.
O nome do namespace deve ter de 1 a 255 caracteres e conter apenas letras minúsculas, dígitos e sublinhados (_). Não pode começar ou terminar com sublinhado nem usar os prefixos OSS, acs, aliyun, alibaba ou aws.
O table bucket de destino deve existir antes da criação do namespace.
Permissões
|
API |
Ação |
Descrição |
|
CreateNamespace |
OSS:CreateNamespace |
Cria um namespace. |
Sintaxe da solicitação
PUT /namespaces/{tableBucketARN} HTTP/1.1
Content-type: application/json
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
{
"namespace": ["string"]
}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 no formato acs:osstables:{region}:{accountId}:bucket/{bucketName}. |
|
namespace |
array |
Sim |
["my_namespace"] |
Array de nomes de namespace. Apenas um namespace por solicitação é suportado. O nome deve ter de 1 a 255 caracteres e conter apenas letras minúsculas, dígitos e sublinhados (_). Não pode começar ou terminar com sublinhado nem usar os prefixos OSS, acs, aliyun, alibaba ou aws. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
namespace |
array |
["my_namespace"] |
Array com os nomes dos namespaces criados. |
|
tableBucketARN |
string |
acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket |
ARN do table bucket que contém o namespace. |
Exemplos
Exemplo de solicitação
PUT /namespaces/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket HTTP/1.1
Content-type: application/json
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****
{
"namespace": ["my_namespace"]
}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"],
"tableBucketARN": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket"
}SDKs
CreateNamespace está disponível nos seguintes SDKs:
ossutil CLI
O comando equivalente no ossutil é crie-namespace.
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 |
O chamador não tem permissão para esta solicitação. |
|
NotFoundException |
404 |
O recurso solicitado não existe. |
|
ConflictException |
409 |
O namespace especificado já existe. |