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