CreateAgentlessScanTask - Security Center - Centre de documentation Alibaba Cloud

Crée une tâche de détection sans agent.

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:CreateAgentlessScanTask

create

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
TargetType	integer	Oui	Le type de cible. Valeurs valides : 1 : Détection d'hôte - détection par instantané. 2 : Détection d'hôte - détection par image. 3 : Détection d'instantané utilisateur. 2 : Détection d'image personnalisée utilisateur.	2
UuidList	array	Non	Les UUID des actifs à détecter.\n\n> Vous pouvez appeler l'opération DescribeCloudCenterInstances pour obtenir les UUID des serveurs.
	string	Non	L'UUID de l'actif à détecter.	66a9c708-d4a4-4feb-aa00-61006556****
AutoDeleteDays	integer	Non	La période de rétention de l'image, en jours. Ce paramètre prend effet uniquement pour la détection d'hôte. Il ne prend pas effet pour la détection d'instantané utilisateur ou la détection d'image personnalisée utilisateur.	1
ScanDataDisk	boolean	Non	Indique si les disques cloud de données doivent être détectés. Valeurs valides : true : Détecté. false : Non détecté.	true
ReleaseAfterScan	boolean	Non	Indique si le mode d'économie de coûts doit être activé. Valeurs valides :\n\n- true : Activé.\n- false : Désactivé.	true
AssetSelectionType	string	Non	L'identifiant de sélection d'actif.	AGENTLESS_SCAN_ONCE_TASK_1720145******
RegionId	string	Non	L'identifiant de la région, qui est généralement renseigné automatiquement par la passerelle.	cn-shanghai
ClientToken	string	Non	L'identifiant de la région de la ressource à détecter, par exemple cn-hangzhou.	cn-hangzhou
Targets	array<object>	Non	La source de l'appel d'API, qui est utilisée pour collecter des statistiques sur le volume de tâches d'analyse et le volume de données d'analyse par source. Si ce paramètre n'est pas spécifié, la valeur est vide.	image-console
	object	Non
ImageId	string	Non	L'identifiant de l'image personnalisée ECS source à remédier. L'image doit se trouver dans la région spécifiée par le paramètre RegionId de cette cible.	m-bp1example123456789
OriginImageName	string	Non	Le nom de l'image personnalisée ECS source à remédier.	source-image
OutputImageName	string	Non	Le nom de l'image ECS générée après la remédiation.	patched-image-20260909
RegionId	string	Non	L'identifiant de la région de l'image source à remédier, par exemple cn-hangzhou.	cn-hangzhou
VulnerabilityIds	array	Non	La liste des identifiants de vulnérabilités à corriger. Au moins un identifiant de vulnérabilité doit être spécifié. Chaque identifiant doit être unique et non vide.
	string	Non	L'identifiant d'une vulnérabilité unique à corriger, par exemple un identifiant CVE.	CVE-2023-38408
		Non	La clé d'idempotence.	66a9c708-d4a4-4fe
		Non	La liste des cibles pour la remédiation de sécurité des images. Chaque cible spécifie l'image source, la région, le nom de l'image remédiée et les identifiants des vulnérabilités à corriger.

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête, qui est un identifiant unique généré par Alibaba Cloud pour cette requête. Vous pouvez utiliser cet identifiant pour résoudre les problèmes.	E90DE229-9FC6-58F6-BF4B-03AD6179****
TaskId	string	L'identifiant de la tâche.	66561899963532d9db8a14124f46f3a0

Exemples

JSON format

{
  "RequestId": "E90DE229-9FC6-58F6-BF4B-03AD6179****",
  "TaskId": "66561899963532d9db8a14124f46f3a0"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	TaskIsProcessing	Task Is Processing.
500	ServerError	ServerError
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.