Object Storage Service:PutTableBucketMaintenanceConfiguration

注意事項

• 現在、サポートされているメンテナンスタイプは icebergUnreferencedFileRemoval のみです。このタイプでは、参照されていない Iceberg データファイルが自動的に削除されます。

• status フィールドで、このメンテナンス機能を有効 (enabled) または無効 (disabled) にします。

• unreferencedDays は、参照されていないファイルの保持日数を指定し、nonCurrentDays は、非最新バージョンのファイルの保持日数を指定します。

権限

リクエスト構文

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

リクエストパラメーター

使用例

リクエスト例

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

以下の SDK がこの操作をサポートしています。

• Python V2

• Go V2

• Java V2

ossutil コマンドラインツール

コマンドラインからこの操作を呼び出すには、ossutil コマンド put-table-bucket-maintenance-configuration を使用します。

エラーコード