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 です。形式は |
レスポンスパラメーター
パラメーター | タイプ | 例 | 説明 |
tableBucketARN | 文字列 | acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket | Table Bucket の ARN です。 |
configuration | コンテナ | - | メンテナンス構成を格納するコンテナです。このコンテナには、ポリシーの |
使用例
リクエスト例
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 | 要求されたリソースが存在しません。 |