获取边缘裸金属物理机列表
更新时间：2024-12-27
接口描述
本接口用于获取BEC裸金属物理机列表。
请求结构
GET /v1/bm?pageNo={pageNo}&pageSize={pageSize}&status={status}&keywordType={keywordType}&keyword={keyword} HTTP/1.1
Host: bec.baidubce.com
Authorization: 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 | 结果总数 |
错误码
请参照错误返回章节的内容。
请求示例
GET /v1/bm?pageNo=1&pageSize=50&status=&keyword=&keywordType=name HTTP/1.1
Host: bec.baidubce.com
Authorization: auth string响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
"order":"desc",
"orderBy":"createTime",
"pageNo":1,
"pageSize":100,
"totalCount":1,
"result":[
{
"bmId":"bm-fs8lksba-1-m-hangzhou",
"hostName":"bm-fs8lksba",
"name":"test-1",
"regionId": "cn-hangzhou-cm",
"spec": "bec.lgn6.c128m1024.3d"
"resourcePackageCode":"BEC-S3-01",
"bccKeyPairList":[
{
"keyPairId":"k-UL9absdfA",
"name":"test-name"
}
],
"cpu":48,
"cpuModel":"Intel Xeon Gold5118(2.3GHZ)",
"systemDisk": {
"volumeType": "SATA_SSD",
"sizeInGb": 480,
"name": "/dev/sda"
},
"diskList":[
{
"sizeInGb":1000,
"volumeType":"NVME_SSD",
"name": "/dev/nvme0n1"
},
{
"sizeInGb":4000,
"volumeType":"NVME_SSD",
"name": "/dev/nvme1n1"
},
{
"sizeInGb":4000,
"volumeType":"NVME_SSD",
"name": "/dev/nvme2n1"
}
],
"iplist": [
{
"name": "xgbe0",
"index": 0,
"ip": "10.59.32.11",
"isp": "intra"
}
],
"expireTime":null,
"gpu":0,
"imageOs":"centos7u9",
"imageVersion": "7.9",
"imageId": "im-public-centos7u9",
"imageType": "public",
"imageName": "centos-7.9-Legacy",
"imageType": "public",
"memory":192,
"paymentMethod":"POSTPAY",
"region":"EAST_CHINA",
"city":"HANGZHOU",
"serviceProvider":"CHINA_MOBILE",
"renewCycle":0,
"reserveLength":0,
"cpuModel": "Intel Xeon Gold 6271C(2.6GHZ)",
"gpuModel": "",
"status":"Deploying",
"createTime":"2021-10-15T03:18:48Z"
}
]
}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 |