CreateNatFirewallControlPolicy - - Centre de documentation Alibaba Cloud

Ajoute une stratégie de contrôle d'accès à un pare-feu NAT.

Description de l'opération

Cette API crée une stratégie pour autoriser, refuser ou observer le trafic traversant le pare-feu NAT.

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

create

*NatFirewallControlPolicy

acs:yundun-cloudfirewall::{#accountId}:natfirewallcontrolpolicy/*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Lang	string	Non	La langue des messages de réponse. Valeurs valides : zh : chinois (par défaut) en : anglais	zh
AclAction	string	Oui	L'action que Cloud Firewall effectue sur le trafic correspondant à la stratégie de contrôle d'accès. Valeurs valides : accept : autorise le trafic. drop : rejette le trafic. log : journalise le trafic.	log
ApplicationNameList	array	Oui	La liste des applications auxquelles s'applique la stratégie de contrôle d'accès.
	string	Non	Une application à laquelle s'applique la stratégie de contrôle d'accès.	ANY
Description	string	Oui	La description de la stratégie de contrôle d'accès.	Autoriser le trafic
DestPort	string	Non	Le port de destination pour le trafic. La valeur de ce paramètre dépend des paramètres Proto et DestPortType. Si Proto est ICMP, laissez ce paramètre vide. Remarque Le contrôle d'accès ne peut pas être configuré en fonction du port de destination pour le trafic ICMP. Si le type de port de destination (DestPortType) est group, laissez ce paramètre vide. Remarque Si DestPortType est défini sur group, vous n'avez pas besoin de spécifier de port de destination car les ports requis sont définis dans le carnet d'adresses de ports sélectionné. Si le protocole est TCP, UDP ou ANY et que le type de port de destination (DestPortType) est port, spécifiez le numéro de port de destination.	80
Destination	string	Oui	L'adresse de destination dans la stratégie de contrôle d'accès. La valeur de ce paramètre varie en fonction de la valeur de DestinationType : Si DestinationType est net, définissez ce paramètre sur le CIDR de destination. Exemple : 1.2.XX.XX/24 Si DestinationType est group, définissez ce paramètre sur le nom du carnet d'adresses de destination. Exemple : db_group Si DestinationType est domain, définissez ce paramètre sur le domaine de destination. Exemple : *.aliyuncs.com Si DestinationType est location, définissez ce paramètre sur l'emplacement de destination. Exemple : ["BJ11", "ZB"]	XX.XX.XX.XX/24
DestinationType	string	Oui	Le type d'adresse de destination dans la stratégie de contrôle d'accès. Valeurs valides : net : CIDR de destination group : carnet d'adresses de destination domain : domaine de destination	net
NatGatewayId	string	Oui	L'identifiant de l'instance de la passerelle NAT.	ngw-2vc2ustolqn6sr0******
Proto	string	Oui	Le protocole pour le trafic dans la stratégie de contrôle d'accès. Valeurs valides : ANY : tous les protocoles TCP UDP ICMP Remarque Si la destination est un domaine, un carnet d'adresses de renseignements sur les menaces ou un carnet d'adresses de services cloud, vous ne pouvez définir ce paramètre que sur TCP. Les types d'applications pris en charge sont HTTP, HTTPS, SMTP, SMTPS et SSL.	ANY
Source	string	Oui	L'adresse source dans la stratégie de contrôle d'accès. La valeur de ce paramètre varie en fonction de la valeur de SourceType : Si SourceType est net, définissez ce paramètre sur le CIDR source. Exemple : 10.2.4.0/24 Si SourceType est group, définissez ce paramètre sur le nom du carnet d'adresses source. Exemple : db_group	192.168.0.25/32
SourceType	string	Oui	Le type d'adresse source dans la stratégie de contrôle d'accès. Valeurs valides : net : CIDR source group : carnet d'adresses source	net
NewOrder	string	Oui	La priorité de la stratégie de contrôle d'accès. Les valeurs commencent à 1. Une valeur plus petite indique une priorité plus élevée.	1
DestPortType	string	Non	Le type de port de destination. port : port ou plage de ports group : carnet d'adresses de ports	port
DestPortGroup	string	Non	Le nom du carnet d'adresses de ports de destination. Remarque Ce paramètre est requis si DestPortType est défini sur group.	my_port_group
Release	string	Non	Indique si la stratégie de contrôle d'accès est activée. Par défaut, les stratégies sont activées lors de leur création. Valeurs valides : true : active la stratégie. false : désactive la stratégie.	true
DomainResolveType	integer	Non	La méthode de résolution de nom de domaine. Valeurs valides : 0 : résolution basée sur FQDN 1 : résolution basée sur DNS dynamique 2 : résolution basée sur FQDN et DNS dynamique Remarque Si la méthode de résolution inclut FQDN, vous ne pouvez définir le protocole que sur TCP. Les applications prises en charge sont HTTP, HTTPS, SMTP, SMTPS et SSL.	0
IpVersion	string	Non	La version IP pour la stratégie de contrôle d'accès. Valeurs valides : 4 (par défaut) : IPv4	4
Direction	string	Oui	La direction du trafic pour la stratégie de contrôle d'accès. Valeurs valides : out : trafic sortant	out
RepeatType	string	Non	Le type de récurrence pour la période de validité de la stratégie. Valeurs valides : Permanent (par défaut) : la stratégie est toujours active. None : la stratégie s'exécute une seule fois pendant une durée spécifiée. Daily : la stratégie se répète quotidiennement. Weekly : la stratégie se répète chaque semaine dans une plage horaire spécifiée. Monthly : la stratégie se répète chaque mois dans une plage horaire spécifiée. Valeurs valides : Daily : Quotidien. Monthly : Mensuel. Permanent : Toujours. Weekly : Hebdomadaire. None : Unique.	Permanent
RepeatDays	array	Non	Les jours de la semaine ou du mois auxquels la stratégie se répète. Si RepeatType est défini sur Permanent, None ou Daily, laissez ce paramètre vide. Exemple : [] Si RepeatType est Weekly, ce paramètre est requis. Exemple : [0, 6] Remarque Si RepeatType est Weekly, les valeurs dans RepeatDays doivent être uniques. Si RepeatType est Monthly, ce paramètre est requis. Exemple : [1, 31] Remarque Si RepeatType est Monthly, les valeurs dans RepeatDays doivent être uniques.
	integer	Non	Le jour de récurrence. Remarque Si RepeatType est Weekly, les valeurs valides vont de 0 à 6. La semaine commence le dimanche. Si RepeatType est Monthly, les valeurs valides vont de 1 à 31.	1
RepeatStartTime	string	Non	L'heure de début de la récurrence. L'heure doit être à l'heure pile ou à la demi-heure, et doit être au moins 30 minutes avant l'heure de fin. Remarque Ce paramètre est requis si RepeatType est défini sur Daily, Weekly ou Monthly. Si RepeatType est Permanent ou None, laissez ce paramètre vide. L'heure est au format HH:mm (24 heures). Par exemple, 08:00 ou 23:30.	08:00
RepeatEndTime	string	Non	L'heure de fin de la récurrence. L'heure doit être à l'heure pile ou à la demi-heure, et doit être au moins 30 minutes après l'heure de début. Remarque Ce paramètre est requis si RepeatType est défini sur Daily, Weekly ou Monthly. Si RepeatType est Permanent ou None, laissez ce paramètre vide. L'heure est au format HH:mm (24 heures). Par exemple, 08:00 ou 23:30.	23:30
StartTime	integer	Non	L'heure de début de la période de validité de la stratégie, spécifiée sous forme d'horodatage Unix. L'heure doit être à l'heure pile ou à la demi-heure et doit être au moins 30 minutes avant l'heure de fin. Remarque Ce paramètre est requis si RepeatType est None, Daily, Weekly ou Monthly. Si RepeatType est Permanent, laissez ce paramètre vide.	1694761200
EndTime	integer	Non	L'heure de fin de la période de validité de la stratégie, spécifiée sous forme d'horodatage Unix. L'heure doit être à l'heure pile ou à la demi-heure et doit être au moins 30 minutes après l'heure de début. Remarque Ce paramètre est requis si RepeatType est None, Daily, Weekly ou Monthly. Si RepeatType est Permanent, laissez ce paramètre vide.	1694764800

Éléments de réponse

Élément	Type	Description	Exemple
	object
AclUuid	string	L'identifiant unique de la stratégie de contrôle d'accès. Remarque Pour modifier une stratégie de contrôle d'accès, vous devez fournir son identifiant unique. Vous pouvez appeler l'opération DescribeNatFirewallControlPolicy pour obtenir cet identifiant.	6504d2fb-ab36-49c3-92a6-*****
RequestId	string	L'identifiant de la requête.	0DC783F1-B3A7-578D-8A63-*****

Exemples

JSON format

{
  "AclUuid": "6504d2fb-ab36-49c3-92a6-*****",
  "RequestId": "0DC783F1-B3A7-578D-8A63-*****"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	ErrorParametersUid	The aliUid parameter is invalid.	The aliUid parameter is invalid.
400	ErrorUUIDNew	The UUID is invalid.	The UUID is invalid.
400	ErrorParametersSource	The source is invalid.	The source is invalid.
400	ErrorParametersDestination	The Destination parameter is invalid.	The Destination parameter is invalid.
400	ErrorParametersProto	The protocol is invalid.	The protocol is invalid.
400	ErrorParametersDestPort	The dst_port is invalid.	The dst_port is invalid.
400	ErrorParametersAction	The action is invalid.	The action is invalid.
400	ErrorDBSelect	An error occurred while querying database.	An error occurred while querying database.
400	ErrorParameters	A parameter error occurred.	A parameter error occurred.
400	ErrorAddressCountExceed	The maximum number of addresses is exceeded.	The maximum number of address is exceeded.
400	ErrorParametersNewOrder	The newOrder is invalid.	The newOrder is invalid.
400	ErrorDBInsert	An error occurred while performing an insert operation in the database.	An error occurred while performing an insert operation in the database.
400	ErrorDBDelete	An error occurred while deleting the database.	An error occurred while deleting the database.
400	ErrorRecordLog	An error occurred while updating the operation log.	An error occurred while updating the operation log.
400	ErrorAclDomainAnyCountExceed	The number of resolved domain names cannot exceed 200. ACL configuration can be continued for HTTP, HTTPS, SMTP, SMTPS, and SSL applications.	The domain name is resolved to more than 200 IP addresses. We recommend that you set Application in your access control policy to HTTPS, HTTPS, SMTP, SMTPS, or SSL.
400	ErrorParametersNatGatewayId	Invalid parameters NatGatewayId.	The request parameter NatGatewayId is invalid or does not exist.
400	ErrorParameterIpVersion	The IP version is invalid.	The IP version is invalid.
400	ErrorParametersDirection	The direction is invalid.	The direction is invalid.
400	ErrorDomainResolve	An error occurred while resolving the domain.	An error occurred while resolving the domain.
400	ErrorParametersPageSizeOrNo	Either pageSize or pageNo is invalid.	Either pageSize or pageNo is invalid.
400	ErrorMarshalJSON	An error occurred while encoding JSON.	An error occurred while encoding JSON.
400	ErrorParametersDestinationCount	Exceeding the number of countries in a single ACL.	Exceeds the number of selected areas for one ACL. It is recommended to split it into multiple ACLs.
400	ErrorStartTimeOrEndTime	The start time or end time is invalid. The time must be the hour or half hour, and the start time must be 30 minutes earlier than the end time.	The start time or end time is invalid. The time must be an hour or half an hour, and the start time must be 30 minutes earlier than the end time.
400	ErrorParametersFtpNotSupport	domain destination not support ftp.	FTP application is not supported when the policy destination is a domain name
400	ErrorAclExtendedCountExceed	ACL or extended ACL rules are not matched.	The quota for access control policies or extra access control policies is exhausted.
400	ErrorAddressGroupNotExist	The address group does not exist.	The address group does not exist.
400	ErrorParametersApplicationNameList	Specified parameter ApplicationNameList is not valid.	Specified parameter ApplicationNameList is not valid.

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

Notes de version

Consultez Notes de version pour la liste complète.