Tous les produits
Search
Centre de documentation

:CreateSecurityProxy

Dernière mise à jour :Oct 09, 2026

Crée un 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:CreateSecurityProxy

get

*Toutes les ressources.

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

Lang

string

Non

La langue du message de réponse. Valeurs valides :

  • zh (par défaut) : chinois.

  • en : anglais.

zh

ProxyName

string

Oui

Le nom du pare-feu NAT. Le nom doit comporter entre 4 et 50 caractères et peut contenir des lettres majuscules et minuscules, des caractères chinois, des chiffres et des traits de soulignement (_). Il ne peut pas commencer par un trait de soulignement.

nat-firewall

RegionNo

string

Oui

L'identifiant de la région du VPC.

Remarque

Pour plus d'informations sur les régions prises en charge par Cloud Firewall, consultez Régions prises en charge.

cn-hangzhou

VpcId

string

Oui

L'identifiant du VPC.

vpc-uf6b5lyul0x******

NatGatewayId

string

Oui

L'identifiant de la passerelle NAT.

ngw-bp1okz6k7******

VswitchAuto

string

Non

Indique si le mode automatique doit être utilisé pour le vSwitch. Valeurs valides :

  • true : mode automatique.

  • false : mode manuel.

Remarque

Valeur par défaut : true. Si VswitchAuto est défini sur true, VswitchCidr est requis et doit être un bloc CIDR valide. Si VswitchAuto est défini sur false, VswitchId est requis.

true

VswitchId

string

Non

L'identifiant du vSwitch. Ce paramètre est requis lorsque le mode manuel est utilisé pour le vSwitch.

vsw-bp1sqg9w******

NatRouteEntryList

array<object>

Oui

La liste des routes à basculer pour la passerelle NAT.

object

Non

La liste des adresses de destination pour la protection de sécurité.

DestinationCidr

string

Oui

Le bloc CIDR de destination de la route par défaut.

0.0.0.0/0

NextHopId

string

Oui

Le saut suivant de la passerelle NAT d'origine.

ngw-bp1okz6******

NextHopType

string

Oui

Le type de réseau du saut suivant. Valeur valide : NatGateway.

NatGateway

RouteTableId

string

Oui

L'identifiant de la table de routage à laquelle la route par défaut de la passerelle NAT appartient.

vtb-2ze1******

FirewallSwitch

string

Non

Le commutateur de protection de sécurité. Valeurs valides :

  • open : Activé.

  • close : Désactivé.

close

StrictMode

integer

Non

Indique si le mode strict doit être activé. Valeurs valides :

  • 1 : Activer le mode strict.

  • 0 : Désactiver le mode strict.

0

VswitchCidr

string

Non

Le bloc CIDR du vSwitch. Ce paramètre est requis lorsque le mode automatique est utilisé pour le vSwitch.

0.0.0.0/0

FirewallServiceMode

string

Non

Le mode de déploiement du service de pare-feu. Valeurs valides :

  • PrimaryStandby : mode principal/secours.

  • MultiPrimary : mode actif-actif.

PrimaryStandby

FirewallServiceZones

array

Non

La liste des identifiants de zone utilisés par le service de pare-feu.

string

Non

Un identifiant de zone utilisé par le service de pare-feu.

cn-hangzhou-i

FwVswitchZoneId

string

Non

La zone du vSwitch du pare-feu.

cn-beijing-b

Éléments de réponse

Élément

Type

Description

Exemple

object

ProxyId

string

L'identifiant du pare-feu NAT.

proxy-nat97a******

RequestId

string

L'identifiant de la requête.

15FCCC52-1E23-57AE-B5EF-3E00A3******

Exemples

JSON format

