ModifyControlPolicy - - Centre de documentation Alibaba Cloud

Modifie les configurations d'une stratégie de contrôle d'accès.

Description de l'opération

Cette opération permet de modifier les configurations d'une stratégie de contrôle d'accès qui autorise, refuse ou surveille le trafic via 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, les appels d'API sont limités, ce qui peut affecter votre activité. Appelez cette opération à une fréquence 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:ModifyControlPolicy

update

*ControlPolicy.

acs:cloudfirewall::{#accountId}:controlpolicy/{#AclUuid}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ClientToken	string	Non	Le jeton d'idempotence.	ddadxefexxxx
DryRun	boolean	Non	Indique si un test à blanc doit être effectué.
Lang `deprecated`	string	Non	La langue de la requête et de la réponse. Valeurs valides : zh (par défaut) : chinois en : anglais	zh
AclAction	string	Non	L'action que la stratégie de contrôle d'accès effectue sur le trafic qui traverse le pare-feu. Valeurs valides : accept : autorise l'accès. drop : refuse. log : surveille le trafic.	accept
ApplicationName `deprecated`	string	Non	Le type d'application pris en charge par la stratégie de contrôle d'accès. Les types d'application suivants sont pris en charge : ANY HTTP HTTPS MySQL SMTP SMTPS RDP VNC SSH Redis MQTT MongoDB Memcache SSL Remarque ANY indique que la stratégie s'applique à tous les types d'applications. Remarque Vous devez spécifier ApplicationNameList ou ApplicationName. Vous ne pouvez pas laisser les deux paramètres vides. Si vous spécifiez les deux paramètres, la valeur de ApplicationNameList est prioritaire.	HTTP
Description	string	Non	La description de la stratégie de contrôle d'accès.	test
DestPort	string	Non	Le port de destination dans la stratégie de contrôle d'accès.	80
Destination	string	Non	L'adresse de destination dans la stratégie de contrôle d'accès. Si DestinationType est défini sur net, Destination est un bloc CIDR de destination. Exemple : 1.2.XX.XX/24. Si DestinationType est défini sur group, Destination est un nom de carnet d'adresses de destination. Exemple : db_group. Si DestinationType est défini sur domain, Destination est un nom de domaine de destination. Exemple : .aliyuncs.com. Si DestinationType* est défini sur location, Destination est une zone de destination. Pour plus d'informations sur l'encodage positionnel des zones, consultez les sections suivantes. Exemple : ["BJ11", "ZB"].	192.0.XX.XX/24
DestinationType	string	Non	Le type de l'adresse de destination dans la stratégie de contrôle d'accès. Valeurs valides : net : bloc CIDR de destination group : carnet d'adresses de destination domain : nom de domaine de destination location : région de destination	net
Direction	string	Non	La direction du trafic de la stratégie de contrôle d'accès. Valeurs valides : in : trafic entrant out : trafic sortant	in
Proto	string	Non	Le type de protocole de sécurité dans la stratégie de contrôle d'accès. Les types de protocole suivants sont pris en charge : ANY TCP UDP ICMP Remarque ANY indique que la stratégie s'applique à tous les types de protocoles. Remarque Si la direction du trafic est sortante et que l'adresse de destination est un carnet d'adresses de renseignements sur les menaces ou un carnet d'adresses de services cloud de type domaine, vous pouvez définir le protocole sur TCP ou ANY. Si vous sélectionnez TCP, l'application peut être définie sur HTTP, HTTPS, SMTP, SMTPS ou SSL. Si vous sélectionnez ANY, l'application ne peut être définie que sur ANY.	TCP
Source	string	Non	L'adresse source dans la stratégie de contrôle d'accès. Si SourceType est défini sur net, Source est un bloc CIDR source. Exemple : 1.2.XX.XX/24. Si SourceType est défini sur group, Source est un nom de carnet d'adresses source. Exemple : db_group. Si SourceType est défini sur location, Source est une zone source. Pour plus d'informations sur l'encodage positionnel des zones, consultez les sections suivantes. Exemple : ["BJ11", "ZB"].	192.0.XX.XX/24
AclUuid	string	Oui	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 l'identifiant unique de la stratégie. Vous pouvez appeler l'opération DescribeControlPolicy pour obtenir l'identifiant.	00281255-d220-4db1-8f4f-c4df221ad84c
SourceType	string	Non	Le type de l'adresse source dans la stratégie de contrôle d'accès. Valeurs valides : net : bloc CIDR source group : carnet d'adresses source location : région source	net
DestPortType	string	Non	Le type du port de destination dans la stratégie de contrôle d'accès. Valeurs valides : port : port group : carnet d'adresses de ports	port
DestPortGroup	string	Non	Le nom du carnet d'adresses de ports de destination dans la stratégie de contrôle d'accès.	my_port_group
Release	string	Non	L'état d'activation de la stratégie de contrôle d'accès. Valeurs valides : true : la stratégie est activée. false : la stratégie est désactivée.	true
ApplicationNameList	array	Non	La liste des noms d'applications. Remarque Vous devez spécifier ApplicationNameList ou ApplicationName. Vous ne pouvez pas laisser les deux paramètres vides. Si vous spécifiez les deux paramètres, la valeur de ApplicationNameList est prioritaire.
	string	Non	Le nom de l'application.	HTTP
RepeatType	string	Non	Le type de récurrence pour la période de validité de la stratégie de contrôle d'accès. Valeurs valides : Permanent (par défaut) : toujours None : une seule fois Daily : quotidiennement Weekly : hebdomadairement Monthly : mensuellement Valeurs valides : Daily : quotidiennement. Monthly : mensuellement. Permanent : toujours. Weekly : hebdomadairement. None : une seule fois.	Permanent
RepeatDays	array	Non	Les jours d'une semaine ou d'un mois auxquels la stratégie de contrôle d'accès prend effet. Paramètres pour la période de validité de la stratégie. Si RepeatType est défini sur `Permanent`, `None` ou `Daily`, RepeatDays est un tableau vide. Exemple : [] Si RepeatType est défini sur Weekly, RepeatDays ne doit pas être vide. Exemple : [0, 6] Remarque Si RepeatType est défini sur Weekly, les valeurs dans RepeatDays ne peuvent pas être répétées. Si RepeatType est défini sur `Monthly`, RepeatDays ne doit pas être vide. Exemple : [1, 31] Remarque Si RepeatType est défini sur Monthly, les valeurs dans RepeatDays ne peuvent pas être répétées.
	integer	Non	Le jour de récurrence pour la période de validité de la stratégie de contrôle d'accès. Paramètres pour le jour de récurrence. Remarque Si RepeatType est défini sur Weekly, les valeurs valides vont de 0 à 6. Une semaine commence le dimanche. Si RepeatType est défini sur Monthly, les valeurs valides vont de 1 à 31.	1
RepeatStartTime	string	Non	L'heure de début de récurrence de la période de validité de la stratégie. L'heure est au format HH:mm et utilise une horloge de 24 heures. Exemple : 08:00. Remarque Si RepeatType est défini sur Permanent ou None, ce paramètre est laissé vide. Si RepeatType est défini sur Daily, Weekly ou Monthly, ce paramètre est requis.	08:00
RepeatEndTime	string	Non	L'heure de fin de récurrence de la période de validité de la stratégie. L'heure est au format HH:mm et utilise une horloge de 24 heures. Exemple : 23:00. Remarque Si RepeatType est défini sur Permanent ou None, ce paramètre est laissé vide. Si RepeatType est défini sur Daily, Weekly ou Monthly, ce paramètre est requis.	23:30
StartTime	integer	Non	L'heure de début de la période de validité de la stratégie de contrôle d'accès. La valeur est un horodatage UNIX au format secondes. L'heure doit être à l'heure pile ou à la demi-heure et doit être antérieure d'au moins 30 minutes à l'heure de fin. Paramètres pour l'heure de début. Remarque Si RepeatType est défini sur Permanent, ce paramètre est laissé vide. Si RepeatType est défini sur None, Daily, Weekly ou Monthly, ce paramètre est requis.	1694761200
EndTime	integer	Non	L'heure de fin de la période de validité de la stratégie de contrôle d'accès. La valeur est un horodatage UNIX au format secondes. L'heure doit être à l'heure pile ou à la demi-heure et doit être postérieure d'au moins 30 minutes à l'heure de début. Paramètres pour l'heure de fin. Remarque Si RepeatType est défini sur Permanent, ce paramètre est laissé vide. Si RepeatType est défini sur None, Daily, Weekly ou Monthly, ce paramètre est requis.	1694764800
DomainResolveType	string	Non	La méthode de résolution de nom de domaine de la stratégie de contrôle d'accès. Valeurs valides : FQDN : basé sur FQDN DNS : résolution dynamique basée sur DNS FQDN_AND_DNS : résolution dynamique basée sur FQDN et DNS	FQDN

Éléments de réponse

Élément	Type	Description	Exemple
	object
DryRun	boolean	Indique si la requête est un test à blanc. La valeur true indique que seul un test à blanc a été effectué et qu'aucune modification réelle n'a été apportée.
RequestId	string	L'identifiant de la requête.	CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D

Exemples

JSON format

{
  "DryRun": false,
  "RequestId": "CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	ErrorParametersUid	The aliUid parameter is invalid.	L'Aliuid est invalide.
400	ErrorParametersDirection	The direction is invalid.	La direction n'est pas valide.
400	ErrorDBSelect	An error occurred while querying database.	Une exception de lecture de base de données côté serveur s'est produite. Réessayez plus tard. Si le problème persiste, contactez le support technique.
400	ErrorRecordLog	An error occurred while updating the operation log.	Échec de l'écriture du journal.
400	ErrorParameters	Error Parameters	Une erreur de paramètre s'est produite.
400	ErrorParametersSource	The source is invalid.	La source est invalide.
400	ErrorParametersDestination	The Destination parameter is invalid.	La destination n'est pas valide.
400	ErrorParametersFtpNotSupport	domain destination not support ftp.	L'application FTP n'est pas prise en charge lorsque la destination de la stratégie est un nom de domaine.
400	ErrorAclDomainAnyCountExceed	The number of resolved domain names cannot exceed 200. ACL configuration can be continued for HTTP, HTTPS, SMTP, SMTPS, and SSL applications.	Le nombre de noms de domaine résolus dépasse 200. Les applications HTTP, HTTPS, SMTP, SMTPS et SSL prennent en charge davantage de configurations.
400	ErrorAclNotExist	The ACL does not exist.	L'ACL spécifiée n'existe pas.
400	ErrorAclEffectiveTimeNonPermanent	ACL rule is not allowed to update status when effective is not permanent.	L'état d'une stratégie de contrôle d'accès ne peut pas être mis à jour lorsque la période de validité n'est pas définie sur permanente.
400	ErrorAclExtendedCountExceed	ACL or extended ACL rules are not matched.	Les règles d'ACL ou d'ACL étendues ne correspondent pas.
400	ErrorDBUpdate	internal error: sql updat.	La requête a échoué en raison de l'échec de l'opération de mise à jour de la base de données.
400	ErrorDBInsert	An error occurred while performing an insert operation in the database.	Une erreur interne s'est produite lors de l'opération d'insertion dans la base de données.
400	ErrorMarshalJSON	An error occurred while encoding JSON.	Une erreur interne s'est produite : l'encodage JSON a échoué.
400	ErrorParametersDestinationCount	Exceeding the number of countries in a single ACL.	Le nombre de régions sélectionnées pour une ACL unique a été dépassé. Divisez l'ACL en plusieurs ACL.
400	ErrorEmptyDomainResolveType	Empty DomainResolveType only support HTTP/HTTPS/SSL/SMTP/SMTPS apps.	Un mode de résolution de nom de domaine vide n'est pas pris en charge.
400	ErrorParametersApplicationName	Specified parameter ApplicationName is not valid.	Le type d'application pris en charge par la stratégie de contrôle d'accès n'est pas valide.
400	ErrorParametersApplicationNameList	Specified parameter ApplicationNameList is not valid.	La liste des types d'application pris en charge par la stratégie de contrôle d'accès n'est pas valide.
400	ErrorParametersAclUuid	Specified parameter AclUuid is not valid.	L'UUID de l'ACL spécifié n'est pas valide.
400	ErrorAddressGroupNotExist	The address group does not exist.	Le carnet d'adresses n'existe pas.
400	ErrorParametersProtoAppsMismatch	The protocol and applicationName mismatch.	Le protocole ne correspond pas à l'application.
400	ErrorApplicationTemplateNotFound	Application template not found.	Le modèle d'application n'existe pas.
400	ErrorWebFilterTemplateNotFound	Web filter template not found.	Le modèle de filtrage web n'existe pas.
400	InvalidClientToken	ClientToken format invalid. Only ASCII letters, digits, hyphens and underscores are allowed, max 64 characters.
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.
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.