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

指定されたテーブルの自動メンテナンスジョブの実行ステータスを取得します。

権限

API	アクション	説明
GetTableMaintenanceJobStatus	oss:GetTableMaintenanceJobStatus	テーブルメンテナンスジョブのステータスを取得します。

リクエスト構文

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

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
tableBucketARN	string	はい	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	Table Bucket の ARN です。フォーマットは `acs:osstables:{region}:{uid}:bucket/{bucketName}` です。このパラメーターは URI の一部です。
namespace	string	はい	my_namespace	テーブルが含まれる名前空間です。このパラメーターは URI の一部です。
name	string	はい	my_table	テーブル名です。このパラメーターは URI の一部です。
x-oss-table-arn	string	管理者ユーザーに必須	-	テーブルの ARN です。

レスポンスパラメーター

パラメーター

タイプ

例

説明

tableARN

string

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

テーブルの ARN です。

status

コンテナ

自動メンテナンスジョブのステータスを格納するコンテナです。icebergCompaction、icebergSnapshotManagement、および icebergUnreferencedFileRemoval の子オブジェクトが含まれます。各子オブジェクトには、status（ジョブステータス）、failureMessage（失敗理由。ジョブが失敗した場合のみ返されます）、および lastRunTimestamp（最終実行時のタイムスタンプ）が含まれます。

status フィールドの有効な値は以下のとおりです。

Disabled：メンテナンス構成が有効になっていません。
Not_Yet_Run：ジョブは有効ですが、まだ実行されていません。
Successful：ジョブは正常に実行されました。
Failed：ジョブの実行に失敗しました。

Disabled および Not_Yet_Run のステータスはシステムによって生成されます。Successful および Failed のステータスは、バックエンドのメンテナンスサービスが SetTableMaintenanceJobStatus 操作を使用して書き込みます。

使用例

リクエスト例

GET /tables/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/my_namespace/my_table/maintenance-job-status 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:osstable:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table_id",
   "status": {
      "icebergCompaction": {
         "status": "Successful",
         "failureMessage": "",
         "lastRunTimestamp": "2024-01-15T10:30:00.000000Z"
      },
      "icebergSnapshotManagement": {
         "status": "Successful",
         "failureMessage": "",
         "lastRunTimestamp": "2024-01-15T08:00:00.000000Z"
      },
      "icebergUnreferencedFileRemoval": {
         "status": "Successful",
         "failureMessage": "",
         "lastRunTimestamp": "2024-01-15T06:00:00.000000Z"
      }
   }
}

SDK

GetTableMaintenanceJobStatus 操作に対応する SDK は以下のとおりです。

ossutil CLI

対応する ossutil コマンドについては、「get-table-maintenance-job-status」をご参照ください。

エラーコード

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