GetJobInfo - MaxCompute: Central de Documentação do Alibaba Cloud

Consulta as informações básicas de um job.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

odps:GetJobInfo

get

*Job

acs:odps:{#regionId}:{#accountId}:job/{#instanceId}

Nenhuma

Sintaxe da solicitação

GET /api/v1/jobs/{instanceId}/info HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
instanceId	string	Sim	O ID do job.	20230410****60gg

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Nenhum parâmetro necessário.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O corpo da resposta.
requestId	string	O ID da solicitação.	0be3e0bb16654558425251398e27a9
httpCode	integer	O código de status HTTP. 1xx: informativo. A solicitação foi recebida e está sendo processada. 2xx: sucesso. A solicitação foi recebida, compreendida e aceita. 3xx: redirecionamento. Uma ação adicional é necessária para concluir a solicitação. 4xx: erro do cliente. A solicitação contém parâmetros ou sintaxe inválidos, ou uma pré-condição não pode ser atendida. 5xx: erro do servidor. O servidor não conseguiu atender à solicitação.	200
errorCode	string	O código de erro.	OBJECT_NOT_EXIST
errorMsg	string	A mensagem de erro.	This object does not exist.
data	object	Os dados retornados.
tenantId	string	O ID do locatário.	4784****5249
region	string	O ID da região.	cn-shanghai
instanceId	string	O ID do job.	20230410****60gg
jobOwner	string	O proprietário do job.	ALIYUN$7632***@aliyun.com
project	string	O nome do projeto.	dp_cdm_prod
jobType	string	O tipo de job.	SQL
priority	integer	A prioridade do job.	1
status	string	O status do job.	running
quotaNickname	string	O apelido da cota de computação usada pelo job.	os_bigdata
quotaType	string	O tipo de cota.	subscription
cuUsage	integer	Os recursos consumidos pelo job. Retornados apenas para jobs concluídos. Unidade: 100 × Core × s.	10
memoryUsage	integer	A memória consumida pelo job. Retornada apenas para jobs concluídos. Unidade: MB × s.	40
submittedAtTime	integer	A hora em que o job foi enviado.	1672112013
waitingTime	integer	A duração desde o envio do job até o início da execução.	100
runningAtTime	integer	A hora em que o job recebeu seus primeiros recursos de computação. Para jobs de curta duração ou sem recursos (como jobs DDL), a hora de envio é usada em seu lugar.	1672112113
runningTime	integer	A duração desde o início até o fim do job.	800
endAtTime	integer	A hora de término do job.	1672112913
totalTime	integer	A duração total desde o envio do job até o seu encerramento.	900
signature	string	A assinatura do job SQL. Use este valor para localizar todas as instâncias em que uma instrução SQL foi executada.	20c1efb4a7caca1865f4aa784bb500efae74af04
extPlantFrom	string	A plataforma upstream.	platform_3
extNodeId	string	O ID do nó ancestral.	node_4
extNodeOnDuty	string	O ID da conta Alibaba Cloud do proprietário do job.	duty_2
inputBytes	number	A quantidade de dados escaneada pelo job.	1234
sceneResults	array<object>	Os resultados do diagnóstico inteligente.
	array<object>	Os itens de resultado do diagnóstico inteligente.
sceneTag	string	The intelligent diagnostics result tag.	SubscriptionLackResource
scene	string	The intelligent diagnostics scenario.	LackResource
type	string	The intelligent diagnostics result type.	warning
summary	string	The intelligent diagnostics result summary.	Insufficient computing resources available for the job. Click to view details.
description	string	The intelligent diagnostics result description.	This job uses annual and monthly computing resources. It may be that the job is waiting for resources due to the large amount of overall job running data, many resources requested, and low job priority. Please go to Resource Consumption to view the specific situation. You can also go to Cost Optimization to see if you need to adjust resource configuration.
params	object	Node information for data skew or data expansion diagnostics. Returned only when the scenario is data skew or data expansion.
	string	Node information for data skew or data expansion diagnostics.	"jobinsight_data_skew_node": "Worker M1#10000_0"
jobSubStatusList	array<object>	Os substatus do ciclo de vida do job.
	object	O substatus do job.
code	integer	The substatus code.	1010
startTime	string	The start time of the substatus.	2025-03-05 00:04:15.717364 +0800
description	string	The description of the substatus.	Waiting for scheduling

Exemplos

Resposta de sucesso

JSON formato

{
  "requestId": "0be3e0bb16654558425251398e27a9",
  "httpCode": 200,
  "errorCode": "OBJECT_NOT_EXIST",
  "errorMsg": "This object does not exist.",
  "data": {
    "tenantId": "4784****5249",
    "region": "cn-shanghai",
    "instanceId": "20230410****60gg",
    "jobOwner": "ALIYUN$7632***@aliyun.com\n",
    "project": "dp_cdm_prod",
    "jobType": "SQL\n",
    "priority": 1,
    "status": "running",
    "quotaNickname": "os_bigdata",
    "quotaType": "subscription",
    "cuUsage": 10,
    "memoryUsage": 40,
    "submittedAtTime": 1672112013,
    "waitingTime": 100,
    "runningAtTime": 1672112113,
    "runningTime": 800,
    "endAtTime": 1672112913,
    "totalTime": 900,
    "signature": "20c1efb4a7caca1865f4aa784bb500efae74af04",
    "extPlantFrom": "platform_3",
    "extNodeId": "node_4",
    "extNodeOnDuty": "duty_2",
    "inputBytes": 1234,
    "sceneResults": [
      {
        "sceneTag": "SubscriptionLackResource",
        "scene": "LackResource",
        "type": "warning",
        "summary": "\t\nInsufficient computing resources available for the job. Click to view details.",
        "description": "This job uses annual and monthly computing resources. It may be that the job is waiting for resources due to the large amount of overall job running data, many resources requested, and low job priority. Please go to Resource Consumption to view the specific situation. You can also go to Cost Optimization to see if you need to adjust resource configuration.",
        "params": {
          "key": "\"jobinsight_data_skew_node\": \"Worker M1#10000_0\"\n"
        }
      }
    ],
    "jobSubStatusList": [
      {
        "code": 1010,
        "startTime": "2025-03-05 00:04:15.717364 +0800",
        "description": "Waiting for scheduling"
      }
    ]
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.