DescribeEvents - - Centre de documentation Alibaba Cloud

Consulte les événements de risque des disques cloud.

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.

ebs:DescribeEvents

none

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région. Vous pouvez appeler DescribeRegions pour consulter la liste des régions prises en charge par EBS Lens.	cn-hangzhou
EventName	string	Non	Le nom de l'événement. Valeurs valides : NoSnapshot : protection des données BurstIOTriggered : E/S en rafale CostOptimizationNeeded : optimisation des coûts DiskSpecNotMatchedWithInstance : incompatibilité entre les spécifications de l'instance et du disque DiskIONo4kAligned : lecture/écriture non alignée sur 4K DiskIOHang : blocage des E/S du disque survenu InstanceIOPSExceedInstanceMaxLimit : les IOPS de l'instance ont atteint la limite supérieure InstanceBPSExceedInstanceMaxLimit : le BPS de l'instance a atteint la limite supérieure DiskIOPSExceedInstanceMaxLimit : les IOPS du disque ont atteint la limite supérieure de l'instance DiskBPSExceedInstanceMaxLimit : le BPS du disque a atteint la limite supérieure de l'instance DiskIOPSExceedDiskMaxLimit : les IOPS du disque ont atteint la limite supérieure du disque DiskBPSExceedDiskMaxLimit : le BPS du disque a atteint la limite supérieure du disque	DiskIOHang
ResourceId	string	Non	L'identifiant de la ressource.	d-bp67acfmxazb4p****
ResourceType	string	Non	Le type de ressource. Valeurs valides : disk : disque cloud	disk
Status	string	Non	L'état de l'événement. Valeurs valides : WillExecute : en attente Executing : en cours de traitement Executed : traité Ignore : ignoré Expired : expiré Deleted : supprimé	WillExecute
StartTime	string	Non	L'heure de début de l'événement. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC.	2023-06-01T03:00:00Z
EndTime	string	Non	L'heure de fin de l'événement. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC.	2023-06-01T04:00:00Z
MaxResults	integer	Non	Le nombre maximal d'entrées par page pour une requête paginée. Si vous spécifiez ce paramètre, les paramètres MaxResults et NextToken sont utilisés ensemble pour la requête. Valeurs valides : 1 à 100. Valeur par défaut : 10.	10
NextToken	string	Non	Le jeton de pagination. Définissez ce paramètre sur la valeur NextToken renvoyée lors de l'appel d'API précédent.	AAAAAdDWBF2****
EventLevel	string	Non	Le niveau de l'événement. Valeurs valides : INFO : Notification. WARN : Avertissement. CRITICAL : Critique.	WARN

Éléments de réponse

Élément	Type	Description	Exemple
	object	Schéma de la réponse.
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
TotalCount	integer	Le nombre total d'entrées renvoyées pour la requête paginée.	1
NextToken	string	Le jeton pour la requête suivante. Si NextToken est vide, il n'y a plus de résultats.	AAAAAdDWBF2****
ResourceEvents	array<object>	La liste des événements.
	object
