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

Lista o uso de computação de jobs no nível da instância.

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

list

*Todos os recursos.

*

Nenhuma

Sintaxe da solicitação

POST /api/v1/computeMetrics/listByInstance HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
body	object	Não	Os parâmetros do corpo da solicitação.
projectNames	array	Não	O nome do projeto.
	string	Não	O nome do projeto.	odps_porject
startDate	integer	Não	A data de início. Este valor é um timestamp UNIX em milissegundos.	1715393576201
endDate	integer	Não	A data de término. Este valor é um timestamp UNIX em milissegundos.	1718590596556
instanceId	string	Não	O ID do job.	20240730****ddlr
jobOwner	string	Não	O proprietário do job.	ALIYUN$7632***@aliyun.com
signature	string	Não	A assinatura do job SQL.	ghijkl789012
pageNumber	integer	Não	O número da página.	1
pageSize	integer	Não	O número de entradas por página. Valor padrão: 10.	10
types	array	Não	Os tipos de medição.
	string	Não	O tipo de medição. Valores válidos: ComputationSql: dados de medição de jobs SQL que operam em tabelas internas. ComputationSqlOTS: dados de medição de jobs SQL que operam em tabelas externas do OTS. ComputationSqlOSS: dados de medição de jobs SQL que operam em tabelas externas do OSS. MapReduce: dados de medição de jobs MapReduce. spark: dados de medição de jobs Spark. mars: dados de medição de jobs Mars.	SQL
specCodes	array	Não	Os tipos de especificação.
	string	Não	O tipo de especificação. Valores válidos: OdpsStandard: o método de faturamento pay-as-you-go da Edição Standard. OdpsSpot: o método de faturamento pay-as-you-go da Edição Off-peak.	OdpsStandard

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta. Exemplo: { "data":{ "instanceComputeMetrics":[ { "unit":"GBCplx", "instanceId":"20260415082755g4af3vobxio", "submitTime":1776241680, "specCode":"OdpsStandard", "signature":"4c504210645f7850cf847c17886bf", "usage":0.8054948877543211, "jobOwner":"RAM$1393348188455728:role/aliyunservicerolefomputemms", "endTime":1776241682, "type":"ComputationSql", "projectName":"dbs_mc" }, { "unit":"GBCplx", "instanceId":"202604150828258gv9abz7unq14", "submitTime":1776241707, "specCode":"OdpsStandard", "signature":"cacb1e31deb**c19e515b59634a", "usage":0.1720797186717391, "jobOwner":"ALIYUN$mc_ma_testcloud_com", "endTime":1776241707, "type":"ComputationSql", "projectName":"webui_139728_hangzhou" } ], "pageNumber":1, "pageSize":10, "totalCount":2808 }, "requestId":"0adb99df17763408113761151d0001" }
requestId	string	O ID da solicitação.	0bc059b717363029839908920ea631
httpCode	integer	O código de status HTTP. Valores válidos: 1xx: Resposta informativa. A solicitação foi recebida e está sendo processada. 2xx: Sucesso. A solicitação foi recebida, compreendida e aceita com sucesso pelo servidor. 3xx: Redirecionamento. A solicitação é redirecionada e uma ação adicional é necessária para concluir a solicitação. 4xx: Erro do cliente. A solicitação contém parâmetros inválidos, sintaxe incorreta ou condições específicas da solicitação não podem ser atendidas. 5xx: Erro do servidor. O servidor não pode atender à solicitação devido a outros motivos.	200
data	object	Os dados da resposta.
instanceComputeMetrics	array<object>	A lista de uso de computação de jobs no modelo pay-as-you-go.
	object
instanceId	string	O ID do job.	20240730****ddlr
type	string	O tipo de medição. Valores válidos: ComputationSql: dados de medição de jobs SQL que operam em tabelas internas. ComputationSqlOTS: dados de medição de jobs SQL que operam em tabelas externas do OTS. ComputationSqlOSS: dados de medição de jobs SQL que operam em tabelas externas do OSS. MapReduce: dados de medição de jobs MapReduce. spark: dados de medição de jobs Spark. mars: dados de medição de jobs Mars.	ComputationSql
specCode	string	O tipo de especificação. Valores válidos: OdpsStandard: o método de faturamento pay-as-you-go da Edição Standard. OdpsSpot: o método de faturamento pay-as-you-go da Edição Off-peak.	OdpsStandard
jobOwner	string	O proprietário do job.	ALIYUN$7632***@aliyun.com
projectName	string	O nome do projeto.	odps_porject
submitTime	integer	A hora de envio do job. Este valor é um timestamp UNIX em milissegundos.	1610432000000
endTime	integer	A hora de término do job. Este valor é um timestamp UNIX em milissegundos.	1710432000000
signature	string	A assinatura do job SQL.	pqrs12345tuv
usage	number	O uso de computação. Para tipos de faturamento baseados em varredura, a unidade é GB. Isso inclui os tipos de faturamento ComputationSql, ComputationSqlOTS e ComputationSqlOSS, que são faturados com base na quantidade de dados verificados. O uso de computação é calculado como o volume de varredura × complexidade para cada job. A complexidade para os tipos ComputationSqlOTS e ComputationSqlOSS é fixada em 1. Para tipos de faturamento baseados em CU-hora, a unidade é CU-horas. Isso inclui os tipos de faturamento MapReduce, spark e mars, que são faturados com base em CU-horas.	1024
unit	string	A unidade de uso de computação.	GB
totalCount	integer	O número total de entradas retornadas.	64
pageNumber	integer	O número da página atual.	1
pageSize	integer	O número de entradas por página.	10

Exemplos

Resposta de sucesso

JSON formato

{
  "requestId": "0bc059b717363029839908920ea631",
  "httpCode": 200,
  "data": {
    "instanceComputeMetrics": [
      {
        "instanceId": "20240730****ddlr",
        "type": "ComputationSql",
        "specCode": "OdpsStandard",
        "jobOwner": "ALIYUN$7632***@aliyun.com",
        "projectName": "odps_porject",
        "submitTime": 1610432000000,
        "endTime": 1710432000000,
        "signature": "pqrs12345tuv",
        "usage": 1024,
        "unit": "GB"
      }
    ],
    "totalCount": 64,
    "pageNumber": 1,
    "pageSize": 10
  }
}

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.