All Products
Search
Document Center

Cloud Firewall:ModifyVpcFirewallConfigure

Last Updated:Jul 27, 2026

Modifies the configurations of a virtual private cloud (VPC) firewall that controls traffic between two VPCs connected by using an Express Connect circuit.

Operation description

This operation is used to modify the configurations of a virtual private cloud (VPC) firewall that controls traffic between two VPCs connected by using an Express Connect circuit. Before you invoke this operation, make sure that you have created a virtual private cloud (VPC) firewall by invoking the CreateVpcFirewallConfigure operation.

QPS limit

The single-user QPS limit for this operation is 10 calls per second. If the number of calls per second exceeds the limit, throttling is triggered. Throttling may affect your business. Invoke this operation within the limit.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

yundun-cloudfirewall:ModifyVpcFirewallConfigure

update

*VpcFirewall

acs:cloudfirewall::{#accountId}:vpcfirewall/{#VpcFirewallId}

None None

Request parameters

Parameter

Type

Required

Description

Example

Lang

string

No

The language of the content within the request and response. Valid values:

  • zh (default): Chinese.

  • en: English.

zh

VpcFirewallId

string

Yes

The instance ID of the virtual private cloud (VPC) firewall.

Note

You can invoke the DescribeVpcFirewallList operation to query the instance ID of the virtual private cloud (VPC) firewall.

vfw-m5e7dbc4y****

VpcFirewallName

string

Yes

The instance name of the virtual private cloud (VPC) firewall.

test-vpc-firewall

LocalVpcCidrTableList

string

Yes

The CIDR block information of the local VPC, in JSON format. The following parameters are included:

  • RouteTableId: the routing table ID of the local VPC.

  • RouteEntryList: specified in JSON format and contains DestinationCidr (the destination CIDR block of the local VPC) and NextHopInstanceId (the next hop instance ID of the local VPC).

Note

You can invoke the DescribeVpcFirewallDetail operation to query the CIDR block information of the local VPC for the virtual private cloud (VPC) firewall.

[{"RouteTableId":"vtb-1234","RouteEntryList":[{"DestinationCidr":"192.168.XX.XX/24","NextHopInstanceId":"vrt-m5eb5me6c3l5sezae****"}]},{"RouteTableId":"vtb-1235","RouteEntryList":[{"DestinationCidr":"192.168.XX.XX/24","NextHopInstanceId":"vrt-m5eb5me6c3l5sezae****"}]}]

PeerVpcCidrTableList

string

Yes

The CIDR block information of the peer VPC, in JSON format. The following parameters are included:

  • RouteTableId: the routing table ID of the peer VPC.

  • RouteEntryList: specified in JSON format and contains DestinationCidr (the destination CIDR block of the peer VPC) and NextHopInstanceId (the next hop instance ID of the peer VPC).

Note

You can invoke the DescribeVpcFirewallDetail operation to query the CIDR block information of the peer VPC for the virtual private cloud (VPC) firewall.

[{"RouteTableId":"vtb-1234","RouteEntryList":[{"DestinationCidr":"192.168.XX.XX/24","NextHopInstanceId":"vrt-m5eb5me6c3l5sezae****"}]},{"RouteTableId":"vtb-1235","RouteEntryList":[{"DestinationCidr":"192.168.XX.XX/24","NextHopInstanceId":"vrt-m5eb5me6c3l5sezae****"}]}]

MemberUid

string

No

The UID of the member accounts of the current Alibaba Cloud account.

258039427902****

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

850A84D6-0DE4-4797-A1E8-00090125k6f8

Examples

Success response

JSON format

{
  "RequestId": "850A84D6-0DE4-4797-A1E8-00090125k6f8"
}

Error codes

HTTP status code

Error code

Error message

Description

400 ErrorAliUid The aliuid is invalid. The aliuid is invalid.
400 ErrorVpcFirewallNotFound The specified VPC firewall does not exist. Please select again. The specified VPC firewall does not exist. Enter another value.
400 ErrorDBSelectError A database select error occurred. The error message returned because an internal error has occurred in querying the database.
400 ErrorUnmarshalJSON An error occurred while parsing JSON. An error occurred while decoding JSON.
400 ErrorDBTxError A database transaction error occurred. The error message returned because an internal error has occurred in the database transaction.
400 ErrorDBUpdateError A database update error occurred.
400 ErrorRecordLog An error occurred while updating the operation log. An error occurred while updating the operation log.
400 ErrorInvalidMemberUid Member uid is invalid The member is invalid.
400 ErrorFirewallId Firewall ID is invalid. The ID of the firewall is invalid.
400 ErrorFirewallName Firewall name invalid. Firewall name error, please re-enter.
400 ErrorDestCidrError The destination CIDR block is invalid. The specified destination CIDR block is invalid. Enter another value.
400 ErrorDestCidrEmpty The target network segment is empty and cannot be created The destination CIDR block is not specified. The firewall cannot be created.
400 ErrorVpcFirewallExist Vpc firewall already exist. The firewall is already configured and cannot be configured repeatedly.
400 ErrorFirewallStatusCannotModify Current firewall status, configuration not allowed You cannot configure the firewall because the status of the firewall is invalid.
400 ErrorSameCidrIp The same network segment cannot be configured repeatedly. Please reselect the network segment. The CIDR block is already in use. Specify another CIDR block.
400 ErrorCustomRouteEntryMax The number of target network segments exceeds the maximum limit. Please reduce the number of network segments The number of destination CIDR blocks exceeds the upper limit. Reduce the number of CIDR blocks.
400 ErrorCidrFormat Cidr ip format error. CIDR format error, please re-select
400 ErrorCidrIpAddress Target network segment error, please reselect The destination CIDR block is invalid. Specify another value.
400 ErrorRouteTableIdNotFound Route table id not found. Routing table ID not found

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.