获取可用边缘节点列表
更新时间:2021-02-20
接口描述
获取可用边缘节点列表。
请求结构
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<RegionList> | 当前可用节点列表 |
nodeSum | int | 当前可用节点数目 |
错误码
请参照错误返回章节的内容。
请求示例
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 | 电信 |