DescribeRiskEventGroup - - Centre de documentation Alibaba Cloud

Obtient les détails des événements de prévention des intrusions.

Description de l'opération

Vous pouvez utiliser cette opération pour interroger et télécharger les détails des événements de prévention des intrusions. Nous vous recommandons d'interroger 5 à 10 entrées à la fois. Pour éviter les délais d'attente des requêtes, définissez le paramètre NoLocation sur true si vous n'avez pas besoin des informations de géolocalisation IP.

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.

yundun-cloudfirewall:DescribeRiskEventGroup

list

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Lang	string	Non	La langue de la requête et de la réponse. Valeurs valides : zh (par défaut) : chinois. en : anglais.	zh
Lang	string	Non	La langue de la requête et de la réponse. Valeurs valides :\n\n- zh (par défaut) : chinois.\n\n- en : anglais.	zh
StartTime	string	Oui	Le début de la plage horaire à interroger. La valeur est un horodatage UNIX. Unité : secondes.	1534408189
EndTime	string	Oui	La fin de la plage horaire à interroger. La valeur est un horodatage UNIX. Unité : secondes.	1534408267
Direction	string	Non	La direction du trafic de l'événement de prévention des intrusions. Valeurs valides : in : entrant out : sortant Remarque Si vous ne définissez pas ce paramètre, les événements de toutes les directions de trafic sont interrogés.	in
PageSize	string	Non	Le nombre d'entrées à renvoyer par page. Valeur par défaut : 6. Valeur maximale : 10.	6
CurrentPage	string	Non	Le numéro de page des données retournées.	1
DataType	string	Oui	Le type d'événement de risque. Définissez la valeur sur session, qui indique les événements de prévention des intrusions.	session
RuleSource	string	Non	La source de la règle utilisée pour détecter l'événement de prévention des intrusions. Valeurs valides : 1 : protection de base 2 : correctif virtuel 4 : renseignement sur les menaces Remarque Si vous ne définissez pas ce paramètre, les événements détectés sur la base de tous les types de règles sont interrogés.	1
RuleResult	string	Non	L'état de traitement de Cloud Firewall. Valeurs valides : 1 : Alerte 2 : Blocage Remarque Si vous ne définissez pas ce paramètre, les événements de tous les états de traitement sont interrogés.	1
SrcIP	string	Non	L'adresse IP source à interroger. Si vous définissez ce paramètre, seuls les événements de prévention des intrusions contenant l'adresse IP source spécifiée sont interrogés.	192.0.XX.XX
DstIP	string	Non	L'adresse IP de destination à interroger. Si vous définissez ce paramètre, seuls les événements de prévention des intrusions contenant l'adresse IP de destination spécifiée sont interrogés.	192.0.XX.XX
VulLevel	string	Non	Le niveau de risque de l'événement de prévention des intrusions. Valeurs valides : 1 : faible 2 : moyen 3 : élevé Remarque Si vous ne définissez pas ce paramètre, les événements de tous les niveaux de risque sont interrogés.	1
FirewallType	string	Non	Le type de pare-feu. Valeurs valides : VpcFirewall : pare-feu VPC InternetFirewall (par défaut) : pare-feu Internet	InternetFirewall
SrcNetworkInstanceId	string	Non	L'identifiant du VPC source. Remarque Ce paramètre est requis uniquement lorsque FirewallType est défini sur VpcFirewall.	vpc-uf6e9a9zyokj2ywuo****
DstNetworkInstanceId	string	Non	L'identifiant du VPC de destination. Remarque Ce paramètre est requis uniquement lorsque FirewallType est défini sur VpcFirewall.	vpc-uf6e9a9zyokj2ywuo****
AttackType	string	Non	Le type d'attaque. Valeurs valides : 1 : connexion anormale 2 : exécution de commande 3 : attaque par force brute 4 : analyse 5 : autre 6 : fuite d'informations 7 : attaque DoS 8 : attaque par dépassement 9 : attaque Web 10 : cheval de Troie à porte dérobée 11 : virus ou ver 12 : comportement de minage 13 : shell inversé Remarque Si vous ne définissez pas ce paramètre, les événements de tous les types d'attaque sont interrogés.	1
NoLocation	string	Non	Indique si les informations de localisation de l'adresse IP doivent être récupérées. Valeurs valides : true : ne récupère pas les informations de géolocalisation de l'adresse IP. false (par défaut) : récupère les informations de géolocalisation de l'adresse IP.	false
AttackApp	array	Non	Une liste des noms des applications attaquées. Utilisez le format `["AttackApp1","AttackApp2"]`.	["MySql","DNS"]
	string	Non	Le nom de l'application attaquée.	Redis
