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

Consulta os dados de série temporal de consumo de recursos para uma cota.

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

list

*Quota

acs:odps:{#regionId}:{#accountId}:quota/{#metric}

Nenhuma

Sintaxe da solicitação

POST /api/v1/observations/quota/{metric} HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
metric	string	Sim	O nome da métrica. Valores válidos: cpu e memory.	cpu

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
startTime	integer	Sim	O início do intervalo de tempo a ser consultado.	1735534322
endTime	integer	Sim	O fim do intervalo de tempo a ser consultado.	1735536322
strategy	string	Não	A estratégia de agregação para os dados. O valor padrão é max. Valores válidos: max e avg. Os dados são coletados em intervalos de um minuto. Se você consultar um intervalo de tempo longo, o sistema poderá usar um intervalo maior que um minuto e agregar os dados. Este parâmetro especifica como os dados são agregados.	max
body	object	Não	O corpo da solicitação.
nickname	string	Não	O apelido da cota de nível 1. Este parâmetro é obrigatório.	os_sns_p
subQuotaNickname	string	Não	O apelido da cota de nível 2.	os_sns
interval	integer	Não	O intervalo fixo em segundos. Se você deixar este parâmetro vazio, o sistema usará uma política de intervalo automática. Política de intervalo automática: O intervalo é de 60 segundos para um intervalo de tempo de até 6 horas, 300 segundos para um intervalo de tempo de até 24 horas, 900 segundos para um intervalo de tempo de até 72 horas e 1.800 segundos para um intervalo de tempo superior a 72 horas. Intervalo especificado: Os valores válidos são 60, 300 e 900. O intervalo de tempo da consulta deve ser de até 72 horas.	60
subMetric	string	Não

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	PopResult<ObservationMetricDto>
requestId	string	O ID da solicitação.	0b87b7b316643495896551555e855b
httpCode	integer	O código de status HTTP. 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 foi redirecionada. Uma ação adicional precisa ser executada para concluir a solicitação. 4xx: erro do cliente. A solicitação contém parâmetros ou sintaxe de solicitação incorretos, ou condições específicas da solicitação não podem ser atendidas. 5xx: erro do servidor. O servidor não conseguiu atender à solicitação por outros motivos.	200
errorCode	string	O código de erro.	success
errorMsg	string	A mensagem de erro.	plan \"***\" does not exist
data	object	Os dados retornados.
category	string	Este parâmetro não é suportado.	Not supported.
name	string	O nome da métrica.	cpu
period	integer	O tamanho do passo dos dados de monitoramento.	60
metrics	array<object>	Os valores da métrica.
	array<object>	O valor da métrica.
metric	object	The metadata of the metric.
	string	The metadata of the metric. unit: The unit of the metadata. If the metric is cpu, the unit is Core. If the metric is memory, the unit is GB. type: The type of the metadata. If the metric is cpu, the valid metadata types are totalMaxCpu, totalUsedCpu, adhocCpu, adhocUsedCpu, maxCpu, minCpu, requestCpu, usedCpu, elasticMaxCpu, and elasticUsedCpu. If the metric is memory, the valid metadata types are totalMaxMem, totalUsedMem, adhocMem, adhocUsedMem, elasticMaxMem, elasticUsedMem, maxMem, minMem, and usedMem.	totalUsedCpu
values	array	The time series data.
	array	An array of two elements. The first element is the timestamp and the second element is the value.
	number	An array of two elements. The first element is the timestamp and the second element is the value.	[1757571840,10]

Exemplos

Resposta de sucesso

JSON formato

{
  "requestId": "0b87b7b316643495896551555e855b",
  "httpCode": 200,
  "errorCode": "success",
  "errorMsg": "plan \\\"***\\\" does not exist",
  "data": {
    "category": "Not supported.",
    "name": "cpu",
    "period": 60,
    "metrics": [
      {
        "metric": {
          "key": "totalUsedCpu"
        },
        "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.