# 使用Postman调用创建集群接口
#### 场景介绍
本章节指导用户使用Postman创建DWS集群。该接口为异步接口，创建集群需要10～15分钟。API的调用方法请参考[如何调用API](https://support.huaweicloud.com/api-dws/dws_02_0062.html)。
#### 视频介绍
<video controls="controls" preload="none" id="object1349943851817" class="idp-external-video" src="https://res-video.hc-cdn.com/cloudbu-site/china/zh-cn/support/dws-video/1627893239972026707.mp4" title="调用API" poster="https://support.huaweicloud.com/api-dws/figure/zh-cn_image_0000002402653737.png" height="315.0000" width="600.0000"></video>
 #### 准备工作
- 已注册华为云账号，完成实名认证，请参见[注册华为云账号](https://support.huaweicloud.com/usermanual-account/account_id_001.html)。
- 已获取服务对应区域终端节点地址，具体请参考[地区和终端节点](https://developer.huaweicloud.com/endpoint?DWS)。
- 已获取华为云账号对应的用户名、用户密码、账号名及项目ID。在华为云控制台右上角"我的凭证-\>API凭证-\>项目列表"查看用户名、账号名、用户密码和所属区域项目ID。项目ID获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-dws/dws_02_0011.html)。
- 创建VPC，并获取VPC和子网的ID，具体参考[虚拟私有云VPC](https://support.huaweicloud.com/productdesc-vpc/zh-cn_topic_0013748729.html)。
 
#### 操作步骤
1. 环境配置。 
   ![](https://support.huaweicloud.com/api-dws/public_sys-resources/note_3.0-zh-cn.png)
   下载Postman调用创建快照服务，Postman建议使用7.24.0版本。
   
   
2. 获取Token，进行认证。 
   1. 在Postman界面上新建Post请求，选中Body的配置项，填写用户名、用户密码、账号名及项目ID。
      ![](https://support.huaweicloud.com/api-dws/figure/zh-cn_image_0000001621306277.png "点击放大")
      ![](https://support.huaweicloud.com/api-dws/public_sys-resources/note_3.0-zh-cn.png)
      获取token的华为云服务所在区域需要和调用的服务所在区域需一致，否则会导致调用失败。
      
   
   2. 单击右上角"Send"，发送"POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens"。获取返回结果中的Headers-\>X-Subject-Token值（Token有效期为24小时）。 ![](https://support.huaweicloud.com/api-dws/figure/zh-cn_image_0000001570626596.png "点击放大")
      
   
   
   
   
3. 调用创建集群接口。 
   1. 在Postman界面上新建Post请求，选中"Headers"配置项，添加对应的KEY、VALUE，复制Token值到"X-Auth-Token"。
   
   2. 调用接口，本服务提供了两个创建集群接口。其中请求URL的所在区域需要与调用的服务所在区域保持一致，project_id为项目ID（必填参数），获取方法参见[准备工作]。
      - v1接口：
        ```
        POST https://{Endpoint}/v1.0/{project_id}/clusters
        ```
        
      
      - v2接口：
        ```
        POST https://{Endpoint}/v2/{project_id}/clusters
        ```
        
      
      
      ![](https://support.huaweicloud.com/api-dws/public_sys-resources/note_3.0-zh-cn.png)
      推荐使用v2接口。
      
   
   3. 单击"Body"， 添加请求参数值到请求中。不同服务的参数各不相同，详情请参考[API说明](https://support.huaweicloud.com/api-dws/dws_02_0037.html)。
      ```
      {
          "cluster": {
              "flavor": "dwsx2.rt.xlarge.m6",
              "num_node": 3,
              "subnet_id": "050e154d-9954-4929-b6d3-12af7c9213ac",
              "security_group_id": "",
              "vpc_id": "050e154d-9954-4929-b6d3-12af7c9213ac",
              "db_port": 8000,
              "datastore_version": "8.1.3.320",
              "availability_zones": [
                  "cn-north-4c"
              ],
              "name": "dws1",
              "num_cn": 3,
              "db_name": "dbadmin",
              "db_password": "Passw0rd!",
              "public_ip": {
                  "public_bind_type": "auto_assign",
                  "eip_id": ""
              },
              "volume": {
                  "volume": "SSD",
                  "capacity": "100"
              }
          }
      }
      ```
      
   
   4. 单击右上角"Send"按钮发送请求。例如："POST https://dws.**cn-north-4** .myhuaweicloud.com/v2/89cd04f168b84af6be287f71730fdb4b/clusters"，查看创建结果。
      ```
      {
        "cluster" : {
          "id" : "7d85f602-a948-4a30-afd4-e84f47471c15"
        }
      }
      ```
      
   
   
   
   
 
#### 常见问题
- DWS.5207 CN实例个数不合法 根据最新版本，集群CN数量，取值范围为2\~集群节点数，最大值为20，默认值为3。
  
- DWS.5240 所选规格不存在 v2接口flavor填写规格名称，请勿使用规格ID。
  
- ECS.0319 创建集群失败，报错"The capacity of flavor am7.xlarge.8 is not sufficient."。 所选DWS规格在底层资源不足，请确认flavor字段并重新选择可用的DWS规格。