BuyVersion	integer	Non	L'édition de Cloud Firewall. Valeurs valides : 2 : Édition Premium 3 : Édition Entreprise 4 : Édition Ultime 10 : paiement à l'usage	10
Sort	string	Non	Le champ à utiliser pour le tri. Valeurs valides : VulLevel (par défaut) : Trie par niveau de risque. LastTime : Trie par heure d'occurrence la plus récente.	LastTime
Order	string	Non	L'ordre de tri. Valeurs valides : asc : croissant desc (par défaut) : décroissant	desc
EventName	string	Non	Le nom de l'événement de prévention des intrusions.	communication de porte dérobée de cheval de Troie
IsOnlyPrivateAssoc	string	Non	Indique si seules les données associées à des adresses IP privées doivent être interrogées.	true
AttackAppCategory	array	Non	Une liste des catégories des applications attaquées. Utilisez le format ["AttackAppCategory1","AttackAppCategory2"].
	string	Non	La catégorie de l'application attaquée.	Composant IA

En plus des paramètres de requête précédents, vous devez spécifier les paramètres de requête communs lors de l'appel de cette opération. Pour plus d'informations sur les paramètres de requête communs, consultez Paramètres communs. Pour le format de la requête, consultez l'exemple de requête dans la section Exemples de cette rubrique.

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les détails des événements de prévention des intrusions.
TotalCount	integer	Le nombre total d'événements à risque.	20
RequestId	string	L'identifiant de la requête.	B14757D0-4640-4B44-AC67-7F558FE7E6EF
DataList	array<object>	La liste des données renvoyées.
	array<object>	La liste des données renvoyées.
Direction	string	La direction du trafic de l'événement de prévention des intrusions. Valeurs valides : in : entrant out : sortant	in
EventName	string	Le nom de l'événement de prévention des intrusions.	Attaque par traversée de répertoire Web
DstIP	string	L'adresse IP de destination. L'événement de prévention des intrusions contient cette adresse IP de destination.	192.0.XX.XX
AttackType	integer	Le type d'attaque. Valeurs valides : 1 : connexion anormale 2 : exécution de commande 3 : attaque par force brute 4 : analyse 5 : autre 6 : fuite d'informations 7 : attaque DoS 8 : attaque par débordement 9 : attaque Web 10 : cheval de Troie à porte dérobée 11 : virus ou ver 12 : comportement de minage 13 : shell inversé	1
Tag	string	La balise pour la prise en charge des événements majeurs.	test-tag
RuleId	string	L'identifiant de la règle utilisée pour contrer l'événement de prévention des intrusions.	1000****
EventId	string	L'identifiant de l'événement de prévention des intrusions.	2b58efae-4c4b-4d96-9544-a586fb1f****
ResourceType	string	Le type d'adresse IP publique. Valeurs valides : EIP : une adresse IP élastique (EIP) EcsPublicIP : une adresse IP publique ECS EcsEIP : une EIP ECS NatPublicIP : une adresse IP publique NAT NatEIP : une EIP NAT SlbPublicIp : une adresse IP publique SLB	EcsPublicIP
FirstEventTime	integer	L'heure à laquelle l'événement d'intrusion s'est produit pour la première fois. La valeur est un horodatage UNIX. Unité : secondes.	1534408189
Description	string	La description de l'événement de prévention des intrusions.	Une attaque par traversée de répertoire a été détectée dans les accès Web pour les requêtes HTTP
EventCount	integer	Le nombre d'événements de prévention des intrusions.	100
VulLevel	integer	Le niveau de risque de l'événement de prévention des intrusions. Valeurs valides : 1 : faible 2 : moyen 3 : élevé	1
AttackApp	string	Le nom de l'application attaquée.	MySql
RuleSource	integer	La source de la règle utilisée pour détecter l'événement de prévention des intrusions. Valeurs valides : 1 : protection de base 2 : correctif virtuel 4 : renseignements sur les menaces	1
RuleResult	integer	Le statut de traitement. Valeurs valides :	2
SrcIP	string	L'adresse IP source. L'événement de prévention des intrusions contient cette adresse IP source.	192.0.XX.XX
LastEventTime	integer	L'heure à laquelle l'événement de prévention des intrusions s'est produit pour la dernière fois. La valeur est un horodatage UNIX. Unité : secondes.	1534408267
ResourcePrivateIPList	array<object>	Les informations relatives à l'adresse IP privée dans l'événement de prévention des intrusions. La valeur est un tableau composé des paramètres RegionNo, ResourceInstanceId, ResourceInstanceName et ResourcePrivateIP. RegionNo indique l'identifiant de la région de l'adresse IP. ResourceInstanceId indique l'identifiant de l'instance à laquelle l'adresse IP appartient. ResourceInstanceName indique le nom de l'instance à laquelle l'adresse IP appartient. ResourcePrivateIP indique l'adresse IP.
	object	Les informations relatives à l'adresse IP privée dans l'événement de prévention des intrusions. La valeur est un tableau composé des paramètres RegionNo, ResourceInstanceId, ResourceInstanceName et ResourcePrivateIP. RegionNo indique l'identifiant de la région de l'adresse IP. ResourceInstanceId indique l'identifiant de l'instance à laquelle l'adresse IP appartient. ResourceInstanceName indique le nom de l'instance à laquelle l'adresse IP appartient. ResourcePrivateIP indique l'adresse IP.
