Creates a scheduling rule for an on-demand instance.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | CreateSchedruleOnDemand |
The operation that you want to perform. Set the value to CreateSchedruleOnDemand. |
InstanceId | String | Yes | ddosbgp-cn-z2q1qzxb**** |
The ID of the on-demand instance. Note You can call the DescribeOnDemandInstance operation to query the IDs of all on-demand instances.
|
RuleAction | String | Yes | declare |
The scheduling action. Set the value to declare, which indicates that the route is advertised. |
RuleConditionCnt | String | Yes | 3 |
If the inbound bandwidth or packets consecutively exceed the threshold for the specified number of times, the scheduling rule is triggered and traffic is rerouted to the on-demand instance. The specified number of times is the value of this parameter. Note The threshold of inbound bandwidth is the value of RuleConditionMbps. The threshold of inbound packets is the value of RuleConditionKpps.
|
RuleConditionKpps | String | Yes | 10 |
The threshold of inbound packets. Unit: Kpps. Minimum value: 10. |
RuleConditionMbps | String | Yes | 100 |
The threshold of inbound bandwidth. Unit: Mbit/s. Minimum value: 100. |
RuleName | String | Yes | ddosbgp-cn-z2q1qzxb**** |
The name of the scheduling rule. The name can contain lowercase letters, digits, hyphens (-), and underscores (_).
The name can be up to 32 characters in length. We recommend that you use the ID of
the on-demand instance as the name. Example: |
RuleSwitch | String | Yes | on |
Specifies whether the scheduling rule is enabled. Valid values:
|
RuleUndoBeginTime | String | Yes | 03:00 |
The start time of the period during which the scheduling rule is automatically stopped.
The time must be in the 24-hour clock and in the If the system detects that DDoS attacks stop, the system no longer reroutes traffic to the on-demand instance from the time you specified. We recommend that you set this parameter to a value that is defined as off-peak hours. Note This parameter takes effect only when the RuleUndoMode parameter is set to auto.
|
RuleUndoMode | String | Yes | auto |
The stop method of the scheduling rule. Valid values:
|
TimeZone | String | Yes | GMT-08:00 |
The time zone of the time when the scheduling rule automatically stops. The time zone
must be in the For example, the value Note This parameter takes effect only when the RuleUndoMode parameter is set to auto.
|
RuleUndoEndTime | String | No | 03:05 |
The end time of the period during which the scheduling rule is automatically stopped.
The time must be in the 24-hour clock and in the |
RegionId | String | No | cn-zhangjiakou |
The region ID of the on-demand instance. Note You can call the DescribeRegions operation to query all regions supported by Anti-DDoS Origin.
|
All Alibaba Cloud API operations must include common request parameters. For more information about common request parameters, see Common parameters.
For more information about sample requests, see the "Examples" section of this topic.
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | BD06F539-2FBE-450D-9391-7EFF787128F5 |
The ID of the request. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=CreateSchedruleOnDemand
&InstanceId=ddosbgp-cn-z2q1qzxb****
&RuleAction=declare
&RuleConditionCnt=3
&RuleConditionKpps=10
&RuleConditionMbps=100
&RuleName=ddosbgp-cn-z2q1qzxb****
&RuleSwitch=on
&RuleUndoBeginTime=03:00
&RuleUndoMode=auto
&TimeZone=GMT-08:00
&<Common request parameters>
Sample success responses
XML
format
<CreateSchedruleOnDemandResponse>
<RequestId>BD06F539-2FBE-450D-9391-7EFF787128F5</RequestId>
</CreateSchedruleOnDemandResponse>
JSON
format
{
"RequestId": "BD06F539-2FBE-450D-9391-7EFF787128F5"
}
Error codes
For a list of error codes, visit the API Error Center.