CreateTableBucket - Criar um Table Bucket do OSS - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações de uso

O Table Bucket é o contêiner de recursos de nível superior do OSS Tables. Ele armazena e gerencia tabelas no formato Apache Iceberg. O Table Bucket utiliza uma hierarquia de três níveis: Table Bucket > namespace > tabela.

Ao chamar esta operação, observe as seguintes restrições:

Uma conta Alibaba Cloud pode criar no máximo 10 Table Buckets em uma única região.
O nome do Table Bucket deve ser exclusivo dentro da mesma conta e região da Alibaba Cloud.

Permissões

API	Action	Descrição
CreateTableBucket	oss:CreateTableBucket	Necessária para crie um Table Bucket.
CreateTableBucket	oss:PutTableBucketEncryption	Obrigatória caso você especifique o parâmetro encryptionConfiguration.

Sintaxe da solicitação

PUT /buckets HTTP/1.1
Content-type: application/json
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

{
   "encryptionConfiguration": {
      "kmsKeyArn": "string",
      "sseAlgorithm": "string"
   },
   "name": "string"
}

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
name	String	Sim	my-table-bucket	Nome do Table Bucket. Deve ter entre 3 e 32 caracteres, contendo apenas letras minúsculas, dígitos e hifens (-). Não pode começar ou terminar com hífen. É proibido iniciar com oss, acs, aliyun, alibaba ou aws.
encryptionConfiguration	Container	Não	-	Configuração de criptografia no lado do servidor.
sseAlgorithm	String	Não	AES256	Algoritmo de criptografia. Apenas AES256 é suportado. Nó pai: encryptionConfiguration
kmsKeyArn	String	Não	-	ARN da chave KMS. Este parâmetro deve permanecer vazio. Nó pai: encryptionConfiguration

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
arn	String	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	ARN do Table Bucket.

Exemplos

Exemplo de solicitação

Crie um Table Bucket chamado my-table-bucket com criptografia AES256 no lado do servidor.

PUT /buckets HTTP/1.1
Content-type: application/json
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/osstables/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c****

{
   "name": "my-table-bucket",
   "encryptionConfiguration": {
      "sseAlgorithm": "AES256"
   }
}

Exemplo de resposta

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

{
   "arn": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket"
}

SDKs

Os SDKs listados abaixo oferecem suporte a esta operação:

ossutil CLI

O comando equivalente no ossutil é create-table-bucket.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
BadRequestException	400	A solicitação é inválida ou está malformada.
ForbiddenException	403	O chamador não possui as permissões necessárias.
ConflictException	409	Conflito detectado com uma operação de gravação anterior. Tente novamente a solicitação.