更新时间:2026-08-10 GMT+08:00

创建Pro实例 - CreateRomaInstanceV3

功能介绍

创建ROMA实例,只支持创建RCU类别的实例。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。

URI

POST /v3/{project_id}/roma/instances

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

实例所属租户。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

名称。

description

否

String

实例描述。

charge_type

是

String

指定实例计费模式。取值如下: - prePaid:预付费模式,也称作包周期计费模式。 - postPaid:后付费模式,也称作按需计费模式。

available_zone_ids

是

Array of strings

可用区列表。

cpu_arch

是

String

架构类型。

enterprise_project_id

否

String

企业项目ID,需要与企业项目开关配合使用,开启企业项目后必填。

rcu

是

rcu object

RCU实例的RCU配置信息。

vpc_id

是

String

用户选择虚拟私有云ID。

subnet_id

是

String

用户选择的子网。

ingress_bandwidth_size

否

Integer

入口公网带宽,在公网访问开关开启时生效。

publicip_enable

否

Boolean

公网访问开关,默认为false。

config

否

config object

创建实例关联资源配置参数。

scope

否

String

区分IES边缘实例,取值edge,默认值为center。

表3 rcu

参数

是否必选

参数类型

描述

total

否

Integer

RCU的总和。

distribution

否

Array of RCUAssignReq objects

RCU的分配。

表4 RCUAssignReq

参数

是否必选

参数类型

描述

indicator

是

indicator object

RCU指标对象。

value

是

Integer

分配给指标的RCU数值,范围符合指标约束范围要求。

表5 indicator

参数

是否必选

参数类型

描述

id

是

String

RCU指标ID。

表6 config

参数

是否必选

参数类型

描述

mqs

否

mqs object

实例的MQS参数配置,默认不需要进行配置。

表7 mqs

参数

是否必选

参数类型

描述

engine_version

否

String

引擎版本号。

retention_policy

否

String

MQS的磁盘容量到达容量阈值后,对消息的处理策略。取值如下:

  • produce_reject: 表示拒绝消息写入。

  • time_base: 表示自动删除最老消息。

ssl_enable

否

Boolean

是否开启SSL加密访问。取值如下:

  • true: 打开SSL加密访问。

  • false: 不打开SSL加密访问。

trace_enable

否

Boolean

是否开启消息轨迹。取值如下:

  • true: 打开消息轨迹。

  • false: 关闭消息轨迹。

vpc_client_plain

否

Boolean

是否开启VPC明文访问。取值如下:

  • true: 打开VPC明文访问。

  • false: 关闭VPC明文访问。

响应参数

状态码:202

表8 响应Body参数

参数

参数类型

描述

instance_id

String

实例ID。

job_id

String

实例任务ID。

状态码:default

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

无

响应示例

无

状态码

状态码

描述

202

OK

default

response for errors

错误码

请参见错误码。