获取BEC虚机实例详情
更新时间：2020-07-03
获取BEC虚机实例详情
接口描述
获取BEC虚机实例详情
请求结构
GET /v1/vm/instance/{vmID} HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| vmID | String | 是 | URL参数 | 虚机实例id |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| vmId | String | 虚机实例ID |
| status | String | 资源状态(STOP，RUNNING，PENDING，TERMINATING，FAILED，SUCCEEDED，UNKNOWN，TERMINATED，WAITING) |
| cpu | float | cpu数量 |
| mem | float | 内存数量 |
| rootDiskSize | int | 系统盘数量 |
| dataStorage | int | 数据盘数量 |
| region | String | 地域 |
| serviceProvider | String | 运营商 |
| city | String | 城市 |
| needPublicIp | boolean | 是否开通公网 |
| bandwidth | String | 公网带宽大小 |
| publicIp | String | 公网ip |
| internalIp | String | 内网ip |
| osImage | ImageDetail | 系统镜像详情 |
| serviceId | String | 虚机服务id |
| createTime | Date | 创建时间 |
错误码
请参照前文的统一错误码和平台错误码。
请求示例
GET /v1/vm/instance/vm-6ahy6dli 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":{
"vmId": "vm-6ahy6dli",
"status": "RUNNING",
"cpu": 1.0,
"mem": 2.0,
"region": "NORTH_WEST",
"serviceProvider": "CHINA_TELECOM",
"city": "XIAN",
"needPublicIp": true,
"bandwidth": "100Mbps",
"internalIp": "10.244.3.165",
"publicIp": "112.29.149.223",
"osImage": {
"id": "0e005dd1-9ff8-482c-aa34-d102aa40f65c",
"imageId": "m-2AJNSsmZ",
"name": "BMR-centos-7u1-210-lkr-20200409101246",
"imageType": "common",
"snapshotId": "",
"cpu": 0,
"memory": 0,
"osType": "linux",
"osVersion": "7.1",
"osName": "CentOS",
"osBuild": "2020040900",
"osLang": "ENG",
"diskSize": 0,
"createTime": "2020-04-09T02:22:29Z",
"status": "active",
"minMem": 1,
"minCpu": 0,
"minDiskGb": 20,
"desc": "BMR-centos-7u1-210-lkr-20200409101246",
"osArch": "x86_64 (64bit)",
"ephemeralSize": 0,
"imageDescription": "BMR-centos-7u1-210-lkr-20200409101246",
"shareToUserNumLimit": 0,
"sharedToUserNum": 0,
"fpgaType": "",
"name_fri": null
},
"serviceId": "s-dqtuksua",
"createTime": "2020-06-22T08:44:15Z",
"rootDiskSize": 45,
"dataStorage": 20
},
"success":true
}Model对象定义
ImageDetail
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | String | id |
| imageId | String | imageId |
| name | String | 镜像名称 |
| imageType | String | 镜像类型 |
| snapshotId | String | 快照id |
| cpu | int | cpu数量 |
| memory | int | 内存数量 |
| osType | String | os类型 |
| osVersion | String | os版本 |
| osName | String | os名称 |
| osBuild | String | os创建时间 |
| osLang | String | os语言 |
| diskSize | int | 磁盘大小 |
| createTime | Date | 创建时间 |
| minCpu | int | 最小cpu数量 |
| minMem | int | 最小内存数量 |
| minDiskGb | int | 最小磁盘数量 |
| desc | String | 描述 |
| osArch | String | osArch |
| ephemeralSize | int | ephemeralSize |
| imageDescription | String | 镜像描述 |
| shareToUserNumLimit | int | 分享数量限制 |
| sharedToUserNum | int | 分享数量 |
| fpgaType | String | fpgaType |
| name_fri | String | name_fri |