DescribeMetricData - - Centre de documentation Alibaba Cloud

Interroge les données de surveillance d'une métrique temporelle d'un service cloud sur une période spécifiée.

Pour plus d'informations sur l'attribution des valeurs aux paramètres Namespace, Project, Metric, Period et Dimensions pour les services cloud, consultez DescribeMetricMetaList ou Annexe 1 : Métriques.

Remarque

Contrairement à DescribeMetricList, cette opération offre des fonctionnalités statistiques. Vous pouvez définir le paramètre Dimension sur {"userId":"xxxx"} pour agréger toutes les données de l'utilisateur spécifié.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	DescribeMetricData	Opération à effectuer. Définissez la valeur sur DescribeMetricData.
MetricName	String	Oui	cpu_idle	Nom de la métrique à interroger.
Namespace	String	Oui	acs_ecs_dashboard	Namespace du service. Spécifiez la valeur au format acs_Service.
Period	String	Non	60	Intervalle de temps pour l'interrogation des données de surveillance. Unité : secondes. Valeurs valides : 60, 300 et 900. Définissez ce paramètre selon vos besoins.
StartTime	String	Non	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 1er janvier 1970, 00:00:00 UTC. Format d'heure : AAAA-MM-JJThh:mm:ssZ. Remarque La période spécifiée par StartTime et EndTime inclut le point temporel défini par EndTime mais exclut celui défini par StartTime. StartTime doit être antérieur à EndTime.
EndTime	String	Non	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 1er janvier 1970, 00:00:00 UTC. Format d'heure : AAAA-MM-JJThh:mm:ssZ.
Dimensions	String	Non	[{"instanceId": "i-abcdefgh12****"}]	Dimensions spécifiant les ressources pour lesquelles vous souhaitez interroger les données de surveillance. Définissez la valeur sous forme de collection de paires clé-valeur. Une paire clé-valeur typique est `instanceId:XXXXXX`. La clé et la valeur peuvent chacune avoir une longueur de 1 à 64 octets. Les valeurs contenant plus de 64 caractères sont tronquées. La clé et la valeur peuvent contenir des lettres, des chiffres, des points (.), des traits d'union (-), des traits de soulignement (_), des barres obliques (/) et des barres obliques inverses (\). Remarque Les dimensions doivent être organisées dans une chaîne JSON et respecter l'ordre requis.
Express	String	Non	"{"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.
Length	String	Non	1000	Nombre d'entrées à renvoyer par page.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Code	String	200	Code de réponse. Remarque Le code HTTP 200 indique que la requête a réussi.
Datapoints	String	[{"timestamp":1548777660000,"userId":"123**","instanceId":"i-abc**","Minimum":9.92,"Average":9.92,"Maximum":9.92}]	Données de surveillance de la métrique. La valeur comprend les champs suivants : timestamp : horodatage du déclenchement de l'alerte. userId : ID de l'utilisateur concerné par l'alerte. instanceId : ID de l'instance concernée par l'alerte. Minimum, Average et Maximum : méthodes d'agrégation.
Message	String	The Request is not authorization.	Message d'erreur.
Period	String	60	Intervalle de temps des données de surveillance interrogées. Unité : secondes. Valeurs valides : 60, 300 et 900.
RequestId	String	6A5F022D-AC7C-460E-94AE-B9E75083D027	ID de la requête.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

XML format

<DescribeMetricData>
		  <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>
		  <Code>200</Code>
</DescribeMetricData>

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",
    "Code": "200"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.