# 创建密码服务集群 - CreateCluster #### 功能介绍 创建密码服务集群 ![](https://support.huaweicloud.com/api-dew/public_sys-resources/note_3.0-zh-cn.png) 调用接口之后返回订单ID，需要到"待支付订单里面"支付成功之后才能创建密码服务集群。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-dew/dew_02_0002.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dew/dew_02_0308.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | cpcs:cluster:create | Write | cluster \* | - | - | billing:contract:viewDiscount | #### URI POST /v1/{project_id}/dew/cpcs/cluster 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID。可参考[获取项目ID](https://support.huaweicloud.com/api-dew/dew_02_0009.html)获取。 **约束限制：** 不涉及 **取值范围：** 字符长度为32 **默认取值：** 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务查询用户Token接口获取（响应消息头中X-Subject-Token的值）。使用AK、SK等认证方式，此处非必选 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | charging_mode | 是 | Integer | **参数解释：** 计费模式 - 0：包年/包月。 **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | region_id | 是 | String | **参数解释：** 局点ID **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | period_type | 是 | Integer | **参数解释：** 周期类型 - 2：月。 - 3：年。 **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | period_num | 是 | Integer | **参数解释：** 周期数量 **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | subscription_num | 是 | Integer | **参数解释：** 实例数量 **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | period_product_id | 是 | String | **参数解释：** 产品id **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | period_resource_spec_code | 是 | String | **参数解释：** 产品规格code **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | cluster_name | 是 | String | **参数解释：** 集群名称 **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | service_type | 是 | String | **参数解释：** 服务类型 - ENCRYPT_DECRYPT：加解密服务。 - SIGN_VERIFY：签名验签服务。 - KMS：密钥管理服务。 - TIMESTAMP：时间戳服务。 - COLLA_SIGN：协同签名服务。 - OTP：动态令牌服务。 - DB_ENCRYPT：数据库加密服务。 - FILE_ENCRYPT：文件加密服务。 - DIGIT_SEAL：电子签章服务。 - SSL_VPN：SSL_VPN服务。 - IAS：身份认证服务。 **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | share_type | 是 | String | **参数解释：** 共享类型 - EXCLUSIVE：应用独享。 - SHARED：应用共享。 **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | image_id | 否 | String | **参数解释：** 镜像id **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | is_auto_renew | 是 | Integer | **参数解释：** 是否自动续费 **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | promotion_info | 否 | String | **参数解释：** 折扣 **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | app_id | 否 | String | **参数解释：** 应用id **约束限制：** 网卡类服务为必填项 **取值范围：** 不涉及 **默认取值：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | enterprise_project_id | 否 | String | **参数解释：** 企业项目id **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | type | 否 | String | **参数解释：** 实例类型 - SINGLE：单机。 - STANDBY：主备。 **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | | az | 是 | String | **参数解释：** az **取值范围：** 不涉及 **约束限制：** 不涉及 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | order_id | String | **参数解释：** 集群订单ID **取值范围：** 不涉及 | #### 请求示例 请求头中的**X-Auth-Token**字段需要填写token，且该token需要具有本API的访问权限 ``` POST https://cpcs.com/v1/{project_id}/dew/cpcs/cluster { "charging_mode" : 0, "region_id" : "test-region", "period_type" : 2, "period_num" : 1, "subscription_num" : 1, "period_product_id" : "OFFI1015101891137228800", "period_resource_spec_code" : "cpcs.crypto.instance.standard", "cluster_name" : "0719", "service_type" : "SSL_VPN", "share_type" : "EXCLUSIVE", "image_id" : "00ee2d5f-3f56-4729-8315-b10ed7724324", "is_auto_renew" : 0, "promotion_info" : "", "app_id" : "ea04bbba983d461a9ac8759074d5f6e0", "enterprise_project_id" : "0", "type" : "SINGLE", "az" : "AUTO-AZ" } ``` #### 响应示例 **状态码：200** 请求已成功 ``` { "order_id" : "a6bbf0be-79f3-4f66-858a-0fdcb96dfcbe" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 请求已成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-dew/ErrorCode.html)。