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

Descrição da operação

Antes de começar

As chamadas de DescribeMetricLast, DescribeMetricList, DescribeMetricData e DescribeMetricTop compartilham uma cota gratuita combinada de 1.000.000 de chamadas por mês. Após a cota gratuita ser esgotada, se você não tiver ativado o método de faturamento pay-as-you-go do CloudMonitor Basic, não poderá usar esta API normalmente. Se você tiver ativado o método de faturamento pay-as-you-go do CloudMonitor Basic, a API continuará funcionando após o esgotamento da cota gratuita, e o uso além da cota gratuita será faturado automaticamente. Para obter o método de ativação do faturamento pay-as-you-go, consulte Ativar faturamento pay-as-you-go.
O limite de taxa para uma única operação de API é de 50 chamadas por segundo. Esse limite é compartilhado por uma conta Alibaba Cloud e todos os usuários do Resource Access Management (RAM) sob essa conta.

Nota

Ao invocar uma operação de API, se a resposta contiver Throttling.User ou Request was denied due to user flow control, significa que a API está sendo limitada. Para obter o método de tratamento, consulte Como lidar com a limitação da API de consulta.

Observações

A duração de armazenamento dos dados de monitoramento de serviços em nuvem depende do Period (período estatístico). Um valor maior de Period resulta em dados de monitoramento mais esparsos e em uma duração de armazenamento mais longa. As relações são as seguintes:

Se Period for menor que 60 segundos, a duração de armazenamento será de 7 dias.
Se Period for igual a 60 segundos, a duração de armazenamento será de 31 dias.
Se 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, para a instância i-abcdefgh12**** na conta 123456789876****, o valor máximo é 100, o valor mínimo é 93,1 e o valor médio é 99,52 em um intervalo de 60 segundos.

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

*Todos os recursos.

*

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 namespaces de serviços em nuvem, consulte Métricas de 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 nomes de métricas, consulte Métricas de 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 definir o 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 da lista de métricas do serviço em nuvem de destino em Métricas de monitoramento de serviços em nuvem.	60
StartTime	string	Não	A hora de início. Dois formatos são suportados: 1. Uma string de timestamp UNIX em milissegundos (ms), que representa o número de milissegundos decorridos desde 1970-01-01 00:00:00 UTC. 2. Uma string de tempo no formato ISO 8601 AAAA-MM-DDThh:mm:ssZ em UTC. Nota O intervalo de consulta utiliza um modo exclusivo à esquerda e inclusivo à direita. StartTime não pode ser igual ou maior que EndTime, e o intervalo entre eles deve ser menor ou igual a 31 dias.	2019-01-31 10:00:00
EndTime	string	Não	A hora de término para consultar a métrica. O sistema limita automaticamente a hora de início da consulta (tamanho da janela de consulta) com base na granularidade dos dados: Dados de nível de segundo: O intervalo máximo de consulta é de 20 minutos (hora de início = Max(startTime, EndTime - 20min)). Dados de nível de minuto: O intervalo máximo de consulta é de 2 horas (hora de início = Max(startTime, EndTime - 2h)). Dados de nível de hora: O intervalo máximo de consulta é de 2 dias (hora de início = Max(startTime, EndTime - 2d)). Nota Se o startTime especificado for anterior ao limite, o sistema usará automaticamente o limite como a hora de início real da consulta.	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**"}` ou `{"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 os resultados da consulta que correspondem às condições de filtro excederem 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 da 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 dados de monitoramento. Este parâmetro é usado para consulta paginada. Valor padrão: 1000, que indica 1000 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: Bem-sucedido. false: Falha.	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 de 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	Descrição
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.	O recurso especificado %s não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.