DescribeInstanceMonitorData - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Tenez compte des points suivants :

Un maximum de 400 entrées de données de surveillance peuvent être renvoyées en une seule fois. Une erreur est renvoyée si la valeur calculée à l'aide de la formule suivante est supérieure à 400 : (EndTime − StartTime)/Period.
Vous pouvez interroger les données de surveillance des 30 derniers jours. Si la valeur du paramètre StartTime est antérieure de plus de 30 jours à l'heure actuelle, une erreur est renvoyée.
Dans certains scénarios, par exemple lorsque l'instance est à l'état Stopped, le système ne peut pas obtenir les informations pertinentes et une partie des données de surveillance renvoyées peut être manquante.
Il est impossible d'obtenir les données de surveillance de base du CPU pour une instance ECS Bare Metal. Installez l'agent CloudMonitor pour obtenir les informations de surveillance du CPU. Pour plus d'informations, consultez InstallCloudMonitor.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour votre 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	DescribeInstanceMonitorData	L'opération que vous souhaitez effectuer. Définissez la valeur sur DescribeInstanceMonitorData.
InstanceId	String	Yes	i-bp1a36962lrhj4ab****	L'ID de l'instance.
StartTime	String	Yes	2014-10-29T23:00:00Z	Le début de la plage de temps à interroger. Spécifiez l'heure au format ISO 8601 selon le format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC. Si la valeur des secondes (`ss`) n'est pas `00`, l'heure est arrondie à la minute supérieure.
EndTime	String	Yes	2014-10-30T08:00:00Z	La fin de la plage de temps à interroger. Spécifiez l'heure au format ISO 8601 selon le format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC. Si la valeur des secondes (`ss`) n'est pas `00`, l'heure est arrondie à la minute supérieure.
Period	Integer	No	60	L'intervalle auquel récupérer les données de surveillance. Unité : secondes. Valeurs valides : 60 600 3600 Valeur par défaut : 60.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la requête.
MonitorData	Array of InstanceMonitorData		Données de surveillance de l'instance.
InstanceMonitorData
CPUCreditBalance	Float	120	Nombre total de crédits CPU de l'instance à performances variables.
BPSRead	Integer	1000	Bande passante en lecture des disques (disque système et disques de données). Unité : octets/s.
InternetTX	Integer	343	Volume de trafic de données envoyé par l'instance vers Internet pendant la période spécifiée par le paramètre `Period`, qui commence à l'heure spécifiée par le paramètre `TimeStamp`. Unité : Kbit.
CPU	Integer	2	Utilisation du vCPU de l'instance. Unité : pourcentage (%).
CPUCreditUsage	Float	30	Nombre de crédits CPU consommés par l'instance à performances variables.
IOPSWrite	Integer	200	Nombre d'opérations d'E/S en écriture par seconde sur les disques (disque système et disques de données).
IntranetTX	Integer	343	Volume de trafic de données envoyé par l'instance vers le réseau interne pendant la période spécifiée par le paramètre `Period`, qui commence à l'heure spécifiée par le paramètre `TimeStamp`. Unité : Kbit.
InstanceId	String	i-bp1a36962lrhj4****	ID de l'instance.
BPSWrite	Integer	13585	Bande passante en écriture des disques (disque système et disques de données). Unité : octets/s.
CPUNotpaidSurplusCreditUsage	Float	0,5	Crédits CPU découverts non payés.
CPUAdvanceCreditBalance	Float	0,4	Crédits CPU découverts de l'instance à performances variables.
IOPSRead	Integer	1000	Nombre d'opérations d'E/S en lecture par seconde sur les disques (disque système et disques de données).
InternetBandwidth	Integer	10	Bande passante publique de l'instance. Unité : Kbit/s.
InternetRX	Integer	122	Volume de trafic de données reçu par l'instance depuis Internet pendant la période spécifiée par le paramètre `Period`, qui commence à l'heure spécifiée par le paramètre `TimeStamp`. Unité : Kbit.
TimeStamp	String	2014-10-30T05:00:00Z	Horodatage de l'interrogation des données de surveillance.
IntranetRX	Integer	122	Volume de trafic de données reçu par l'instance depuis le réseau interne pendant la période spécifiée par le paramètre `Period`, qui commence à l'heure spécifiée par le paramètre `TimeStamp`. Unité : Kbit.
IntranetBandwidth	Integer	10	Bande passante interne de l'instance. Unité : Kbit/s.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com/?Action=DescribeInstanceMonitorData
&EndTime=2014-10-30T08:00:00Z
&InstanceId=i-bp1a36962lrhj4ab****
&StartTime=2014-10-29T23:00:00Z
&Period=3600
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<DescribeInstanceMonitorDataResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
    <MonitorData>
        <InstanceMonitorData>
            <InstanceId>i-bp1a36962lrhj4ab****</InstanceId>
            <CPU>2</CPU>
            <IntranetRX>122</IntranetRX>
            <IntranetTX>343</IntranetTX>
            <IntranetFlow>675</IntranetFlow>
            <IntranetBandwidth>10</IntranetBandwidth>
            <InternetRX>122</InternetRX>
            <InternetTX>343</InternetTX>
            <InternetFlow>675</InternetFlow>
            <InternetBandwidth>10</InternetBandwidth>
            <IOPSRead>1000</IOPSRead>
            <IOPSWrite>200</IOPSWrite>
            <BPSRead>1000</BPSRead>
            <BPSWrite>13585</BPSWrite>
            <TimeStamp>2014-10-30T05:00:00Z</TimeStamp>
        </InstanceMonitorData>
    </MonitorData>
</DescribeInstanceMonitorDataResponse>

JSON format

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

{
  "RequestId" : "C8B26B44-0189-443E-9816-D951F59623A9",
  "MonitorData" : {
    "InstanceMonitorData" : [ {
      "InstanceId" : "i-bp1a36962lrhj4ab****",
      "CPU" : 0,
      "IntranetRX" : 122,
      "IntranetTX" : 343,
      "IntranetFlow" : 675,
      "IntranetBandwidth" : 10,
      "InternetRX" : 122,
      "InternetTX" : 343,
      "InternetFlow" : 675,
      "InternetBandwidth" : 10,
      "IOPSRead" : 1000,
      "IOPSWrite" : 13585,
      "BPSRead" : 1000,
      "BPSWrite" : 200,
      "TimeStamp" : "2014-10-30T05:00:00Z"
    } ]
  }
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidEndTime.Malformed	The specified parameter "EndTime" is not valid.	La valeur EndTime n'est pas valide.
400	InvalidParameter.TooManyDataQueried	Too many data queried.	Le nombre maximal de données de surveillance pouvant être interrogées est dépassé.
400	Throttling	Request was denied due to request throttling.	La requête est refusée en raison d'une limitation de débit.
400	InvalidStartTime.ValueNotSupported	The specified parameter StartTime is later than EndTime.	L'heure de fin ne peut pas être antérieure à l'heure de début.
500	InternalError	The request processing has failed due to some unknown error.	Une erreur interne s'est produite. Réessayez ultérieurement.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	L'ID de l'instance est introuvable.

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