DescribeMetricLast - : Central de Documentação do Alibaba Cloud

Limites

Cada operação de API permite até 50 chamadas por segundo. A conta Alibaba Cloud e seus usuários RAM compartilham essa cota.

Precauções

O tempo de retenção dos dados de monitoramento de cada serviço de nuvem depende do parâmetro Period (período estatístico). Quanto maior o valor de Period, maior o intervalo de tempo dos dados consultados e maior o tempo de retenção. A lista a seguir detalha essas relações:

Se o valor de Period for menor que 60 segundos, o tempo de retenção é de sete dias.
Para Period igual a 60 segundos, a retenção é de 31 dias.
Quando Period é de 300 segundos, os dados são retidos por 91 dias.

Notas de uso

Este tópico apresenta um exemplo de consulta dos dados de monitoramento mais recentes da métrica CPUUtilization para o Elastic Compute Service (ECS). O namespace do ECS é acs_ecs_dashboard. O resultado indica a consulta dos dados de monitoramento da instância i-abcdefgh12**** da conta 123456789876**** em intervalos de 60 segundos. Os valores máximo, mínimo e médio da métrica são 100, 93,1 e 99,52, respectivamente.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar, recomendamos chamar esta operação no OpenAPI Explorer. A ferramenta também gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeMetricLast	A operação a ser executada. defina o valor como DescribeMetricLast.
Namespace	String	Sim	acs_ecs_dashboard	O namespace do serviço de nuvem. Para mais informações sobre os namespaces dos serviços de nuvem, consulte o Apêndice 1: Métricas.
MetricName	String	Sim	CPUUtilization	A métrica usada para monitorar o serviço de nuvem. Para mais informações sobre os nomes das métricas, consulte o Apêndice 1: Métricas.
Period	String	Não	60	O período estatístico dos dados de monitoramento. Valores válidos: 15, 60, 900 e 3600. Unidade: segundos. Nota Caso não especifique este parâmetro, o sistema consulta os dados de monitoramento com base no período de relato dos valores da métrica. Os períodos estatísticos variam conforme as métricas definidas em `MetricName`. Para mais informações, consulte o Apêndice 1: Métricas.
StartTime	String	Não	2019-01-31 10:00:00	O início do intervalo de tempo para consulta dos dados de monitoramento.
EndTime	String	Não	2019-01-31 10:10:00	O fim do intervalo de tempo para consulta dos dados de monitoramento. Para dados em nível de segundos, o horário de início corresponde ao valor mais antigo entre o parâmetro StartTime e o parâmetro EndTime menos 20 minutos. Para dados em nível de minutos, o horário de início corresponde ao valor mais antigo entre o parâmetro StartTime e o parâmetro EndTime menos 2 horas. Para dados em nível de horas, o horário de início corresponde ao valor mais antigo entre o parâmetro StartTime e o parâmetro EndTime menos dois dias.
Dimensions	String	Não	[{"instanceId":"i-2ze2d6j5uhg20x47****"}]	As dimensões de monitoramento do recurso especificado. defina o valor como um conjunto de pares `chave:valor`. Exemplo: `{"userId":"120886317861"}` ou `{"instanceId":"i-2ze2d6j5uhg20x47"}`. Nota É possível consultar no máximo 50 instâncias em uma única requisição.
NextToken	String	Não	15761432850009dd70bb64cff1f0fff6c0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****	O token de paginação. Se o número de resultados exceder o limite de entradas por página, o sistema retorna um token de paginação. Use este token como parâmetro de entrada para obter a próxima página de resultados. Se não houver mais resultados, nenhum token é retornado.
Length	String	Não	1000	O número de entradas por página. Valor padrão: 1000. Este valor indica que cada página retorna no máximo 1.000 entradas de dados de monitoramento. Nota O valor máximo do parâmetro Length em uma requisição é 1440.
Express	String	Não	{"groupby":["userId","instanceId"]}	A expressão usada para calcular os resultados da consulta em tempo real.

Para mais informações sobre os parâmetros comuns de requisição, consulte Parâmetros comuns.

Parâmetros da resposta

Parâmetro	Tipo	Exemplo	Descrição
NextToken	String	xxxxxx	O token de paginação.
RequestId	String	021472A6-25E3-4094-8D00-BA4B6A5486C3	O id da requisição.
Success	Boolean	true	Indica se a requisição foi bem-sucedida. Valores válidos: true false
Datapoints	String	[{"timestamp":1548777660000,"userId":"123456789876**","instanceId":"i-abcdefgh12**","Minimum":93.1,"Average":99.52,"Maximum":100}]	Os dados de monitoramento.
Code	String	200	O código de status. Nota O código de status 200 indica que a requisição foi bem-sucedida.
Message	String	The specified resource is not found.	A mensagem de erro.
Period	String	60	O intervalo de tempo. Unidade: segundos.

Exemplos

Exemplos de requisições

http(s)://[Endpoint]/?Action=DescribeMetricLast
&MetricName=CPUUtilization
&Namespace=acs_ecs_dashboard
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<QueryMetricListResponse>
	<Period>60</Period>
	<Datapoints>
		<timestamp>1548777660000</timestamp>
		<Maximum>100</Maximum>
		<userId>123456789876****</userId>
		<Minimum>93.1</Minimum>
		<instanceId>i-abcdefgh12****</instanceId>
		<Average>99.52</Average>
	</Datapoints>
	<RequestId>6A5F022D-AC7C-460E-94AE-B9E75083D027</RequestId>
	<Success>true</Success>
	<Code>200</Code>
</QueryMetricListResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Period" : "60",
  "Datapoints" : [ {
    "timestamp" : 1548777660000,
    "Maximum" : 100,
    "userId" : "123456789876****",
    "Minimum" : 93.1,
    "instanceId" : "i-abcdefgh12****",
    "Average" : 99.52
  } ],
  "RequestId" : "6A5F022D-AC7C-460E-94AE-B9E75083D027",
  "Success" : true,
  "Code" : "200"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
404	ResourceNotFound	The specified resource is not found.	O recurso especificado não foi encontrado.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.