Queries anti-DDoS diversion instances.
Debugging
Authorization information
There is currently no authorization information disclosed in the API.
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| SaleId | string | No | The ID of the anti-DDoS diversion instance. | ddos_diversion_public_cn-xxxxxxxxxxxxx |
| Name | string | No | The name of the instance. | |
| Status | string | No | The status of the instance. Valid values:
| normal |
| Page | long | No | The page number. Default value: 1 | 1 |
| Num | long | No | The number of entries per page. Default value: 100. | 100 |
Response parameters
Examples
Sample success responses
JSONformat
{
"Code": 200,
"RequestId": "B0949F09-B9C1-1D5E-8F27-0A5BF3CD5D95",
"Message": "successful",
"Data": [
{
"Total": 10,
"Page": 1,
"Num": 100,
"Instances": [
{
"UserId": "177xxxxxxxxxxxxx",
"SaleId": "ddos_diversion_public_cn-xxxxxxxxxxxxx",
"InstanceId": "ddos_diversion_public_cn-xxxxxxxxxxxxx_xxxxxx",
"Name": "",
"Status": "normal",
"Comment": "",
"Message": "successful",
"Spec": {
"IdcNumbers": "1",
"NormalBandwidth": "100",
"IpSubnetNums": "1",
"Coverage": "international_and_hmt",
"Edition": "enterprise",
"MitigationCapacity": "unlimited",
"MitigationNums": "unlimited",
"DiversionType": "on-demand",
"MitigationAnalysis": "off",
"MitigationAnalysisCapacity": "3T",
"InitialInstallation": "gre_tunnel_by_pccw",
"InitialQty": "1"
},
"GmtExpire": "2023-02-23 00:00:00",
"GmtCreate": "2022-12-15 11:10:42",
"GmtModify": "2022-12-15 11:10:42"
}
]
}
]
}Error codes
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 400 | AuthenticationFailed | User authentication failed. | User authentication failed. |
| 400 | AutoScheduleRuleExist | The auto schedule rule already exists. | The scheduling rule already exists. |
| 400 | AutoScheduleRuleNotExist | The auto schedule rule dose not exist. | The scheduling rule does not exist. |
| 400 | BlackHoleConfigurationError | A black hole configuration error occurred. | The blackhole filtering configuration is invalid. |
| 400 | CleanConfigurationError | A clean configuration error occurred. | The traffic scrubbing configuration is invalid. |
| 400 | CoveredNet | The CIDR block is overwritten. | The specified CIDR block overlaps with another CIDR block. |
| 400 | DatabaseError | A database error. | The database is invalid. |
| 400 | DeclaredNet | The CIDR block has been advertised. | The CIDR block is in the Advertising state. |
| 400 | DefenseConfigurationError | A defense configuration error occurred. | The mitigation settings are invalid. |
| 400 | ForwardConfigurationNotExist | The CIDR block forwarding configuration is not found. | The forwarding configuration of the CIDR block does not exist. |
| 400 | ForwardNotExist | The CIDR block zone forwarding configuration is not found. | The zone forwarding configuration of the CIDR block does not exist. |
| 400 | ForwardRuleNotExist | The CIDR block forwarding rule is not found. | The CIDR block forwarding rule does not exist. |
| 400 | HttpFailed | HTTP request failed. | The HTTP request failed. |
| 400 | IDNSubnetsCountLimit | The maximum number of IDCs of the instance is exceeded. | The number of data centers for the instance has reached the upper limit. |
| 400 | InstanceExist | The instance already exists. | The instance already exists. |
| 400 | InstanceNetConfigurationExist | The instance CIDR block configuration already exists. | The CIDR block configuration of the instance already exists. |
| 400 | InstanceNotExist | The instance is not found. | The instance does not exist. |
| 400 | InstanceUpstreamLimit | The maximum number of reinjection configurations for the instance is exceeded. | The number of reinjection configurations of the instance is limited. |
| 400 | InternalError | An internal error occurred. | An internal error occurred. |
| 400 | InvalidNet | Invalid CIDR block. | The CIDR block is invalid. |
| 400 | InvalidParam | Invalid parameter value. | The parameter is invalid. |
| 400 | IPSubnetsCountLimit | The maximum number of CIDR blocks of the instance is exceeded. | The number of CIDR blocks of the instance has reached the upper limit. |
| 400 | JsonDecodeError | Json string decoding failed. | Failed to convert JSON string to JSON object. |
| 400 | NetCannotExtend | The CIDR block cannot be extended. | The CIDR block cannot be expanded. |
| 400 | NetConfigurationExist | The CIDR block configuration already exists. | The CIDR block configuration already exists. |
| 400 | NetConfigurationNotExist | The CIDR block configuration is not found. | The CIDR block configuration does not exist. |
| 400 | NetForwardDelete | The CIDR block forwarding is being deleted. | The forwarding configuration of the CIDR block is being deleted. |
| 400 | NetMaskOutOfRange | The subnet mask of the CIDR block is invalid. | The subnet mask exceeds the upper limit. |
| 400 | NetNeedExtend | The CIDR block needs to be extended. | The CIDR block needs to be expanded. |
| 400 | NetStatusNotReady | The CIDR block reinjection configuration has not been completed. | Failed to complete the reinjection configuration of the CIDR block. |
| 400 | NetworkDeclearedFailed | Failed to advertise the CIDR block. | Failed to advertise the CIDR block. |
| 400 | NetWorkNotExist | The CIDR block is not found. | The CIDR block does not exist. |
| 400 | NetworkUndeclearedFailed | Failed to cancel the advertisement of the CIDR block. | Failed to withdraw the advertising of the CIDR block. |
| 400 | ParameterNotEnough | Required parameters are not specified. | A required parameter is not specified. |
| 400 | ParameterOutOfRange | Invalid parameter value. | The value of the parameter is invalid. |
| 400 | RegionNotExist | The region does not exist. | The zone does not exist. |
| 400 | RequestMethodError | An incorrect request method. | The request method is invalid. |
| 400 | SubnetCountLimit | The maximum number of subnets is exceeded. | The number of subnets has reached the upper limit. |
| 400 | UnKnownError | An unknown error occurred. | An unknown error occurred. |
| 400 | UpsteamNotComplete | The reinjection configuration has not been completed. | Failed to complete the reinjection configuration of the CIDR block. |
| 400 | UpstreamConfigurationNotExist | The reinjection configuration is not found. | The reinjection configuration does not exist. |
For a list of error codes, visit the Service error codes.
Change history
| Change time | Summary of changes | Operation |
|---|---|---|
| 2024-04-28 | The Error code has changed. The response structure of the API has changed | View Change Details |
| 2023-12-11 | The Error code has changed | View Change Details |