Interroge les données d'une métrique de série temporelle pour un service cloud spécifié.
Pour savoir comment attribuer des valeurs aux paramètres Namespace, Project, Metric, Period et Dimensions pour les services cloud, consultez
ou
.
Débogage
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 :
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 :
|
| 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 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 :
|
| 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.