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

创建集群

分享
更新时间: 2019/09/12 11:31

功能介绍

该接口用于创建集群。

集群必须要运行在VPC之内,创建集群前,您需要先创建VPC,并获取VPC和子网的ID。

该接口为异步接口,创建集群需要10~15分钟。

URI

  • URI 格式
    POST /v1.0/{project_id}/clusters
  • 参数说明
    表1 URI参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    String

    项目编号。获取方法,请参见获取项目ID

请求消息

  • 请求样例
    POST /v1.0/89cd04f168b84af6be287f71730fdb4b/clusters
    
    {
    "cluster": {
            "node_type": "dws.m1.xlarge.ultrahigh",
            "number_of_node": 3,
            "subnet_id": "374eca02-cfc4-4de7-8ab5-dbebf7d9a720",
            "security_group_id": "dc3ec145-9029-4b39-b5a3-ace5a01f772b",
            "vpc_id": "85b20d7e-9eb7-4b2a-98f3-3c8843ea3574",
            "availability_zone": "cn-north-1b",
            "port": 8000,
            "name": "dws-1",
            "user_name": "dbadmin",
            "user_pwd": "Passw0rd!",
            "public_ip": {
                "public_bind_type": "auto_assign",
                "eip_id": ""
            }
            "eps_id":"aca4e50a-266f-4786-827c-f8d6cc3fbada"
        }
    }
  • 参数说明
    表2 请求参数说明

    参数

    是否必选

    参数类型

    描述

    cluster

    cluster object

    集群对象。

    表3 cluster

    参数

    是否必选

    参数类型

    描述

    node_type

    String

    节点类型。DWS服务支持的节点类型可通过调用查询节点类型接口进行查询。

    number_of_node

    Integer

    集群节点数量,取值范围为3~32。

    subnet_id

    String

    指定子网ID,用于集群网络配置。

    vpc_id

    String

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

    security_group_id

    String

    指定安全组ID,用于集群网络配置。

    availability_zone

    String

    配置集群可用区。

    当前支持的可用区有:

    • cn-east-2a
    • cn-east-2b
    • cn-south-1a
    • cn-south-2b
    • cn-south-1c

    name

    String

    集群名称,要求唯一性,必须以字母开头并只包含字母、数字、中划线或下划线,长度为4~64个字符。

    user_name

    String

    DWS集群管理员用户名。用户命名要求如下:

    • 只能由小写字母、数字或下划线组成。
    • 必须以小写字母或下划线开头。
    • 长度为1~63个字符。
    • 用户名不能为DWS数据库的关键字。DWS数据库的关键字,请参见《数据仓库服务数据库开发指南》关键字章节。

    user_pwd

    String

    DWS集群管理员密码。

    密码复杂度要求如下:

    • 密码字符长度为8~32位。
    • 不能与用户名或倒序的用户名相同。
    • 至少包含以下4种类型的3种:
      • 小写字母
      • 大写字母
      • 数字
      • 特殊字符~!@#%^&*()-_=+|[{}];:,<.>/?
    • 不能为弱密码,例如:Admin123!

    port

    Integer

    集群服务端口,取值范围为8000~10000,默认值:8000。

    public_ip

    public_ip object

    公网IP地址,如果未指定,则默认不使用公网连接。

    number_of_cn

    Integer

    CN部署量,取值范围为2~集群节点数-1,最大值为5,默认值为2。

    eps_id

    UUID

    企业项目ID,对集群指定企业项目,默认设为default。

    表4 public_ip字段数据结构说明

    参数

    是否必选

    参数类型

    描述

    public_bind_type

    String

    弹性IP绑定类型,取值如下:
    • auto_assign:自动绑定
    • not_use:暂不使用
    • bind_existing:使用已有

    默认值为“not_use”。

    eip_id

    UUID

    弹性IP的id。

响应消息

  • 响应样例
    {
        "cluster": {
            "id": "7d85f602-a948-4a30-afd4-e84f47471c15"
         }
    }
  • 参数说明
    表5 响应参数说明

    参数

    是否必选

    参数类型

    描述

    cluster

    Object

    集群对象。

    id

    String

    集群ID。

状态码

  • 正常

    200

  • 异常
    表6 返回值说明

    返回值

    描述

    400 Bad Request

    请求错误。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误

    503 Service Unavailable

    服务不可用。

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区