All Products
Search
Document Center

Cloud Firewall:PutDisableFwSwitch

Last Updated:Jan 22, 2026

Disables a firewall switch.

Operation description

This operation disables a firewall switch. After the switch is disabled, traffic no longer passes through Cloud Firewall.

QPS limit

The queries per second (QPS) limit for a single user is 10. If you exceed this limit, your API calls are throttled, which may affect your business.

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

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

SourceIp deprecated

string

No

The source IP address of the requester.

192.0.XX.XX

Lang

string

No

The language of the messages that are returned. Valid values:

  • zh (default): Chinese

  • en: English

zh

IpaddrList

array

No

The list of IP addresses.

Note

You must specify one of the IpaddrList, RegionList, and ResourceTypeList parameters.

["192.0.XX.XX","192.0.XX.XX"]

string

No

The IP address.

192.0.XX.XX

RegionList

array

No

The list of regions.

Note

You must specify one of the IpaddrList, RegionList, and ResourceTypeList parameters.

["cn-hangzhou","cn-shanghai"]

string

No

The region ID.

cn-hangzhou

ResourceTypeList

array

No

The list of asset types.

Note

You must specify one of the IpaddrList, RegionList, and ResourceTypeList parameters.

["EcsPublicIp","NatEip"]

string

No

The asset type. Valid values:

  • BastionHostIP: the egress IP address of a bastion host.

  • BastionHostIngressIP: the ingress IP address of a bastion host.

  • EcsEIP: an EIP of an ECS instance.

  • EcsPublicIP: a public IP address of an ECS instance.

  • EIP: an Elastic IP Address.

  • EniEIP: an EIP of an elastic network interface (ENI).

  • NatEIP: an EIP of a NAT gateway.

  • SlbEIP: an EIP of an SLB instance.

  • SlbPublicIP: a public IP address of an SLB instance.

  • NatPublicIP: a public IP address of a NAT gateway.

  • HAVIP: a high-availability virtual IP address (HAVIP).

EcsPublicIP

MemberUid

string

No

The unique identifier of the member

1234

IpVersion

string

No

The IP version number

4

When you call this operation, you must specify both operation-specific and common request parameters. For more information about common request parameters, see Common parameters. For information about the request format, see the request example in the Examples section of this topic.

Response elements

Element

Type

Description

Example

object

RequestId

string

The ID of the request.

B2841452-CB8D-4F7D-B247-38E1CF7334F8

Examples

Success response

JSON format

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

Error codes

HTTP status code

Error code

Error message

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.
401 ErrorAuthentication An authentication error occurred. An authentication error occurred.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.