查询代播的网段列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| ddosdiversion:QueryNetList | get |
|
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| SaleId | string | 否 | 代播实例的 ID。 | ddos_diversion_public_cn-xxxxxxxxxxxxx |
| Net | string | 否 | 代播实例的网段。 说明
代播实例没有扩展网段时，表示实例的网段。代播实例有扩展网段时，表示扩展的网段，与 MainNet 参数配合使用。
| 192.168.XX.XX/24 |
| Mode | string | 否 | 调度模式。取值：
| netflow-auto |
| MainNet | string | 否 | 具有扩展网段的代播实例的主网段。如果查询的代播实例没有扩展网段，此参数为空。 | 192.168.XX.XX/22 |
| Page | long | 否 | 页码。 默认值：1。 | 1 |
| Num | long | 否 | 数量。默认值：100。 | 100 |
返回参数
示例
正常返回示例
JSON格式
{
"Code": 200,
"RequestId": "24B652B5-AEFF-3F03-9114-00D053C42277",
"Message": "successful",
"Data": {
"Total": 10,
"Page": 1,
"Num": 100,
"Nets": [
{
"UserId": "57690941xxxxxxxx",
"SaleId": "ddos_diversion_public_cn-xxxxxxxxxxxxx",
"UpstreamType": "aliyun_line",
"Net": "192.168.XX.XX/24",
"NetType": "ipv4",
"Mode": "manual",
"DeclaredState": 0,
"Declared": [
{
"Region": "oe26",
"Declared": "0"
}
],
"GmtCreate": "2024-09-05 13:52:50",
"GmtModify": "2024-09-05 13:59:55",
"NetExtend": "0",
"DDoSDefense": {
"DjPolicy": {
"PolicyName": "gf_origin_xxxxx"
},
"CleanTh": {
"Mbps": 0,
"Pps": 0
},
"HoleTh": {
"ThreshMbps": 0
}
},
"FwdEffect": 1,
"NetMain": "192.168.XX.XX/22",
"Permit": 2
}
]
}
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | AuthenticationFailed | User authentication failed. | 用户认证失败。 |
| 400 | AutoScheduleRuleExist | The auto schedule rule already exists. | 调度规则已存在。 |
| 400 | AutoScheduleRuleNotExist | The auto schedule rule dose not exist. | 调度规则不存在。 |
| 400 | BlackHoleConfigurationError | A black hole configuration error occurred. | 黑洞配置错误。 |
| 400 | CleanConfigurationError | A clean configuration error occurred. | 清洗配置错误。 |
| 400 | CoveredNet | The CIDR block is overwritten. | 网段被其他网段覆盖。 |
| 400 | DatabaseError | A database error. | 数据库错误。 |
| 400 | DeclaredNet | The CIDR block has been advertised. | 网段处于宣告状态。 |
| 400 | DefenseConfigurationError | A defense configuration error occurred. | 防护配置错误。 |
| 400 | ForwardConfigurationNotExist | The CIDR block forwarding configuration is not found. | 网段转发配置不存在。 |
| 400 | ForwardNotExist | The CIDR block zone forwarding configuration is not found. | 网段可用区转发配置不存在。 |
| 400 | ForwardRuleNotExist | The CIDR block forwarding rule is not found. | 网段转发规则不存在。 |
| 400 | HttpFailed | HTTP request failed. | HTTP 请求失败。 |
| 400 | IDNSubnetsCountLimit | The maximum number of IDCs of the instance is exceeded. | 实例的IDC数量达到上限 |
| 400 | InstanceExist | The instance already exists. | 实例已经存在。 |
| 400 | InstanceNetConfigurationExist | The instance CIDR block configuration already exists. | 实例网段配置已存在。 |
| 400 | InstanceNotExist | The instance is not found. | 实例不存在。 |
| 400 | InstanceUpstreamLimit | The maximum number of reinjection configurations for the instance is exceeded. | 实例的回注配置数量受限。 |
| 400 | InternalError | An internal error occurred. | 内部错误。 |
| 400 | InvalidNet | Invalid CIDR block. | 网段不合法。 |
| 400 | InvalidParam | Invalid parameter value. | 参数非法。 |
| 400 | IPSubnetsCountLimit | The maximum number of CIDR blocks of the instance is exceeded. | 实例的网段数量达到上限。 |
| 400 | JsonDecodeError | Json string decoding failed. | JSON字符串转JSON对象失败。 |
| 400 | NetCannotExtend | The CIDR block cannot be extended. | 网段不能被扩容。 |
| 400 | NetConfigurationExist | The CIDR block configuration already exists. | 网段配置已存在。 |
| 400 | NetConfigurationNotExist | The CIDR block configuration is not found. | 网段配置不存在。 |
| 400 | NetForwardDelete | The CIDR block forwarding is being deleted. | 网段转发删除中。 |
| 400 | NetMaskOutOfRange | The subnet mask of the CIDR block is invalid. | 网段掩码超出范围。 |
| 400 | NetNeedExtend | The CIDR block needs to be extended. | 网段需要扩容。 |
| 400 | NetStatusNotReady | The CIDR block reinjection configuration has not been completed. | 网段回注配置未完成 |
| 400 | NetworkDeclearedFailed | Failed to advertise the CIDR block. | 网段宣告失败。 |
| 400 | NetWorkNotExist | The CIDR block is not found. | 网段不存在。 |
| 400 | NetworkUndeclearedFailed | Failed to cancel the advertisement of the CIDR block. | 网段解除宣告失败。 |
| 400 | ParameterNotEnough | Required parameters are not specified. | 必填参数缺失。 |
| 400 | ParameterOutOfRange | Invalid parameter value. | 参数超出指定取值范围 |
| 400 | RegionNotExist | The region does not exist. | 可用区不存在。 |
| 400 | RequestMethodError | An incorrect request method. | 请求方式错误。 |
| 400 | SubnetCountLimit | The maximum number of subnets is exceeded. | 子网数量达到上限。 |
| 400 | UnKnownError | An unknown error occurred. | 未知错误。 |
| 400 | UpsteamNotComplete | The reinjection configuration has not been completed. | 网段回注配置未完成。 |
| 400 | UpstreamConfigurationNotExist | The reinjection configuration is not found. | 回注配置不存在。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2024-09-18 | OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更 | 查看变更详情 |
| 2024-09-05 | OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更 | 查看变更详情 |
| 2024-04-28 | OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更 | 查看变更详情 |
| 2023-12-12 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2023-12-11 | OpenAPI 错误码发生变更 | 查看变更详情 |