DescribeMetricList - - Centro de documentación de Alibaba Cloud

Consulta los datos de una métrica de serie temporal de un servicio en la nube específico.

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 que ejecute esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeMetricList	La operación que desea ejecutar. Establezca el valor en DescribeMetricList.
MetricName	String	Sí	cpu_idle	El nombre de la métrica.
Namespace	String	Sí	acs_ecs_dashboard	El espacio de nombres del servicio en la nube. Especifique el valor con el formato acs_service name.
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. Nota Establezca este parámetro según sea necesario.
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 fin 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.
NextToken	String	No	15761485350009dd70bb64cff1f0fff750b08ffff073be5fb1e785e2b020f1a949d5ea14aea7fed82f01dd8****	El cursor de paginación. Nota Si no se especifica este parámetro, se devuelven los datos de la primera página. El valor devuelto indica que no se han devuelto todas las entradas. Use este valor como parámetro de entrada para obtener las entradas de la siguiente página. Si una respuesta está vacía, significa que se han devuelto todos los resultados de la consulta.
Length	String	No	1000	El número de entradas a devolver en cada página.
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.
Success	Boolean	true	Indica si la llamada fue exitosa. Valores válidos: true: La llamada fue exitosa. false: La llamada falló.
NextToken	String	15761441850009dd70bb64cff1f0fff6d0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****	El cursor de paginación.
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.
Datapoints	String	[{"timestamp":1548777660000,"userId":"123","instanceId":"i-abc","Minimum":9.92,"Average":9.92,"Maximum":9.92}]	Los datos de la métrica.
Message	String	The Request is not authorization.	El mensaje de error.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

Formato XML

<DescribeMetricListResponse>
		  <Period>60</Period>
		  <Datapoints>
			    <timestamp>1490152860000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>93.1</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.52</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490152920000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>92.59</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.49</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490152980000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>92.86</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.44</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490153040000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>91.43</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.36</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490153100000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>93.55</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.51</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490153160000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>93.1</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.52</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490153220000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>92.59</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.42</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490153280000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>91.18</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.34</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490153340000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>92.86</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.46</Average>
		  </Datapoints>
		  <Datapoints>
			    <timestamp>1490153400000</timestamp>
			    <Maximum>100</Maximum>
			    <userId>123456789876****</userId>
			    <Minimum>91.18</Minimum>
			    <instanceId>i-abcdefgh12****</instanceId>
			    <Average>99.35</Average>
		  </Datapoints>
		  <RequestId>6A5F022D-AC7C-460E-94AE-B9E75083D027</RequestId>
		  <Success>true</Success>
		  <Code>200</Code>
</DescribeMetricListResponse>

Formato JSON

{
    "Period": "60",
    "Datapoints": [
        {
            "timestamp": 1490152860000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 93.1,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.52
        },
        {
            "timestamp": 1490152920000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 92.59,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.49
        },
        {
            "timestamp": 1490152980000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 92.86,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.44
        },
        {
            "timestamp": 1490153040000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 91.43,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.36
        },
        {
            "timestamp": 1490153100000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 93.55,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.51
        },
        {
            "timestamp": 1490153160000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 93.1,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.52
        },
        {
            "timestamp": 1490153220000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 92.59,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.42
        },
        {
            "timestamp": 1490153280000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 91.18,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.34
        },
        {
            "timestamp": 1490153340000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 92.86,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.46
        },
        {
            "timestamp": 1490153400000,
            "Maximum": 100,
            "userId": "123456789876****",
            "Minimum": 91.18,
            "instanceId": "i-abcdefgh12****",
            "Average": 99.35
        }
    ],
    "RequestId": "6A5F022D-AC7C-460E-94AE-B9E75083D027",
    "Success": true,
    "Code": "200"
}

Códigos de error

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