DescribeGroupedVul - Security Center - Centre de documentation Alibaba Cloud

Consulte les informations sur les vulnérabilités par groupe.

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-sas:DescribeGroupedVul

get

*All Resource

*

acs:ResourceGroupId

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Lang	string	Non	Le type de langue de la requête et de la réponse. Valeur par défaut : zh. Valeurs valides : zh : chinois en : anglais.	zh
Type	string	Non	Le type de vulnérabilité à interroger. Valeur par défaut : cve. Valeurs valides : cve : vulnérabilité logicielle Linux sys : vulnérabilité du système Windows cms : vulnérabilité Web-CMS app : vulnérabilité d'application (analyse réseau) sca : vulnérabilité d'application (analyse de composition logicielle).	cve.
Uuids	string	Non	Les UUID des serveurs à interroger. Séparez les UUID multiples par des virgules (,).	d42f938c-d962-48a0-90f9-05e4ea****
AliasName	string	Non	L'alias de la vulnérabilité à interroger.	RHSA-2019:0230-Important: polkit security update.
Necessity	string	Non	La priorité de correction de la vulnérabilité à interroger. Séparez les priorités multiples par des virgules (,). Valeurs valides : asap : élevée later : moyenne nntf : faible.	asap,later,nntf.
Dealed	string	Non	Indique si la vulnérabilité est traitée. Valeurs valides : y : traitée n : non traitée.	n
CurrentPage	integer	Non	Le numéro de la première page à afficher dans les résultats de la requête. Valeur par défaut : 1, ce qui indique que les résultats commencent à la page 1.	1
PageSize	integer	Non	Le nombre d'entrées de vulnérabilité par page dans une requête paginée. Valeur par défaut : 10, ce qui indique que 10 entrées de vulnérabilité sont affichées par page.	20
GroupId	string	Non	L'identifiant du groupe d'actifs.	235454
CveId	string	Non	L'identifiant CVE. Remarque Appelez l'opération DescribeVulListPage pour obtenir ce paramètre.	CVE-2017-15420
ContainerFieldName	string	Non	Le champ de recherche de conteneur. Valeurs valides : instanceId : identifiant de l'instance appName : nom de l'application clusterId : identifiant du cluster regionId : région nodeName : nom du nœud namespace : espace de noms clusterName : nom du cluster image : nom de l'image imageRepoName : nom du référentiel d'images imageRepoNamespace : espace de noms du référentiel d'images imageRepoTag : balise de l'image imageDigest : condensé de l'image.	appName.
ContainerFieldValue	string	Non	La valeur qui correspond à ContainerFieldName.	cc914b0df156d40148412afe4a581****
TargetType	string	Non	Le type de requête de conteneur. Valeurs valides : containerId : identifiant du conteneur uuid : identifiant de l'actif.	containerId.
ClusterId	string	Non	L'identifiant du cluster.	c88fb10da1168494091db6aafc5dd****
SearchTags	string	Non	Le libellé utilisé pour le filtrage. Valeurs valides : Restart required Remote utilization EXP exists Available Privilege escalation Code execution	Code Execution.
AttachTypes	string	Non	Le type de vulnérabilité. Cette condition de requête n'est valide que pour les vulnérabilités d'application. Séparez les valeurs multiples par des virgules (,). Valeurs valides : sca : vulnérabilité d'analyse de composition logicielle app : vulnérabilité d'application.	sca.
AssetType	string	Non	Le type d'actif sur lequel la vulnérabilité est détectée. Séparez les types multiples par des virgules (,). Valeurs valides : ECS : actif hôte CONTAINER : actif conteneur.	ECS,CONTAINER.
ResourceDirectoryAccountId	integer	Non	L'identifiant du compte Alibaba Cloud ajouté en tant que compte membre dans un dossier de ressources. Remarque Appelez l'opération DescribeMonitorAccounts pour obtenir ce paramètre.	127608589417****
RaspDefend	integer	Non	Indique si la fonction Runtime Application Self-Protection (RASP) prend en charge la protection en temps réel contre la vulnérabilité. Valeurs valides : 0 : Non prise en charge. 1 : Prise en charge.	1

