更新BEC虚机实例
所有文档

          边缘计算节点 BEC

          更新BEC虚机实例

          接口描述

          用于更新BEC虚机实例配置,密码或密钥,数据盘。

          请求结构

          PUT /v1/vm/instance/{vmId} HTTP/1.1
          Host: bec.baidubce.com
          Authorization: authorization string
          
          {
              "type": type,
              "cpu":cpu,
              "memory":memory,
              "keyConfig": {
                  "type": type,
                  "adminPass": "password",
                  "bccKeyPairIdList": [],
               }
              "imageId":imageId,
              "bandwidth":bandwidth,
              "dnsConfig": {
                  "dnsType": dnsType,
                  "dnsAddress": dnsAddress
              },
              "dataStorage":{
                  "name":name,
                  "sizeInGB":sizeInGB,
                  "volumeType":NVME
              }
          }

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          vmId String URL参数 虚机实例id
          type String RequestBody参数 更新类型(password,vmName,resource)
          cpu int RequestBody参数 CPU大小
          memory int RequestBody参数 内存大小
          dataStorage VolumeConfig RequestBody参数 数据盘大小
          keyConfig KeyConfig RequestBody参数 密码或密钥配置
          imageId String RequestBody参数 镜像id
          bandwidth float RequestBody参数 公网带宽大小(-1时为最大值)
          dnsConfig DnsConfig RequestBody参数 DNS配置
          needIpv6PublicIp boolean RequestBody参数 是否开通IPv6公网,true为开通,false为不开通。缺省为false
          networkConfig NetworkConfig RequestBody参数 包含内外网卡名称的设置

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          details VmInstanceDetailsVo 虚机实例信息
          action String 更新操作
          result boolean 操作是否成功

          错误码

          请参照前文的统一错误码和平台错误码。

          请求示例

          更新配置

          支持更新虚机配置,包括cpu、内存、DNS、带宽、网卡名称和数据盘。

          PUT /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
          
          {
              "vmId": "vm-6ahy6dl",
              "type": "resource",
              "cpu": 1,
              "memory": 4,
              "dataVolumeList": [{
                  "sizeInGB": 20,
                  "volumeType": "NVME",
                  "name": "addNewDataDisk"
              }],
              "dnsConfig": {
                  "dnsType": "CUSTOMIZE",
                  "dnsAddress": "129.29.29.29"
              },
              "networkConfig": {
                  "privateNetworkName": "test-eth0",
                  "publicNetworkName": "test-eth1"
              },
              "needPublicIp": true,
              "needIpv6PublicIp": true,
              "bandwidth": 67
          }

          更新密码

          密码限制长度为8~32位字符,英文、数字和符号必须同时存在,符号仅限!@#$%^+*()。

          PUT /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
          
              {
                  "keyConfig": {
                      "type": "bccKeyPair",
                      "bccKeyPairIdList": ["k-1MkI9Laa"]
                  },
                  "type": "password",
                  "vmId": "vm-6ahy6dli"
              }
              

          更新密钥

          仅支持BCC密钥。使用前必须先在BCC的华北-北京区域创建密钥对。keyConfig的参数type填bccKeyPair,bccKeyPairIdList是bcc密钥对的keyId列表,keyId可通过BCC查询密钥对列表获得。

          PUT /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
          
              {
                  "keyConfig": {
                      "type": "bccKeyPair",
                      "bccKeyPairIdList": ["k-1MkI9Laa"]
                  },
                  "type": "password",
                  "vmId": "vm-6ahy6dli"
              }       
              

          响应示例

          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": true,
              "action": "update",
              "details": {
                  "publicIp": "36.158.184.31",
                  "ipv6PublicIp": "",
                  "internalIp": null,
                  "multiplePublicIp": null,
                  "serviceProvider": "CHINA_MOBILE",
                  "vmId": "vm-i029wtci-0-m-xiangtan-f1gvv",
                  "uuid": "76050e65-b8e5-4fcf-a61b-dd2b71949370",
                  "vmName": "vm-i029wtci-0-m-xiangtan-f1gvv",
                  "status": "RUNNING",
                  "cpu": 1,
                  "mem": 2,
                  "gpu": 0,
                  "region": "CENTRAL_CHINA",
                  "city": "XIANGTAN",
                  "needPublicIp": true,
                  "needIpv6PublicIp": true,
                  "bandwidth": "100Mbps",
                  "osImage": {
                      "id": "49",
                      "imageId": "im-awwxnhme-2-u-huhehaote",
                      "name": "helloworld",
                      "imageType": "becCustom",
                      "snapshotId": null,
                      "cpu": 0,
                      "memory": 0,
                      "osType": "linux",
                      "osVersion": "7.3",
                      "osName": "CentOS",
                      "osBuild": "2020122100",
                      "osLang": "ENG",
                      "diskSize": 0,
                      "createTime": "2021-01-25T13:30:02Z",
                      "status": null,
                      "minMem": 0,
                      "minCpu": 0,
                      "minDiskGb": 0,
                      "desc": null,
                      "osArch": "x86_64 (64bit)",
                      "ephemeralSize": 0,
                      "imageDescription": null,
                      "shareToUserNumLimit": 0,
                      "sharedToUserNum": 0,
                      "fpgaType": null,
                      "name_fri": null
                  },
                  "dns":"customize-129.29.29.29",
                  "serviceId": "s-i029wtci",
                  "createTime": "2021-03-01T10:34:06Z",
                  "rootDiskSize": 40,
                  "dataStorage": 43,
                  "systemVolume": {
                      "volumeType": "SATA",
                      "sizeInGB": 40,
                      "name": "vm-rootfs",
                      "pvcName": "lvm-i029wtci-0-m-xiangtan-f1gvv-rootfs"
                  },
                  "dataVolumeList": [
                      {
                          "name": "volume1",
                          "volumeType": "NVME",
                          "sizeInGB": 21,
                          "pvcName": "lvm-i029wtci-0-m-xiangtan-f1gvv-0ya7f"
                      }
                  ]
              }
          }

          Model对象定义

          VmInstanceDetailsVo

          参数名称 类型 描述
          vmId String 虚机实例ID
          uuId String 虚机实例ID
          vmName String 虚机实例名称
          status String 资源状态(CREATING,RUNNING,STOPPING,STOPPED,RESTARTING,REINSTALLING,STARTING,IMAGING,FAILED,UNKNOWN)
          cpu int CPU数量
          mem int 内存数量
          gpu int GPU数量
          rootDiskSize int 系统盘数量
          dataStorage int 数据盘数量
          region String 地域
          serviceProvider String 运营商
          city String 城市
          needPublicIp boolean 是否开通公网
          needIpv6PublicIp boolean 是否开通ipv6公网
          multiplePublicIp List<IpInfo> 三线公网ip
          ipv6PublicIp String ipv6公网ip
          internalIp String 内网ip
          bandwidth String 公网带宽大小
          bandwidth String 公网带宽大小
          osImage ImageDetail 系统镜像详情
          serviceId String 虚机服务id
          createTime Date 创建时间
          systemVolume SystemVolumeConfig 系统盘
          dataVolumeList List<VolumeConfig> 数据盘列表

          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

          SystemVolumeConfig

          参数名称 类型 描述
          volumeType DiskType 盘类型
          sizeInGB int 盘尺寸
          name String 盘名称
          pvcName String pvc名称

          VolumeConfig

          参数名称 类型 描述
          volumeType DiskType 盘类型
          sizeInGB int 盘尺寸
          name String 盘名称
          pvcName String pvc名称

          KeyConfig

          参数名称 类型 描述
          type String 类型,bccKeyPair为选择密钥对,password为选择的密码
          bccKeyPairIdList List<String> 虚机密钥对ID列表
          adminPass String 虚机密码限制长度为8~32位字符,英文、数字和符号必须同时存在,符号仅限!@#$%^+*()

          DnsConfig

          参数名称 类型 描述
          dnsType DnsType DNS类型
          dnsAddress String DNS地址,多个DNS地址以逗号分隔

          DnsType

          参数名称 描述
          NONE 不需要设置
          DEFAULT 使用默认DNS地址(114.114.114.114)
          CUSTOMIZE 使用自定义DNS地址
          LOCAL 使用所属节点的local dns

          NetworkConfig

          参数名称 类型 描述
          privateNetworkName String 内网网卡名称
          publicNetworkName String 公网网卡名称
          上一篇
          获取BEC虚机实例监控
          下一篇
          删除BEC虚机实例