ModifyDefenseThreshold - Anti-DDoS - Alibaba Cloud Documentation Center

Changes the scrubbing thresholds for an asset. The asset can be an elastic IP address (EIP). The asset can also be an Elastic Compute Service (ECS) instance or Server Load Balancer (SLB) instance that is assigned a public IP address.

Operation description

You can call the ModifyDefenseThreshold operation to change the scrubbing thresholds for an asset.

Limits

You can call this operation up to 10 times per second per account. If the number of the calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
DdosRegionId	string	Yes	The region ID of the asset for which you want to change the scrubbing thresholds. Note You can call the DescribeRegions operation to query the most recent region list.	cn-hangzhou
InstanceType	string	Yes	The type of the asset. Valid values: ecs: ECS instance slb: SLB instance eip: EIP	ecs
InstanceId	string	Yes	The ID of the asset. Note You can call the DescribeInstance operation to query the IDs of ECS instances, SLB instances, and EIPs within the current Alibaba Cloud account.	i-uf6idy3c57psf7vu****
Bps	integer	No	Specifies the traffic scrubbing threshold. Unit: Mbit/s. The traffic scrubbing threshold cannot exceed the peak inbound or outbound Internet traffic, whichever is larger, of the asset. You can use the monitoring tool that is provided by the asset to query the Internet traffic of the asset: For more information about how to query the Internet traffic of an ECS instance, see Query monitoring information of an instance. For more information about how to query the number of packets of an SLB instance, see View monitoring data in the console.	100
Pps	integer	No	Specifies the packet scrubbing threshold. Unit: packets per second (pps). The packet scrubbing threshold cannot exceed the peak number of inbound or outbound packets, whichever is larger, of the asset. You can use the monitoring tool that is provided by the asset to query the number of packets of the asset: For more information about how to query the number of packets of an ECS instance, see Query monitoring information of an instance. For more information about how to query the number of packets of an SLB instance, see View monitoring data in the console.	70000
IsAuto	boolean	No	Specifies whether to automatically adjust the scrubbing threshold based on the traffic load on the asset. Valid values: true: automatically adjusts the scrubbing thresholds. You do not need to configure the Bps and Pps parameters. false: The scrubbing threshold is not automatically adjusted. You must configure the Bps and Pps parameters. Default value: false.	false
InternetIp	string	No	The IP address of the asset.	192.0.XX.XX

Response parameters

Parameter	Type	Description	Example
	object
RequestId	string	The ID of the request, which is used to locate and troubleshoot issues.	BC0607F8-A9F3-5E11-977B-D59CD58C64ED

Examples

Sample success responses

JSONformat

{
  "RequestId": "BC0607F8-A9F3-5E11-977B-D59CD58C64ED"
}

Error codes

For a list of error codes, visit the Service error codes.