Éléments de réponse

Élément	Type	Description	Exemple
	object	La réponse pour la consultation des informations sur les vulnérabilités par groupe.
CurrentPage	integer	Le numéro de la page actuelle dans une requête paginée.	1
RequestId	string	L'identifiant de la requête, qui est un identifiant unique généré par Alibaba Cloud pour la requête. Vous pouvez utiliser cet identifiant pour résoudre les problèmes.	9BFA6D78-07EA-5C0A-9358-E4434573507B.
PageSize	integer	Le nombre d'entrées de vulnérabilité par page dans une requête paginée. Valeur par défaut : 10, ce qui indique que 10 entrées de vulnérabilité sont affichées par page.	20
TotalCount	integer	Le nombre total de résultats de la requête.	1
GroupedVulItems	array<object>	Les informations sur les vulnérabilités renvoyées par la requête.
	object
Type	string	Le type de la vulnérabilité. Valeurs valides : cve : vulnérabilité logicielle Linux sys : vulnérabilité du système Windows cms : vulnérabilité Web-CMS app : vulnérabilité d'application emg : vulnérabilité d'urgence sca : analyse de composition logicielle.	cve.
NntfCount	integer	Le nombre de vulnérabilités avec une priorité de correction faible.	59
RaspDefend	integer	Indique si la protection en temps réel RASP est prise en charge. Valeurs valides : 0 : Non prise en charge. 1 : Prise en charge. Remarque Si cette propriété n'est pas présente, la protection en temps réel RASP n'est pas prise en charge.	1
HandledCount	integer	Le nombre de vulnérabilités traitées.	0
GmtFirst	integer	L'horodatage de la première détection de la vulnérabilité, en millisecondes.	1639371046000
GmtLast	integer	L'horodatage de la dernière détection de la vulnérabilité, en millisecondes.	1639371446000
Tags	string	Le libellé de la vulnérabilité. Valeurs valides : Restart required Remote utilization EXP exists Available Privilege escalation Code execution	Code Execution.
LaterCount	integer	Le nombre de vulnérabilités avec une priorité de correction moyenne.	0
AliasName	string	L'alias de la vulnérabilité.	RHSA-2017:0184-Important: mysql security update.
Name	string	Le nom de la vulnérabilité.	oval:com.redhat.rhsa:def:20170184
TotalFixCount	integer	Le nombre total de vulnérabilités corrigées.	0
AsapCount	integer	Le nombre de vulnérabilités avec une priorité de correction élevée.	0
Related	string	La liste des CVE associés à la vulnérabilité.	CVE-2023-24881,CVE-2023-24898
LanguageType	string	Le type de langage associé à la vulnérabilité. Valeurs valides : java php Remarque Ce paramètre s'applique uniquement aux vulnérabilités sca.	java.

Exemples

JSON format

{
  "CurrentPage": 1,
  "RequestId": "9BFA6D78-07EA-5C0A-9358-E4434573507B",
  "PageSize": 20,
  "TotalCount": 1,
  "GroupedVulItems": [
    {
      "Type": "cve",
      "NntfCount": 59,
      "RaspDefend": 1,
      "HandledCount": 0,
      "GmtFirst": 1639371046000,
      "GmtLast": 1639371446000,
      "Tags": "Code Execution",
      "LaterCount": 0,
      "AliasName": "RHSA-2017:0184-Important: mysql security update",
      "Name": "oval:com.redhat.rhsa:def:20170184",
      "TotalFixCount": 0,
      "AsapCount": 0,
      "Related": "CVE-2023-24881,CVE-2023-24898",
      "LanguageType": "java"
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	NoPermission	no permission
400	RdCheckNoPermission	Resource directory account verification has no permission.
500	ServerError	ServerError
500	RdCheckInnerError	Resource directory account service internal error.
403	NoPermission	caller has no permission

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

Notes de version

Consultez Notes de version pour la liste complète.