# 购买实例V3 #### 功能介绍 购买DDM实例 #### URI POST /v3/{project_id}/instances 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 租户在某一region下的project ID。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | DDM实例名称，命名要求如下。 - 长度为4-64个字符。 - 必须以字母开头。 - 可以包含字母、数字、中划线、下划线，不能包含其它特殊字符。 最小长度：**4** 最大长度：**64** | | available_zones | 是 | Array of strings | 可用区code。取值非空，请参见[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/DDM)。 | | node_num | 是 | Integer | 节点数量。 | | engine_version | 是 | String | 引擎版本号（Core实例版本号）。获取方法常见 [查询DDM引擎信息](https://support.huaweicloud.com/api-ddm/ddm_api_01_0015.html)。 | | flavor_ref | 是 | String | 规格码。参见[查询DDM可用区规格信息](https://support.huaweicloud.com/api-ddm/ddm_api_01_0016.html)获取。 | | vpc_id | 是 | String | 虚拟私有云id。 | | subnet_id | 是 | String | 子网id。 | | security_group_id | 是 | String | 安全组id。 | | param_group_id | 否 | String | 参数组id。 | | enterprise_project_id | 否 | String | 企业项目id。 | | time_zone | 否 | String | UTC时区。默认为UTC。取值范围："UTC","UTC-12:00","UTC-11:00","UTC-10:00","UTC-09:00", "UTC-08:00", "UTC-07:00", "UTC-06:00", "UTC-05:00", "UTC-04:00", "UTC-03:00", "UTC-02:00", "UTC-01:00", "UTC+01:00", "UTC+02:00", "UTC+03:00", "UTC+04:00", "UTC+05:00", "UTC+06:00", "UTC+07:00", "UTC+08:00", "UTC+09:00", "UTC+10:00", "UTC+11:00", "UTC+12:00" | | admin_user_name | 否 | String | 管理员账号用户名。 - 长度为1-32个字符。 - 必须以字母开头。 - 可以包含字母，数字、下划线，不能包含其它特殊字符。 | | admin_user_password | 否 | String | 管理员账号密码。 - 长度为8\~32位。 - 至少包含三种字符组合：大写字母（A\~Z）、小写字母（a\~z）、数字（0\~9）、特殊字符\~!@#%\^\*-_+?的组合。 建议您输入高强度密码，以提高安全性，防止出现密码被暴力破解等安全风险。 | | charge_info | 否 | [ChargeInfo] object | 计费信息。 | 表4ChargeInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | charge_mode | 否 | String | 计费模式，取值范围： - prePaid：预付费，即包年/包月。 - postPaid：后付费，即按需付费。 默认值为postPaid。 缺省值：**postPaid** 枚举值： - **prePaid** - **postPaid** | | period_num | 否 | Integer | 订购周期类型，取值范围： - month：月。 - year：年。 "charge_mode"参数配置为"prePaid"时该参数有效且为必选值。 枚举值： - **month** - **year** | | period_type | 否 | String | 订购周期数，取值范围： - period_type=month（周期类型为月）时，取值为\[1，9\]。 - period_type=year（周期类型为年）时，取值为1。 "charge_mode"参数配置为"prePaid"时该参数有效且为必选值。 | | is_auto_pay | 否 | Boolean | 下单订购后，是否自动从客户的账户的余额中支付，取值范围： - "true"：是（自动从客户账户的余额中支付）。 - "false"：否（需要客户手动支付）。 "charge_mode"参数配置为"prePaid"时该参数有效，不传该字段时默认为客户手动支付。 枚举值： - **true** - **false** | | is_auto_renew | 否 | Boolean | 是否自动续订，取值范围： "true"：自动续订。 "false"：不自动续订。 "charge_mode"参数配置为"prePaid"时该参数有效，不传该字段时默认为不自动续订。 枚举值： - **true** - **false** | #### 响应参数 - 正常响应参数说明 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | job_id | String | 任务ID。 仅创建按需实例时会返回该参数。 | | order_id | String | 订单号，创建包年/包月实例时返回该参数。 | | id | String | 实例ID。创建按需付费实例时返回该参数。 | #### 请求示例 购买实例 ``` { "name" : "test", "flavor_ref" : "ddm.xlarge.4", "node_num" : 4, "engine_version" : "3.1.7.0", "enterprise_project_id" : 0, "available_zones" : [ "eu-de-01" ], "vpc_id" : "f6509a58-51bc-4454-a3e7-6ec7e97xx", "security_group_id" : "16cfe4b3-905c-44b8-a29d-e51d8b03c6dc", "subnet_id" : "22774dc2-abe8-4435-85b1-c9b997518a5d", "param_group_id" : "527818581bee4283ac14cc1e9b457072pr09", "time_zone" : "UTC", "admin_user_name" : "root", "admin_user_password" : "PassWord_234", "charge_info" : { "charge_mode" : "prePaid", "period_type" : "month", "period_num" : 1, "is_auto_renew" : true, "is_auto_pay" : true } } ``` #### 响应示例 - 正常响应示例 ``` { "id" : "e90bc6739a3c4666a577c3fa1524dac2in09", "job_id" : "1eb697c0-1842-43a3-8671-f562d0385cb9" } ``` - 异常响应 请参见[异常请求结果](https://support.huaweicloud.com/api-ddm/ddm_api_01_0059.html)。 #### 状态码 - 正常 202 - 异常 请参见[状态码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0060.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0061.html)。