获取边缘裸金属物理机列表
更新时间:2025-08-05
接口描述
本接口用于获取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 | 
