GetTableMaintenanceConfiguration - Object Storage Service - Alibaba Cloud ドキュメントセンター

GetTableMaintenanceConfiguration 操作を呼び出して、指定されたテーブルの自動メンテナンス構成を取得します。

注意事項

応答には、icebergCompaction（テーブル圧縮）や icebergSnapshotManagement（スナップショット管理）など、すべてのメンテナンスタイプの構成が含まれます。
各メンテナンスタイプの構成には、status と settings が含まれます。

権限

API	操作	説明
GetTableMaintenanceConfiguration	oss:GetTableMaintenanceConfiguration	テーブルメンテナンス構成を取得します。この操作ではテーブルポリシーもチェックされます。管理者ユーザーはこのチェックが免除されます。

リクエスト構文

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

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
tableBucketARN	String	はい	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	テーブルバケットの ARN です。形式は `acs:osstables:{region}:{uid}:bucket/{bucketName}` です。このパラメーターは URI パスの一部です。
namespace	String	はい	my_namespace	テーブルの名前空間です。このパラメーターは URI パスの一部です。
name	String	はい	my_table	テーブル名です。このパラメーターは URI パスの一部です。

レスポンスパラメーター

パラメーター	タイプ	例	説明
tableARN	String	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table-id	テーブルの ARN です。
configuration	コンテナ	-	メンテナンス構成のコンテナです。`icebergCompaction`（テーブル圧縮）および `icebergSnapshotManagement`（スナップショット管理）という 2 つの子オブジェクトが含まれます。各子オブジェクトには、`status` および `settings` オブジェクトが含まれます。

例

リクエスト例

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

レスポンス例

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

この操作は以下の SDK で利用できます。

ossutil CLI

この操作に対応する ossutil コマンドは get-table-maintenance-configuration です。

エラーコード

エラーコード	HTTP ステータスコード	説明
ForbiddenException	403	呼び出し元にこのリクエストを実行するための必要な権限がありません。
NotFoundException	404	要求されたリソースが存在しません。