GetTableMaintenanceJobStatus - OSS Tables API - Object Storage Service: Central de Documentação do Alibaba Cloud

Permissões

API	Action	Descrição
GetTableMaintenanceJobStatus	oss:GetTableMaintenanceJobStatus	Recupera o status dos jobs de manutenção de tabela.

Sintaxe da requisição

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}

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
tableBucketARN	string	Sim	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	ARN do Table Bucket no formato `acs:osstables:{region}:{uid}:bucket/{bucketName}`. Parte da URI.
namespace	string	Sim	my_namespace	Namespace da tabela. Parte da URI.
name	string	Sim	my_table	Nome da tabela. Parte da URI.
x-oss-table-arn	string	Obrigatório para usuários administradores	-	ARN da tabela.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

tableARN

string

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

ARN da tabela.

status

container

-

Contém o status dos jobs de manutenção automática, incluindo os objetos filhos icebergCompaction, icebergSnapshotManagement e icebergUnreferencedFileRemoval. Cada objeto filho possui três campos: status (status do job), failureMessage (motivo da falha, retornado apenas em caso de falha) e lastRunTimestamp (horário da última execução).

Valores válidos para status:

Disabled: Manutenção não ativada.
Not_Yet_Run: Ativada, mas ainda não executada.
Successful: Job concluído com sucesso.
Failed: Falha na execução do job.

O sistema define Disabled e Not_Yet_Run. O serviço de manutenção de backend grava Successful e Failed por meio de SetTableMaintenanceJobStatus.

Exemplos

Exemplo de requisição

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

Exemplo de resposta

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

SDKs disponíveis para GetTableMaintenanceJobStatus:

ossutil CLI

Comando correspondente do ossutil: get-table-maintenance-job-status.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
ForbiddenException	403	O chamador não tem a permissão necessária.
NotFoundException	404	O recurso especificado não existe.