额外公网IP查询
更新时间：2025-05-30 10:57:03
用于查询已申请的额外公网IP。
- 单用户调用频率：300/5min
- 适用产品：边缘云主机
API鉴权说明详见：API鉴权概览
请求参数
查询参数
| 参数名称 | 描述 |
|---|---|
nodeNameString | 可选
节点名称，多个用英文逗号分隔 |
serverIdString | 可选
虚拟机ID，多个用英文逗号分隔 |
serverIpString | 可选
虚拟机主IP，多个用英文逗号分隔 |
edgeIpString | 可选
额外Ip，多个用英文逗号分隔 |
stateString | 可选
IP状态：FREE-空闲未绑定；ASSIGNED-已绑定 |
返回参数
Body 参数
| 参数名称 | 描述 |
|---|---|
edgeIpsList | 额外Ip详细信息 |
edgeIpString | 额外Ip |
stateString | IP状态：FREE-空闲未绑定；ASSIGNED-已绑定 |
serverIdString | 绑定的虚拟机ID |
serverIpList | 绑定的虚拟机外网IP |
nodeNameString | 所属节点名称 |
occupancyFlagBoolean | 是否独占 |
netmaskString | 子网掩码 |
错误码
| 错误代码（code） | 描述（message） | HTTP状态码 | 语义 |
|---|---|---|---|
| 26032002 | Error querying edge IP:26032002 | 500 | 查询额外ip错误码：26032002 |
示例
VMP额外IP查询成功示例
- 请求示例 复制成功
GET /edgeIp?state=FREE
- 返回示例 复制成功
{ "edgeIps": [{ "edgeIp": "36.250.74.180", "netmask": "255.255.255.0" "occupancyFlag": -1, "state": "ASSIGNED", "serverId": "4b4e37c392bf48378e87536ea6e2be89", "serverIp": ["36.250.74.180"], "nodeName": "HB-langfang2-DX" }] }
本篇文档内容对您是否有帮助？
有帮助
我要反馈