获取边缘裸金属物理机列表
更新时间:2024-12-27
接口描述
本接口用于获取BEC裸金属物理机列表。
请求结构
Plain Text
1GET /v1/bm?pageNo={pageNo}&pageSize={pageSize}&status={status}&keywordType={keywordType}&keyword={keyword} HTTP/1.1
2Host: bec.baidubce.com
3Authorization: authorization string
请求头域
除公共头域外,无其他特殊头域。
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
pageNo | Integer | 否 | Query参数 | 页数,缺省值为1 |
pageSize | Integer | 否 | Query参数 | 每页裸金属物理机个数,取值范围为1~100,缺省值为50。 |
keywordType | String | 否 | Query参数 | 查询裸金属物理机的关键字类型,取值为bmId、name,分别表示物理机ID,物理机名字。 |
keyword | String | 否 | Query参数 | 查询裸金属物理机的关键字 |
status | String | 否 | Query参数 | Creating 调度中, PrerequisiteCheck 预检中,Deploying 安装交付中,Deployed 安装完成(开始网络配置), DeployFailed 安装失败,Redeploying重装中,Imaging 镜像制作中, Running 运行中, Stopped 已关机, Restarting重启中, Expired 已到期 |
响应头域
除公共头域外,无其他特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
result | List<BareMetalInstanceVo> | 列表数据 |
orderBy | String | 排序字段 |
order | String | 排序顺序 |
pageNo | Integer | 页码 |
pageSize | Integer | 每页结果数 |
totalCount | Integer | 结果总数 |
错误码
请参照错误返回章节的内容。
请求示例
Plain Text
1GET /v1/bm?pageNo=1&pageSize=50&status=&keyword=&keywordType=name HTTP/1.1
2Host: bec.baidubce.com
3Authorization: auth string
响应示例
JSON
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2015 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5Server: BWS
6
7{
8 "order":"desc",
9 "orderBy":"createTime",
10 "pageNo":1,
11 "pageSize":100,
12 "totalCount":1,
13 "result":[
14 {
15 "bmId":"bm-fs8lksba-1-m-hangzhou",
16 "hostName":"bm-fs8lksba",
17 "name":"test-1",
18 "regionId": "cn-hangzhou-cm",
19 "spec": "bec.lgn6.c128m1024.3d"
20 "resourcePackageCode":"BEC-S3-01",
21 "bccKeyPairList":[
22 {
23 "keyPairId":"k-UL9absdfA",
24 "name":"test-name"
25 }
26 ],
27 "cpu":48,
28 "cpuModel":"Intel Xeon Gold5118(2.3GHZ)",
29 "systemDisk": {
30 "volumeType": "SATA_SSD",
31 "sizeInGb": 480,
32 "name": "/dev/sda"
33 },
34 "diskList":[
35 {
36 "sizeInGb":1000,
37 "volumeType":"NVME_SSD",
38 "name": "/dev/nvme0n1"
39 },
40 {
41 "sizeInGb":4000,
42 "volumeType":"NVME_SSD",
43 "name": "/dev/nvme1n1"
44 },
45 {
46 "sizeInGb":4000,
47 "volumeType":"NVME_SSD",
48 "name": "/dev/nvme2n1"
49 }
50 ],
51 "iplist": [
52 {
53 "name": "xgbe0",
54 "index": 0,
55 "ip": "10.59.32.11",
56 "isp": "intra"
57 }
58 ],
59 "expireTime":null,
60 "gpu":0,
61 "imageOs":"centos7u9",
62 "imageVersion": "7.9",
63 "imageId": "im-public-centos7u9",
64 "imageType": "public",
65 "imageName": "centos-7.9-Legacy",
66 "imageType": "public",
67 "memory":192,
68 "paymentMethod":"POSTPAY",
69 "region":"EAST_CHINA",
70 "city":"HANGZHOU",
71 "serviceProvider":"CHINA_MOBILE",
72 "renewCycle":0,
73 "reserveLength":0,
74 "cpuModel": "Intel Xeon Gold 6271C(2.6GHZ)",
75 "gpuModel": "",
76 "status":"Deploying",
77 "createTime":"2021-10-15T03:18:48Z"
78 }
79 ]
80}
Model对象定义
BareMetalInstanceVo
参数名称 | 类型 | 描述 |
---|---|---|
name | String | 物理机名称 |
hostName | String | 物理机主机名 |
bmId | String | 物理机ID |
regionId | String | 所在节点ID(节点唯一标识) |
city | String | 城市 |
region | String | 地域 |
serviceProvider | String | 运营商 |
spec | String | 规格 |
resourcePackageCode | String | 套餐编号 |
cpu | Integer | CPU数量 |
memory | Integer | 内存数量 |
cpuModel | String | CPU型号 |
systemDisk | BmDisk | 系统磁盘 |
diskList | List<BmDisk> | 磁盘列表 |
ipList | List<Interface> | IP列表 |
gpu | Integer | GPU数量 |
gpuModel | String | GPU型号 |
imageId | String | 操作系统镜像ID |
imageOs | String | 操作系统 |
imageVersion | String | 操作系统版本 |
imageName | String | 镜像名称 |
imageType | String | 镜像类型: public 公共镜像, custom 自定义镜像 |
bccKeyPairList | List<KeyPair> | 密钥对列表 |
paymentMethod | String | 付费方式, POSTPAY后付费, PREPAY预付费 |
renewCycle | Integer | 自动续费周期,单位月 |
reserveLength | Integer | 购买时长,单位月 |
status | String | 状态 Creating 调度中, PrerequisiteCheck 预检中,Deploying 安装交付中,Deployed 安装完成(开始网络配置), DeployFailed 安装失败,Redeploying重装中,Imaging 镜像制作中, Running 运行中, Stopped 已关机, Restarting重启中, Expired 已到期 |
sn | String | 机器SN。申请白名单开放 |
bmType | String | 类型:classic 经典; bbc1 一代BBC |
createTime | DateTime | 创建时间 |
Interface
参数名称 | 类型 | 描述 |
---|---|---|
name | String | 网卡名称 |
index | Integer | 网卡序号 |
ip | String | IP地址 |
isp | String | intra内网, 其他公网 |
BmDisk
参数名称 | 类型 | 描述 |
---|---|---|
name | String | 磁盘名称 |
sizeInGb | Integer | 磁盘容量 |
volumeType | String | 磁盘类型: NVME_SSD,SATA_HDD |