获取边缘裸金属物理机列表
更新时间：2021-10-21
接口描述
本接口用于获取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参数 | Deploying 交付中 Running 使用中 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: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de响应示例
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
{
"result":{
"order":"desc",
"orderBy":"createTime",
"pageNo":1,
"pageSize":100,
"result":[
{
"bccKeyPairList":[
{
"keyPairId":"k-UL9absdfA",
"name":"test-name"
}
],
"bmId":"bm-fs8lksba-1-m-hangzhou",
"city":"HANGZHOU",
"cpu":48,
"cpuModel":"Intel Xeon Gold5118(2.3GHZ)",
"createTime":"2021-10-15T03:18:48Z",
"diskList":[
{
"sizeInGb":1000,
"volumeType":"NVME_SSD"
},
{
"sizeInGb":4000,
"volumeType":"SATA_HDD"
},
{
"sizeInGb":4000,
"volumeType":"SATA_HDD"
},
{
"sizeInGb":4000,
"volumeType":"SATA_HDD"
},
{
"sizeInGb":4000,
"volumeType":"SATA_HDD"
}
],
"expireTime":null,
"gpu":0,
"hostName":"test-1",
"imageOs":"centos7u6",
"memory":192,
"name":"test-1",
"paymentMethod":"POSTPAY",
"region":"EAST_CHINA",
"renewCycle":0,
"replicas":1,
"reserveLength":0,
"resourcePackageCode":"BEC-S3-01",
"serviceProvider":"CHINA_MOBILE",
"status":"Deploying"
}
],
"totalCount":1
},
"success":true
}Model对象定义
BareMetalInstanceVo
| 参数名称 | 类型 | 描述 |
|---|---|---|
| name | String | 物理机名称 |
| hostName | String | 物理机主机名 |
| bmId | String | 物理机ID |
| city | String | 城市 |
| region | String | 地域 |
| serviceProvider | String | 运营商 |
| resourcePackageCode | String | 套餐编号 |
| cpu | Integer | CPU数量 |
| memory | Integer | 内存数量 |
| cpuModel | String | CPU型号 |
| diskList | BmDisk | 磁盘列表 |
| gpu | Integer | GPU数量 |
| imageOs | String | 操作系统镜像 |
| bccKeyPairList | List<KeyPair> | 密钥对列表 |
| paymentMethod | String | 付费方式 |
| renewCycle | Integer | 自动续费周期，单位月 |
| reserveLength | Integer | 购买时长，单位月 |
| status | String | 状态 Deploying 交付中 Running 使用中 Expired 已到期 |
| createTime | DateTime | 创建时间 |