获取节点已分配资源详情
更新时间:2021-08-02
接口描述
本接口用于获取节点已分配资源详情。
请求结构
GET /v1/node/resource/allocated HTTP/1.1
Host: bec.baidubce.com
Content-Type: application/json; charset=utf-8
Authorization: authorization string
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
---|---|---|---|---|
region | String | 否 | Query参数 | 节点所在区域名称,格式如“NORTH_CHINA” |
serviceProvider | String | 否 | Query参数 | 节点所在运营商名称,格式如“CHINA_UNICOM” |
city | String | 否 | Query参数 | 节点所在城市名称,格式如“XIAN” |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
nodeList | List<NodeResource> | 节点已分配资源信息 |
错误码
请参照错误返回章节的内容。
请求示例
GET /v1/node/resource/allocated HTTP/1.1
Host: bec.baidubce.com
Content-Type: application/json; charset=utf-8
Authorization: bce-auth-v1/318857a8f08b11e9845ca7e54775a0c2/2019-10-17T03:07:21Z/1800/host/212eef8cfe1ac94be56c4afedb9360bba621ef646c3c8288971d36801d70501a
响应示例
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
{
"nodeList": [
{
"node": {
"region": "SOUTH_CHINA",
"regionName": "华南",
"city": "GUANGZHOU",
"cityName": "广州",
"serviceProvider": "CHINA_UNICOM",
"serviceProviderName": "联通"
},
"cpu": {
"number": "9.000000",
"unit": "c"
},
"memory": {
"number": "18.000000",
"unit": "Gi"
},
"hdd": {
"number": "355.000000",
"unit": "Gi"
},
"ssd": {
"number": "0.000000",
"unit": "Gi"
}
},
{
"node": {
"region": "NORTH_EAST",
"regionName": "东北",
"city": "CHANGCHUN",
"cityName": "长春",
"serviceProvider": "CHINA_UNICOM",
"serviceProviderName": "联通"
},
"cpu": {
"number": "10.000000",
"unit": "c"
},
"memory": {
"number": "20.000000",
"unit": "Gi"
},
"hdd": {
"number": "155.000000",
"unit": "Gi"
},
"ssd": {
"number": "0.000000",
"unit": "Gi"
}
},
{
"node": {
"region": "SOUTH_WEST",
"regionName": "西南",
"city": "CHENGDU",
"cityName": "成都",
"serviceProvider": "CHINA_MOBILE",
"serviceProviderName": "移动"
},
"cpu": {
"number": "0.000000",
"unit": "c"
},
"memory": {
"number": "0.000000",
"unit": "Gi"
},
"hdd": {
"number": "0.000000",
"unit": "Gi"
},
"ssd": {
"number": "0.000000",
"unit": "Gi"
}
}
]
}
Model对象定义
NodeResource
参数名称 | 类型 | 描述 |
---|---|---|
node | NodeNameVo | 节点信息 |
cpu | QuantityVo | 节点CPU资源信息 |
memory | QuantityVo | 节点memory资源信息 |
hdd | QuantityVo | 节点HDD资源信息 |
ssd | QuantityVo | 节点SSD资源信息 |
NodeNameVo
参数名称 | 类型 | 描述 |
---|---|---|
region | Region | 节点所在区域英文名称 |
regionName | String | 节点所在区域中文名称 |
city | String | 节点所在城市英文名称 |
cityName | String | 节点所在城市中文名称 |
serviceProvider | ServiceProvider | 节点所属运营商英文名称 |
serviceProviderName | String | 节点所属运营商中文名称 |
QuantityVo
参数名称 | 类型 | 描述 |
---|---|---|
number | BigDecimal | 资源总量 |
unit | 枚举类型Unit | 资源单位,包括C、Gi两种。C用于CPU资源代表核数,Gi用于memory、SSD、HDD等表示GB |
Region
枚举名称 | 描述 |
---|---|
CENTRAL_CHINA | 华中 |
EAST_CHINA | 华东 |
NORTH_CHINA | 华北 |
SOUTH_CHINA | 华南 |
NORTH_EAST | 东北 |
NORTH_WEST | 西北 |
SOUTH_WEST | 西南 |
ServiceProvider
枚举名称 | 描述 |
---|---|
CHINA_UNICOM | 联通 |
CHINA_MOBILE | 移动 |
CHINA_TELECOM | 电信 |