创建实例
更新时间：2023-10-25
前提条件
创建实例需要实名认证，没有通过实名认证的可以前往百度智能云官网控制台中的安全认证下的实名认证中进行认证。
说明
- 本接口用于创建相同配置的云数据库 HBase 实例，目前仅支持一次创建一个。
- 创建后付费方式的实例需要账户现金余额大于等于100元。
- 创建接口为异步创建，可通过查询指定实例详情接口查询实例状态。
请求结构
Plain Text
1POST /v{version}/instance?clientToken={clientToken} HTTP/1.1
2HOST: hbase.bj.baidubce.com
3Authorization: authorization string
4{
5 "billing":{
6 "paymentTiming": paymentTiming,
7 "reservation": {
8 "reservationLength": reservationLength,
9 "reservationTimeUnit": "Month"
10 }
11 },
12 "name": name,
13 "engine":engine
14 "engineVersion": engineVersion,
15 "zkNodeSpec": zkNodeSpec,
16 "masterNodeSpec": masterNodeSpec,
17 "coreNodeCount": coreNodeCount,
18 "coreNodeSpec": coreNodeType,
19 "coreNodeDiskType": coreNodeDiskType,
20 "coreNodeDiskSizeInGB": coreNodeDiskSizeInGB,
21 "coldStorageDir": coldStorageDir,
22 "tsdbProxyCount": tsdbProxyCount,
23 "tsdbProxySpec": tsdbProxySpec,
24 "vpcId": vpcId,
25 "tags": [{
26 "tagKey": "testKey",
27 "tagValue": "testValue"
28 }],
29 "subnets":[
30 {
31 "zoneName": zoneName,
32 "subnetId": subnetId
33 }
34 ],
35 "resGroupId": "resGroupId"
36}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| 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 | Integer | 是 | RequestBody参数 | Core节点数量 |
| coreNodeSpec | String | 是 | RequestBody参数 | Core节点规格类型 |
| coreNodeDiskType | String | 否 | RequestBody参数 | Core节点的磁盘类型 |
| coreNodeDiskSizeInGB | Integer | 否 | RequestBody参数 | Core节点的磁盘大小 |
| coldStorageDir | String | 否 | RequestBody参数 | 冷存储的存储目录，举例：bos://bucket/object_prefix/ |
| tsdbProxyCount | Integer | 否 | 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 |
请求示例
Plain Text
1POST /v1/instance?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2HOST: hbase.bj.baidubce.com
3Content-Type: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5{
6 "engine": "hbase",
7 "engineVersion": "2.0",
8 "coreNodeDiskType": "cloud_hp1",
9 "coreNodeDiskSizeInGB": 400,
10 "coreNodeCount": 2,
11 "zkNodeSpec": "c1m2",
12 "masterNodeSpec": "c4m8",
13 "vpcId": "vpcId",
14 "coreNodeSpec": "c4m16",
15 "billing": {
16 "paymentTiming": "Prepaid",
17 "reservation": {
18 "reservationLength": 1,
19 "reservationTimeUnit": "Month"
20 },
21 "autoRenew": {
22 "autoRenewTimeUnit": "Month",
23 "autoRenewLength": 1
24 }
25 },
26 "tags": [{
27 "tagKey": "testKey",
28 "tagValue": "testValue"
29 }],
30 "subnets": [{
31 "zoneName": "zoneE",
32 "subnetId": "subnetId"
33 }],
34 "resGroupId": "resGroupId"
35}返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
3Content-Type: application/json
4{
5 "orderId": "1cbe9770a8d24afabfbb719997d98d9c",
6 "instances": [
7 {
8 "instanceUuid": "34412f60-5362-4a48-8346-8a1624a93d8d",
9 "instanceId": "hb-uxhfnr"
10 }
11 ]
12}