DescribeMetricTop - - Centro de documentación de Alibaba Cloud

Consulta los datos ordenados de una métrica de serie temporal que pertenece a un servicio en la nube.

Nota

Para obtener información sobre cómo asignar valores a los parámetros Namespace, Project, Metric, Period y Dimensions para servicios en la nube, consulte

DescribeMetricMetaList

Metrics

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeMetricTop	La operación que desea ejecutar. Establezca el valor en DescribeMetricTop.
MetricName	String	Sí	cpu_idle	El nombre de la métrica.
Namespace	String	Sí	acs_ecs_dashboard	El namespace del servicio en la nube. Especifique el valor con el formato acs_service name.
Orderby	String	Sí	Average	El campo por el cual se ordenan los datos de la métrica.
Period	String	No	60	El intervalo de tiempo en el que se consultan los datos de la métrica. Unidad: segundos. Valores válidos: 60, 300 y 900. Establezca este parámetro según sea necesario. Ejemplos: Si establece este parámetro en 60 y existen 1,440 entradas de datos de métrica, solo se devuelven las primeras 1,000 entradas. Si establece este parámetro en 300 y existen 288 entradas de datos de métrica, se devuelven todas las entradas. Nota El número máximo de entradas de datos de métrica devueltas es 1,000. Si el número supera 1,000, solo se devuelven las primeras 1,000 entradas.
StartTime	String	No	2019-01-30 00:00:00	El inicio del rango de tiempo a consultar. Formatos compatibles: Marca de tiempo UNIX: el número de milisegundos transcurridos desde las 00:00:00 del jueves 1 de enero de 1970. Formato de hora: AAAA-MM-DDThh:mm:ssZ. Nota El periodo especificado por StartTime y EndTime incluye la hora indicada por EndTime y excluye la hora indicada por StartTime. StartTime debe ser anterior a EndTime.
EndTime	String	No	2019-01-30 00:10:00	El final del rango de tiempo a consultar. Formatos compatibles: Marca de tiempo UNIX: el número de milisegundos transcurridos desde las 00:00:00 del jueves 1 de enero de 1970. Formato de hora: AAAA-MM-DDThh:mm:ssZ.
Dimensions	String	No	[{"instanceId": "i-abcdefgh12****"}]	Las dimensiones que especifican los recursos para los cuales desea consultar datos de métricas. Establezca el valor como un conjunto de pares clave-valor. Un par típico es `instanceId:i-2ze2d6j5uhg20x47**`. Nota** Dimensions debe tener formato de cadena JSON en un orden específico.
OrderDesc	String	No	False	El método que se utiliza para ordenar los datos de la métrica. Valores válidos: True: ordena los valores en orden ascendente. False: ordena los valores en orden descendente.
Length	String	No	1000	El número de entradas a devolver en cada página. Valor predeterminado: 1000.
Express	String	No	{"groupby":["userId","instanceId"]}	La expresión para el cálculo en tiempo real sobre los resultados de la consulta. Solo se admite la expresión `groupby`. Esta expresión es similar a la instrucción GROUP BY utilizada en bases de datos.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	3121AE7D-4AFF-4C25-8F1D-C8226EBB1F42	El ID de la solicitud.
Code	String	200	El código de estado HTTP. Nota El código de estado 200 indica que la llamada fue exitosa.
Datapoints	String	[{"timestamp":1548777660000,"userId":"123","instanceId":"i-abc","Minimum":9.92,"Average":9.92,"Maximum":9.92,"_count":1}]	Los datos de la métrica.
Period	String	60	El intervalo de tiempo en el que se consultaron los datos de la métrica. Unidad: segundos. Valores válidos: 60, 300 y 900.
Message	String	The Request is not authorization.	El mensaje de error.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/? Action=DescribeMetricTop
&MetricName=cpu_idle
&Namespace=acs_ecs_dashboard
&Orderby=Average
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<DescribeMetricTopResponse>
	  <Period>60</Period>
	  <Datapoints>
		    <order>1</order>
		    <timestamp>1551687360000</timestamp>
		    <userId>12345****</userId>
		    <instanceId>i-2zeehst1****</instanceId>
		    <Maximum>16.41</Maximum>
		    <Minimum>4.66</Minimum>
		    <Average>7.74</Average>
		    <_count>1</_count>
	  </Datapoints>
	  <Datapoints>
		    <order>2</order>
		    <timestamp>1551687360000</timestamp>
		    <userId>12345****</userId>
		    <instanceId>i-2zefxdy2****</instanceId>
		    <Maximum>15.74</Maximum>
		    <Minimum>5.03</Minimum>
		    <Average>7.14</Average>
		    <_count>1</_count>
	  </Datapoints>
	  <RequestId>1F68A4E8-4488-48E7-9189-3E1F5165E64E</RequestId>
	  <Code>200</Code>
</DescribeMetricTopResponse>

Formato JSON

{
    "Period": "60",
    "Datapoints": [
        {
            "order": 1,
            "timestamp": 1551687360000,
            "userId": "12345****",
            "instanceId": "i-2zeehst1****",
            "Maximum": 16.41,
            "Minimum": 4.66,
            "Average": 7.74,
            "_count": 1
        },
        {
            "order": 2,
            "timestamp": 1551687360000,
            "userId": "12345****",
            "instanceId": "i-2zefxdy2****",
            "Maximum": 15.74,
            "Minimum": 5.03,
            "Average": 7.14,
            "_count": 1
        }
    ],
    "RequestId": "1F68A4E8-4488-48E7-9189-3E1F5165E64E",
    "Code": "200"
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.