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

Lista os jobs.

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:ListJobInfos

list

*Todos os recursos.

*

Nenhuma

Sintaxe da solicitação

POST /api/v1/jobs HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
tenantId	string	Não	O ID do tenant.	478403690625249
region	string	Não	O ID da região.	cn-shanghai
orderColumn	string	Não	A coluna de ordenação.	cuUsage
ascOrder	boolean	Não	Especifica se os resultados devem ser ordenados em ordem crescente.	true
pageNumber	integer	Não	O número da página.	1
pageSize	integer	Não	O número de entradas a serem retornadas em cada página.	10
body	object	Não	Os parâmetros do corpo da solicitação.
extNodeIdList	array	Não	Os IDs dos nós upstream.
	string	Não	Os IDs dos nós upstream.	76358164
extNodeNameList	array	Não	Os nomes dos nós upstream.
	string	Não	Os nomes dos nós upstream.	ods_wfq_company_industry_di
from	integer	Sim	O timestamp de início.	1672112000
instanceIdList	array	Não	O ID da instância do job.
	string	Não	O ID da instância do job.	20241028****jkl
jobOwnerList	array	Não	A lista de proprietários dos jobs.
	string	Não	O proprietário do job. Há suporte para correspondência aproximada. Vários valores são combinados com um OR lógico.	ALIYUN$7632***@aliyun.com
priorityList	array	Não	As prioridades dos jobs.
	integer	Não	As prioridades dos jobs.	0
projectList	array	Não	Os nomes dos projetos.
	string	Não	Os nomes dos projetos.	projectA
quotaNickname	string	Não	O apelido da cota.	quota_nickname
sceneTagList	array	Não	As tags de diagnóstico inteligente.
	string	Não	As tags de diagnóstico inteligente.	SubscriptionLackResource
signatureList	array	Não	As assinaturas dos jobs.
	string	Não	As assinaturas dos jobs.	signatureabc
sortByList	array	Não	Os campos de ordenação de múltiplas colunas.
	string	Não	Os campos de ordenação de múltiplas colunas.	cuUsage
sortOrderList	array	Não	As ordens de classificação de múltiplas colunas.
	string	Não	As ordens de classificação de múltiplas colunas.	desc
statusList	array	Não	Os status dos jobs.
	string	Não	Os status dos jobs.	running
taskNameList	array	Não	Os nomes dos jobs.
	string	Não	Os nomes dos jobs.	console_query_task_1788796813532
to	integer	Sim	O timestamp de término.	1672112130
typeList	array	Não	Os tipos de jobs.
	string	Não	Os tipos de jobs.	SQL

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	PopResult
data	object	Os dados da resposta.
jobInfoList	array<object>	A lista de informações do job.
	array<object>	As informações do job.
cluster	string	O ID do cluster.	AY20A
cuSnapshot	number	A proporção de snapshot de CU do job.	0.48
cuUsage	integer	O uso total de CU.	10
endAtTime	integer	A hora de término da execução. O valor é um timestamp UNIX em segundos.	0
extNodeId	string	O ID do nó do DataWorks.	node_4
extNodeName	string	O nome da plataforma de agendamento externa que enviou o job.	ods_wfq_company_industry_di
extNodeOnDuty	string	O responsável pela execução.	duty_2
extPlantFrom	string	A plataforma upstream.	platform_3
extPlatformId	string	O identificador da plataforma de agendamento externa que enviou o job.	dataworks
inputBytes	number	A quantidade de dados escaneados pelo job. Unidade: bytes.	1234
instanceId	string	O ID da instância.	20230410050036549gfmsdwf60gg
jobOwner	string	A conta que enviou o job.	ALIYUN$xxx@test.aliyunid.com
jobType	string	Os tipos de jobs.	SQL
memorySnapshot	number	A proporção de snapshot de memória do job.	0.42
memoryUsage	integer	O uso total de memória.	40
priority	integer	A prioridade.	1
project	string	O nome do projeto MaxCompute.	openrec_new
quotaNickname	string	O apelido da cota usada pelo job.	my_quota
quotaType	string	O tipo de cota.	subscription
region	string	O ID da região.	cn-shanghai
roleSessionName	string	A assunção de função usada para submeter o job.	aliyunservicerole
runningAtTime	integer	A hora de início da execução do job. O valor é um timestamp UNIX em segundos.	1672112113
runningTime	integer	A duração da execução. Unidade: segundos.	800
sceneResults	array<object>	Os resultados do diagnóstico inteligente.
	array<object>	Os resultados do diagnóstico inteligente.
