PutTableBucketMaintenanceConfiguration - Object Storage Service

Operasi PutTableBucketMaintenanceConfiguration menetapkan atau memperbarui konfigurasi maintenance untuk bucket tabel tertentu. Konfigurasi ini secara otomatis menghapus file data yang tidak direferensikan dalam tabel Iceberg.

Usage notes

Saat ini, hanya tipe maintenance icebergUnreferencedFileRemoval yang didukung. Tipe ini secara otomatis menghapus file data Iceberg yang tidak direferensikan.
Bidang status mengaktifkan (enabled) atau menonaktifkan (disabled) fitur maintenance ini.
unreferencedDays menentukan jumlah hari retensi untuk file yang tidak direferensikan, sedangkan nonCurrentDays menentukan jumlah hari retensi untuk file versi non-current.

Permissions

API	Action	Description
PutTableBucketMaintenanceConfiguration	oss:PutTableBucketMaintenanceConfiguration	Menetapkan konfigurasi maintenance untuk Table Bucket.

Request syntax

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

Request parameters

Parameter	Type	Required	Example	Description
tableBucketARN	string	Yes	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	Nama Sumber Daya Alibaba Cloud (ARN) dari Table Bucket. Formatnya adalah `acs:osstables:{region}:{accountId}:bucket/{bucketName}`.
type	string	Yes	icebergUnreferencedFileRemoval	Tipe maintenance. Saat ini, hanya `icebergUnreferencedFileRemoval` yang didukung.
value	container	No	-	Berisi status dan pengaturan untuk konfigurasi maintenance.
status	string	No	enabled	Menentukan status fitur maintenance. Nilai yang valid: `enabled` dan `disabled`. Node induk: `value`
settings	container	No	-	Berisi pengaturan detail untuk tipe maintenance. Node induk: `value`. Node anak: `icebergUnreferencedFileRemoval`
icebergUnreferencedFileRemoval	container	No	-	Menentukan pengaturan untuk menghapus file Iceberg yang tidak direferensikan. Node induk: `settings`. Node anak: `unreferencedDays`, `nonCurrentDays`
unreferencedDays	integer	No	5	Jumlah hari untuk menyimpan file yang tidak direferensikan. Nilai yang valid: 1 hingga 2.147.483.647. Node induk: `icebergUnreferencedFileRemoval`
nonCurrentDays	integer	No	15	Jumlah hari untuk menyimpan file versi non-current. Nilai yang valid: 1 hingga 2.147.483.647. Node induk: `icebergUnreferencedFileRemoval`

Examples

Request example

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

Response example

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

SDKs

SDK berikut mendukung operasi ini:

ossutil command-line tool

Untuk memanggil operasi ini dari command line, gunakan perintah ossutil put-table-bucket-maintenance-configuration.

Error codes

Error code	HTTP status code	Description
BadRequestException	400	Permintaan tidak valid atau rusak.
ForbiddenException	403	Pemanggil tidak memiliki otorisasi untuk melakukan permintaan ini.
NotFoundException	404	Sumber daya yang diminta tidak ada.