购买实例V3
功能介绍
购买DDM实例
URI
POST /v3/{project_id}/instances
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 租户在某一region下的project ID。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| name | 是 | String | DDM实例名称,命名要求如下。
最小长度:4 最大长度:64 |
| available_zones | 是 | Array of strings | 可用区code。取值非空,请参见地区和终端节点终端节点和区域说明。 |
| node_num | 是 | Integer | 节点数量。 |
| engine_version | 是 | String | 引擎版本号(Core实例版本号)。获取方法常见 查询DDM引擎信息。 |
| flavor_ref | 是 | String | 规格码。参见查询DDM可用区规格信息获取。 |
| 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 | 管理员账号用户名。
|
| admin_user_password | 否 | String | 管理员账号密码。
|
| charge_info | 否 | ChargeInfo object | 计费信息。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| charge_mode | 否 | String | 计费模式,取值范围:
缺省值:postPaid 枚举值:
|
| period_num | 否 | Integer | 订购周期类型,取值范围:
枚举值:
|
| period_type | 否 | String | 订购周期数,取值范围:
|
| is_auto_pay | 否 | Boolean | 下单订购后,是否自动从客户的账户的余额中支付,取值范围:
枚举值:
|
| is_auto_renew | 否 | Boolean | 是否自动续订,取值范围: “true”:自动续订。 “false”:不自动续订。 “charge_mode”参数配置为“prePaid”时该参数有效,不传该字段时默认为不自动续订。 枚举值:
|
响应参数
- 正常响应参数说明
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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"
} - 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。