Tous les produits
Search
Centre de documentation

:ModifyVpcFirewallControlPolicy

Dernière mise à jour :Aug 06, 2026

Modifie la configuration d'une stratégie de contrôle d'accès pour un groupe de stratégies de pare-feu VPC spécifié.

Description de l'opération

Cette opération modifie la configuration d'une stratégie de contrôle d'accès pour un groupe de stratégies de pare-feu VPC spécifié. Les instances de pare-feu VPC utilisent différentes stratégies de contrôle d'accès pour protéger les instances Cloud Enterprise Network (CEN) et les circuits Express Connect.

Limites de QPS

La limite de requêtes par seconde (QPS) pour cette opération est de 10 pour un utilisateur unique. Si le nombre d'appels à cette opération par seconde dépasse la limite, une limitation de débit est déclenchée. Cela peut affecter votre activité. Planifiez vos appels en conséquence.

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

update

*VpcFirewallControlPolicy

acs:yundun-cloudfirewall::{#accountId}:vpcfirewallcontrolpolicy/{#AclUuid}

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 : chinois (par défaut)

  • en : anglais

zh

AclAction

string

Non

L'action effectuée sur le trafic qui correspond à la stratégie de contrôle d'accès.

Valeurs valides :

  • accept : autorise le trafic.

  • drop : refuse le trafic.

  • 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.

Valeurs valides :

  • ANY (tous les types d'applications)

  • FTP

  • HTTP

  • HTTPS

  • MySQL

  • SMTP

  • SMTPS

  • RDP

  • VNC

  • SSH

  • Redis

  • MQTT

  • MongoDB

  • Memcache

  • SSL

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, spécifiez un bloc CIDR de destination.

    Exemple : 10.2.3.0/24

  • Si DestinationType est défini sur group, spécifiez le nom d'un carnet d'adresses de destination.

    Exemple : db_group

  • Si DestinationType est défini sur domain, spécifiez un nom de domaine de destination.

    Exemple : *.aliyuncs.com

10.2.X.X/XX

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

net

VpcFirewallId

string

Oui

L'identifiant de l'instance de pare-feu VPC. Vous pouvez appeler l'opération DescribeVpcFirewallAclGroupList pour interroger l'identifiant.

  • Si le pare-feu VPC protège une instance CEN, la valeur de ce paramètre est l'identifiant de l'instance CEN.

    Exemple : cen-ervw0g12b5jbw****

  • Si le pare-feu VPC protège un circuit Express Connect, la valeur de ce paramètre est l'identifiant de l'instance de pare-feu VPC.

    Exemple : vfw-a42bbb7b887148c9****

vfw-a42bbb7b887148c9****

Proto

string

Non

Le type de protocole pour le trafic auquel s'applique la stratégie de contrôle d'accès.

Valeurs valides :

  • ANY (tous les types de protocoles)

  • TCP

  • UDP

  • ICMP

TCP

Source

string

Non

L'adresse source dans la stratégie de contrôle d'accès.

Valeurs valides :

  • Si SourceType est défini sur net, spécifiez un bloc CIDR source.

    Exemple : 10.2.4.0/24

  • Si SourceType est défini sur group, spécifiez le nom d'un carnet d'adresses source.

    Exemple : db_group

10.2.X.X/XX

AclUuid

string

Oui

L'identifiant unique de la stratégie de contrôle d'accès.

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 DescribeVpcFirewallControlPolicy pour interroger l'identifiant.

00281255-d220-4db1-8f4f-c4df221a****

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

net

DestPortType

string

Non

Le type de port de destination pour le trafic auquel s'applique la stratégie de contrôle d'accès.

  • port : port

  • group : carnet d'adresses de ports

port

DestPortGroup

string

Non

Le nom du carnet d'adresses de ports de destination pour le trafic auquel s'applique la stratégie de contrôle d'accès.

my_port_group

Release

string

Non

L'état de la stratégie de contrôle d'accès. Par défaut, une stratégie de contrôle d'accès est activée après sa création. Valeurs valides :

  • true : active la stratégie de contrôle d'accès.

  • false : désactive la stratégie de contrôle d'accès.

true

ApplicationNameList

array

Non

La liste des noms d'applications.

string

Non

Le nom de l'application.

["ANY"]

RepeatType

string

Non

Le type de récurrence pour la prise d'effet de la stratégie. Valeurs valides :

  • Permanent (par défaut) : la stratégie est toujours en vigueur.

  • None : la stratégie prend effet pendant une période spécifique.

  • Daily : la stratégie prend effet quotidiennement.

  • Weekly : la stratégie prend effet hebdomadairement.

  • Monthly : la stratégie prend effet mensuellement.

Valeurs valides :

  • Daily :

    La stratégie prend effet quotidiennement.

  • Monthly :

    La stratégie prend effet mensuellement.

  • Permanent :

    La stratégie est toujours en vigueur.

  • Weekly :

    La stratégie prend effet hebdomadairement.

  • None :

    La stratégie prend effet pendant une période spécifique.

Permanent

RepeatDays

array

Non

Les jours de la semaine ou du mois auxquels la stratégie prend effet.

  • Si RepeatType est défini sur Permanent, None ou Daily, ce paramètre est vide. Exemple : []

  • Si RepeatType est défini sur Weekly, ce paramètre ne peut pas être vide. Exemple : [0, 6]

Remarque

Si RepeatType est défini sur Weekly, les éléments du tableau ne peuvent pas être répétés.

  • Si RepeatType est défini sur Monthly, ce paramètre ne peut pas être vide. Exemple : [1, 31]

Remarque

Si RepeatType est défini sur Monthly, les éléments du tableau ne peuvent pas être répétés.

integer

Non

Le jour de la semaine ou du mois auquel la stratégie prend effet.

Remarque

Si RepeatType est défini sur Weekly, les valeurs valides sont de 0 à 6. La semaine commence le dimanche. Si RepeatType est défini sur Monthly, les valeurs valides sont de 1 à 31.

1

RepeatStartTime

string

Non

L'heure de début de la récurrence. L'heure est au format HH:mm. L'heure est à l'heure pile ou à la demi-heure, et doit être au moins 30 minutes avant l'heure de fin. Exemple : 08:00.

Remarque

Si RepeatType est défini sur Permanent ou None, ce paramètre est vide. Si RepeatType est défini sur Daily, Weekly ou Monthly, vous devez spécifier ce paramètre.

08:00

RepeatEndTime

string

Non

L'heure de fin de la récurrence. L'heure est au format HH:mm. L'heure est à l'heure pile ou à la demi-heure, et doit être au moins 30 minutes après l'heure de début. Exemple : 23:30.

Remarque

Si RepeatType est défini sur Permanent ou None, ce paramètre est vide. Si RepeatType est défini sur Daily, Weekly ou Monthly, vous devez spécifier ce paramètre.

23:30

StartTime

integer

Non

L'heure de début de la période de validité de la stratégie. La valeur est un horodatage UNIX. L'heure est à l'heure pile ou à la demi-heure, et doit être au moins 30 minutes avant l'heure de fin.

Remarque

Si RepeatType est défini sur Permanent, ce paramètre est vide. Si RepeatType est défini sur None, Daily, Weekly ou Monthly, vous devez spécifier ce paramètre.

1694761200

EndTime

integer

Non

L'heure de fin de la période de validité de la stratégie. La valeur est un horodatage UNIX. L'heure est à l'heure pile ou à la demi-heure, et doit être au moins 30 minutes après l'heure de début.

Remarque

Si RepeatType est défini sur Permanent, ce paramètre est vide. Si RepeatType est défini sur None, Daily, Weekly ou Monthly, vous devez spécifier ce paramètre.

1694764800

DomainResolveType

string

Non

La méthode de résolution de nom de domaine pour la stratégie de contrôle d'accès. Valeurs valides :

  • FQDN : basée sur le nom de domaine entièrement qualifié (FQDN)

  • DNS : basée sur la résolution DNS dynamique

  • FQDN_AND_DNS : basée sur le FQDN et la résolution DNS dynamique

FQDN

Éléments de réponse

Élément

Type

Description

Exemple

object

RequestId

string

L'identifiant de la requête.

CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D

Exemples

JSON format

{
  "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. The aliUid parameter is invalid.
400 ErrorDBSelect An error occurred while querying database. An error occurred while querying database.
400 ErrorParametersSource The source is invalid. The source is invalid.
400 ErrorParametersProto The protocol is invalid. The protocol is invalid.
400 ErrorParametersDestination The Destination parameter is invalid. The Destination parameter 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 ErrorAddressCountExceed The maximum number of addresses is exceeded. The maximum number of address is exceeded.
400 ErrorAclNotExist The ACL does not exist. The ACL does not exist.
400 ErrorRecordLog An error occurred while updating the operation log. An error occurred while updating the operation log.
400 ErrorAclEffectiveTimeNonPermanent ACL rule is not allowed to update status when effective is not permanent. ACL rule is not allowed to update status when effective is not permanent.
400 ErrorUUIDNew The UUID is invalid. The UUID is invalid.
400 ErrorParameterIpVersion The IP version is invalid. The IP version is invalid.
400 ErrorParametersDirection The direction is invalid. The direction is invalid.
400 ErrorDomainResolve A domain resolution error occurred. An error occurred while resolving the domain.
400 ErrorParameters Parameters error. Parameter error.
400 ErrorAclExtendedCountExceed ACL or extended ACL rules are not matched. The quota for access control policies or extra access control policies is exhausted.
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 ErrorDBUpdate internal error: sql updat. An error occurred while updating the database.
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 ErrorParametersFtpNotSupport domain destination not support ftp. FTP application is not supported when the policy destination is a domain name
400 ErrorParametersApplicationName Specified parameter ApplicationName is not valid. Specified parameter ApplicationName is not valid.
400 ErrorParametersApplicationNameList Specified parameter ApplicationNameList is not valid. Specified parameter ApplicationNameList is not valid.
400 ErrorParametersAclUuid Specified parameter AclUuid is not valid. Specified parameter AclUuid is not valid.
400 ErrorAddressGroupNotExist The address group does not exist. The address group does not exist.
400 ErrorParametersVpcFirewallId Specified parameter VpcFirewallId is not valid. Specified parameter VpcFirewallId is not valid.

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

Notes de version

Consultez Notes de version pour la liste complète.