GetTableBucketMaintenanceConfiguration - Object Storage Service

Operasi GetTableBucketMaintenanceConfiguration mengambil konfigurasi pemeliharaan untuk Table Bucket tertentu.

Usage notes

Konfigurasi pemeliharaan yang dikembalikan mencakup status dan parameter terkait kebijakan penghapusan file unreferenced Iceberg.
Jika tidak ada kebijakan pemeliharaan yang dikonfigurasi untuk Table Bucket tersebut, status dalam konfigurasi yang dikembalikan adalah disabled.

Permissions

API	Action	Description
GetTableBucketMaintenanceConfiguration	oss:GetTableBucketMaintenanceConfiguration	Mengambil konfigurasi maintenance untuk Table Bucket.

Request syntax

GET /buckets/{tableBucketARN}/maintenance HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Request parameters

Parameter	Type	Required	Example	Description
tableBucketARN	string	Yes	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	ARN dari Table Bucket. Formatnya adalah `acs:osstables:{region}:{accountId}:bucket/{bucketName}`.

Response parameters

Parameter	Type	Example	Description
tableBucketARN	string	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	ARN dari Table Bucket.
configuration	container	-	Sebuah container untuk konfigurasi maintenance. Container ini mencakup objek `icebergUnreferencedFileRemoval`, yang menentukan `status` dan `settings` kebijakan tersebut. Pengaturan tersebut berisi parameter seperti `unreferencedDays` dan `nonCurrentDays`.

Examples

Request example

GET /buckets/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/maintenance HTTP/1.1
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****

Response example

HTTP/1.1 200 OK
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3
Content-Type: application/json

{
   "tableBucketARN": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket",
   "configuration": {
      "icebergUnreferencedFileRemoval": {
         "status": "enabled",
         "settings": {
            "icebergUnreferencedFileRemoval": {
               "unreferencedDays": 3,
               "nonCurrentDays": 10
            }
         }
      }
   }
}

SDKs

Anda dapat memanggil operasi GetTableBucketMaintenanceConfiguration menggunakan SDK berikut:

ossutil command-line tool

Perintah ossutil untuk operasi GetTableBucketMaintenanceConfiguration adalah get-table-bucket-maintenance-configuration.

Error codes

Error code	HTTP status code	Description
ForbiddenException	403	Anda tidak memiliki izin untuk melakukan permintaan ini.
NotFoundException	404	Resource yang diminta tidak ada.