弹性裸金属服务器

    实例相关接口

    创建实例

    接口描述

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

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

    响应(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",
    			"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
    上一篇
    简介
    下一篇
    标签相关接口