ResourceInstanceName	string	The name of the instance.	LD-shenzhen-zy****
ResourcePrivateIP	string	The private IP address.	10.255.XX.XX
ResourceInstanceId	string	The ID of the instance.	i-wz92jf4scg2zb74p****
RegionNo	string	The region ID. This parameter indicates the region ID of the private IP address.	cn-hangzhou
SrcPrivateIPList	array	La liste des adresses IP privées sources dans l'événement de prévention des intrusions.
	string	L'adresse IP privée source dans l'événement de prévention des intrusions. Remarque Ce paramètre est renvoyé uniquement pour le trafic sortant.	["192.168.XX.XX","192.168.XX.XX"]
VpcSrcInfo	object	Les informations relatives au VPC source de l'événement de prévention des intrusions. Cette structure contient les paramètres EcsInstanceId, EcsInstanceName, NetworkInstanceId, NetworkInstanceName et RegionNo. EcsInstanceId indique l'identifiant de l'instance ECS dans le VPC. EcsInstanceName indique le nom de l'instance ECS dans le VPC. NetworkInstanceId indique l'identifiant du VPC. NetworkInstanceName indique le nom du VPC. RegionNo indique l'identifiant de la région du VPC.
EcsInstanceName	string	The name of the ECS instance.	LD-shenzhen-zy****
NetworkInstanceName	string	The name of the VPC.	VPC-SH-TX****
NetworkInstanceId	string	The ID of the VPC.	vpc-uf6e9a9zyokj2ywuo****
EcsInstanceId	string	The ID of the ECS instance.	i-wz92jf4scg2zb74p****
RegionNo	string	The region ID. This parameter indicates the region ID of the source VPC.	cn-hangzhou
VpcDstInfo	object	Les informations relatives au VPC de destination de l'événement de prévention des intrusions. Cette structure contient les paramètres EcsInstanceId, EcsInstanceName, NetworkInstanceId, NetworkInstanceName et RegionNo. EcsInstanceId indique l'identifiant de l'instance ECS dans le VPC. EcsInstanceName indique le nom de l'instance ECS dans le VPC. NetworkInstanceId indique l'identifiant du VPC. NetworkInstanceName indique le nom du VPC. RegionNo indique l'identifiant de la région du VPC.
EcsInstanceName	string	The name of the ECS instance.	LD-shenzhen-zy****
NetworkInstanceName	string	The name of the VPC.	VPC-SH-TX****
NetworkInstanceId	string	The ID of the VPC.	vpc-uf6e9a9zyokj2ywuo****
EcsInstanceId	string	The ID of the ECS instance.	i-wz92jf4scg2zb74p****
RegionNo	string	The region ID. This parameter indicates the region ID of the destination VPC.	cn-hangzhou
IPLocationInfo	object	Les informations de géolocalisation de l'adresse IP. Cette structure contient les paramètres CityId, CityName, CountryId et CountryName. CityId indique l'identifiant de la ville de l'adresse IP. CityName indique le nom de la ville de l'adresse IP. CountryId indique l'identifiant du pays de l'adresse IP. CountryName indique le nom du pays de l'adresse IP.
CityId	string	The city ID.	510100
CountryName	string	The country name.	China
CityName	string	The city name.	Chengdu
CountryId	string	The country ID.	CN
SrcIPTag `deprecated`	string	La balise de l'adresse IP source. Cette balise est utilisée pour identifier si l'adresse IP est une adresse IP de retour à l'origine d'un service Alibaba Cloud.	Adresse de retour à l'origine WAF
SrcIPTags	array	La liste des balises d'adresses IP.
	string	La balise d'adresse IP.	Adresse de retour à l'origine Anti-DDoS

