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

Notas de uso

A resposta inclui configurações para todos os tipos de manutenção, como icebergCompaction (compactação de tabela) e icebergSnapshotManagement (gerenciamento de snapshots).
A configuração de cada tipo de manutenção inclui seu respectivo status e settings.

Permissões

API	Action	Descrição
GetTableMaintenanceConfiguration	oss:GetTableMaintenanceConfiguration	Recupera a configuração de manutenção da tabela. Esta operação também verifica a política da tabela. Usuários administradores estão isentos dessa verificação.

Sintaxe da solicitação

GET /tables/{tableBucketARN}/{namespace}/{name}/maintenance 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	Valor de exemplo	Descrição
tableBucketARN	String	Sim	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	ARN do table bucket no formato `acs:osstables:{region}:{uid}:bucket/{bucketName}`. Especifique-o no caminho da URI.
namespace	String	Sim	my_namespace	Namespace da tabela. Especifique-o no caminho da URI.
name	String	Sim	my_table	Nome da tabela. Especifique-o no caminho da URI.

Parâmetros da resposta

Parâmetro	Tipo	Valor de exemplo	Descrição
tableARN	String	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table-id	ARN da tabela.
configuration	container	-	Configuração de manutenção com dois objetos filhos: `icebergCompaction` (compactação de tabela) e `icebergSnapshotManagement` (gerenciamento de snapshots). Cada objeto filho contém um objeto `status` e um objeto `settings`.

Exemplos

Exemplo de solicitação

GET /tables/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/my_namespace/my_table/maintenance HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: Thu, 10 Apr 2025 08:00:00 GMT
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

{
   "tableARN": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table_id",
   "configuration": {
      "icebergCompaction": {
         "status": "enabled",
         "settings": {
            "icebergCompaction": {
               "targetFileSizeMB": 512,
               "strategy": "auto"
            }
         }
      },
      "icebergSnapshotManagement": {
         "status": "enabled",
         "settings": {
            "icebergSnapshotManagement": {
               "minSnapshotsToKeep": 1,
               "maxSnapshotAgeHours": 120
            }
         }
      }
   }
}

SDK

Esta operação está disponível nos seguintes SDKs:

ossutil CLI

O comando do ossutil para esta operação é get-table-maintenance-configuration.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
ForbiddenException	403	O chamador não tem as permissões necessárias para executar esta solicitação.
NotFoundException	404	O recurso solicitado não existe.