CreateHoneypotProbe - Security Center - Centre de documentation Alibaba Cloud

Crée une sonde de pot de miel.

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

create

*HoneypotProbe.

acs:yundun-sas:{#regionId}:{#accountId}:honeypotprobe/*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ControlNodeId	string	Oui	L'identifiant du nœud de gestion. Remarque Vous pouvez appeler l'opération ListHoneypotNode pour obtenir cette valeur.	a882e590-b87b-45a6-87b9-d0a3e5a0****
ProbeType	string	Oui	Le type de sonde. Valeurs valides : host_probe : sonde d'hôte vpc_black_hole_probe : sonde de trou noir VPC	host_probe
DisplayName	string	Oui	Le nom de la sonde.	testHoneyPotProbe
ProbeVersion	string	Non	La version de la sonde.	0.0.0
Uuid	string	Non	L'UUID de l'instance. Remarque Ce paramètre est requis lorsque ProbeType est défini sur host_probe.	e4af3620-6895-4e2f-a641-a9d8fb53****
BusinessGroupId	string	Non	Le groupe d'activités.	2022011817324588686
HoneypotBindList	array<object>	Non	La collection des configurations de service.
	array<object>	Non	Les détails de la configuration de service.
BindPortList	array<object>	Non	La liste des ports d'écoute.
	object	Non	Les détails du port d'écoute.
TargetPort	integer	Non	Le port de destination. Remarque Ce paramètre est requis lorsque HoneypotId n'est pas vide.	80
StartPort	integer	Non	Le port de début.	80
EndPort	integer	Non	Le port de fin.	90
Fixed	boolean	Non	Indique si le port est fixe. Valeurs valides : 0 : Non. 1 : Oui.	false
BindPort	boolean	Non	Indique s'il faut lier le port. Valeurs valides : true : Oui. false : Non.	true
HoneypotId	string	Non	L'identifiant du pot de miel. Remarque Vous pouvez appeler l'opération ListHoneypot pour obtenir cette valeur.	1a5eda2d40f92ac87d6b63e1a5ad4b76fe0d4110c4a3e2fa85438a29ae55****
Ping	boolean	Non	Indique si la détection par analyse ping doit être activée. Valeurs valides : true : Activée. false : Désactivée.	true
Arp	boolean	Non	Indique si la détection d'usurpation ARP doit être activée. Valeurs valides : true : Activée. false : Désactivée.	true
VpcId	string	Non	L'identifiant du cloud privé virtuel (VPC). Remarque Ce paramètre est requis lorsque ProbeType est défini sur vpc_black_hole_probe. Vous pouvez appeler l'opération DescribeVpcHoneyPotList pour obtenir cette valeur.	vpc-zm0asrkpv1q8gnk7mn4dn
ProxyIp	string	Non	L'adresse IP du proxy.	192.168.XX.XX

Éléments de réponse

Élément	Type	Description	Exemple
	object	La réponse pour la création d'une sonde de pot de miel.
Success	boolean	Indique si l'appel a réussi. Valeurs valides : true : Réussi. false : Échoué.	true
Code	string	Le code de résultat. Une valeur de 200 indique un succès. Toute autre valeur indique un échec. Vous pouvez utiliser ce champ pour déterminer la cause de l'échec.	200
Message	string	Le message de réponse.	successful
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.	B7A839E8-70AE-591D-8D9E-C5419A2240DB
HttpStatusCode	integer	Le code d'état HTTP.	200
HoneypotProbe	object	Les informations de la sonde renvoyées après la création.
ProbeId	string	L'identifiant unique de la sonde.	b69e9aa8-2ea8-4c5a-836a-c1fbacff****

Exemples

JSON format

{
  "Success": true,
  "Code": "200",
  "Message": "successful.",
  "RequestId": "B7A839E8-70AE-591D-8D9E-C5419A2240DB",
  "HttpStatusCode": 200,
  "HoneypotProbe": {
    "ProbeId": "b69e9aa8-2ea8-4c5a-836a-c1fbacff****"
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	AgentNotOnline	The agent not online.
400	IllegalParam	Illegal param
400	NodeNotExist	The control node does not exist.
400	BindPortAlreadyExist	The specified service port already exists.
400	MachineNotExist	The machine does not exist.
400	ProbeAlreadyCreate	The probe has been created.
400	ProbeNameAlreadyExists	The probe name already exists.
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.