Todos os produtos
Search

Este produto

    MaxCompute:ListJobMetric

    Central de documentação

    MaxCompute:ListJobMetric

    Última atualização: Jul 04, 2026

    Consulta uma métrica de desempenho do job concluído.

    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

    *All Resource

    *

    		 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

    O horário de início do intervalo de observação.

    1735534322
    endTime

    integer

    Sim

    O horário de término do intervalo de observação.

    1735536322
    body

    object

    Não

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

    metric

    string

    Não

    O nome da métrica de observação.

    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 de observação.

    Valores válidos:

    • p1 :

      apenas para a métrica runningTime.

    • p99 :

      apenas para a métrica runningTime.

    • total :

      apenas para as métricas num, cpu, memory, inputBytes, inputBytesPerCu.

    • min :

      apenas para a métrica runningTime.

    • avg :

      apenas para a métrica runningTime.

    • max :

      apenas para a métrica runningTime.

    • p5 :

      apenas para a métrica runningTime.

    • p90 :

      apenas para a métrica runningTime.

    • p50 :

      apenas para a métrica runningTime.

    • p95 :

      apenas para a métrica runningTime.

    • p10 :

      apenas para a métrica runningTime.

    total
    project

    array

    Não

    O nome dos projetos do MaxCompute (para filtragem).

    string

    Não

    O nome do projeto do MaxCompute.

    project_a
    quota

    array

    Não

    O apelido da cota de computação usada pelo job (para filtragem).

    string

    Não

    O apelido da cota de computação usada pelo job.

    os_PayAsYouGoQuota

    period

    integer

    Não

    O período estatístico de monitoramento. Unidade: segundo(s).

    Valores válidos:

    • 3600 :

      3600

    • 86400 :

      86400

    3600
    group

    string

    Não

    Base de agrupamento.

    Nota

    Valores disponíveis: project, quota, type, status. Significados:

    • project: Agrupa e agrega por projeto;

    • quota: Agrupa e agrega por cota;

    • type: Agrupa e agrega por tipo de job;

    • status: Agrupa e agrega 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

    Código de status HTTP.

    • 1xx: Resposta informativa - Solicitação recebida, o processamento continua.

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

    • 3xx: Redirecionamento - Uma ação adicional deve ser executada para concluir a solicitação.

    • 4xx: Erro do cliente - A solicitação contém sintaxe incorreta ou não pode ser atendida.

    • 5xx: Erro do servidor - O servidor falhou ao atender a uma solicitação aparentemente válida.

    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.

    category

    string

    A categoria das métricas.

    job
    name

    string

    O nome da métrica de observação.

    num
    period

    integer

    O período estatístico de monitoramento. Unidade: segundo(s).

    3600
    metrics

    array<object>

    Detalhes das métricas.

    array<object>

    Valores das métricas.

    metric

    object

    Metric related information.

    string

    Metric information.

    Nota

    Possible values: type, project, quota, group.

    "type": "total"
    values

    array

    Metric values information.

    array

    List of metric values.

    number

    The first column represents the timestamp and the second column represents the corresponding value.

    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.