Tous les produits
Search
Centre de documentation

:DescribeMetricList

Dernière mise à jour :Aug 11, 2026

Interroge les données d'une métrique de série temporelle pour un service cloud spécifié.

Remarque

Pour savoir comment attribuer des valeurs aux paramètres Namespace, Project, Metric, Period et Dimensions pour les services cloud, consultez

DescribeMetricMetaList

ou

Metrics

.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter Type Required Example Description
Action String Yes DescribeMetricList

Opération à effectuer. Définissez la valeur sur DescribeMetricList.

MetricName String Yes cpu_idle

Nom de la métrique.

Namespace String Yes acs_ecs_dashboard

Namespace du service cloud.

Spécifiez la valeur au format acs_service name.

Period String No 60

Intervalle de temps entre les requêtes de données de métrique. Unité : secondes. Valeurs valides : 60, 300 et 900.

Remarque Définissez ce paramètre selon vos besoins.
StartTime String No 2019-01-30 00:00:00

Début de la plage de temps à interroger. Formats pris en charge :

  • Horodatage UNIX : nombre de millisecondes écoulées depuis le jeudi 1er janvier 1970 à 00:00:00.
  • Format horaire : YYYY-MM-DDThh:mm:ssZ.
Remarque La période spécifiée par StartTime et EndTime inclut l'heure spécifiée par EndTime et exclut celle spécifiée par StartTime. StartTime doit être antérieur à EndTime.
EndTime String No 2019-01-30 00:10:00

Fin de la plage de temps à interroger. Formats pris en charge :

  • Horodatage UNIX : nombre de millisecondes écoulées depuis le jeudi 1er janvier 1970 à 00:00:00.
  • Format horaire : YYYY-MM-DDThh:mm:ssZ.
Dimensions String No [{"instanceId": "i-abcdefgh12****"}]

Dimensions spécifiant les ressources pour lesquelles vous souhaitez interroger les données de métrique.

Définissez la valeur sur un ensemble de paires clé-valeur. Une paire typique est instanceId:i-2ze2d6j5uhg20x47****.

Remarque Les dimensions doivent être formatées sous forme de chaîne JSON dans un ordre spécifié.
NextToken String No 15761485350009dd70bb64cff1f0fff750b08ffff073be5fb1e785e2b020f1a949d5ea14aea7fed82f01dd8****

Curseur de pagination.

Remarque Si ce paramètre n'est pas spécifié, les données de la première page sont renvoyées. La valeur renvoyée indique que toutes les entrées n'ont pas été renvoyées. Vous pouvez utiliser cette valeur comme paramètre d'entrée pour obtenir les entrées de la page suivante. Si une réponse est vide, tous les résultats de la requête ont été renvoyés.
Length String No 1000

Nombre d'entrées à renvoyer sur chaque page.

Express String No {"groupby":["userId","instanceId"]}

Expression pour le calcul en temps réel des résultats de la requête.

Seule l'expression groupby est prise en charge. Cette expression est similaire à l'instruction GROUP BY utilisée dans les bases de données.

Paramètres de réponse

Parameter Type Example Description
RequestId String 3121AE7D-4AFF-4C25-8F1D-C8226EBB1F42

ID de la requête.

Code String 200

Code d'état HTTP.

Remarque Le code d'état 200 indique que l'appel a réussi.
Success Boolean true

Indique si l'appel a réussi. Valeurs valides :

  • true : L'appel a réussi.
  • false : L'appel a échoué.
NextToken String 15761441850009dd70bb64cff1f0fff6d0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****

Curseur de pagination.

Period String 60

Intervalle de temps entre les requêtes de données de métrique. Unité : secondes. Valeurs valides : 60, 300 et 900.

Datapoints String [{"timestamp":1548777660000,"userId":"123","instanceId":"i-abc","Minimum":9.92,"Average":9.92,"Maximum":9.92}]

Données de la métrique.

Message String The Request is not authorization.

Message d'erreur.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

XML format

<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>

JSON format

{
    "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"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.