文档首页> > API参考> 集群管理接口> 创建集群

创建集群

更新时间: 2018-11-02 17:48

功能介绍

该接口用于创建集群。

URI

POST /v1.0/{project_id}/clusters
表1 参数说明

参数

是否为必选

类型

说明

project_id

String

项目编号。

请求消息

请求参数如表2所示。

表2 请求参数

参数

是否为必选

类型

说明

cluster

Object

集群对象。

表3 cluster字段要素说明

参数

是否为必选

类型

说明

instance

Object

实例对象。

datastore

否,可选

Object

数据搜索引擎类型。

name

String

集群名称。4~32个字符,只能包含数字、字母、中划线和下划线,且必须以字母开头。

instanceNum

Integer

集群实例个数,取值范围为1~32。

表4 instances字段要素说明

参数

是否为必选

类型

说明

flavorRef

String

实例规格名称。

  • ess.spec-1u8g规格对应的取值范围为40GB~640GB。
  • ess.spec-2u16g规格对应的取值范围为40GB~1280GB。
  • ess.spec-4u32g规格对应的取值范围为40GB~2560GB。
  • ess.spec-8u64g规格对应的取值范围为80GB~5120GB。
  • ess.spec-16u128g规格对应的取值范围为160GB~10240GB。

volume

Object

volume信息。

nics

Object

子网信息。

availability_zone

否,可选

String

可用区。

表5 volume字段要素说明

参数

是否为必选

类型

说明

volume_type

String

COMMON:普通I/O,即SATA磁盘。

HIGH:高I/O,即SAS磁盘。

ULTRAHIGH:超高I/O,即SSD磁盘。

size

Integer

卷大小,必须为4和10的倍数。

表6 nics字段要素说明

参数

是否为必选

类型

说明

vpcId

String

指定虚拟私有云ID,用于集群网络配置。

netId

String

子网ID(网络ID),其中一个搜索集群所有实例的子网和安全组必须相同。

securityGroupId

String

安全组ID,其中一个搜索集群所有实例的子网和安全组必须相同。

表7 datastore字段要素说明

参数

是否为必选

类型

说明

version

String

引擎版本号,支持5.5.1或6.2.3。

type

String

引擎类型,默认为elasticsearch。目前只支持elasticsearch。

响应消息

响应参数如表8所示。

表8 响应参数

参数

类型

说明

cluster

Object

集群对象。

表9 cluster字段要素说明

参数

类型

说明

id

String

集群ID。

name

String

集群名称。

示例

请求样例

POST /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters
{ 
    "cluster": { 
        "name": "ES-Test",
        "instanceNum": 4,
           "instance": { 
               "flavorRef": "ess.spec-2u16g", 
                  "volume": { 
                         "volume_type": "COMMON", 
                         "size": 100
                  }, 
                  "nics": { 
                         "vpcId": "fccd753c-91c3-40e2-852f-5ddf76d1a1b2",
                         "netId": "af1c65ae-c494-4e24-acd8-81d6b355c9f1", 
                         "securityGroupId": "7e3fed21-1a44-4101-ab29-34e57124f614" 
                  }
           }
    } 
}
响应样例
{
  "cluster": {
    "id": "ef683016-871e-48bc-bf93-74a29d60d214",
    "name": "ES-Test"
  }
}

状态码

状态码如表10所示。

表10 状态码

状态码

编码

状态码说明

400

BadRequest

非法请求。

建议直接修改该请求,不要重试该请求。

409

Conflict

服务器在完成请求时发生冲突。

返回该状态码,表明客户端尝试创建的资源已经存在,或者由于冲突请求的更新操作不能被完成。

412

Precondition Failed

未满足前提条件,服务器未满足请求者在请求中设置的其中一个前提条件。

200

OK

请求已成功。

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

在文档使用中是否遇到以下问题







请至少选择或填写一项反馈信息

字符长度不能超过100

反馈内容不能为空!

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区
点我,12·12惊喜等着你哦~