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

Notas de uso

O sistema oferece suporte apenas ao tipo de manutenção icebergUnreferencedFileRemoval, que exclui automaticamente arquivos de dados Iceberg não referenciados.
Use o campo status para ative (enabled) ou desativar (disabled) esse recurso de manutenção.
O parâmetro unreferencedDays determina o tempo de retenção de arquivos não referenciados, enquanto nonCurrentDays define a retenção de arquivos de versões não atuais.

Permissões

API	Action	Descrição
PutTableBucketMaintenanceConfiguration	oss:PutTableBucketMaintenanceConfiguration	Define a configuração de manutenção para um Table Bucket.

Sintaxe da solicitação

PUT /buckets/{tableBucketARN}/maintenance/{type} HTTP/1.1
Content-type: application/json
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

{
   "value": {
      "status": "string",
      "settings": {
         "icebergUnreferencedFileRemoval": {
            "unreferencedDays": number,
            "nonCurrentDays": number
         }
      }
   }
}

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	Alibaba Cloud Resource Name (ARN) do Table Bucket. Formato: `acs:osstables:{region}:{accountId}:bucket/{bucketName}`.
type	string	Sim	icebergUnreferencedFileRemoval	Tipo de manutenção. Atualmente, há suporte apenas para `icebergUnreferencedFileRemoval`.
value	container	Não	-	Status e configurações da manutenção.
status	string	Não	enabled	Status do recurso de manutenção. Valores válidos: `enabled` e `disabled`. Nó pai: `value`.
settings	container	Não	-	Configurações detalhadas do tipo de manutenção. Nó pai: `value`. Nó filho: `icebergUnreferencedFileRemoval`.
icebergUnreferencedFileRemoval	container	Não	-	Define as configurações para remoção de arquivos não referenciados do Iceberg. Nó pai: `settings`. Nós filhos: `unreferencedDays`, `nonCurrentDays`.
unreferencedDays	integer	Não	5	Número de dias de retenção de arquivos não referenciados. Valores válidos: 1 a 2.147.483.647. Nó pai: `icebergUnreferencedFileRemoval`.
nonCurrentDays	integer	Não	15	Número de dias de retenção de arquivos de versões não atuais. Valores válidos: 1 a 2.147.483.647. Nó pai: `icebergUnreferencedFileRemoval`.

Exemplos

Exemplo de solicitação

PUT /buckets/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/maintenance/icebergUnreferencedFileRemoval HTTP/1.1
Content-Type: application/json
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****

{
   "value": {
      "status": "enabled",
      "settings": {
         "icebergUnreferencedFileRemoval": {
            "unreferencedDays": 5,
            "nonCurrentDays": 15
         }
      }
   }
}

Exemplo de resposta

HTTP/1.1 204 No Content
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3

SDKs

Os SDKs a seguir oferecem suporte a esta operação:

Ferramenta de linha de comando ossutil

Para executar esta operação na linha de comando, use o comando ossutil put-table-bucket-maintenance-configuration.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
BadRequestException	400	A solicitação é inválida ou malformada.
ForbiddenException	403	Você não tem autorização para realizar esta operação.
NotFoundException	404	O recurso especificado não existe.