云服务器IP / API接口 / 获取资源
获取资源
推荐阅读时长:4分钟获取云IP资源接口用于根据项目 ID 和服务器类型查询可用云服务器IP资源。购买和线路切换前,建议先调用该接口确认可用地区和库存。
接口信息
| 请求方式 | POST |
|---|---|
| 接口路径 | /api/v1/cloud/getNodeList |
| 鉴权要求 | Authorization: Bearer {token} |
| Content-Type | application/json |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
projectId | integer | 是 | 项目 ID,必须大于 0。 |
serverType | integer | 是 | 服务器类型,可选 2、4。 |
请求示例
{
"projectId": 1,
"serverType": 2
}
响应说明
| 字段 | 类型 | 说明 |
|---|---|---|
code | integer | 状态码,成功为 200。 |
msg | string | 响应消息。 |
data | array | 云服务器IP资源列表,具体字段以后端实际返回为准。 |
regionId | integer | 地区/线路 ID,购买和切换时常用。 |
count | integer | 可用数量或库存数量。 |
响应示例
{
"code": 200,
"msg": "获取云IP成功",
"data": [
{
"regionId": 10001,
"province": "广东",
"region": "深圳",
"count": 10
}
]
}
建议:资源会随库存变化,下单或切换前应重新获取一次资源列表。
