更新时间:2025-11-28 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

实例名称。

available_zones

Array of strings

可用区。

node_num

Integer

节点数量。

engine_version

String

引擎版本。

flavor_ref

String

规格。

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

时区。

admin_user_name

String

账号。

admin_user_password

String

密码。

charge_info

Object

付费信息。

表4 ChargeInfo

参数

是否必选

参数类型

描述

charge_mode

String

付费模式。

period_num

Integer

使用周期。

period_type

String

周期模式。

is_auto_pay

Boolean

是否自动支付。

is_auto_renew

Boolean

是否自动续费。

响应参数

状态码:202

表5 响应Body参数

参数

参数类型

描述

job_id

String

任务ID。

仅创建按需实例时会返回该参数。

order_id

String

订单号,创建包年/包月实例时返回该参数。

id

String

实例ID。创建按需付费实例时返回该参数。

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

状态码:500

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

请求示例

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

响应示例

状态码:202

ok

{
  "id" : "e90bc6739a3c4666a577c3fa1524dac2in09",
  "job_id" : "1eb697c0-1842-43a3-8671-f562d0385cb9"
}

状态码:400

bad request

{
  "error_msg" : "Parameter error.",
  "error_code" : "DBS.280001"
}

状态码:500

server error

{
  "error_msg" : "Parameter error.",
  "error_code" : "DBS.280001"
}

状态码

状态码

描述

202

ok

400

bad request

500

server error

错误码

请参见错误码

相关文档