PutEnableFwSwitch - - Centre de documentation Alibaba Cloud

Active un commutateur de pare-feu.

Description de l'opération

Active un commutateur de pare-feu. Le trafic transite par Cloud Firewall uniquement après l'activation du commutateur de pare-feu.

Limite de QPS

La limite de QPS par utilisateur pour cette opération est de 5 appels par seconde. Si cette limite est dépassée, les appels d'API sont limités, ce qui peut affecter votre activité. Appelez cette opération de manière appropriée.

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

update

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
SourceIp `deprecated`	string	Non	L'adresse IP source de la requête.	192.0.XX.XX
Lang	string	Non	Le type de langue du message reçu. Valeurs valides : zh : chinois en : anglais	zh
IpaddrList	array	Non	La liste des adresses IP. Remarque Les paramètres IpaddrList, RegionList et ResourceTypeList ne peuvent pas être tous vides. Vous devez spécifier une valeur pour au moins l'un de ces paramètres.	["192.0.X.X","192.0.X.X"]
	string	Non	La liste des adresses IP. Remarque Les paramètres IpaddrList, RegionList et ResourceTypeList ne peuvent pas être tous vides. Vous devez spécifier une valeur pour au moins l'un de ces paramètres.	192.0.XX.XX
RegionList	array	Non	La liste des régions. Remarque Les paramètres IpaddrList, RegionList et ResourceTypeList ne peuvent pas être tous vides. Vous devez spécifier une valeur pour au moins l'un de ces paramètres.	["cn-hangzhou","cn-shanghai"]
	string	Non	La liste des régions. Remarque Les paramètres IpaddrList, RegionList et ResourceTypeList ne peuvent pas être tous vides. Vous devez spécifier une valeur pour au moins l'un de ces paramètres.	cn-hangzhou,cn-shanghai
ResourceTypeList	array	Non	La liste des types d'actifs. Valeurs valides : BastionHostEgressIP : adresse IP de sortie de l'hôte bastion. BastionHostIngressIP : adresse IP d'entrée de l'hôte bastion. EcsEIP : EIP ECS. EcsPublicIP : adresses IP publiques des instances Elastic Compute Service (ECS). EIP : adresse IP élastique. EniEIP : EIP de contrôleur d'interface réseau (NIC). NatEIP : EIP NAT. SlbEIP : EIP SLB (EIP CLB). SlbPublicIP : adresse IP publique SLB (adresse IP publique CLB). NatPublicIP : adresse IP publique NAT. HAVIP : adresse IP virtuelle hautement active. NlbEIP : EIP NLB. ApiGatewayEIP : adresse IP publique API Gateway. AlbEIP : EIP ALB. AiGatewayEIP : adresse IP publique AI Gateway. GaEIP : EIP GA. SwasEIP : adresse IP publique de serveur d'applications simple. EcdEIP : adresse IP publique Elastic Desktop Service. BastionHostIP : adresse IP de l'hôte bastion. Remarque Les paramètres IpaddrList, RegionList et ResourceTypeList ne peuvent pas être tous vides. Vous devez définir une valeur pour au moins l'un de ces paramètres. La configuration d'au moins un paramètre est requise.	["EcsPublicIp","NatEip"]
	string	Non	La liste des types d'actifs. Valeurs valides : BastionHostEgressIP : adresse IP de sortie de l'hôte bastion. BastionHostIngressIP : adresse IP d'entrée de l'hôte bastion. EcsEIP : EIP ECS. EcsPublicIP : adresses IP publiques des instances Elastic Compute Service (ECS). EIP : adresse IP élastique. EniEIP : EIP de contrôleur d'interface réseau (NIC). NatEIP : EIP NAT. SlbEIP : EIP SLB (EIP CLB). SlbPublicIP : adresse IP publique SLB (adresse IP publique CLB). NatPublicIP : adresse IP publique NAT. HAVIP : adresse IP virtuelle hautement active. NlbEIP : EIP NLB. ApiGatewayEIP : adresse IP publique API Gateway. AlbEIP : EIP ALB. AiGatewayEIP : adresse IP publique AI Gateway. GaEIP : EIP GA. SwasEIP : adresse IP publique de serveur d'applications simple. EcdEIP : adresse IP publique Elastic Desktop Service. BastionHostIP : adresse IP de l'hôte bastion. Remarque Les paramètres IpaddrList, RegionList et ResourceTypeList ne peuvent pas être tous vides. Vous devez définir une valeur pour au moins l'un de ces paramètres. La configuration d'au moins un paramètre est requise.	EcsPublicIp,NatEip
