
# 创建Pro实例 - CreateRomaInstanceV3
#### 功能介绍
创建ROMA实例，只支持创建RCU类别的实例。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ROMA/doc?api=CreateRomaInstanceV3)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-roma/roma_06_0018.html)。
#### 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。                                           |
   
 表3rcu 
| 参数           | 是否必选 | 参数类型                                                                         | 描述      |
|:---|:---|:---|:---|
| total        | 否    | Integer                                                                      | RCU的总和。 |
| distribution | 否    | Array of [RCUAssignReq] objects | RCU的分配。 |
   
 表4RCUAssignReq 
| 参数        | 是否必选 | 参数类型                                                         | 描述                        |
|:---|:---|:---|:---|
| indicator | 是    | [indicator] object | RCU指标对象。                  |
| value     | 是    | Integer                                                      | 分配给指标的RCU数值，范围符合指标约束范围要求。 |
   
 表5indicator 
| 参数 | 是否必选 | 参数类型   | 描述       |
|:---|:---|:---|:---|
| id | 是    | String | RCU指标ID。 |
   
 表6config 
| 参数  | 是否必选 | 参数类型                                             | 描述                    |
|:---|:---|:---|:---|
| mqs | 否    | [mqs] object | 实例的MQS参数配置，默认不需要进行配置。 |
   
 表7mqs 
| 参数               | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| 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 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-roma/ErrorCode.html)。
