PutCustomMetric - - Centre de documentation Alibaba Cloud

Remarque

Nous vous recommandons d'utiliser l'opération

de Hybrid Cloud Monitoring pour publier des données de monitoring.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération via OpenAPI Explorer, qui 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	PutCustomMetric	L'action à effectuer. Définissez la valeur sur PutCustomMetric.
MetricList.N.Type	String	Oui	0	Le type des données publiées. N varie de 1 à 21. Valeurs possibles : 0 : publie des données brutes 1 : publie des données agrégées Remarque Nous vous recommandons de publier des données agrégées pour les périodes d'agrégation de 60 s et 300 s. Sinon, vous ne pourrez pas interroger les données de monitoring sur une période supérieure à sept jours.
MetricList.N.MetricName	String	Oui	cpu_total	Le nom de la métrique. N varie de 1 à 21. Pour plus d'informations, consultez l'Annexe 1 : Métriques.
MetricList.N.Time	String	Non	1508136760000	L'horodatage de génération des données de métrique. N varie de 1 à 21. Formats acceptés : Horodatage UTC au format AAAA-MM-JJThh:mm:ssZ. Exemple : 20171012T132456.888+0800. Horodatage UNIX de type LONG. Exemple : 1508136760000.
MetricList.N.GroupId	String	Oui	12345	L'ID du groupe d'applications. N varie de 1 à 21. Remarque Si la métrique n'appartient à aucun groupe d'applications, saisissez 0.
MetricList.N.Values	String	Oui	{"value":10.5}	La collection de valeurs de métrique. N varie de 1 à 21. Remarque Si le paramètre MetricList.N.Type est défini sur 0, les clés de ce paramètre doivent correspondre à la valeur spécifiée. CloudMonitor agrège les données brutes durant chaque période d'agrégation pour générer plusieurs valeurs statistiques, telles que la valeur maximale, le nombre et la valeur totale.
MetricList.N.Dimensions	String	Oui	{"sampleName1":"value1","sampleName2":"value2"}	Les dimensions spécifiant les ressources dont vous souhaitez interroger les données de monitoring. N varie de 1 à 21. Définissez la valeur sous forme de collection de paires clé-valeur. Format : `{"Key":"Value"}`. La clé ou la valeur doit comporter entre 1 et 64 octets. Les caractères excédentaires sont tronqués. La clé ou la valeur peut 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 formatées sous forme de chaîne JSON dans un ordre spécifique.
MetricList.N.Period	String	Non	60	La période d'agrégation. N varie de 1 à 21. Unité : secondes. Valeurs possibles : 60 et 300. Remarque Si le paramètre MetricList.N.Type est défini sur 1, le paramètre MetricList.N.Period est obligatoire.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Code	String	200	Le code d'état HTTP. Remarque Le code d'état 200 indique que l'appel a réussi.
Message	String	The request has failed due to a temporary failure of the server.	Le message d'erreur.
RequestId	String	05B36C2C-5F6E-48D5-8B41-CE36DD7EE8E0	L'ID de la requête.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=PutCustomMetric
&MetricList.1.Dimensions={"sampleName1":"value1","sampleName2":"value2"}
&MetricList.1.GroupId=12345
&MetricList.1.MetricName=cpu_total
&MetricList.1.Type=0
&MetricList.1.Values={"value":10.5}
&<Common request parameters>

Exemples de réponses réussies

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<PutCustomMetricResponse>
	<RequestId>75D115CE-5DA8-4647-9073-8F72BB85B6F7</RequestId>
	<Message>success</Message>
	<Code>200</Code>
</PutCustomMetricResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "75D115CE-5DA8-4647-9073-8F72BB85B6F7",
  "Message" : "success",
  "Code" : "200"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.