MemberUid	string	Non	L'identifiant unique du compte membre.	1234
IpVersion	string	Non	La version IP.	4
ClientToken	string	Non	Le jeton client qui garantit l'idempotence de la requête. Généré par le client, le jeton doit être unique pour les différentes requêtes. La valeur est une chaîne sensible à la casse au format [0-9a-zA-Z-_]{1,64}. Nous vous recommandons d'utiliser un UUID. Le serveur garantit l'idempotence pendant la période de validité (600 secondes) : les requêtes répétées avec le même ClientToken et les mêmes paramètres métier renvoient le même résultat que la première requête. Si le ClientToken est identique mais que les paramètres métier sont différents, une erreur HTTP 400 avec le code d'erreur IdempotentParameterMismatch est renvoyée.	ddadxefexxxx
DryRun	boolean	Non	Indique si un test à blanc de la requête doit être effectué uniquement. Si vous définissez ce paramètre sur true, le système effectue des pré-vérifications telles que la validation des paramètres, la vérification de l'identité et des autorisations, l'existence des ressources et les limites de quota, sans créer, mettre à jour ou supprimer de ressources réelles, déclencher de tâches de dérivation de trafic asynchrones, ou générer d'effets secondaires en aval tels que la facturation, les notifications ou les rappels. Si le test à blanc réussit, la réponse contient DryRun=true, ce qui la distingue d'une réponse d'appel réel. Si le test à blanc échoue, un code d'erreur lisible par machine est renvoyé, tel que ErrorParamsInvalid pour des paramètres invalides, ErrorAuthentication pour des autorisations insuffisantes, ou ErrorInstanceOpenIpNumExceed pour un quota insuffisant. Si vous définissez ce paramètre sur false (valeur par défaut), la requête est envoyée et l'opération d'activation est effectuée.	true

Éléments de réponse

Élément	Type	Description	Exemple
	object
AbnormalResourceStatusList	array<object>	La liste des informations d'état pour les actifs qui ne sont pas synchronisés.
	object
Msg	string	Le message lorsque l'actif n'est pas synchronisé. Valeurs valides : cloudfirewall do not sync this ip address : Cloud Firewall n'a pas synchronisé cette adresse IP d'actif.	cloudfirewall do not sync this ip address
Resource	string	L'adresse IP de l'actif.	203.0.113.0
Status	string	L'état lorsque l'actif n'est pas synchronisé. Valeurs valides : ip_not_sync : l'actif n'est pas synchronisé.	ip_not_sync
DryRun	boolean	Indique si cette réponse est une réponse de réussite de test à blanc. Une valeur true indique que seul le test à blanc a été effectué et qu'aucune modification réelle n'a été apportée. Ce champ n'est pas renvoyé ou est défini sur false pour les appels réels.	true
RequestId	string	L'identifiant de la requête.	B2841452-CB8D-4F7D-B247-38E1CF7334F8

Exemples

JSON format

{
  "AbnormalResourceStatusList": [
    {
      "Msg": "cloudfirewall do not sync this ip address",
      "Resource": "203.0.113.0",
      "Status": "ip_not_sync"
    }
  ],
  "DryRun": true,
  "RequestId": "B2841452-CB8D-4F7D-B247-38E1CF7334F8"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	ErrorInstanceOpenIpNumExceed	The maximum number of protected assets has been reached.	Le nombre d'actifs protégés a atteint la limite supérieure.
400	ErrorInstanceStatusNotNormal	This operation is not supported when the instance is in the current state.	L'état actuel de l'instance ne permet pas cette opération.
400	ErrorParamsNotEnough	Parameters are insufficient.	Les paramètres sont insuffisants.
400	ErrorDBTxError	A database transaction error occurred.	Une erreur interne s'est produite lors de la transaction de base de données.
400	ErrorParamsInvalid	Invalid Params	Le paramètre n'est pas valide.
400	ErrorInstanceOpenIpRegionNumExceed	open ip region num exceed.	Le quota de protection régional est insuffisant.
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	IdempotentParameterMismatch	The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.	Cette requête utilise le même jeton client qu'une requête précédente, mais n'est pas identique à celle-ci. Ne réutilisez pas un jeton client pour des requêtes différentes, sauf si les requêtes sont strictement identiques.
400	InvalidClientToken	ClientToken format invalid. Only ASCII letters, digits, hyphens and underscores are allowed, max 64 characters.
401	ErrorAuthentication	An authentication error occurred.	L'authentification a échoué.
409	IdempotentToken.Processing	A previous request with the same ClientToken is still being processed.

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

Notes de version

Consultez Notes de version pour la liste complète.