调用CreateInstance接口创建云消息队列 RocketMQ 版5.0实例。调用本接口会创建一个新购实例资源的订单，并自动支付。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
Action | String | 是 | CreateInstance | 系统规定参数。取值：CreateInstance。 |
Parameter.N.Code | String | 是 | InstanceType | 第N个模块属性Code配置，如有多个模块属性参数，按照N=0,1,2,3…N的形式拼接多个参数。 该参数需与Parameter.N.Value一起使用。 云消息队列 RocketMQ 版创建实例还需要配置更多属性，请参见配置Parameter.N.Code参数。 |
Parameter.N.Value | String | 是 | professional | 第N个模块属性Code对应的Value，如有多个模块属性参数，按照N=0,1,2,3…N的形式拼接多个参数。 |
ProductCode | String | 是 | ons | 产品代码，固定为：ons。 |
ProductType | String | 否 | ons_rmqsub_public_cn | 产品类型，固定为：ons_rmqsub_public_cn。 |
SubscriptionType | String | 是 | Subscription | 付费类型，取值如下：
使用本接口创建云消息队列 RocketMQ 版5.0实例，该参数只能取值为Subscription。 |
RenewalStatus | String | 否 | AutoRenewal | 续费方式，取值如下：
|
RenewPeriod | Integer | 否 | 1 | 自动续费周期， 单位：月。 说明 当RenewalStatus取值为AutoRenewal时，该参数必须设置。 |
Period | Integer | 否 | 1 | 预付费周期，单位：月。按年付费产品请输入12的整数倍。 |
Logistics | String | 否 | 不涉及 | 物流信息。创建云消息队列 RocketMQ 版实例时不涉及，您无需填写该参数。 |
ClientToken | String | 否 | JASIOFKVNVIXXXXXX | 客户端幂等参数，服务端会查询是否有相同ClientToken的请求，如果有，直接返回上次调用结果。 |
表 1. 配置Parameter.N.Code参数
参数 | 取值 | 是否必选 | 描述 |
Parameter.0.Code | internet_spec | 是 | 配置是否为实例是否开启公网访问功能。 Parameter.0.Value取值如下：
若开启公网访问，云消息队列 RocketMQ 版会收取公网下行带宽费用。具体计费信息，请参见公网访问费用。 |
Parameter.1.Code | flow_out_type | 是 | 配置公网计费类型。 Parameter.1.Value取值如下：
|
Parameter.2.Code | flow_out_bandwidth | 否 | 配置公网带宽。Parameter.1.Value取值为payByBandwidth时必须配置。 Parameter.2.Value取值范围为[1,1000]，单位：Mbps。 |
Parameter.3.Code | region | 是 | 配置实例所属地域。Parameter.3.Value取值为实例所支持的地域ID，例如cn-shenzhen。各地域所对应的RegionID，请参见开服地域。 |
Parameter.4.Code | instance_version | 是 | 配置实例版本。 Parameter.4.Value固定取值：rocketmq5.0。 |
Parameter.5.Code | vpc_id | 是 | 配置实例所绑定的VPC。 Parameter.5.Value取值为已创建的VPC的ID，例如：vpc-**1u0bwhyb586i7axgs**。 选择的VPC实例和待创建的云消息队列 RocketMQ 版实例需要处于同一地域。 |
Parameter.6.Code | vswitch_id | 是 | 配置实例所绑定的Vswitch。 Parameter.6.Value取值为已选择的VPC下的Switch的ID。例如：vsw-***bdohgpe5atvjbu***。 |
Parameter.7.Code | series_type | 是 | 配置实例的主系列。 Parameter.7.Value取值如下：
实例规格差异，请参见实例规格。 |
Parameter.8.Code | sub_series_type | 是 | 配置实例的子系列。 Parameter.8.Value取值如下：
|
Parameter.9.Code | msg_process_spec | 是 | 配置云消息队列 RocketMQ 版实例的计算规格。 Parameter.9.Value取值请参见实例规格上限中的实例规格列。例如：rmq.s2.2xlarge。 重要 填写的实例规格必须是所选择的主系列和子系列下所支持的规格。 |
Parameter.10.Code | order_num | 否 | 配置需要创建的实例数量。 Parameter.10.Value取值范围为 [1,9999]，单位：个。 |
Parameter.11.Code | ord_time | 否 | 配置实例的购买时长。 Parameter.11.Value取值范围为[1,36]的整数，单位：月。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
Code | String | Success | 状态码。 |
Data | Struct | 返回信息。 | |
InstanceId | String | rmq-cn-wny3psj**** | 订单对应的实例ID。 |
OrderId | String | 21014976059**** | 创建成功的订单ID。 |
Message | String | Successful！ | 提示信息。 |
RequestId | String | B62C712B-1789-5114-B0BB-80CB2AFD**** | 请求ID。 |
Success | Boolean | true | 是否成功。 |
示例
请求示例
http(s)://business.aliyuncs.com/?Action=CreateInstance
&Parameter.0.Code=internet_spec
&Parameter.0.Value=enable
&Parameter.1.Code=flow_out_type
&Parameter.1.Value=payByBandwidth
&Parameter.2.Code=flow_out_bandwidth
&Parameter.2.Value=30
&Parameter.3.Code=region
&Parameter.3.Value=cn-shenzhen
&Parameter.4.Code=instance_version
&Parameter.4.Value=rocketmq5.0
&Parameter.5.Code=vpc_id
&Parameter.5.Value=vpc-**1u0bwhyb586i7axgs**
&Parameter.6.Code=vswitch_id
&Parameter.6.Value=vsw-***bdohgpe5atvjbu***
&Parameter.7.Code=series_type
&Parameter.7.Value=standard
&Parameter.8.Code=sub_series_type
&Parameter.8.Value=single_node
&Parameter.9.Code=msg_process_spec
&Parameter.9.Value=rmq.s1.micro
&Parameter.10.Code=order_num
&Parameter.10.Value=1
&Parameter.11.Code=ord_time
&Parameter.11.Value=1
&ProductCode=ons
&ProductType=ons_rmqsub_public_cn
&SubscriptionType=Subscription
&Period=1
&RenewPeriod=1
&RenewalStatus=AutoRenewal
&<公共请求参数>正常返回示例
XML 格式
<CreateInstanceResponse>
<RequestId>B62C712B-1789-5114-B0BB-80CB2AFD****</RequestId>
<Message>Successful!</Message>
<Data>
<InstanceId>rmq-cn-wny3p***</InstanceId>
<OrderId>21014976059****</OrderId>
</Data>
<Code>Success</Code>
<Success>true</Success>
</CreateInstanceResponse>JSON 格式
{
"RequestId": "B62C712B-1789-5114-B0BB-80CB2AFD****",
"Message": "Successful!",
"Data": {
"InstanceId": "rmq-cn-wny3p***",
"OrderId": 21014976059****
},
"Code": "Success",
"Success": true
}错误码
访问错误中心查看更多错误码。
访问错误中心查看更多错误码。