Exemples

JSON format

{
  "TotalCount": 20,
  "RequestId": "B14757D0-4640-4B44-AC67-7F558FE7E6EF",
  "DataList": [
    {
      "Direction": "in",
      "EventName": "Web Directory Traversal Attack",
      "DstIP": "192.0.XX.XX",
      "AttackType": 1,
      "Tag": "test-tag",
      "RuleId": "1000****",
      "EventId": "2b58efae-4c4b-4d96-9544-a586fb1f****",
      "ResourceType": "EcsPublicIP",
      "FirstEventTime": 1534408189,
      "Description": "A directory traversal attack was detected in Web access for HTTP requests",
      "EventCount": 100,
      "VulLevel": 1,
      "AttackApp": "MySql",
      "RuleSource": 1,
      "RuleResult": 2,
      "SrcIP": "192.0.XX.XX",
      "LastEventTime": 1534408267,
      "ResourcePrivateIPList": [
        {
          "ResourceInstanceName": "LD-shenzhen-zy****",
          "ResourcePrivateIP": "10.255.XX.XX",
          "ResourceInstanceId": "i-wz92jf4scg2zb74p****",
          "RegionNo": "cn-hangzhou"
        }
      ],
      "SrcPrivateIPList": [
        "[\"192.168.XX.XX\",\"192.168.XX.XX\"]"
      ],
      "VpcSrcInfo": {
        "EcsInstanceName": "LD-shenzhen-zy****",
        "NetworkInstanceName": "VPC-SH-TX****",
        "NetworkInstanceId": "vpc-uf6e9a9zyokj2ywuo****",
        "EcsInstanceId": "i-wz92jf4scg2zb74p****",
        "RegionNo": "cn-hangzhou"
      },
      "VpcDstInfo": {
        "EcsInstanceName": "LD-shenzhen-zy****",
        "NetworkInstanceName": "VPC-SH-TX****",
        "NetworkInstanceId": "vpc-uf6e9a9zyokj2ywuo****",
        "EcsInstanceId": "i-wz92jf4scg2zb74p****",
        "RegionNo": "cn-hangzhou"
      },
      "IPLocationInfo": {
        "CityId": "510100",
        "CountryName": "China",
        "CityName": "Chengdu",
        "CountryId": "CN"
      },
      "SrcIPTag": "WAF Back-to-origin Address",
      "SrcIPTags": [
        "Anti-DDoS Back-to-origin Address"
      ]
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	ErrorAliUid	Aliuid invalid.	The aliuid is invalid.
400	ErrorFirewallType	The specified firewall type is invalid.	The firewall type of traffic log is invalid.
400	ErrorParameters	A parameter error occurred.	A parameter error occurred.
400	ErrorDirectionError	The direction is invalid.	The direction is invalid.
400	ErrorIpFormat	The IP address is invalid.	The IP address is invalid.
400	ErrorRuleSourceError	The rule source is invalid.	The rule source is invalid.
400	ErrorRuleResultError	The rule result is invalid.	The rule result is invalid.
400	ErrorVulLevelFailed	VulLevel has failed.	VulLevel has failed.
400	ErrorTimeError	time range invalid.	The specified time is invalid. Select again.
400	ErrorIntervalError	The interval is invalid.	The interval is invalid.
400	ErrorPageNo	Either page number or page size is invalid.	Either page number or page size is invalid.
400	ErrorDBSelectError	A database select error occurred.	The error message returned because an internal error has occurred in querying the database.
400	ErrorMarshalJSON	internal error.	Internal error.

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

Notes de version

Consultez Notes de version pour la liste complète.