调用CreateCluster创建集群_微服务引擎(MSE)-阿里云帮助中心

创建一个注册配置中心（ZooKeeper、Nacos等）集群。

接口说明

请确保在使用该接口前，已充分了解 MSE（Microservice Engine）产品的收费方式和价格。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
mse:CreateCluster	Write	Cluster acs:mse:{#regionId}:{#accountId}:instance/*	无	无

请求参数

名称	类型	必填	描述	示例值
PubNetworkFlow	string	否	ConnectionType 为`slb`时有效，0 表示不创建公网接入 SLB，1 以上值表示公网接入 SLB 的带宽固定值；单位 Mbps。取值范围：0~5000。	0
PubSlbSpecification`deprecated`	string	否	不再使用
DiskType`deprecated`	string	否	不再使用
VpcId	string	否	VPC ID。	vpc-bp1t50e045b5g7i3p****
NetType	string	是	网络类型，取值如下： `privatenet`：表示专有网络。 `pubnet`：表示公网。	privatenet
VSwitchId	string	否	交换机 ID。	vsw-bp17opt4v18sto39k****
InstanceCount	integer	是	实例节点数，范围限制：1~9 个。 [专业版] 实例数大于等于 3，且必须为奇数。 [开发版] 实例数只能为 1。 [Serverless 版] 忽略该参数。	3
ClusterSpecification	string	是	引擎规格，取值如下： [专业版] `MSE_SC_2_4_60_c`：2 核 4G `MSE_SC_1_2_60_c`：1 核 2G `MSE_SC_4_8_60_c`：4 核 8G `MSE_SC_8_16_60_c`：8 核 16G `MSE_SC_16_32_60_c`：16 核 32G [开发版] `MSE_SC_1_2_60_c`：1 核 2G `MSE_SC_2_4_60_c`：2 核 4G [Serverless 版] 忽略该参数，也可填`MSE_SC_SERVERLESS`。	MSE_SC_2_4_60_c
ClusterVersion	string	是	集群版本，取值如下： [专业版] `NACOS_2_0_0`：表示 Nacos 2.x.x 版本。 `ZooKeeper_3_8_0`：表示 ZooKeeper 3.8.x 版本。 [开发版] `NACOS_2_0_0`：表示 Nacos 2.x 版本。 `ZooKeeper_3_8_0`：表示 ZooKeeper 3.8.x 版本。 [Serverless 版] `NACOS_2_0_0`：表示 Nacos 2.x 版本。 `ZooKeeper_3_8_0`：表示 ZooKeeper 3.8.x 版本。	NACOS_2_0_0
ClusterType	string	是	集群类型，包括 ZooKeeper、Nacos-Ans。	Nacos-Ans
Region	string	是	集群所在地域，包括但不限于如下地域： `cn-hangzhou`：杭州 `cn-beijing`：北京 `cn-shanghai`：上海 `cn-zhangjiakou`：张家口 `cn-shenzhen`：深圳	cn-hangzhou
PrivateSlbSpecification`deprecated`	string	否	不再使用
ConnectionType	string	否	网络接入类型，`slb`或`single_eni`；部分 Region 开发版只支持`single_eni`类型。
RequestPars	string	否	扩展请求参数，JSON 格式。	{}
MseVersion	string	否	非特殊情况必填，取值如下： `mse_pro`：表示专业版。 `mse_dev`：表示开发版。 `mse_serverless`：表示 Serverless 版。	mse_pro
InstanceName	string	否	实例自定义名称	tanshuyingtest001
ResourceGroupId	string	否	资源组 ID。资源组详情请参见查看资源组基本信息。	rg-aekzcqmoay3dlyq
Tag	object []	否	待添加的标签列表。最多包含 20 个子项。
Key	string	否	标签 KEY。	env
Value	string	否	标签值。	prd
ChargeType	string	否	付费模式，包括 PREPAY（包年包月）和 POSTPAY（按量付费）。 Serverless 版忽略该参数。	POSTPAY
SecurityGroupType	string	否	ConnectionType 为`single_eni`时有效，表示实例所在的安全组类型	enterprise
EipEnabled	boolean	否	ConnectionType 为`single_eni`时有效，表示是否开启公网访问（弹性公网 IP）枚举值： true：true。 false：false。
AcceptLanguage	string	否	返回信息的语言类型： zh：中文 en：英文	zh

返回参数

名称	类型	描述	示例值
	object	字符串对象。
RequestId	string	请求 ID。	dc63-465d-8ef5-20dc18af****
Message	string	返回信息。	请求处理成功
InstanceId	string	实例 ID。	mse-cn-st21ri2****
ErrorCode	string	错误码。	mse-100-000
OrderId	string	订单 ID。	20574710974****
Success	boolean	请求结果，取值如下： `true`：请求成功。 `false`：请求失败。	true

示例

正常返回示例

JSON格式

{
  "RequestId": "dc63-465d-8ef5-20dc18af****",
  "Message": "请求处理成功",
  "InstanceId": "mse-cn-st21ri2****",
  "ErrorCode": "mse-100-000",
  "OrderId": "20574710974****",
  "Success": true
}

错误码

HTTP status code	错误码	错误信息	描述
400	IllegalRequest	Invalid request:%s	非法请求： %s
400	InvalidParameter	Parameter error:%s	请求参数错误：%s
403	NoPermission	You are not authorized to perform this operation:%s	没有权限使用此接口：%s
404	NotFound	Not found:%s	资源不存在：%s
500	InternalError	Console error. Try again later:%s	控制台错误.稍后重试：%s

访问错误中心查看更多错误码。

变更历史

变更时间

变更内容概要

操作

2023-08-29

OpenAPI 入参发生变更

看变更集

变更项	变更内容
入参	OpenAPI 入参发生变更。
	新增入参：SecurityGroupType
	新增入参：EipEnabled

2023-05-09

OpenAPI 入参发生变更

看变更集

变更项	变更内容
入参	OpenAPI 入参发生变更。
	新增入参：ChargeType

2022-08-11

OpenAPI 入参发生变更

看变更集

变更项	变更内容
入参	OpenAPI 入参发生变更。
	删除入参：ResourceGroupId
	删除入参：Tags