DescribeDiskMonitorData - Elastic Compute Service - Centre de documentation Alibaba Cloud

Consulte les informations d'utilisation d'un disque sur une période spécifiée, telles que les IOPS en lecture, les IOPS en écriture, la bande passante en lecture (o/s), la bande passante en écriture (o/s), la latence en lecture (μs) et la latence en écriture (μs).

Description de l'opération

Lors de l'appel de cette opération, prenez en compte les limites suivantes :

Vous pouvez uniquement consulter les informations d'utilisation des disques qui sont à l'état En cours d'utilisation (In_use). Pour plus d'informations, consultez États des disques.

Remarque
Si les informations renvoyées présentent du contenu manquant, cela signifie que le disque n'était pas à l'état En cours d'utilisation (In_use) pendant cette période, et les informations d'utilisation ne peuvent pas être obtenues.
Un maximum de 400 entrées de données peut être renvoyé à la fois. La valeur de (EndTime – StartTime) / Period doit être inférieure ou égale à 400. Autrement dit, la valeur du paramètre de réponse TotalCount ne peut pas dépasser 400. Sinon, l'erreur InvalidParameter.TooManyDataQueried est renvoyée.
Vous pouvez consulter les informations de surveillance des 30 derniers jours au maximum. Le paramètre StartTime spécifié ne peut pas être antérieur de plus de 30 jours à l'heure actuelle.

Exemple de requête

Supposons que vous souhaitiez consulter les informations d'utilisation d'un disque dont l'identifiant est d-bp14emm68wx98vjk**** dans la région Chine (Hangzhou) du 2025-02-17T00:00:00Z au 2025-02-18T10:00:00Z à des intervalles de 600 secondes. Configurez les paramètres de requête comme suit :

RegionId:"cn-hangzhou", // Définir la région Chine (Hangzhou)
DiskId:"d-bp14emm68wx98vjk****", // Définir l'identifiant du disque
StartTime:"2025-02-15T00:00:00Z", // Définir l'heure de début de la requête
EndTime:"2025-02-17T00:00:00Z", // Définir l'heure de fin de la requête
Period:"600", // Définir la granularité des données

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ecs:DescribeDiskMonitorData

get

*Disk

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
DiskId	string	Oui	L'identifiant du disque à interroger.	d-bp1bq5g3dxxo1x4o****
StartTime	string	Oui	L'heure de début des données. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC. Si la valeur des secondes (ss) n'est pas 00, l'heure de début est automatiquement définie au début de la minute suivante. Remarque Vous pouvez consulter les informations de surveillance des 30 derniers jours au maximum. Le paramètre `StartTime` ne peut pas être antérieur de plus de 30 jours à l'heure actuelle.	2014-07-23T12:07:00Z
EndTime	string	Oui	L'heure de fin des données. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC. Si la valeur des secondes (ss) n'est pas 00, l'heure de fin est automatiquement définie au début de la minute suivante.	2014-07-23T12:09:00Z
Period	integer	Non	La granularité des données. Unité : secondes. Valeurs valides : Valeur par défaut : 60. Remarque La valeur de (EndTime – StartTime) / Period doit être inférieure ou égale à 400. Un maximum de 400 entrées de données peut être renvoyé à la fois.	60

Éléments de réponse

Élément	Type	Description	Exemple
	object
TotalCount	integer	Le nombre d'entrées renvoyées pour les informations d'utilisation du disque, qui correspond au nombre de périodes.	3
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
MonitorData	object
DiskMonitorData	array<object>	L'ensemble des données de surveillance du disque.
	object	L'ensemble des données de surveillance du disque.
BPSRead	integer	The read bandwidth of the cloud disk. Unit: byte/s.	0
IOPSRead	integer	The number of read I/O operations on the cloud disk per second. Unit: operations/s.	0
LatencyRead	integer	The read latency of the cloud disk. Unit: μs (microseconds).	0
BPSTotal	integer	The total read and write bandwidth of the cloud disk. Unit: byte/s.	204
IOPSTotal	integer	The total number of read and write I/O operations on the cloud disk per second. Unit: operations/s.	0
TimeStamp	string	The timestamp of the monitoring data. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.	2014-07-23T12:07:00Z
LatencyWrite	integer	The write latency of the cloud disk. Unit: μs (microseconds).	0
IOPSWrite	integer	The number of write I/O operations on the cloud disk per second. Unit: operations/s.	0
DiskId	string	The ID of the cloud disk.	d-bp1bq5g3dxxo1x4o****
BPSWrite	integer	The write bandwidth of the cloud disk. Unit: byte/s.	204

Exemples

JSON format

{
  "TotalCount": 3,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "MonitorData": {
    "DiskMonitorData": [
      {
        "BPSRead": 0,
        "IOPSRead": 0,
        "LatencyRead": 0,
        "BPSTotal": 204,
        "IOPSTotal": 0,
        "TimeStamp": "2014-07-23T12:07:00Z",
        "LatencyWrite": 0,
        "IOPSWrite": 0,
        "DiskId": "d-bp1bq5g3dxxo1x4o****",
        "BPSWrite": 204
      }
    ]
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidStartTime.Malformed	The specified parameter "StartTime" is not valid.	The specified StartTime parameter does not conform to the specification.
400	InvalidEndTime.Malformed	The specified parameter "EndTime" is not valid.	The specified EndTime parameter is invalid.
400	InvalidPeriod.ValueNotSupported	The specified parameter "Period" is not valid.
400	InvalidStartTime.TooEarly	The specified parameter "StartTime" is too early.
400	InvalidParameter.TooManyDataQueried	Too many data queried.	The monitoring data node is out of range.
400	Throttling	Request was denied due to request throttling.	The request is throttled. Use the NextToken-based pagination method instead of the PageNumber-based pagination method.
400	InvalidInstanceType.NotSupportCredit	The InstanceType of the specified instance does not support credit.	The instance type does not support burstable instances.
400	InvalidParameter.EndTime	The specified parameter EndTime is earlier than StartTime.	The end time cannot be earlier than the start time.
500	InternalError	The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
404	InvalidDiskId.NotFound	The DiskId provided does not exist in our records.	The specified disk does not exist. Check whether the disk ID is correct.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.