GetTableMaintenanceJobStatus - Object Storage Service - Alibaba Cloud Documentation Center

Mengambil status eksekusi pekerjaan pemeliharaan otomatis untuk tabel tertentu.

Permissions

API	Action	Description
GetTableMaintenanceJobStatus	oss:GetTableMaintenanceJobStatus	Mengambil status pekerjaan maintenance tabel.

Request syntax

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}

Request parameters

Parameter	Type	Required	Example	Description
tableBucketARN	string	Yes	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	ARN dari Table Bucket. Formatnya adalah `acs:osstables:{region}:{uid}:bucket/{bucketName}`. Parameter ini merupakan bagian dari URI.
namespace	string	Yes	my_namespace	Namespace yang berisi tabel tersebut. Parameter ini merupakan bagian dari URI.
name	string	Yes	my_table	Nama tabel. Parameter ini merupakan bagian dari URI.
x-oss-table-arn	string	Required for admin users	-	ARN dari tabel tersebut.

Response parameters

Parameter

Type

Example

Description

tableARN

string

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

ARN dari tabel tersebut.

status

container

Sebuah container untuk status pekerjaan maintenance otomatis. Container ini mencakup objek anak icebergCompaction, icebergSnapshotManagement, dan icebergUnreferencedFileRemoval. Setiap objek anak berisi status (status pekerjaan), failureMessage (alasan kegagalan, hanya dikembalikan jika pekerjaan gagal), dan lastRunTimestamp (timestamp eksekusi terakhir).

Nilai valid untuk bidang status adalah:

Disabled: Konfigurasi maintenance tidak diaktifkan.
Not_Yet_Run: Pekerjaan diaktifkan tetapi belum pernah dijalankan.
Successful: Pekerjaan berhasil dieksekusi.
Failed: Eksekusi pekerjaan gagal.

Sistem menghasilkan status Disabled dan Not_Yet_Run. Layanan maintenance backend menulis status Successful dan Failed dengan menggunakan operasi SetTableMaintenanceJobStatus.

Examples

Request example

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

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

SDKs

SDK berikut tersedia untuk operasi GetTableMaintenanceJobStatus:

ossutil CLI

Untuk perintah ossutil yang sesuai, lihat get-table-maintenance-job-status.

Error codes

Error code	HTTP status code	Description
ForbiddenException	403	Pemanggil tidak memiliki izin yang diperlukan.
NotFoundException	404	Resource yang diminta tidak ada.