获取可用边缘节点列表
更新时间：2022-04-18
接口描述
本接口用于获取可用边缘节点列表。
请求结构
GET /v1/node/type/{type}?country={country} HTTP/1.1
Host: bec.baidubce.com
Content-Type: application/json; charset=utf-8
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| type | String | 是 | URI参数 | 需要查询的节点种类，目前支持gpu、container、vm、lb、bm五种，分别代表创建GPU、容器、虚机、负载均衡、裸金属资源时可用的节点列表 |
| country | String | 否 | Query参数 | 指定查询某个国家下的节点列表，不传默认all，查询全部国家节点 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| 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": "华南",
"country":"CHINA",
"countryName":"中国",
"cityList": [
{
"city": "GUANGZHOU",
"name": "广州",
"serviceProviderList": [
{
"serviceProvider": "CHINA_UNICOM",
"name": "联通",
"regionId": "cn-guangzhou-un"
}
]
}
]
},
{
"region": "NORTH_EAST",
"name": "东北",
"country":"CHINA",
"countryName":"中国",
"cityList": [
{
"city": "CHANGCHUN",
"name": "长春",
"serviceProviderList": [
{
"serviceProvider": "CHINA_UNICOM",
"name": "联通",
"regionId": "cn-changchun-un"
}
]
}
]
},
{
"region": "SOUTH_WEST",
"name": "西南",
"country":"CHINA",
"countryName":"中国",
"cityList": [
{
"city": "CHENGDU",
"name": "成都",
"serviceProviderList": [
{
"serviceProvider": "CHINA_MOBILE",
"name": "移动",
"regionId": "cn-chengdu-cm"
}
]
}
]
},
{
"cityList":[
{
"city":"SINGAPORE",
"name":"新加坡",
"serviceProviderList":[
{
"name":"BGP",
"regionId":"sg-singapore-bgp",
"serviceProvider":"BGP"
}
]
}
],
"country":"SINGAPORE",
"countryName":"新加坡",
"name":"新加坡",
"region":"SINGAPORE"
},
{
"cityList":[
{
"city":"DALLAS",
"name":"达拉斯",
"serviceProviderList":[
{
"name":"BGP",
"regionId":"us-dallas-bgp",
"serviceProvider":"BGP"
}
]
}
],
"country":"AMERICA",
"countryName":"美国",
"name":"美国",
"region":"AMERICA"
}
],
"nodeSum": 7
}Model对象定义
RegionInfo
| 参数名称 | 类型 | 描述 |
|---|---|---|
| region | Region | 节点所属区域英文名称 |
| name | String | 节点所属区域中文名称，如region为"CENTRAL_CHINA"，对应name为"华中" |
| country | String | 节点所属国家英文名称，例如 "CHINA" |
| countryName | String | 节点所属国家中文名称，例如 country为"CHINA"，对应countryName为"中国" |
| cityList | List<CityInfo> | 节点所在城市信息 |
CityInfo
| 参数名称 | 类型 | 描述 |
|---|---|---|
| city | String | 节点所在城市英文名称，格式如“CHENGDU” |
| name | String | 节点所在城市中文名称，如city为“CHENGDU”，则对应name为“成都” |
| serviceProviderList | List<ServiceProviderInfo> | 节点所在运营商信息 |
ServiceProviderInfo
| 参数名称 | 类型 | 描述 |
|---|---|---|
| serviceProvider | ServiceProvider | 节点所属运营商英文名称 |
| name | String | 节点所属运营商中文名称 |
| regionId | String | 节点ID，由“国家码-城市-运营商”的小写字母组成字符串。例如 cn-hangzhou-cm，其中国家码标准为ISO 3166-2，城市为拼音，运营商为中国移动cm/中国电信ct/中国联通un/三线ix，海外节点运营商为bgp。 |
Region
| 枚举名称 | 描述 |
|---|---|
| CENTRAL_CHINA | 华中 |
| EAST_CHINA | 华东 |
| NORTH_CHINA | 华北 |
| SOUTH_CHINA | 华南 |
| NORTH_EAST | 东北 |
| NORTH_WEST | 西北 |
| SOUTH_WEST | 西南 |
| SINGAPORE | 新加坡 |
| AMERICA | 美国 |
| GERMANY | 德国 |
ServiceProvider
| 枚举名称 | 描述 |
|---|---|
| CHINA_UNICOM | 联通 |
| CHINA_MOBILE | 移动 |
| CHINA_TELECOM | 电信 |
| BGP | 海外节点运营商BGP |