Todos os produtos
Search
Central de documentação

Object Storage Service:GetTableBucket

Última atualização: Jul 03, 2026

Obtém os detalhes de um Table Bucket específico, incluindo nome, ARN, data de criação e proprietário.

Observações de uso

  • O chamador deve ter permissões de leitura no Table Bucket.

  • A resposta inclui o ARN, o nome, a data de criação, o ID da conta Alibaba Cloud do proprietário e o ID do Table Bucket.

Permissões

API

Ações

Descrição

GetTableBucket

oss:GetTableBucket

Recupera informações do Table Bucket.

Sintaxe da solicitação

GET /buckets/{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}.

Parâmetros da resposta

Parâmetro

Tipo

Exemplo

Descrição

arn

String

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

ARN do Table Bucket.

createdAt

String

2024-01-01T00:00:00.000000Z

Data de criação no formato ISO 8601.

name

String

my-table-bucket

Nome do Table Bucket.

ownerAccountId

String

1234567890

ID da conta Alibaba Cloud do proprietário.

tableBucketId

String

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

ID do Table Bucket no formato UUID.

type

String

customer

Tipo do Table Bucket.

Exemplos

Exemplo de solicitação

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

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",
   "createdAt": "2024-01-01T00:00:00.000000Z",
   "name": "my-table-bucket",
   "ownerAccountId": "1234567890",
   "tableBucketId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
   "type": "customer"
}

SDKs

SDKs compatíveis:

ossutil

O comando correspondente do ossutil é get-table-bucket.

Códigos de erro

Código de erro

Código de status HTTP

Descrição

NotFoundException

404

O recurso solicitado não existe.

ForbiddenException

403

Você não tem autorização para realizar esta solicitação.