所有文档

          弹性裸金属服务器

          实例相关接口

          创建实例

          接口描述

          • 本接口用于创建一个或多个同配物理机实例。

          • 创建物理机前应查询所选套餐的RAID情况,并根据需要选取raidId。

          请求(Request)

          • 请求语法
              POST /v{version}/instance?clientToken={clientToken} HTTP/1.1
              Host: bbc.bj.baidubce.com
              Authorization: authorization string
              {
                  "name": name,
                  "flavorId":flavorId,
                  "imageId": imageId,
                  "raidId":raidId,
                  "rootDiskSizeInGb":rootDiskSizeInGb,
                  "purchaseCount": purchaseCount,
                  "zoneName":zoneName,
                  "subnetId":subnetId,
                  "securityGroupId": securityGroupId,
                  "autoRenewTimeUnit": autoRenewTimeUnit,
                  "autoRenewTime": autoRenewTime,
                  "billing":{
                      "paymentTiming": paymentTiming,
                      "reservation": {
                          "reservationLength": reservationLength
                      }
                  }
              }
          • 请求头域

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

          • 请求参数
          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号。
          clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串。
          flavorId String Request Body参数 物理机套餐Id。
          imageId String Request Body参数 镜像Id。
          raidId String Request Body参数 raid配置Id,可通过查询RAID接口获得。
          rootDiskSizeInGb int Request Body参数 待创建物理机的系统盘大小。
          purchaseCount int Request Body参数 批量创建(购买)的虚拟机实例个数,必须为大于0的整数,可选参数,缺省为1。
          zoneName String Request Body参数 可通过调用查询可用区列表接口查询可用区列表。zoneName命名规范是“国家-region-可用区序列",小写,例如北京可用区A为"cn-bj-a"。专属实例使用专属服务器所在zone,无需指定该字段。
          subnetId String Request Body参数 指定subnet信息,不能为空。
          securityGroupId String Request Body参数 指定securityGroupId信息。
          autoRenewTimeUnit String Request Body参数 按月付费或者按年付费 月是"month",年是"year"
          autoRenewTime int Request Body参数 自动续费的时间 按月是1-9 按年是 1-3。
          billing Billing Request Body参数 订单、计费相关参数。
          name String Request Body参数 物理机名字(可选)。默认都不指定name。
          adminPass String Request Body参数 机器密码,密码需要加密传输。请参考密码加密传输规范

          响应(Response)

          • 响应头域

          无特殊Header参数响应

          • 响应参数
          名称 类型 描述
          instanceIds List 物理机实例ID的集合,其中ID符合BCE规范,必须是一个定长字符串,且只允许包含大小写字母、数字、连字号(-)和下划线(_)

          示例

          • 请求示例
              POST /v1/instance?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
              Host: bbc.bj.baidubce.com
              ContentType: application/json    
              Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
              {
                  "name": "test2",
              	"flavorId":"BBC-I1-01",
              	"imageId": "m-JTcDChqz",
              	"raidId":"raid-hna71m59",
              	"rootDiskSizeInGb":"40",
              	"purchaseCount": 2,
              	"zoneName":"cn-bj-a",
              	"subnetId":"8ea4c63e-9a93-47ac-b1c8-27f7f4b28154",
                  "autoRenewTimeUnit": "month",
                  "autoRenewTime": 1,
              	"billing":{
                      "paymentTiming":"Prepaid",
                      "reservation": {
                          "reservationLength": 1
                      }
                  }
              }
          • 响应示例

            HTTP/1.1 200 OK x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50 Date: Wed, 03 Dec 2014 06:42:19 GMT Content-Type: application/json;charset=UTF-8 Server: BWS { "instanceIds": [ "i-l1KApd9e", "i-gFbUIZ13" ] }

          查询实例列表

          描述

          查询所有BBC实例的列表及详情信息。

          请求结构

          GET /v{version}/instance?marker={marker}&maxKeys={maxKeys}&internalIp={internalIp} HTTP/1.1
          Host: bbc.bj.baidubce.com
          Authorization: authorization string

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          marker String Query参数 批量获取列表的查询的起始位置,是一个由系统生成的字符串。
          maxKeys int Query参数 每页包含的最大数量,最大数量通常不超过1000,缺省值为1000。
          internalIp String Query参数 内网ip
          vpcId String Query参数 vpcId

          返回头域

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

          返回参数

          名称 类型 描述
          marker String 标记查询的起始位置。
          isTruncated boolean true表示后面还有数据,false表示已经是最后一页。
          nextMarker String 获取下一页所需要传递的marker值。当isTruncated为false时,该域不出现。
          maxKeys int 每页包含的最大数量。
          instances List<InstanceModel> 实例信息,由 InstanceModel 组成的集合。

          错误码

          无特殊返回错误码

          请求示例

          GET /v1/instance?marker=i-IyWRtII7&maxKeys=1 HTTP/1.1
          Host: bbc.bj.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Fri, 09 Sep 2016 03:31:51 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS
          
          {
              "nextMarker": "i-xktdeMSf",
              "marker": "i-IyWRtII7",
              "maxKeys": 1,
              "isTruncated": true,
              "instances": [
                  {
                      "id": "i-IyWRtII7",
                      "name": "instance-j93wzbn1",
                      "status": "Running",
                      "desc": "console",
                      "paymentTiming":"Postpaid",
          			"createTime": "2015-08-06T13:23:13Z",
                      "expireTime": null,
                      "internalIp": "192.168.6.15",
                      "publicIp":"10.107.3.45",
          		    "networkCapacityInMbps": 1,
          			"flavorId":"BBC-C1-01",
                      "imageId": "m-3zfBY1Ku",
                      "tags": [
                          {
                              "tagKey": "jian",
                              "tagValue": "1"
                          }
                      ],				
          
          			"zone":"zoneA",
          			"region": "bj"
                  }
              ]
          }
          
          	

          查询单个实例详情

          查询指定的某个实例详细信息。

          请求结构

          GET /v{version}/instance/{instanceId} HTTP/1.1
          Host: bbc.bj.baidubce.com
          Authorization: authorization string

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          instanceId String URL参数 待查询的实例ID

          返回头域

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

          返回参数

          参数名称 类型 描述
          instance InstanceModel 返回的实例详情

          请求示例

          GET /v1/instance/i-YufwpQAe HTTP/1.1
          Host: bbc.bj.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Wed, 03 Dec 2014 06:42:19 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS
          
          {
                      "id": "i-IyWRtII7",
                      "name": "instance-j93wzbn1",
                      "status": "Running",
                      "desc": "console",
                      "paymentTiming":"Postpaid",
          			"createTime": "2015-08-06T13:23:13Z",
                      "expireTime": null,
                      "internalIp": "192.168.6.15",
                      "publicIp":"10.107.3.45",
          		    "networkCapacityInMbps": 1,
          			"flavorId":"BBC-C1-01",
                      "imageId": "m-3zfBY1Ku",
                         "tags": [
                          {
                              "tagKey": "jian",
                              "tagValue": "1"
                          }
                      ],				
          			"zone":"zoneA",
                      "deploysetId":"",
                      "hasAlive":1,
          			"region": "bj"
          
          }

          启动实例

          开机启动一个指定的实例。

          • 接口调用成功后实例进入 Starting 状态。
          • 实例状态必须为 Stopped,调用此接口才可以成功返回,否则提示409错误。

          请求结构

          PUT /v{version}/instance/{instanceId}?{action} HTTP/1.1
          Host: bbc.bj.baidubce.com
          Authorization: authorization string

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          instanceId String URL参数 待启动的实例ID
          action String Query参数 对实例执行的动作,本接口中该参数取值start

          返回头域

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

          返回参数

          无特殊返回参数

          错误码

          错误码 错误描述 HTTP状态码 中文解释
          Instance.StartInstanceOperationForbidden Instance not stopped when starting. 409 只有 Stopped 状态的实例才可以进行开启

          请求示例

          PUT /v1/instance/i-YufwpQAe?start HTTP/1.1
          Host: bbc.bj.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Wed, 03 Dec 2014 06:42:19 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS

          停止实例

          停止一个指定的实例。

          • 系统后台会在实例实际 Stop 成功后进入“已停止”状态。
          • 只有状态为 Running 的实例才可以进行此操作,否则提示 409 错误。
          • 实例支持强制停止,强制停止等同于断电处理,可能丢失实例操作系统中未写入磁盘的数据。

          请求结构

          PUT /v{version}/instance/{instanceId}?{action} HTTP/1.1
          Host: bbc.bj.baidubce.com
          Authorization: authorization string
          {
              "forceStop":forceStop
          }

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          instanceId String URL参数 待启动的实例ID
          action String Query参数 对实例执行的动作,本接口中该参数取值stop
          forceStop Boolean Request Body参数 指定实例是否强制关机,可选值:true,false,缺省为false

          返回头域

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

          返回参数

          无特殊返回参数

          错误码

          错误码 错误描述 HTTP状态码 中文解释
          Instance.StopInstanceOperationForbidden Instance not running when shutting down. 409 只有 Running 状态的实例才可以进行关机

          请求示例

          PUT /v1/instance/i-YufwpQAe?stop HTTP/1.1   
          Host: bbc.bj.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
          {
              "forceStop":false
          }

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Wed, 03 Dec 2014 06:42:19 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS

          重启实例

          描述

          重启一个指定的实例

          • 只有状态为 Running 的实例才可以进行此操作,否则提示 409 错误。
          • 接口调用成功后实例进入 Starting 状态。
          • 支持强制重启,强制重启等同于传统服务器的断电重启,可能丢失实例操作系统中未写入磁盘的数据。

          请求结构

          PUT /v{version}/instance/{instanceId}?{action} HTTP/1.1
          Host: bbc.bj.baidubce.com
          Authorization: authorization string
          {
              "forceStop":forceStop
          }

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          instanceId String URL参数 待启动的实例ID
          action String Query参数 对实例执行的动作,本接口中该参数取值reboot
          forceStop boolean Request Body参数 是否强制停止实例,可选值true,false,缺省为false

          返回头域

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

          返回参数

          无特殊返回参数

          错误码

          错误码 错误描述 HTTP状态码 中文解释
          Instance.RebootInstanceOperationForbidden Instance not running when rebooting. 409 只有 Running 状态的实例才可以进行重启

          请求示例

          PUT /v1/instance/i-YufwpQAe?reboot HTTP/1.1
          Host: bbc.bj.baidubce.com
          ContentType: application/json
          Date: Wed, 01 Mar 2006 12:00:00 GMT
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
          {
              "forceStop": true
          }

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Wed, 03 Dec 2014 06:42:19 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS

          修改实例名称

          描述

          修改指定虚机的名称;

          • 只有 Running 和 Stopped 状态的实例才可以调用该接口,否则提示 409 错误。

          请求结构

          PUT /v{version}/instance/{instanceId}?{action} HTTP/1.1
          Host: bbc.bj.baidubce.com
          Authorization: authorization string
          
          {
              "name": name
          }

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          instanceId String URL参数 指定的实例ID
          action String Query参数 对实例执行的动作,当前取值rename
          name String Request Body参数 实例名称,满足规则大小写字母、数字以及-_ /.特殊字符,必须以字母开头,长度1-65

          返回头域

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

          返回参数

          无特殊返回参数

          错误码

          错误码 错误描述 HTTP状态码 中文解释
          BadRequest Bad request parameters or illegal request. 400 请求参数无效
          Instance.NameInvalid Instance name is invalid. 400 name无效
          NoSuchObject The specified object is not found or resource do not exist. 404 资源不存在
          OperationDenied Operation not available. 409 不可操作

          请求示例

          PUT /v1/instance/i-YufwpQAe?rename HTTP/1.1
          Host: bbc.bj.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
          {
              "name": "example"
          }

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Wed, 03 Dec 2014 06:42:19 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS

          修改实例描述

          描述

          修改指定虚机的描述;

          • 只有 Running 和 Stopped 状态的实例才可以调用该接口,否则提示 409 错误。

          请求结构

          PUT /v{version}/instance/{instanceId}?{action} HTTP/1.1
          Host: bbc.bj.baidubce.com
          Authorization: authorization string
          
          {
              "desc": desc
          }

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          instanceId String URL参数 指定的实例ID
          action String Query参数 对实例执行的动作,当前取值updateDesc
          desc String Request Body参数 实例描述

          返回头域

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

          返回参数

          无特殊返回参数

          错误码

          错误码 错误描述 HTTP状态码 中文解释
          BadRequest Bad request parameters or illegal request. 400 请求参数无效
          NoSuchObject The specified object is not found or resource do not exist. 404 资源不存在
          OperationDenied Operation not available. 409 不可操作

          请求示例

          PUT /v1/instance/i-YufwpQAe?updateDesc HTTP/1.1
          Host: bbc.bj.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
          {
              "desc": "example"
          }

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Wed, 03 Dec 2014 06:42:19 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS

          重装实例

          描述

          使用镜像重建指定虚拟机

          • 实例重装后,基于原系统盘的自定义镜像会保留。

          请求结构

          PUT /v{version}/instance/{instanceId}?{action} HTTP/1.1
          Host: bbc.bj.baidubce.com
          Authorization: authorization string
          
          {
              "imageId": imageId,
              "adminPass":adminPass,
              "isPreserveData":isPreserveData,
              "raidId":raidId,
              "sysRootSize":sysRootSize
          }

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          instanceId String URL参数 指定的实例ID
          action String Query参数 对实例执行的动作,当前取值rebuild
          imageId String Request Body参数 待指定的镜像ID
          adminPass String Request Body参数 机器密码,密码需要加密传输
          isPreserveData bool Request Body参数 是否保留数据,默认为true。当值为true时,raidId和sysRootSize字段不生效
          raidId String Request Body参数 raid配置Id,可通过查询RAID接口获得。此参数在isPreserveData为false时为必填,在isPreserveData为true时不生效
          sysRootSize int Request Body参数 系统盘根分区大小,默认为20G,取值范围为20-100。此参数在isPreserveData为true时不生效

          返回头域

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

          返回参数

          无特殊返回参数

          请求示例

          PUT /v1/instance/i-YufwpQAe?rebuild HTTP/1.1
          Host: bbc.bj.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
          {
              "imageId": "m-mRjO3cjs",
              "adminPass":"8e056bf0eac2333baec721fc9e7eaf92",
              "isPreserveData":false,
              "raidId":"raid-fjzh8321",
              "sysRootSize":20
          }

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Wed, 03 Dec 2014 06:42:19 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS

          释放实例

          描述

          释放单个物理机实例,释放后实例所使用的物理资源都被收回,相关数据全部丢失且不可恢复。

          • 只有付费类型为Postpaid或者付费类型为Prepaid且已过期的实例才可以释放。
          • 实例释放后,基于原系统盘的自定义镜像会保留。

          请求结构

          DELETE /v{version}/instance/{instanceId} HTTP/1.1
          Host: bbc.bj.baidubce.com
          Authorization: authorization string

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          instanceId String URL参数 待释放的物理机实例ID

          返回头域

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

          返回参数

          无特殊返回参数

          请求示例

          DELETE /v2/instance/i-3ghjsb67 HTTP/1.1
          Host: bbc.bj.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-04-10T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Mon, 10 Apr 2017 04:17:29 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS

          修改实例密码

          修改指定虚机的管理员密码

          请求结构

          PUT /v{version}/instance/{instanceId}?{action} HTTP/1.1
          Host: bbc.bj.baidubce.com
          Authorization: authorization string

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          instanceId String URL参数 指定的实例ID
          action String Query参数 对实例执行的动作,当前取值changePass
          adminPass String Request Body参数 待指定的实例管理员密码,8-16位字符,英文,数字和符号必须同时存在,符号仅限!@#$%^*(),密码需要加密传输

          返回头域

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

          返回参数

          无特殊返回参数

          错误码

          错误码 错误描述 HTTP状态码 中文解释
          Instance.PasswordOperationForbidden Instance not stopped when changing password. 409 只有 Stopped 状态的实例才可以修改密码

          请求示例

          PUT /v1/instance/i-YufwpQAe?changePass HTTP/1.1
          Host: bbc.bj.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
          {
              "adminPass": "c5b31add-ffe0-44b0-86eb-063109a1b6fe"
          }

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Wed, 03 Dec 2014 06:42:19 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS

          查询实例VPC/Subnet信息

          描述

          通过BBC实例id查询VPC/Subnet信息

          请求结构

          POST /v{version}/vpcSubnet HTTP/1.1
          Host: bbc.bj.baidubce.com
          Authorization: authorization string

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          bbcIds List<String> Request Body参数 需要查询VPC/Subnet信息的BBC实例Id列表

          返回头域

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

          返回参数

          参数名称 类型 描述
          networkInfo List<BbcNetworkModel> 返回BBC的VPC和Subnet信息

          请求示例

          POST /v1/vpcSubnet HTTP/1.1
          Host: bbc.bj.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
          {
             "bbcIds":["i-CRALHVQx"]
          }

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Wed, 03 Dec 2014 06:42:19 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS
          
          {
          "networkInfo": [{
          	"subnet": {
          		"vpcId": "vpc-cwtrgdc3cre4",
          		"name": "系统预定义子网",
          		"subnetType": "1",
          		"subnetId": "sbn-tgk8c11e7imb",
          		"cidr": "192.168.0.0/20",
          		"zoneName": "cn-bj-a"
          	},
          	"bbcId": "i-CRALHVQx",
          	"vpc": {
          		"cidr": "192.168.0.0/16",
          		"vpcId": "vpc-cwtrgdc3cre4",
          		"name": "默认私有网络",
          		"isDefault": "true",
          		"description": "default"
          	}
          }]
          }

          实例绑定安全组

          实例绑定安全组

          请求结构

          POST /v{version}/instance/securitygroup?{action} HTTP/1.1
          Host: bbc.bj.baidubce.com
          Authorization: authorization string

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          action String Query参数 对实例执行的动作,当前取值bind
          instanceIds List Request Body参数 待绑定安全组的实例ID集合
          securityGroups List Request Body参数 安全组ID集合

          返回头域

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

          返回参数

          无特殊返回参数

          请求示例

          POST /v1/instance/securitygroup?bind HTTP/1.1
          Host: bbc.bj.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
          {
              "instanceIds": ["i-c5b31add", "i-063109a1"],
              "securityGroups": ["sg-a5b11avd","sg-bvb1sdnd"]
          }

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Wed, 03 Dec 2014 06:42:19 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS

          实例解绑安全组

          实例解绑安全组

          请求结构

          POST /v{version}/instance/securitygroup?{action} HTTP/1.1
          Host: bbc.bj.baidubce.com
          Authorization: authorization string

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          action String Query参数 对实例执行的动作,当前取值unbind
          instanceId String Request Body参数 待解绑安全组的实例ID
          securityGroupId String Request Body参数 安全组ID

          返回头域

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

          返回参数

          无特殊返回参数

          请求示例

          POST /v1/instance/securitygroup?unbind HTTP/1.1
          Host: bbc.bj.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
          {
              "instanceId": "i-c5b31add",
              "securityGroupId": "sg-a5b11avd"
          }

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Wed, 03 Dec 2014 06:42:19 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS

          bbc开通自动续费(包含关联产品)

          描述

          仅限预付费产品生效

          请求结构

           POST /v{version}/instance/batchCreateAutoRenewRules HTTP/1.1
           Host: bbc.bj.baidubce.com
           Authorization: authorization string
            

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          instanceId String requestBody 虚拟机实例id
          renewTimeUnit String requestBody 续费单位,month,year
          renewTime int requestBody 续费时长,单位:month,支持1, 2, 3, 4, 5, 6, 7, 8, 9;单位:year,支持1, 2, 3

          返回头域

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

          返回参数

          无特殊返回参数

          错误码

          无特殊返回错误码

          请求示例

           POST /v1/instance/batchCreateAutoRenewRules HTTP/1.1
           Host: bbc.bj.baidubce.com
           ContentType: application/json
           Authorization: bce auth v1/f81d3b34e48048fbb2634dc7882d7e21/2015 08 11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
           
           {
               "instanceId": "i-UWMoa9i8",
               "renewTimeUnit" : "month"
               "renewTime" : 1
           }

          返回示例

           HTTP/1.1 200 OK
           x bce request id: 1214cca7 4ad5 451d 9215 71cb844c0a50
           Date: Wed, 03 Dec 2014 06:42:19 GMT
           Content Type: application/json;charset=UTF 8
           Server: BWS

          bbc关闭自动续费(包含关联产品)

          描述 仅限预付费产品生效

          请求结构

           POST /v{version}/instance/batchDeleteAutoRenewRules HTTP/1.1
           Host: bbc.bj.baidubce.com
           Authorization: authorization string
            

          请求头域

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

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          instanceId String requestBody 虚拟机实例id

          返回头域

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

          返回参数

          无特殊返回参数

          错误码

          无特殊返回错误码

          请求示例

           POST /v1/instance/batchDeleteAutoRenewRules HTTP/1.1
           Host: bbc.bj.baidubce.com
           ContentType: application/json
           Authorization: bce auth v1/f81d3b34e48048fbb2634dc7882d7e21/2015 08 11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
           
           {
               "instanceId": "i-UWMoa9i8"
           }

          返回示例

           HTTP/1.1 200 OK
           x bce request id: 1214cca7 4ad5 451d 9215 71cb844c0a50
           Date: Wed, 03 Dec 2014 06:42:19 GMT
           Content Type: application/json;charset=UTF 8
           Server: BWS
          上一篇
          简介
          下一篇
          标签相关接口