DescribeDiskMonitorData - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Les données de surveillance incluent les IOPS en lecture, les IOPS en écriture, la bande passante en lecture (octets/s), la bande passante en écriture (octets/s), la latence en lecture (μs) et la latence en écriture (μs) du disque.

Tenez compte des points suivants :

Vous ne pouvez interroger les données de surveillance que pour les disques dont l'état est En cours d'utilisation (In_Use). Pour plus d'informations, consultez la rubrique États des disques.

Remarque
Certaines informations peuvent manquer dans les données de surveillance d'un disque si celui-ci n'est pas dans l'état En cours d'utilisation (

In_Use

), car le système ne peut pas obtenir les informations pertinentes.
Le système renvoie au maximum 400 entrées de données de surveillance par requête. Une erreur survient si la valeur calculée selon 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 de StartTime est antérieure de plus de 30 jours à l'heure actuelle, une erreur est renvoyée.

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	DescribeDiskMonitorData	L'opération à effectuer. Définissez la valeur sur DescribeDiskMonitorData.
DiskId	String	Yes	d-bp1bq5g3dxxo1x4o****	L'ID du disque.
StartTime	String	Yes	2014-07-23T12:07:00Z	Le début de la plage de temps à interroger. Spécifiez l'heure au format ISO 8601 (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-07-23T12:09:00Z	La fin de la plage de temps à interroger. Spécifiez l'heure au format ISO 8601 (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 de récupération des 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
TotalCount	Integer	3	Le nombre total d'entrées de données de surveillance renvoyées.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	L'ID de la requête.
MonitorData	Array of DiskMonitorData		Les données de surveillance du disque.
DiskMonitorData
BPSRead	Integer	0	La bande passante en lecture du disque système. Unité : octets/s.
IOPSRead	Integer	0	Le nombre d'IOPS en lecture sur le disque système.
LatencyRead	Integer	0	La latence en lecture du disque. Unité : μs.
BPSTotal	Integer	204	La bande passante totale en lecture et en écriture du disque système. Unité : octets/s.
IOPSTotal	Integer	0	Le nombre total d'IOPS en lecture et en écriture sur le disque système.
TimeStamp	String	2014-07-23T12:07:00Z	L'horodatage des données surveillées. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
LatencyWrite	Integer	0	La latence en écriture du disque. Unité : μs.
IOPSWrite	Integer	0	Le nombre d'IOPS en écriture sur le disque système.
DiskId	String	d-bp1bq5g3dxxo1x4o****	L'ID du disque.
BPSWrite	Integer	204	La bande passante en écriture du disque système. Unité : octets/s.

Exemples

Exemple de requête

https://ecs.aliyuncs.com/?Action=DescribeDiskMonitorData
&DiskId=d-bp1bq5g3dxxo1x4o****
&EndTime=2014-07-23T12:09:00Z
&StartTime=2014-07-23T12:07:00Z
&Period=60
&<Common request parameters>

Exemple de réponse réussie

XML format

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

<DescribeDiskMonitorDataResponse>
        <MonitorData>
                <DiskMonitorData>
                        <BPSRead>0</BPSRead>
                        <BPSTotal>0</BPSTotal>
                        <BPSWrite>0</BPSWrite>
                        <DiskId>d-bp1bq5g3dxxo1x4o****</DiskId>
                        <IOPSRead>0</IOPSRead>
                        <IOPSTotal>0</IOPSTotal>
                        <IOPSWrite>0</IOPSWrite>
                        <TimeStamp>2014-07-23T12:07:00Z</TimeStamp>
                </DiskMonitorData>
                <DiskMonitorData>
                        <BPSRead>0</BPSRead>
                        <BPSTotal>204</BPSTotal>
                        <BPSWrite>204</BPSWrite>
                        <DiskId>d-bp1bq5g3dxxo1x4o****</DiskId>
                        <IOPSRead>0</IOPSRead>
                        <IOPSTotal>0</IOPSTotal>
                        <IOPSWrite>0</IOPSWrite>
                        <TimeStamp>2014-07-23T12:08:00Z</TimeStamp>
                </DiskMonitorData>
                <DiskMonitorData>
                        <BPSRead>0</BPSRead>
                        <BPSTotal>819</BPSTotal>
                        <BPSWrite>819</BPSWrite>
                        <DiskId>d-bp1bq5g3dxxo1x4o****</DiskId>
                        <IOPSRead>0</IOPSRead>
                        <IOPSTotal>0</IOPSTotal>
                        <IOPSWrite>0</IOPSWrite>
                        <TimeStamp>2014-07-23T12:09:00Z</TimeStamp>
                </DiskMonitorData>
        </MonitorData>
        <RequestId>BF666447-B171-4076-BCBA-48437C18FD76</RequestId>
        <TotalCount>3</TotalCount>
</DescribeDiskMonitorDataResponse>

JSON format

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

{
  "MonitorData" : {
    "DiskMonitorData" : [ {
      "BPSRead" : 0,
      "BPSTotal" : 0,
      "BPSWrite" : 0,
      "DiskId" : "d-bp1bq5g3dxxo1x4o****",
      "IOPSRead" : 0,
      "IOPSTotal" : 0,
      "IOPSWrite" : 0,
      "TimeStamp" : "2014-07-23T12:07:00Z"
    }, {
      "BPSRead" : 0,
      "BPSTotal" : 204,
      "BPSWrite" : 204,
      "DiskId" : "d-bp1bq5g3dxxo1x4o****",
      "IOPSRead" : 0,
      "IOPSTotal" : 0,
      "IOPSWrite" : 0,
      "TimeStamp" : "2014-07-23T12:08:00Z"
    }, {
      "BPSRead" : 0,
      "BPSTotal" : 819,
      "BPSWrite" : 819,
      "DiskId" : "d-bp1bq5g3dxxo1x4o****",
      "IOPSRead" : 0,
      "IOPSTotal" : 0,
      "IOPSWrite" : 0,
      "TimeStamp" : "2014-07-23T12:09:00Z"
    } ]
  },
  "RequestId" : "A48A0A77-34F5-4C33-9066-9E8D2DA0D8E2",
  "TotalCount" : 3
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidEndTime.Malformed	The specified parameter "EndTime" is not valid.	Valeur EndTime non 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	InvalidInstanceType.NotSupportCredit	The InstanceType of the specified instance does not support credit.	Le type d'instance ne prend pas en charge les instances à performance variable.
400	InvalidParameter.EndTime	The specified parameter EndTime is earlier than StartTime.	L'heure de fin spécifiée est antérieure à l'heure de début spécifiée.
404	InvalidDiskId.NotFound	The DiskId provided does not exist in our records.	Le disque spécifié est introuvable. Vérifiez la validité de l'ID du disque.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Une erreur interne s'est produite. Réessayez ultérieurement.

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