DescribeMetricLast - Cloud Monitor - Centro de documentación de Alibaba Cloud

Descripción de la operación

Antes de comenzar

Las invocaciones de DescribeMetricLast, DescribeMetricList, DescribeMetricData y DescribeMetricTop comparten una cuota gratuita combinada de 1,000,000 llamadas al mes. Una vez agotada la cuota gratuita, si no ha activado el método de facturación de pago por uso de CloudMonitor Basic, no podrá utilizar esta API con normalidad. Si ha activado el método de facturación de pago por uso de CloudMonitor Basic, la API continuará funcionando después de que se agote la cuota gratuita, y el uso que exceda dicha cuota se facturará automáticamente. Para conocer el método para activar la facturación de pago por uso, consulte Activar la facturación de pago por uso.
El límite de velocidad para una sola operación de API es de 50 llamadas por segundo. Este límite lo comparten una cuenta de Alibaba Cloud y todos los usuarios de Resource Access Management (RAM) bajo dicha cuenta.

Nota

Cuando invoca una operación de API, si la respuesta contiene Throttling.User o Request was denied due to user flow control, significa que la API está siendo limitada. Para conocer el método de manejo, consulte Cómo manejar la limitación de velocidad de las API de consulta.

Notas

La duración de almacenamiento de los datos de monitoreo de servicios en la nube depende del Period (periodo estadístico). Un valor mayor de Period resulta en datos de monitoreo más dispersos y una mayor duración de almacenamiento. Las relaciones son las siguientes:

Si Period es menor a 60 segundos, la duración de almacenamiento es de 7 días.
Si Period es igual a 60 segundos, la duración de almacenamiento es de 31 días.
Si Period es mayor o igual a 300 segundos, la duración de almacenamiento es de 91 días.

Descripción de la operación

Este tema proporciona un ejemplo de cómo consultar los datos de monitoreo más recientes de la métrica CPUUtilization para el servicio en la nube acs_ecs_dashboard. La respuesta muestra que, para la instancia i-abcdefgh12**** bajo la cuenta 123456789876****, el valor máximo es 100, el valor mínimo es 93.1 y el valor promedio es 99.52 en un intervalo de 60 segundos.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

cms:QueryMetricLast

get

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Namespace	string	Sí	El espacio de nombres del servicio en la nube. Para obtener información sobre los espacios de nombres de los servicios en la nube, consulte Métricas de monitoreo de servicios en la nube.	acs_ecs_dashboard
MetricName	string	Sí	El nombre de la métrica del servicio en la nube. Para obtener información sobre los nombres de las métricas, consulte Métricas de monitoreo de servicios en la nube.	CPUUtilization
Period	string	No	El periodo estadístico de los datos de monitoreo. Valores válidos: 15, 60, 900 y 3600. Unidad: segundos. Nota Si no establece el periodo estadístico, los datos de monitoreo se consultan según el periodo de reporte que se especificó cuando se registró la métrica. - El periodo estadístico varía según la métrica (`MetricName`) para cada servicio en la nube. Para obtener más información, consulte la columna `Min Periods` en la página de lista de métricas del servicio en la nube objetivo en Métricas de monitoreo de servicios en la nube.	60
StartTime	string	No	La hora de inicio. Se admiten dos formatos: 1. Una cadena de marca de tiempo UNIX en milisegundos (ms), que representa el número de milisegundos transcurridos desde 1970-01-01 00:00:00 UTC. 2. Una cadena de tiempo en formato ISO 8601 AAAA-MM-DDThh:mm:ssZ en UTC. Nota El rango de consulta utiliza un modo exclusivo por la izquierda e inclusivo por la derecha. StartTime no puede ser igual o mayor que EndTime, y el intervalo entre ambos debe ser menor o igual a 31 días.	2019-01-31 10:00:00
EndTime	string	No	La hora de finalización para consultar la métrica. El sistema limita automáticamente la hora de inicio de la consulta (tamaño de la ventana de consulta) según la granularidad de los datos: Datos a nivel de segundo: El intervalo máximo de consulta es de 20 minutos (hora de inicio = Max(startTime, EndTime - 20min)). Datos a nivel de minuto: El intervalo máximo de consulta es de 2 horas (hora de inicio = Max(startTime, EndTime - 2h)). Datos a nivel de hora: El intervalo máximo de consulta es de 2 días (hora de inicio = Max(startTime, EndTime - 2d)). Nota Si la startTime especificada es anterior al límite, el sistema utiliza automáticamente el límite como la hora de inicio real de la consulta.	2019-01-31 10:10:00
Dimensions	string	No	Las dimensiones de monitoreo del recurso especificado. Formato: una colección de pares `clave:valor`. Ejemplo: `{"userId":"120886317861**"}` o `{"instanceId":"i-2ze2d6j5uhg20x47"}`. Nota** Se pueden consultar hasta 50 instancias en una sola solicitud.	[{"instanceId":"i-2ze2d6j5uhg20x47****"}]
NextToken	string	No	El cursor de paginación. Si los resultados de la consulta que coinciden con las condiciones de filtro superan el tamaño de página, se devuelve un cursor de paginación. Para recuperar la siguiente página de datos, utilice el valor del cursor devuelto como parámetro de solicitud hasta que no se devuelva ningún valor de cursor, lo cual indica que se han recuperado todos los datos.	15761432850009dd70bb64cff1f0fff6c0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****
Length	string	No	El número de entradas por página para los datos de monitoreo. Este parámetro se utiliza para consultas paginadas. Valor predeterminado: 1000, lo que indica 1000 entradas de datos de monitoreo por página. Nota El valor máximo de Length en una sola solicitud es 1440.	1000
Express	string	No	La expresión para el cálculo en tiempo real sobre los resultados de consulta existentes.	{"groupby":["userId","instanceId"]}

Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
NextToken	string	El cursor de paginación.	xxxxxx
RequestId	string	El ID de la solicitud.	021472A6-25E3-4094-8D00-BA4B6A5486C3
Success	boolean	Indica si la operación se realizó correctamente. Valores válidos: true: Correcto. false: Fallido.	true
Datapoints	string	La lista de datos de monitoreo.	[{"timestamp":1548777660000,"userId":"123456789876**","instanceId":"i-abcdefgh12**","Minimum":93.1,"Average":99.52,"Maximum":100}]
Code	string	El código de estado. Nota Un valor de 200 indica éxito.	200
Message	string	El mensaje de error.	The specified resource is not found
Period	string	El intervalo de tiempo. Unidad: segundos.	60

Ejemplos

Respuesta exitosa

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
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.	The specified resource is not found.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.