文档首页/ 微服务引擎 CSE/ API参考/ CSE API/ 引擎管理/ 创建微服务引擎 - CreateMicroserviceEngine

更新时间：2026-05-29 GMT+08:00

创建微服务引擎 - CreateMicroserviceEngine

功能介绍

创建微服务引擎，支持创建ServiceComb引擎专享版、注册配置中心、应用网关。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。

如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
cse:engine:create	write	-	g:ResourceTag/<tag-key> g:EnterpriseProjectId g:TagKeys	-	-

URI

POST /v2/{project_id}/enginemgr/engines

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	租户子项目的唯一标识。字符长度为1~64。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。
X-Enterprise-Project-ID	否	String	如果不带则默认企业项目为“default”，ID为“0”。
Content-Type	是	String	该字段内容填为 "application/json;charset=UTF-8"。
Accept	是	String	该字段内容填为 "application/json"。

表3 请求Body参数
参数	是否必选	参数类型	描述
name	是	String	微服务引擎的名称。名称以字母开头，字母、数字、（-）组成，且不能以（-）结尾，长度为3-24个字符。
description	否	String	微服务引擎的描述。最大长度：255
payment	是	String	微服务引擎的计费方式。取值范围： 0：表示包周期，暂不支持。 1：表示按需，支持。 2：表示免费，暂不支持。最大长度：24
flavor	是	String	微服务引擎的规格。 cse.s1.xxx对应ServiceComb引擎专享版的规格。 cse.nacos2.xxx对应注册配置中心的规格。取值范围： cse.s1.small2 cse.s1.medium2 cse.s1.large2 cse.s1.xlarge2 cse.s1.small3 cse.s1.medium3 cse.s1.large3 cse.s1.xlarge3 cse.nacos2.c1.large.10 cse.nacos2.c1.xlarge.20 cse.nacos2.c1.xlarge.40 cse.nacos2.c1.xlarge.60 cse.nacos2.c1.2xlarge.100 说明：以下规格当前只在西南-贵阳-汽车二局点支持。 cse.s1.small3 cse.s1.medium3 cse.s1.large3 cse.s1.xlarge3
azList	否	Array of strings	创建ServiceComb引擎专享版时必填，指定引擎部署的可用区列表。数组长度：1 - 3
authType	否	String	创建ServiceComb引擎专享版时必填，指定引擎的认证类型。取值范围： RBAC：引擎开启安全认证。 NONE：引擎未开启安全认证。
vpc	是	String	vpc名称。最大长度：64
vpcId	是	String	vpc标识。最大长度：64
networkId	是	String	微服务引擎子网ID。最大长度：64
subnetCidr	是	String	微服务引擎子网划分。最大长度：24
publicIpId	否	String	微服务引擎公网地址ID，当前为null。最大长度：64
auth_cred	否	EngineRbacPwd object	创建ServiceComb引擎专享版，选择RBAC认证时必传，包含引擎的认证信息。
specType	是	String	微服务引擎的应用部署类型。取值范围： CSE2 CSE3 Nacos2 默认取值： CSE2 说明：当前CSE3只在西南-贵阳-汽车二局点支持。
inputs	否	Map<String,String>	引擎附加参数。
enginestateInfo	否	enginestateInfo object	引擎状态信息。
enterpriseProject	否	enterpriseProject object	企业项目信息。
resourceParams	否	resourceParams object	微服务引擎资源参数。
productId	否	String	产品ID。
capacityProductId	否	String	容量产品ID。
isFree	否	Boolean	微服务引擎是否免费。
subnetName	否	String	微服务引擎使用的子网名称。
tags	否	Array of strings	标签。
elbId	否	String	微服务引擎使用的elb的ID。
elbName	否	String	微服务引擎使用的elb的名称。

表4 EngineRbacPwd
参数	是否必选	参数类型	描述
pwd	否	String	开启安全认证的微服务引擎专享版默认root账号的密码。

表5 enginestateInfo
参数	是否必选	参数类型	描述
cluster	否	Boolean	集群。
twinClusters	否	Boolean	双子集群。
singleEngine	否	Boolean	单引擎。

表6 enterpriseProject
参数	是否必选	参数类型	描述
id	否	String	企业项目ID。
name	否	String	企业项目名称。
description	否	String	企业项目描述。
status	否	Integer	企业项目状态。取值范围： 1：启用 2：停用
created_at	否	String	企业项目创建时间。
updated_at	否	String	企业项目升级时间。
label	否	String	企业项目标签。

表7 resourceParams
参数	是否必选	参数类型	描述
isAutoRenew	否	Integer	是否自动刷新。

响应参数

状态码： 200

表8 响应Body参数
参数	参数类型	描述
id	String	微服务引擎ID。
name	String	微服务引擎名称。
jobId	Integer	微服务引擎执行的任务ID。

状态码： 400

表9 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误信息。
detail	String	详细定位信息。

状态码： 500

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误信息。
detail	String	详细定位信息。

请求示例

POST https://{endpoint}/v2/{project_id}/enginemgr/engines

{
  "name" : "string",
  "description" : "string",
  "payment" : "string",
  "flavor" : "cse.s1.small2",
  "azList" : [ "string" ],
  "authType" : "NONE",
  "vpc" : "string",
  "networkId" : "string",
  "subnetCidr" : "string",
  "vpcId" : "string",
  "publicIpId" : "string",
  "specType" : "string",
  "inputs" : {
    "nodeFlavor" : "string"
  }
}

响应示例

状态码： 200

创建微服务引擎响应结构体。

{
  "id" : "891bf21a-4024-4f47-b38c-bd259ca8f10a",
  "name" : "test",
  "jobId" : 17655
}

状态码

状态码	描述
200	创建微服务引擎响应结构体。
400	错误的请求。
500	服务器内部错误。

错误码

请参见CSE错误码。

父主题： 引擎管理

上一篇：查询微服务引擎列表 - QueryMicroserviceEngineList

下一篇：查询微服务引擎的详情 - QueryDetailsAboutMicroserviceEngine