# 创建实例 ![](https://support.huaweicloud.com/api-rabbitmq/public_sys-resources/note_3.0-zh-cn.png) 当前页面API为历史版本API，未来可能停止维护。请使用[创建实例](https://support.huaweicloud.com/api-rabbitmq/CreatePostPaidInstanceByEngine.html)。 #### 功能介绍 创建实例，该接口创建的实例为按需计费的方式。 #### URI POST /v1.0/{project_id}/instances 参数说明见[表1]。 表1参数说明 | 参数 | 类型 | 必选 | 说明 | |:---|:---|:---|:---| | project_id | String | 是 | 项目ID。 | #### 请求消息 **请求参数** 参数说明见[表2]。 表2参数说明 | 参数 | 类型 | 是否必选 | 说明 | |:---|:---|:---|:---| | name | String | 是 | 实例名称。 由英文字符开头，只能由英文字母、数字、中划线组成，长度为4\~64的字符。 | | description | String | 否 | 实例的描述信息。 长度不超过1024的字符串。 说明： \\与"在json报文中属于特殊字符，如果参数值中需要显示\\或者"字符，请在字符前增加转义字符\\，比如**\\\\** 或者**\\"**。 | | engine | String | 是 | 消息引擎：rabbitmq。 | | engine_version | String | 否 | 消息引擎的版本。 | | storage_space | Integer | 是 | 消息存储空间，单位GB。 - 单机RabbitMQ实例的存储空间的取值范围100GB\~90000GB。 - 集群RabbitMQ实例的存储空间的取值范围为100GB\*节点数\~90000GB、200GB\*节点数\~90000GB、300GB\*节点数\~90000GB。 | | access_user | String | 是 | 认证用户名，只能由英文字母、数字、中划线组成，长度为4\~64的字符。 | | password | String | 是 | 实例的认证密码。 复杂度要求： - 输入长度为8到32位的字符串。 - 必须包含如下四种字符中的两种组合： - 小写字母 - 大写字母 - 数字 - 特殊字符包括（\`\~!@#$%\^\&\*()-_=+\\\|\[{}\]:'",\<.\>/?） | | vpc_id | String | 是 | 租户VPC ID。 | | security_group_id | String | 是 | 租户安全组ID。 | | subnet_id | String | 是 | 子网ID。 | | available_zones | Array | 是 | 创建节点到指定的AZ ID，该参数不能为空数组或者数组的值为空，详情请参考[查询可用区信息](https://support.huaweicloud.com/api-rabbitmq/rabbitmq-api-180514008.html)查询得到。 | | product_id | String | 是 | 产品标识。 详情请参考[查询产品规格列表](https://support.huaweicloud.com/api-rabbitmq/rabbitmq-api-180514009.html)。 | | maintain_begin | String | 否 | 维护时间窗开始时间，格式为HH:mm。 - 维护时间窗开始和结束时间必须为指定的时间段，可参考[查询维护时间窗时间段](https://support.huaweicloud.com/api-rabbitmq/rabbitmq-api-180514010.html)获取。 - 开始时间必须为22:00、02:00、06:00、10:00、14:00和18:00。 - 该参数不能单独为空，若该值为空，则结束时间也为空。系统分配一个默认开始时间02:00。 | | maintain_end | String | 否 | 维护时间窗结束时间，格式为HH:mm。 - 维护时间窗开始和结束时间必须为指定的时间段，可参考[查询维护时间窗时间段](https://support.huaweicloud.com/api-rabbitmq/rabbitmq-api-180514010.html)获取。 - 结束时间在开始时间基础上加四个小时，即当开始时间为22:00时，结束时间为02:00。 - 该参数不能单独为空，若该值为空，则开始时间也为空，系统分配一个默认结束时间06:00。 | | enable_publicip | Boolean | 否 | RabbitMQ实例是否开启公网访问功能。 - true：开启 - false：不开启 | | publicip_id | String | 否 | RabbitMQ实例绑定的弹性IP地址的ID。 如果开启了公网访问功能（即enable_publicip为true），该字段为必选。 | | ssl_enable | Boolean | 否 | 是否打开SSL加密访问。 - true：打开SSL加密访问。 - false：不打开SSL加密访问。 | | storage_spec_code | String | 是 | 存储IO规格。如何选择磁盘类型请参考[磁盘类型及性能介绍](https://support.huaweicloud.com/productdesc-evs/zh-cn_topic_0044524691.html)。 取值范围： - dms.physical.storage.normal： - dms.physical.storage.high - dms.physical.storage.ultra | | enterprise_project_id | String | 否 | 企业项目ID。 | **RabbitMQ** **实例的请求示例** ``` { "name": "rabbitmq-demo", "description": "", "engine": "RabbitMQ", "engine_version": "3.x.x", "storage_space": 100, "access_user": "******", "password": "******", "vpc_id": "1e93f86e-13af-46c8-97d6-d40fa62b76c2", "security_group_id": "0aaa0033-bf7f-4c41-a6c2-18cd04cad2c8", "subnet_id": "b5fa806c-35e7-4299-b659-b39398dd4718", "available_zones": ["d573142f24894ef3bd3664de068b44b0"], "product_id": "00300-30109-0--0", "maintain_begin": "22:00", "maintain_end": "02:00", "ssl_enable": false, "enable_publicip": false, "publicip_id": "", "enterprise_project_id": "0", "storage_spec_code": "dms.physical.storage.ultra" } ``` #### 响应消息 **响应参数** 参数说明见[表3]。 表3参数说明 | 参数 | 类型 | 说明 | |:---|:---|:---| | instance_id | String | 实例ID | **响应示例** ``` { "instance_id": "8959ab1c-7n1a-yyb1-a05t-93dfc361b32d" } ``` #### 状态码 操作成功的状态码如[表4]所示，其他响应见[状态码](https://support.huaweicloud.com/api-rabbitmq/rabbitmq-api-190611008.html)。 表4状态码 | 状态码 | 描述 | |:---|:---| | 200 | 创建实例成功。 |