Todos os produtos
Search

Este produto

    MaxCompute:ListJobMetric

    Central de documentação

    MaxCompute:ListJobMetric

    Última atualização: Oct 12, 2026

    Obtém as métricas de desempenho de jobs concluídos.

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

    list

    *Todos os recursos.

    *

    		 Nenhuma Nenhuma

    Sintaxe da solicitação

    POST /api/v1/jobs/metric HTTP/1.1

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    startTime

    integer

    Sim

    A hora de início do intervalo de tempo da consulta. O valor é um timestamp UNIX em segundos.

    1735534322
    endTime

    integer

    Sim

    A hora de fim do intervalo de tempo da consulta. O valor é um timestamp UNIX em segundos.

    1735536322
    body

    object

    Não

    Os parâmetros do corpo da solicitação.

    metric

    string

    Não

    As informações da métrica.

    Valores válidos:

    • inputBytes :

      inputBytes.

    • memory :

      memory.

    • num :

      num.

    • inputBytesPerCu :

      inputBytesPerCu.

    • cpu :

      cpu.

    • runningTime :

      runningTime.

    num
    type

    string

    Não

    O tipo de métrica.

    Valores válidos:

    • p1 :

      Suportado apenas para runningTime.

    • p99 :

      Suportado apenas para runningTime.

    • total :

      Suportado apenas para num, cpu, memory, inputBytes e inputBytesPerCu.

    • min :

      Suportado apenas para runningTime.

    • avg :

      Suportado apenas para runningTime.

    • max :

      Suportado apenas para runningTime.

    • p5 :

      Suportado apenas para runningTime.

    • p90 :

      Suportado apenas para runningTime.

    • p50 :

      Suportado apenas para runningTime.

    • p95 :

      Suportado apenas para runningTime.

    • p10 :

      Suportado apenas para runningTime.

    total
    project

    array

    Não

    A lista de nomes de projetos do MaxCompute usada para filtragem.

    string

    Não

    O nome do projeto.

    project_a
    quota

    array

    Não

    A lista de apelidos de cotas de computação usada para filtragem.

    string

    Não

    O apelido da cota de computação.

    os_PayAsYouGoQuota

    period

    integer

    Não

    O período estatístico de monitoramento.

    Valores válidos:

    • 3600 :

      3600

    • 86400 :

      86400

    3600
    group

    string

    Não

    A base de agrupamento.

    Nota

    Valores válidos:

    • project: agrupamento e agregação por projeto

    • quota: agrupamento e agregação por cota

    • type: agrupamento e agregação por tipo de job

    • status: agrupamento e agregação por status do job

    Valores válidos:

    • quota :

      quota.

    • project :

      project.

    • type :

      type.

    • status :

      status.

    project

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    PopResult

    requestId

    string

    O ID da solicitação.

    0be3e0aa16667684362147582e038f
    httpCode

    integer

    O código de status HTTP.

    • 1xx: Resposta informativa. A solicitação foi recebida e está sendo processada.

    • 2xx: Sucesso. A ação da solicitação foi recebida, compreendida e aceita com sucesso pelo servidor.

    • 3xx: Redirecionamento. A solicitação foi redirecionada e uma ação adicional é necessária para concluí-la.

    • 4xx: Erro do cliente. A solicitação contém parâmetros inválidos, sintaxe incorreta ou não pode ser atendida devido a condições específicas da solicitação.

    • 5xx: Erro do servidor. O servidor não conseguiu atender à solicitação devido a outros motivos.

    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 da resposta.

    category

    string

    O tipo de métrica.

    job
    name

    string

    O nome da métrica.

    num
    period

    integer

    O período estatístico de monitoramento.

    3600
    metrics

    array<object>

    Os detalhes da métrica.

    array<object>

    O valor da métrica.

    metric

    object

    As informações relacionadas à métrica.

    string

    As informações da métrica.

    Nota

    Valores possíveis: type, project, quota e group.

    "type": "total"
    values

    array

    As informações do valor da métrica.

    array

    A lista de valores da métrica.

    number

    Uma lista de tamanho 2. O primeiro elemento representa o timestamp, e o segundo elemento representa o valor correspondente.

    1736679600, 3

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "requestId": "0be3e0aa16667684362147582e038f",
  "httpCode": 200,
  "errorCode": "OBJECT_NOT_EXIST",
  "errorMsg": "This object does not exist.",
  "data": {
    "category": "job",
    "name": "num",
    "period": 3600,
    "metrics": [
      {
        "metric": {
          "key": "\"type\": \"total\""
        },
        "values": [
          [
            0
          ]
        ]
      }
    ]
  }
}

    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.