创建实例

更新时间：2023-03-03

前提条件

创建实例需要实名认证，没有通过实名认证的可以前往百度智能云官网控制台中的安全认证下的实名认证中进行认证。

说明

本接口用于创建相同配置的云数据库 HBase 实例，目前仅支持一次创建一个。
创建后付费方式的实例需要账户现金余额大于等于100元。
创建接口为异步创建，可通过查询指定实例详情接口查询实例状态。

请求结构

POST /v{version}/instance?clientToken={clientToken} HTTP/1.1
HOST: hbase.bj.baidubce.com
Authorization: authorization string
{
    "billing":{
        "paymentTiming": paymentTiming,
        "reservation": {
            "reservationLength": reservationLength,
            "reservationTimeUnit": "Month"
        }
    },
    "name": name,
    "engine":engine
    "engineVersion": engineVersion,
    "zkNodeSpec": zkNodeSpec,
    "masterNodeSpec": masterNodeSpec,
    "coreNodeCount": coreNodeCount,
    "coreNodeSpec": coreNodeType,
    "coreNodeDiskType": coreNodeDiskType,
    "coreNodeDiskSizeInGB": coreNodeDiskSizeInGB,
    "coldStorageDir": coldStorageDir,
    "tsdbProxyCount": tsdbProxyCount,
    "tsdbProxySpec": tsdbProxySpec,
    "vpcId": vpcId,
    "tags": [{
        "tagKey": "testKey",
        "tagValue": "testValue"
    }],
    "subnets":[
        {
            "zoneName": zoneName,
            "subnetId": subnetId
        }
    ],
    "resGroupId": "resGroupId"
}

请求头域

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

请求参数

参数名称	类型	是否必选	参数位置	描述
version	String	是	URL参数	API版本号
clientToken	String	是	Query参数	幂等性Token，是一个长度不超过64位的ASCII字符串。
billing	Billing	是	RequestBody参数	订单、计费相关参数。
name	string	否	RequestBody参数	实例名称
engine	string	是	RequestBody参数	引擎："hbase"
engineVersion	string	是	RequestBody参数	引擎版本："2.0"
zkNodeSpec	string	是	RequestBody参数	ZK节点规格类型
masterNodeSpec	string	是	RequestBody参数	Master节点规格类型
coreNodeCount	int	是	RequestBody参数	Core节点数量
coreNodeSpec	string	是	RequestBody参数	Core节点规格类型
coreNodeDiskType	string	否	RequestBody参数	Core节点的磁盘类型
coreNodeDiskSizeInGB	int	否	RequestBody参数	Core节点的磁盘大小
coldStorageDir	string	否	RequestBody参数	冷存储的存储目录，举例：bos://bucket/object_prefix/
tsdbProxyCount	int	否	RequestBody参数	tsdb proxy节点数量
tsdbProxySpec	string	否	RequestBody参数	tsdb proxy节点规格
vpcId	string	否	RequestBody参数	如果不提供，则选择默认vpc
subnets	List SubnetModel	否	RequestBody参数	如果不提供，则选择默认子网
resGroupId	string	否	RequestBody参数	所属资源组ID
tags	List TagModel	否	RequestBody参数	实例所属标签

返回头域

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

返回参数

参数名称	类型	描述
orderId	String	订单ID
instances	List<InstanceIdView>	新建的实例的ID

InstanceIdView

参数名称	参数类型	参数描述
instanceUuid	string	实例UUID
instanceId	string	实例ID

请求示例

POST /v1/instance?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST: hbase.bj.baidubce.com
ContentType: application/json    
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
    "engine": "hbase",
    "engineVersion": "2.0",
    "coreNodeDiskType": "cloud_hp1",
    "coreNodeDiskSizeInGB": 400,
    "coreNodeCount": 2,
    "zkNodeSpec": "c1m2",
    "masterNodeSpec": "c4m8",
    "vpcId": "vpcId",
    "coreNodeSpec": "c4m16",
    "billing": {
        "paymentTiming": "Prepaid",
        "reservation": {
            "reservationLength": 1,
            "reservationTimeUnit": "Month"
        },
        "autoRenew": {
            "autoRenewTimeUnit": "Month",
            "autoRenewLength": 1
        }
    },
    "tags": [{
        "tagKey": "testKey",
        "tagValue": "testValue"
    }],
    "subnets": [{
        "zoneName": "zoneE",
        "subnetId": "subnetId"
    }],
    "resGroupId": "resGroupId"
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
Content-Type: application/json
{
    "orderId": "1cbe9770a8d24afabfbb719997d98d9c", 
    "instances": [
        {
            "instanceUuid": "34412f60-5362-4a48-8346-8a1624a93d8d", 
            "instanceId": "hb-uxhfnr"
        }
    ]
}

更改实例名称

查询实例详情

云数据库 HBase

创建实例

InstanceIdView