PutDisableFwSwitch - - Centre de documentation Alibaba Cloud

Désactive le commutateur de pare-feu.

Description de l'opération

Désactive le commutateur de pare-feu. Une fois le commutateur de pare-feu désactivé, le trafic ne transite plus par Cloud Firewall.

Limite de QPS

La limite de QPS par utilisateur pour cette opération est de 10 appels par seconde. Si cette limite est dépassée, l'appel d'API est limité, ce qui peut affecter votre activité. Appelez cette opération selon vos besoins.

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

update

*All Resource

*

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 (par défaut) : 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.XX.XX","192.0.XX.XX"]
	string	Non	L'adresse IP.	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	L'identifiant de la région.	cn-hangzhou
ResourceTypeList	array	Non	La liste des types de ressources. 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 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 spécifier une valeur dans les paramètres pour au moins l'un de ces paramètres.	["EcsPublicIp","NatEip"]
	string	Non	La liste des types de ressources. 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 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 spécifier une valeur dans les paramètres pour au moins l'un de ces paramètres.	EcsPublicIP
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 chaque requête. 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 même ClientToken est utilisé avec des paramètres métier différents, une erreur HTTP 400 avec le code d'erreur IdempotentParameterMismatch est renvoyée.	defefedxexxxx
DryRun	boolean	Non	Indique si un test à blanc uniquement doit être effectué. Si vous définissez ce paramètre sur true, le système effectue des pré-vérifications telles que la validité des paramètres, les autorisations d'identité, l'existence des ressources, les limites de quota et les relations de dépendance, sans créer, mettre à jour ou supprimer de ressources réelles, déclencher de tâches de déroutage 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, DryRun=true est renvoyé dans la réponse, ce qui permet de la distinguer 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 les erreurs de paramètre, ErrorAuthentication pour les autorisations insuffisantes, ou ErrorInstanceOpenIpNumExceed pour un quota insuffisant). Définissez ce paramètre sur false (valeur par défaut) pour initier la requête et effectuer l'opération de désactivation.	true

Lorsque vous appelez cette opération, vous devez inclure les paramètres de requête communs d'Alibaba Cloud en plus des paramètres de requête décrits dans cette rubrique. Pour plus d'informations sur les paramètres communs, consultez Paramètres communs. Pour le format de requête de cette opération, consultez l'exemple de requête dans la section Exemples.

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	B2841452-CB8D-4F7D-B247-38E1CF7334F8
DryRun	boolean	Indique si seul un test à blanc a été effectué. Si ce paramètre est true, le système a effectué des pré-vérifications telles que la validité des paramètres, les autorisations d'identité, l'existence des ressources, les limites de quota et les relations de dépendance, sans créer, mettre à jour ou supprimer de ressources réelles, déclencher de tâches de déroutage 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 a réussi, DryRun=true est renvoyé dans la réponse, ce qui permet de la distinguer d'une réponse d'appel réel. Si le test à blanc a échoué, un code d'erreur lisible par machine est renvoyé (tel que ErrorParamsInvalid pour les erreurs de paramètre, ErrorAuthentication pour les autorisations insuffisantes, ou ErrorInstanceOpenIpNumExceed pour un quota insuffisant). Une valeur false (valeur par défaut) indique que la requête a été initiée et que l'opération d'activation a été effectuée.	true

Exemples

JSON format

{
  "RequestId": "B2841452-CB8D-4F7D-B247-38E1CF7334F8",
  "DryRun": true
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	ErrorParamsNotEnough	Parameters are insufficient.	Parameters are insufficient.
400	ErrorDBSelect	An error occurred while querying database.	An error occurred while querying database.
400	ErrorInstanceStatusNotNormal	This operation is not supported when the instance is in the current state.	This operation is not supported when the instance is in the current state.
400	ErrorRecordLog	An error occurred while updating the operation log.	An error occurred while updating the operation log.
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.	This request uses the same client token as the previous request, but not the same. Do not reuse client tokens in different requests unless the request is the same.
400	InvalidClientToken	ClientToken format invalid. Only ASCII letters, digits, hyphens and underscores are allowed, max 64 characters.
401	ErrorAuthentication	An authentication error occurred.	An authentication error occurred.
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.