すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:GetTableBucketMaintenanceConfiguration

最終更新日:May 09, 2026

GetTableBucketMaintenanceConfiguration 操作は、指定された Table Bucket のメンテナンス構成を取得します。

注意事項

  • 返されるメンテナンス構成には、Iceberg 未参照ファイル削除ポリシーのステータスおよび関連パラメーターが含まれます。

  • Table Bucket にメンテナンスポリシーが設定されていない場合、返される構成内のステータスは disabled になります。

権限

API

アクション

説明

GetTableBucketMaintenanceConfiguration

oss:GetTableBucketMaintenanceConfiguration

Table Bucket のメンテナンス構成を取得します。

リクエスト構文

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

リクエストパラメーター

パラメーター

タイプ

必須

説明

tableBucketARN

文字列

はい

acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket

Table Bucket の ARN です。形式は acs:osstables:{region}:{accountId}:bucket/{bucketName} です。

レスポンスパラメーター

パラメーター

タイプ

説明

tableBucketARN

文字列

acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket

Table Bucket の ARN です。

configuration

コンテナ

-

メンテナンス構成を格納するコンテナです。このコンテナには、ポリシーの status および settings を指定する icebergUnreferencedFileRemoval オブジェクトが含まれます。設定には、unreferencedDaysnonCurrentDays などのパラメーターが含まれます。

使用例

リクエスト例

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

レスポンス例

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

SDK

GetTableBucketMaintenanceConfiguration 操作は、以下の SDK を使用して呼び出すことができます。

ossutil コマンドラインツール

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

エラーコード

エラーコード

HTTP ステータスコード

説明

ForbiddenException

403

このリクエストを実行する権限がありません。

NotFoundException

404

要求されたリソースが存在しません。