description	string	Os detalhes do resultado do diagnóstico inteligente.	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	As informações do nó para skew de dados e data bloat. Este parâmetro é retornado apenas quando o cenário de diagnóstico é skew de dados ou data bloat.
	string	As informações do nó para skew de dados e data bloat.	"jobinsight_data_skew_node": "Worker M1#10000_0"
scene	string	O cenário do resultado do diagnóstico inteligente.	LackResource
sceneTag	string	A tag do resultado do diagnóstico inteligente.	SubscriptionLackResource
summary	string	O resumo do resultado do diagnóstico inteligente.	Insufficient computing resources available for the job. Click to view details.
type	string	O tipo do resultado do diagnóstico inteligente.	warning
signature	string	A assinatura SQL.	i094KijGrN3kOXZ74kbexB77XQY=
status	string	O status.	running
statusSnapshot	string	O status do snapshot do job.	running
submittedAtTime	integer	A hora de envio do job. O valor é um timestamp UNIX em segundos.	1672112013
tags	string	As tags.	[]
taskName	string	O nome da tarefa.	console_query_task_1788796813532
tenantId	string	O ID do tenant.	213065738244354
totalTime	integer	A duração total da execução.	900
waitingTime	integer	O tempo de espera. Unidade: segundos.	100
pageNumber	integer	O número da página atual.	2
pageSize	integer	O número de entradas por página.	10
totalCount	integer	O número total de entradas retornadas.	64
httpCode	integer	Indica se a solicitação foi bem-sucedida. Se o valor não for nulo e não for 200, a solicitação falhou.	200
requestId	string	O ID da solicitação.	0bc13a9516807484336515320e38f5

Exemplos

Resposta de sucesso

JSON formato

{
  "data": {
    "jobInfoList": [
      {
        "cluster": "AY20A",
        "cuSnapshot": 0.48,
        "cuUsage": 10,
        "endAtTime": 0,
        "extNodeId": "node_4",
        "extNodeName": "ods_wfq_company_industry_di",
        "extNodeOnDuty": "duty_2",
        "extPlantFrom": "platform_3",
        "extPlatformId": "dataworks",
        "inputBytes": 1234,
        "instanceId": "20230410050036549gfmsdwf60gg",
        "jobOwner": "ALIYUN$xxx@test.aliyunid.com",
        "jobType": "SQL",
        "memorySnapshot": 0.42,
        "memoryUsage": 40,
        "priority": 1,
        "project": "openrec_new",
        "quotaNickname": "my_quota",
        "quotaType": "subscription",
        "region": "cn-shanghai",
        "roleSessionName": "aliyunservicerole",
        "runningAtTime": 1672112113,
        "runningTime": 800,
        "sceneResults": [
          {
            "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\""
            },
            "scene": "LackResource",
            "sceneTag": "SubscriptionLackResource",
            "summary": "Insufficient computing resources available for the job. Click to view details.",
            "type": "warning"
          }
        ],
        "signature": "i094KijGrN3kOXZ74kbexB77XQY=",
        "status": "running",
        "statusSnapshot": "running",
        "submittedAtTime": 1672112013,
        "tags": "[]",
        "taskName": "console_query_task_1788796813532",
        "tenantId": "213065738244354",
        "totalTime": 900,
        "waitingTime": 100
      }
    ],
    "pageNumber": 2,
    "pageSize": 10,
    "totalCount": 64
  },
  "httpCode": 200,
  "requestId": "0bc13a9516807484336515320e38f5"
}

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.