更新BEC虚机服务

边缘计算节点 BEC

所有文档

          边缘计算节点 BEC

          • BEC
          • >
          • API参考
          • >
          • 边缘云服务器
          • >
          • 虚机服务管理相关接口
          • >
          • 更新BEC虚机服务

          更新BEC虚机服务

          更新时间：2021-05-28

          更新BEC虚机服务

          接口描述

          更新BEC虚机服务，包括扩容虚机服务，更新服务内所有实例的密码或密钥，更新服务配置，更新服务自定义名称等。

          请求结构

          PUT /v1/vm/service/{serviceId} HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string

{
    "type": type,
    "cpu":cpu,
    "memory":memory,
    "adminPass":adminPass,
    "bandwidth":bandwidth,
    "dataStorage":{
        "name":name,
        "sizeInGB":sizeInGB,
        "volumeType":NVME
        },
    "serviceName":serviceName,
    "deployInstances":{
        "region":region,
        "serviceProvider":serviceProvider,
        "city":city,
        "replicas":replicas
    }
}

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          serviceId String 是 URL参数 虚机服务id
          type String 是 RequestBody参数 更新类型，包括 password,replicas,resource，serviceName
          cpu int 否 RequestBody参数 cpu大小
          memory int 否 RequestBody参数 memory大小
          dataStorage VolumeConfig 否 RequestBody参数 数据盘大小
          keyConfig KeyConfig 是 RequestBody参数 密码或密钥配置
          bandwidth float 否 RequestBody参数 公网带宽大小(-1时为最大值)
          serviceName String 否 RequestBody参数 服务名称
          deployInstances List<DeploymentInstance> 否 RequestBody参数 部署区域列表

          响应头域

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

          响应参数

          参数名称 类型 描述
          result boolean 是否成功
          action String 操作描述
          detail VmServiceBriefVo 操作对象返回

          错误码

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

          请求示例

          扩容虚机服务

          PUT /v1/vm/service/s-lqrs2a7u HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
    "type":"replicas",
    "serviceId":"s-lqrs2a7u",
    "deployInstances":[
        {
            "region":"SOUTH_WEST",
            "city":"CHENGDU",
            "serviceProvider":"CHINA_UNICOM",
            "replicas":2
        }]
}

          更新虚机服务配置

          PUT /v1/vm/service/s-lqrs2a7u HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
    "type": "resource",
    "serviceId": "s-lqrs2a7u",
    "cpu": 1,
    "memory": 2,
    "bandwidth": 99
}

          更新虚机服务内所有虚机实例的密码

          目前虚机登录支持密码和密钥两种方式，密码和密钥需要二选一。密码限制长度为8～32位字符，英文、数字和符号必须同时存在，符号仅限!@#$%^+*()。

          PUT /v1/vm/service/s-lqrs2a7u HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
    "type": "password",
    "serviceId": "s-lqrs2a7u",
    "keyConfig": {
        "type": "password",
        "adminPass": "password"
    }
}

          更新虚机服务内所有虚机实例的密钥

          目前虚机登录支持密码和密钥两种方式，密码和密钥需要二选一。密钥仅支持BCC密钥，在使用前必须先在BCC的华北-北京区域创建密钥对。以下是更新虚机服务内所有虚机实例的密钥，其中keyConfig的参数type填bccKeyPair，bccKeyPairIdList填bcc密钥对的keyId，keyId可以通过BCC查询密钥对列表获得。

          PUT /v1/vm/service/s-lqrs2a7u HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
    "type": "password",
    "service": "vm-immgo4ap",
    "keyConfig": {
        "type": "bccKeyPair",
        "bccKeyPairIdList": [
            "k-UDUCAe4n",
            "k-lGMRwvfW",
            "k-gMgYnQbo"
        ]
    }
}

          更新虚机服务名称

          PUT /v1/vm/service/s-lqrs2a7u HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
    "serviceId": "s-lqrs2a7u",
    "type": "serviceName",
    "serviceName": "YourNewName"
}

          响应示例

          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
{
    "action": "update",
    "details": {
        "bandwidth": "100Mbps",
        "createTime": "2021-02-08T12:06:33Z",
        "deployInstances": [
            {
                "city": "CHENGDU",
                "region": "SOUTH_WEST",
                "replicas": 1,
                "serviceProvider": "CHINA_UNICOM"
            }
        ],
        "osImage": {
            "cpu": 0,
            "createTime": "2020-11-13T13:47:10Z",
            "desc": "ubuntu-18.04-amd64-20201113213429",
            "diskSize": 0,
            "ephemeralSize": 0,
            "fpgaType": "",
            "id": "8d3e507f-8b7f-44aa-a3b2-fc52fedecdc3",
            "imageDescription": "ubuntu-18.04-amd64-20201113213429",
            "imageId": "m-IIyr1NaO",
            "imageType": "common",
            "memory": 0,
            "minCpu": 0,
            "minDiskGb": 20,
            "minMem": 1,
            "name": "ubuntu-18.04-amd64-20201113213429",
            "name_fri": null,
            "osArch": "amd64 (64bit)",
            "osBuild": "2020111300",
            "osLang": "ENG",
            "osName": "Ubuntu",
            "osType": "linux",
            "osVersion": "18.04 LTS",
            "shareToUserNumLimit": 0,
            "sharedToUserNum": 0,
            "snapshotId": "",
            "status": "active"
        },
        "regions": 1,
        "runningInstances": 1,
        "serviceId": "s-lqrs2a7u",
        "serviceName": "service-name",
        "status": "NORMAL",
        "totalBandwidth": "100Mbps",
        "totalCpu": 1,
        "totalDisk": 20,
        "totalGpu": 0,
        "totalInstances": 1,
        "totalMem": 2,
        "totalRootDisk": 40
    },
    "result": true
}

          Model对象定义

          ActionInfoVo

          参数名称 类型 描述
          result boolean 是否成功
          action String 操作描述
          detail VmServiceBriefVo 操作对象返回

          VmServiceBriefVo

          参数名称 类型 描述
          serviceId String 虚机服务ID
          serviceName String 虚机服务名称
          status String 资源状态(NORMAL，FAILED)
          totalCpu float cpu数量
          totalMem float 内存数量
          totalRootDisk int 系统盘数量
          totalDisk int 数据盘数量
          regions int 区域数量
          deployInstances List<DeploymentInstance> 部署区域列表
          totalInstances int 总实例数
          runningInstances int 运行实例数
          osImage ImageDetail 系统镜像详情
          createTime Date 创建时间

          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

          DeploymentInstance

          参数名称 类型 描述
          region Region 区域
          serviceProvider ServiceProvider 运营商
          city String 城市
          replicas int 副本数,最小为1

          VolumeConfig

          参数名称 类型 描述
          name String 磁盘名称
          sizeInGB int 磁盘大小(单位G)
          volumeType DiskType 磁盘类型(NVME,SATA)

          DeploymentInstance

          参数名称 类型 描述
          region Region 区域
          serviceProvider ServiceProvider 运营商
          city String 城市
          replicas int 副本数,最小为1

          KeyConfig

          参数名称 类型 描述
          type String 类型，bccKeyPair为选择密钥对，password为选择的密码
          bccKeyPairIdList List<String> BCC虚机密钥对ID列表
          adminPass String 虚机密码限制长度为8～32位字符，英文、数字和符号必须同时存在，符号仅限!@#$%^+*()
          上一篇
          创建BEC虚机服务
          下一篇
          删除BEC虚机服务