{
  "ProxyId": "proxy-nat97a******",
  "RequestId": "15FCCC52-1E23-57AE-B5EF-3E00A3******"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 ErrorAliUid Aliuid invalid. L'identifiant de l'utilisateur n'est pas valide.
400 ErrorParamProxyNameError proxy name invalid. Le nom du pare-feu NAT est invalide.
400 ErrorRegionNoError Region is error, please reselect La zone n'est pas valide.
400 ErrorVpcIdError Vpc ID invalid. La sélection du VPC n'est pas valide. Sélectionnez un autre VPC.
400 ErrorDnatNotSupport Secure proxy does not support DNAT entries. Les pare-feu NAT ne prennent pas en charge le DNAT.
400 ErrorProxySnatIpEmpty SNAT entry is empty. L'entrée SNAT est vide.
400 ErrorSnatIpQuotaExceed The number of SNAT IP exceeds the specification. Le nombre d'EIP sur la passerelle NAT dépasse le quota pris en charge par un seul pare-feu NAT.
400 ErrorDBSelectError A database select error occurred. Une erreur interne s'est produite lors de l'opération de requête de base de données.
400 ErrorDefaultRouteConflicts Default route conflicts. Une route par défaut existe déjà dans la table de routage associée au vSwitch sélectionné.
400 ErrorUserCredentials User credentials failed. Accès non autorisé. Accordez d'abord les autorisations au pare-feu.
400 ErrorVpcOpenApi vpc open api failed Échec de l'appel de l'API VPC.
400 ErrorVswitchNotFound vswitch not found Le vSwitch n'existe pas. Sélectionnez un autre vSwitch.
400 ErrorProxyRouteEntryConflicts Proxy custom route table Nat Gateway and Attachment route entry conflict. La table de routage personnalisée de la passerelle NAT contient des entrées de routage dont le saut suivant est NatGateway ou Attachment.
400 ErrorVswitchNoAvailableCidr No available CIDR to create a vswitch. Il n'existe aucun bloc CIDR disponible dans le VPC pour créer un vSwitch.
400 ErrorCidrFormat Network segment CIDR format error, please select again Le format du bloc CIDR n'est pas valide. Spécifiez un bloc CIDR valide.
400 ErrorInternal internal error Une erreur interne s'est produite.
400 ErrorVswitchCidrNotInVpc Vswitch CIDR address not in vpc. Le bloc CIDR du vSwitch n'appartient pas au VPC actuel.
400 ErrorVswitchRouteConflict vswitch route conflict. Le bloc CIDR du vSwitch spécifié est en conflit avec un bloc CIDR de vSwitch existant.
400 ErrorVswitchCidrIpNumNotEnough No enough private proxy IP in vswitch cidr. Le vSwitch du pare-feu ne dispose pas d'un nombre suffisant d'adresses IP privées.
400 ErrorRouteEntryNotFound route entry not found. Entrée de route introuvable.
400 ErrorUserNotFound User not found L'utilisateur n'existe pas.
400 ErrorProxyVpcNotSupportAdvFeature This vpc advanced feature is not supported. Le VPC contient des instances ECS qui ne prennent pas en charge les fonctionnalités avancées du VPC.
400 ErrorDBInsertError A database insert error occurred. Une erreur interne s'est produite lors de l'opération d'insertion dans la base de données.
400 ErrorProxyNumQuotaTop Proxy num reaches maximum. Le quota est insuffisant.
400 ErrorProxyClusterNotAvailable Can not find available cluster for nat firewall. Échec de l'allocation d'un cluster pour le pare-feu NAT.
400 ErrorDBTxError A database transaction error occurred. Une erreur interne s'est produite lors de la transaction de base de données.
400 ErrorRecordLog record operation log error. Échec de l'écriture du journal.
400 ErrorBandwidthPenalty Cloud Firewall bandwidth is being overused. La surconsommation de bande passante de Cloud Firewall est en cours de traitement.
400 ErrorGeneralInstanceSpecFull Cloud Firewall instance specifications are full. Le quota d'instances Cloud Firewall est atteint.
400 ErrorNatVpnRouteEntryQuotaLimit The number of VPN routes has reached the quota. La route VPN a atteint la limite de spécification.
400 ErrorVpcRouteTableQuotaLimit The number of VPC routing tables has reached the specification limit. Le nombre de tables de routage VPC a atteint la limite supérieure.
400 ErrorNatCustomRouteEntryDifferent The custom route entries in the routing tables are inconsistent. Les entrées de route personnalisées entre les tables de routage sont incohérentes.
400 ErrorSnatEntryQuotaExceed SNAT entry quota exceeded. Le nombre d'entrées SNAT a atteint la limite du quota.
400 ErrorFirewallZoneId Firewall zone error. La sélection de zone du pare-feu n'est pas valide.
400 ErrorParameters Error Parameters Une erreur de paramètre s'est produite.
400 ErrorNatEipNotBind NAT gateway does not bind NAT EIP.
400 ErrorProxyExist firewall already exist. Le pare-feu existe déjà.

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

Notes de version

Consultez Notes de version pour la liste complète.