文档首页/ 应用管理与运维平台 ServiceStage/ API参考/ CSE API/ 引擎管理/ 创建微服务引擎 - CreateMicroserviceEngine
更新时间：2026-02-28 GMT+08:00
查看PDF
分享

创建微服务引擎 - CreateMicroserviceEngine

功能介绍

创建微服务引擎。

调试

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

授权信息

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

URI

POST /v2/{project_id}/enginemgr/engines

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户子项目的唯一标识，字符长度为1~64位，获取方法请参考获取项目ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

X-Enterprise-Project-ID

否

String

企业项目ID。

如果不配置此参数，则默认企业项目为“default”，ID为0。
表3 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

微服务引擎名称，名称为字母开头，字母、数字、-组成，且不能以-结尾，长度3~24。

须知：

微服务引擎名称不允许命名为“default”。

description

否

String

微服务引擎描述，长度0~255。

payment

是

String

微服务引擎计费方式，通过接口只支持创建计费方式为按需的引擎。

设置为固定值1。

flavor

是

String

微服务引擎专享版规格。

取值范围：

  • cse.s1.small2：高可用100实例引擎。
  • cse.s1.medium2：高可用200实例引擎。
  • cse.s1.large2：高可用500实例引擎。
  • cse.s1.xlarge2：高可用2000实例引擎。

azList

是

Array of strings

当前局点可用区列表。

authType

是

String

微服务引擎认证方式。

取值范围：

  • RBAC：引擎开启安全认证。
  • NONE：引擎未开启安全认证。

authConfig

否

表4

微服务引擎的RBAC设置信息。若不传，默认为开启编程接口安全认证。

vpc

是

String

vpc名称。

vpcId

是

String

vpc的id，长度不超过64位。

networkId

是

String

微服务引擎子网ID。

subnetCidr

是

String

微服务引擎子网划分。

publicIpId

否

String

微服务引擎公网访问地址ID。

specType

是

String

微服务引擎专享版部署类型。

取值范围：

  • 1.x引擎时，固定值CSE。
  • 2.x引擎时，固定值为CSE2。

auth_cred

否

object

微服务引擎选择安全认证时必传，包含引擎的认证信息。

inputs

否

Map<String,String>

微服务引擎附加参数。

elbId

否

String

弹性负载均衡器id。

elbName

否

String

微服务引擎使用的elb的名称。
表4 authConfig

参数

是否必选

参数类型

描述

consoleAuthEnabled

是

Boolean

是否开启控制台安全认证。

sdkAuthEnabled

是

Boolean

是否开启编程接口安全认证。

若编程接口认证参数sdkAuthEnabled值为true时，则控制台安全认证参数consoleAuthEnabled也需要设置为true。
表5 object

参数

是否必传

参数类型

描述

pwd

是

String

开启安全认证引擎的root账号密码。

响应参数

状态码： 200

表6 响应Body参数

参数

参数类型

描述

id

String

微服务引擎ID。

name

String

微服务引擎名称。

jobId

Integer

微服务引擎执行任务ID。

状态码： 400

表7 响应Body参数

参数

参数类型

描述

errorCode

String

错误代码。

errorMessage

String

错误信息。

detail

String

详细定位信息。

状态码： 500

表8 响应Body参数

参数

参数类型

描述

errorCode

String

错误代码。

errorMessage

String

错误信息。

detail

String

详细定位信息。

请求示例

创建一个名称为“test”微服务引擎，其计费模式为按需计费，规格为cse.s1.small2，可用区为test，关闭安全认证，微服务引擎的部署类型为CSE2。

POST https://{endpoint}/v2/{project_id}/enginemgr/engines
{
	"name": "test",
	"description": "test",
	"payment": "1",
	"flavor": "cse.s1.small2",
	"azList": ["test"],
	"authType": "NONE",
	"vpc": "vpc-demotest",
	"vpcId": "09902850-9454-4715-9764-018f0c37022",
	"networkId": "88550801-e892-4f8e-b21b-f7147f6229",
	"subnetCidr": "192.168.0.5/26",
	"specType": "CSE2,
	"inputs": {
		"nodeFlavor": "s6.large.2"
	}
}

响应示例

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

状态码

状态码

描述

200

查询当前支持的微服务引擎的规格列表成功。

400

错误的请求。

500

服务内部错误。

错误码

请参见CSE错误码。

父主题： 引擎管理

相关文档