GetTableMaintenanceConfiguration - Object Storage Service

Panggil operasi GetTableMaintenanceConfiguration untuk mengambil konfigurasi pemeliharaan otomatis tabel tertentu.

Usage notes

Respons mencakup konfigurasi untuk semua jenis pemeliharaan, seperti icebergCompaction (kompresi tabel) dan icebergSnapshotManagement (manajemen snapshot).
Konfigurasi untuk setiap jenis pemeliharaan mencakup status dan settings-nya.

Permissions

API	Action	Description
GetTableMaintenanceConfiguration	oss:GetTableMaintenanceConfiguration	Mengambil konfigurasi maintenance tabel. Operasi ini juga memeriksa kebijakan tabel. Pengguna admin dibebaskan dari pemeriksaan ini.

Request syntax

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

Request parameters

Parameter	Type	Required	Example value	Description
tableBucketARN	String	Yes	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	ARN bucket tabel. Formatnya adalah `acs:osstables:{region}:{uid}:bucket/{bucketName}`. Parameter ini merupakan bagian dari path URI.
namespace	String	Yes	my_namespace	Nama namespace tabel. Parameter ini merupakan bagian dari path URI.
name	String	Yes	my_table	Nama tabel. Parameter ini merupakan bagian dari path URI.

Response parameters

Parameter	Type	Example value	Description
tableARN	String	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table-id	ARN tabel.
configuration	container	-	Sebuah container untuk konfigurasi maintenance. Container ini mencakup dua objek anak: `icebergCompaction` (kompresi tabel) dan `icebergSnapshotManagement` (manajemen snapshot). Setiap objek anak berisi objek `status` dan `settings`.

Examples

Request example

GET /tables/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/my_namespace/my_table/maintenance HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: Thu, 10 Apr 2025 08:00:00 GMT
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


{
   "tableARN": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table_id",
   "configuration": {
      "icebergCompaction": {
         "status": "enabled",
         "settings": {
            "icebergCompaction": {
               "targetFileSizeMB": 512,
               "strategy": "auto"
            }
         }
      },
      "icebergSnapshotManagement": {
         "status": "enabled",
         "settings": {
            "icebergSnapshotManagement": {
               "minSnapshotsToKeep": 1,
               "maxSnapshotAgeHours": 120
            }
         }
      }
   }
}

SDK

Operasi ini tersedia di SDK berikut:

ossutil CLI

Perintah ossutil untuk operasi ini adalah get-table-maintenance-configuration.

Error codes

Error code	HTTP status code	Description
ForbiddenException	403	Pemanggil tidak memiliki izin yang diperlukan untuk melakukan permintaan ini.
NotFoundException	404	Sumber daya yang diminta tidak ada.