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

Descrição da operação

Limites

As operações DescribeMetricLast, DescribeMetricList, DescribeMetricData e DescribeMetricTop compartilham uma cota gratuita de 1.000.000 de invocações por mês no total. Após a cota gratuita ser esgotada e se você não tiver ativado o método de cobrança pay-as-you-go do CloudMonitor Basic, não será possível usar esta operação de API normalmente. Se você tiver ativado o método de cobrança pay-as-you-go do CloudMonitor Basic, esta operação de API permanecerá disponível após o esgotamento da cota gratuita, e o uso excedente será cobrado automaticamente. Para obter mais informações sobre como ativar o método de cobrança pay-as-you-go, consulte Ativar a cobrança pay-as-you-go.
Uma única operação de API é limitada a 50 invocações por segundo. Esse limite é compartilhado por uma conta Alibaba Cloud e todos os usuários do Resource Access Management (RAM) sob a conta.

Nota

Se a resposta contiver Throttling.User ou Request was denied due to user flow control ao invocar esta operação de API, a solicitação será limitada. Para obter o método para lidar com esse problema, consulte Como lidar com a limitação da API de consulta.

Antes de começar

A duração de armazenamento dos dados de monitoramento do serviço em nuvem depende do Period (período estatístico). Um valor de Period maior resulta em dados de monitoramento mais esparsos e uma duração de armazenamento mais longa. A lista a seguir descreve a relação:

Se o Period for menor que 60 segundos, a duração de armazenamento será de 7 dias.
Se o Period for igual a 60 segundos, a duração de armazenamento será de 31 dias.
Se o Period for maior ou igual a 300 segundos, a duração de armazenamento será de 91 dias.

Descrição da operação

Este tópico fornece um exemplo de como consultar os dados de monitoramento mais recentes da métrica CPUUtilization para o serviço em nuvem acs_ecs_dashboard. A resposta mostra que o valor máximo é 100, o valor mínimo é 93,1 e o valor médio é 99,52 em intervalos de 60 segundos para a instância i-abcdefgh12**** sob a conta 123456789876****.

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

cms:QueryMetricLast

get

*全部资源

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Namespace	string	Sim	O namespace do serviço em nuvem. Para obter informações sobre os namespaces dos serviços em nuvem, consulte Monitoramento de serviços em nuvem.	acs_ecs_dashboard
MetricName	string	Sim	O nome da métrica do serviço em nuvem. Para obter informações sobre os nomes das métricas, consulte Monitoramento de serviços em nuvem.	CPUUtilization
Period	string	Não	O período estatístico dos dados de monitoramento. Valores válidos: 15, 60, 900 e 3600. Unidade: segundos. Nota Se você não especificar um período estatístico, os dados de monitoramento serão consultados com base no período de relatório especificado quando a métrica foi registrada. - O período estatístico varia de acordo com a métrica (`MetricName`) para cada serviço em nuvem. Para obter mais informações, consulte a coluna `Min Periods` na página Métricas do serviço em nuvem de destino em Monitoramento de serviços em nuvem.	60
StartTime	string	Não	A hora de início da consulta.	2019-01-31 10:00:00
EndTime	string	Não	A hora de término da consulta. Para dados no nível de segundos, a hora de início real da consulta é o maior valor entre o horário 20 minutos antes do EndTime e o startTime especificado. Para dados no nível de minutos, a hora de início real da consulta é o maior valor entre o horário 2 horas antes do EndTime e o startTime especificado. Para dados no nível de horas, a hora de início real da consulta é o maior valor entre o horário 2 dias antes do EndTime e o startTime especificado.	2019-01-31 10:10:00
Dimensions	string	Não	As dimensões de monitoramento do recurso especificado. Formato: uma coleção de pares `chave:valor`. Exemplo: `{"userId":"120886317861**"}` e `{"instanceId":"i-2ze2d6j5uhg20x47"}`. Nota** No máximo 50 instâncias podem ser consultadas em uma única solicitação.	[{"instanceId":"i-2ze2d6j5uhg20x47****"}]
NextToken	string	Não	O cursor de paginação. Se o número de resultados que correspondem às condições de consulta exceder o tamanho da página, um cursor de paginação será retornado. Para recuperar a próxima página de dados, use o valor do cursor retornado como parâmetro de solicitação até que nenhum valor de cursor seja retornado, o que indica que todos os dados foram recuperados.	15761432850009dd70bb64cff1f0fff6c0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****
Length	string	Não	O número de entradas por página para os dados de monitoramento. Este parâmetro é usado para paginação. Valor padrão: 1000, o que indica 1.000 entradas de dados de monitoramento por página. Nota O valor máximo de Length em uma única solicitação é 1440.	1000
Express	string	Não	A expressão para computação em tempo real nos resultados de consulta existentes.	{"groupby":["userId","instanceId"]}

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

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
NextToken	string	O cursor de paginação.	xxxxxx
RequestId	string	O ID da solicitação.	021472A6-25E3-4094-8D00-BA4B6A5486C3
Success	boolean	Indica se a operação foi bem-sucedida. Valores válidos: true: A operação foi bem-sucedida. false: A operação falhou.	true
Datapoints	string	A lista de dados de monitoramento.	[{"timestamp":1548777660000,"userId":"123456789876**","instanceId":"i-abcdefgh12**","Minimum":93.1,"Average":99.52,"Maximum":100}]
Code	string	O código de status. Nota Um valor 200 indica sucesso.	200
Message	string	A mensagem de erro.	The specified resource is not found.
Period	string	O intervalo de tempo. Unidade: segundos.	60

Exemplos

Resposta de sucesso

JSON formato

{
  "NextToken": "xxxxxx",
  "RequestId": "021472A6-25E3-4094-8D00-BA4B6A5486C3",
  "Success": true,
  "Datapoints": "[{\"timestamp\":1548777660000,\"userId\":\"123456789876****\",\"instanceId\":\"i-abcdefgh12****\",\"Minimum\":93.1,\"Average\":99.52,\"Maximum\":100}]",
  "Code": "200",
  "Message": "The specified resource is not found.",
  "Period": "60"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	ParameterInvalid	Illegal parameters.
500	InternalError	The request processing has failed due to some unknown error.
403	AccessForbidden	User not authorized to operate on the specified resource.
404	ResourceNotFound	The specified resource is not found.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.