更新时间:2026-05-21 GMT+08:00
分享

购买实例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。取值非空,请参见地区和终端节点终端节点和区域说明。

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

管理员账号用户名。

  • 长度为1-32个字符。
  • 必须以字母开头。
  • 可以包含字母,数字、下划线,不能包含其它特殊字符。

admin_user_password

String

管理员账号密码。

  • 长度为8~32位。
  • 至少包含三种字符组合:大写字母(A~Z)、小写字母(a~z)、数字(0~9)、特殊字符~!@#%^*-_+?的组合。 建议您输入高强度密码,以提高安全性,防止出现密码被暴力破解等安全风险。

charge_info

ChargeInfo object

计费信息。

表4 ChargeInfo

参数

是否必选

参数类型

描述

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"
}

状态码

错误码

请参见错误码

相关文档