PutTableBucketMaintenanceConfiguration -

PutTableBucketMaintenanceConfiguration介面用於設定或更新指定Table Bucket的維護配置，維護配置用於自動清理Iceberg表中不再被引用的資料檔案。

注意事項

目前僅支援icebergUnreferencedFileRemoval維護類型，用於自動刪除未被引用的Iceberg資料檔案。
可以通過status欄位啟用（enabled）或禁用（disabled）該維護功能。
unreferencedDays指定未引用檔案的保留天數，nonCurrentDays指定非目前的版本檔案的保留天數。

許可權說明

API	Action	說明
PutTableBucketMaintenanceConfiguration	oss:PutTableBucketMaintenanceConfiguration	設定Table Bucket維護配置

請求文法

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

請求參數

名稱	資料類型	是否必選	樣本值	描述
tableBucketARN	字串	是	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	Table Bucket的ARN，格式為acs:osstables:{region}:{accountId}:bucket/{bucketName}。
type	字串	是	icebergUnreferencedFileRemoval	維護類型，目前僅支援icebergUnreferencedFileRemoval。
value	容器	否	-	維護配置值容器。
status	字串	否	enabled	啟用狀態，取值enabled或disabled。父節點：value
settings	容器	否	-	維護設定容器。父節點：value。子節點：icebergUnreferencedFileRemoval
icebergUnreferencedFileRemoval	容器	否	-	Iceberg未引用檔案清理配置容器。父節點：settings。子節點：unreferencedDays, nonCurrentDays
unreferencedDays	整數	否	5	無引用檔案保留天數，取值範圍1~2147483647。父節點：icebergUnreferencedFileRemoval
nonCurrentDays	整數	否	15	非目前的版本檔案保留天數，取值範圍1~2147483647。父節點：icebergUnreferencedFileRemoval

樣本

請求樣本

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

返回樣本

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

SDK

PutTableBucketMaintenanceConfiguration介面所對應的各語言SDK如下：

命令列工具ossutil

PutTableBucketMaintenanceConfiguration介面所對應的ossutil命令為put-table-bucket-maintenance-configuration。

錯誤碼

錯誤碼	HTTP狀態代碼	描述
BadRequestException	400	請求無效或格式錯誤。
ForbiddenException	403	調用者無權執行此請求。
NotFoundException	404	請求的資源不存在。