获取可用边缘节点列表
更新时间：2021-08-02
接口描述
本接口用于获取可用边缘节点列表。
请求结构
GET /v1/node/type/{type} HTTP/1.1
Host: bec.baidubce.com
Content-Type: application/json; charset=utf-8
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| type | String | 是 | URI参数 | 需要查询的节点种类，目前支持gpu、container、vm、lb四种，分别代表创建GPU、容器、虚机、负载均衡资源时可用的节点列表 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| regionList | List<RegionInfo> | 当前可用节点列表 |
| nodeSum | Integer | 当前可用节点数目 |
错误码
请参照错误返回章节的内容。
请求示例
GET /v1/node/type/container HTTP/1.1
Host: bec.baidubce.com
Content-Type: application/json; charset=utf-8
Authorization: bce-auth-v1/365c9f187eb6430696e57721364381e5/2020-06-24T06:17:39Z/1800/host/0332ac7438b701f9f34c7769f25efc954b84469ba6de09cf074667f33213b4e7响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2019 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
X-Bce-Gateway-Region: BJ
{
"regionList": [
{
"region": "SOUTH_CHINA",
"name": "华南",
"cityList": [
{
"city": "GUANGZHOU",
"name": "广州",
"serviceProviderList": [
{
"serviceProvider": "CHINA_UNICOM",
"name": "联通"
}
]
}
]
},
{
"region": "NORTH_EAST",
"name": "东北",
"cityList": [
{
"city": "CHANGCHUN",
"name": "长春",
"serviceProviderList": [
{
"serviceProvider": "CHINA_UNICOM",
"name": "联通"
}
]
}
]
},
{
"region": "SOUTH_WEST",
"name": "西南",
"cityList": [
{
"city": "CHENGDU",
"name": "成都",
"serviceProviderList": [
{
"serviceProvider": "CHINA_MOBILE",
"name": "移动"
}
]
}
]
}
],
"nodeSum": 5
}Model对象定义
RegionInfo
| 参数名称 | 类型 | 描述 |
|---|---|---|
| region | Region | 节点所属区域英文名称 |
| name | String | 节点所属区域中文名称，如region为"CENTRAL_CHINA"，对应name为"华中" |
| cityList | List<CityInfo> | 节点所在城市信息 |
CityInfo
| 参数名称 | 类型 | 描述 |
|---|---|---|
| city | String | 节点所在城市英文名称，格式如“CHENGDU” |
| name | String | 节点所在城市中文名称，如city为“CHENGDU”，则对应name为“成都” |
| serviceProviderList | List<ServiceProviderInfo> | 节点所在运营商信息 |
ServiceProviderInfo
| 参数名称 | 类型 | 描述 |
|---|---|---|
| serviceProvider | ServiceProvider | 节点所属运营商英文名称 |
| name | String | 节点所属运营商中文名称 |
Region
| 枚举名称 | 描述 |
|---|---|
| CENTRAL_CHINA | 华中 |
| EAST_CHINA | 华东 |
| NORTH_CHINA | 华北 |
| SOUTH_CHINA | 华南 |
| NORTH_EAST | 东北 |
| NORTH_WEST | 西北 |
| SOUTH_WEST | 西南 |
ServiceProvider
| 枚举名称 | 描述 |
|---|---|
| CHINA_UNICOM | 联通 |
| CHINA_MOBILE | 移动 |
| CHINA_TELECOM | 电信 |