GetTableBucketMaintenanceConfiguration - OSS Tables API - Object Storage Service: Central de Documentação do Alibaba Cloud

Notas de uso

A resposta inclui o status e os parâmetros da política de remoção de arquivos não referenciados do Iceberg.
Se nenhuma política de manutenção estiver configurada, o status retornado será disabled.

Permissões

API	Action	Descrição
GetTableBucketMaintenanceConfiguration	oss:GetTableBucketMaintenanceConfiguration	Obtém a configuração de manutenção de um Table Bucket.

Sintaxe da requisição

GET /buckets/{tableBucketARN}/maintenance 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
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
tableBucketARN	string	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	ARN do Table Bucket.
configuration	container	-	Contêiner da configuração de manutenção. Inclui o objeto `icebergUnreferencedFileRemoval` com o `status` da política e as `settings`, abrangendo `unreferencedDays` e `nonCurrentDays`.

Exemplos

Exemplo de requisição

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

{
   "tableBucketARN": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket",
   "configuration": {
      "icebergUnreferencedFileRemoval": {
         "status": "enabled",
         "settings": {
            "icebergUnreferencedFileRemoval": {
               "unreferencedDays": 3,
               "nonCurrentDays": 10
            }
         }
      }
   }
}

SDKs

SDKs compatíveis:

Ferramenta de linha de comando ossutil

O comando correspondente no ossutil é get-table-bucket-maintenance-configuration.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
ForbiddenException	403	Permissão insuficiente para executar esta requisição.
NotFoundException	404	O recurso solicitado não existe.