EventType	string	Le type d'événement. Valeurs valides : Notification SystemException Alert	Alert
EventName	string	Le nom de l'événement. Valeurs valides : NoSnapshot : protection des données BurstIOTriggered : E/S en rafale CostOptimizationNeeded : optimisation des coûts DiskSpecNotMatchedWithInstance : incompatibilité entre les spécifications de l'instance et du disque DiskIONo4kAligned : lecture/écriture non alignée sur 4K DiskIOHang : blocage des E/S du disque survenu InstanceIOPSExceedInstanceMaxLimit : les IOPS de l'instance ont atteint la limite supérieure InstanceBPSExceedInstanceMaxLimit : le BPS de l'instance a atteint la limite supérieure DiskIOPSExceedInstanceMaxLimit : les IOPS du disque ont atteint la limite supérieure de l'instance DiskBPSExceedInstanceMaxLimit : le BPS du disque a atteint la limite supérieure de l'instance DiskIOPSExceedDiskMaxLimit : les IOPS du disque ont atteint la limite supérieure du disque DiskBPSExceedDiskMaxLimit : le BPS du disque a atteint la limite supérieure du disque	DiskIOHang
ResourceId	string	L'identifiant de la ressource.	d-bp67acfmxazb4p****
ResourceType	string	Le type de ressource.	disk
Status	string	L'état de l'événement. Valeurs valides : WillExecute : en attente Executing : en cours de traitement Executed : traité Ignore : ignoré Expired : expiré Deleted : supprimé	WillExecute
StartTime	string	L'heure de début de l'événement. Cette valeur est un horodatage en millisecondes.	1684204822000
Description	string	La description de l'événement.	Vous pouvez acheter 4 296 IOPS provisionnées pour optimiser les coûts. Sur la base de votre utilisation au cours des 7 derniers jours, les coûts devraient diminuer de 16 %
RecommendAction	string	L'action recommandée après la survenue de l'événement. Valeurs valides : ModifyDiskSpec : modifier les spécifications du disque CreateSnapshot : créer un instantané ResizeDisk : étendre la capacité du disque AdjustProvision : ajuster les performances provisionnées ModifyInstanceSpec : modifier les spécifications de l'instance	AdjustProvision
RecommendParams	string	Les paramètres de l'action recommandée après la survenue de l'événement.	4296
EventLevel	string	Le niveau de l'événement. Valeurs valides : INFO WARN CRITICAL	INFO
EndTime	string	L'heure de fin de l'événement. Cette valeur est un horodatage en millisecondes.	1679538083000
ExtraAttributes	string	Les propriétés supplémentaires. Champs possibles : EcsInstanceId : l'identifiant de l'instance ECS à laquelle le disque cloud est attaché. Adapter : le point de montage du disque cloud.	{\"EcsInstanceId\":\"i-uf6dkn9qpcw6y94g7ag7\",\"Adapter\":\"hda\"}

Exemples

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "TotalCount": 1,
  "NextToken": "AAAAAdDWBF2****",
  "ResourceEvents": [
    {
      "EventType": "Alert",
      "EventName": "DiskIOHang",
      "ResourceId": "d-bp67acfmxazb4p****",
      "ResourceType": "disk",
      "Status": "WillExecute",
      "StartTime": "1684204822000",
      "Description": "Vous pouvez acheter 4296 IOPS préprovisionnés pour optimiser les coûts. Selon votre utilisation au cours des 7 derniers jours, le coût devrait diminuer de 16 %",
      "RecommendAction": "AdjustProvision",
      "RecommendParams": "4296",
      "EventLevel": "INFO",
      "EndTime": "1679538083000",
      "ExtraAttributes": "{\\\"EcsInstanceId\\\":\\\"i-uf6dkn9qpcw6y94g7ag7\\\",\\\"Adapter\\\":\\\"hda\\\"}"
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	App.NumberExceed	The number of apps exceeded.	Le nombre d'applications a dépassé la limite.
400	DocumentConvertFailed.ExceedFileSizeLimit	The conversion has been failed, exceed file size limit.	Échec de la conversion du document. La taille du fichier dépasse la limite du système.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Des clés en double existent dans les balises. Veillez à ce que les clés de balise soient uniques.
400	IdempotentParameterMismatch	The specified parameter has changed while using an already used clientToken.	Un ClientToken précédemment utilisé a été fourni, mais d'autres paramètres de requête ont changé.
400	InvalidDiskSize.NotSupported	The specified parameter size is not valid.	La taille de disque cloud spécifiée n'est pas prise en charge.
400	InvalidParameter	The parameter %s is invalid.	Paramètre non valide.
400	InvalidParameter.Conflict	The specified parameter %s and %s are not blank at the same time.	Conflit de paramètres.
400	InvalidParameter.EndTime	The specified parameter EndTime is earlier than StartTime.	Le paramètre EndTime est antérieur à StartTime.
400	InvalidParameter.Format	Specified parameter format is not valid.	Le format de retour n'est pas valide (le format spécifié n'est pas pris en charge). Les formats de retour pris en charge sont XML et JSON. Le format par défaut est XML.
400	InvalidParameter.TooManyDataQueried	Too many data queried.	Trop de données interrogées dans la requête.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Une erreur interne s'est produite.
403	AliCroup2CloudUserCannotBuyNotInnerCommodity	There is no group cloud commodity label, and users within the group are not allowed to purchase.	Aucune balise de produit cloud de groupe n'existe. Les utilisateurs internes du groupe ne sont pas autorisés à effectuer d'achats.
403	Forbidden	User is not authorized to operate.	L'utilisateur actuel ne dispose pas des autorisations nécessaires pour effectuer des opérations sur cette ressource. Vérifiez les autorisations de votre compte ou contactez l'administrateur de votre compte principal.
403	Forbidden.Action	User is not authorized to operate this action.	L'utilisateur actuel ne dispose pas des autorisations nécessaires pour effectuer cette opération. Vérifiez les autorisations de votre compte ou contactez l'administrateur de votre compte principal.
403	IncorrectDiskStatus.CreatingSnapshot	A previous snapshot creation is in process.	Un instantané précédent est toujours en cours de création.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Le solde de votre compte est insuffisant.
403	InvalidDiskCategory.NotSupported	The specified disk category is not supported.	La catégorie de disque spécifiée n'est pas prise en charge pour cette opération. Vérifiez vos paramètres d'entrée et la documentation de l'API.
404	InvalidApi.NotFound	Specified api is not found, please check your url and method.
404	NoSuchResource	The specified resource does not exist.	La ressource spécifiée n'existe pas.
504	RequestTimeout	The request is timeout, please try again later.	La requête a expiré. Réessayez ultérieurement.

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

Notes de version

Consultez Notes de version pour la liste complète.