ListTableBuckets - Object Storage Service: Central de Documentação do Alibaba Cloud

Notas de uso

Use o parâmetro prefix para filtrar table buckets por prefixo de nome.
O parâmetro maxBuckets defina o número máximo de table buckets retornados em uma única resposta. Valor padrão: 1.000.
Se a resposta contiver o continuationToken, os resultados estarão truncados. Para obter a próxima página, inclua esse token na próxima requisição.

Permissões

API	Ações	Descrição
ListTableBuckets	oss:ListTableBuckets	Lista table buckets.

Sintaxe da requisição

GET /buckets?continuationToken={continuationToken}&maxBuckets={maxBuckets}&prefix={prefix} 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
maxBuckets	Integer	Não	10	Número máximo de table buckets a retornar. Valores válidos: 1 a 1.000. Valor padrão: 1.000.
prefix	String	Não	my-	Restringe a resposta aos table buckets cujos nomes começam com o prefixo especificado.
continuationToken	String	Não	-	Token de paginação de uma resposta anterior truncada. Inclua este token para recuperar a próxima página de resultados.

Parâmetros da resposta

Parâmetro	Tipo	Exemplo	Descrição
tableBuckets	Array	-	Lista de table buckets. Cada elemento contém o `arn`, `createdAt`, `name`, `ownerAccountId`, `tableBucketId` e `type` de um table bucket.
continuationToken	String	-	Token de paginação retornado quando o conjunto de resultados é truncado. Inclua este token em uma requisição subsequente para recuperar a próxima página de resultados.

Exemplos

Exemplo de requisição

GET /buckets?maxBuckets=10 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

{
   "continuationToken": "xxxxx",
   "tableBuckets": [
      {
         "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

Chame esta operação usando os seguintes SDKs:

Ferramenta de linha de comando Ossutil

Para ver o comando ossutil desta operação, consulte list-table-buckets.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
BadRequestException	400	A requisição é inválida ou malformada.
ForbiddenException	403	O chamador não tem autorização para executar esta operação.