# 创建微服务引擎 - CreateMicroserviceEngine #### 功能介绍 创建微服务引擎。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CSE/doc?api=CreateEngine)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-servicestage/servicestage_06_0183.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | cse:engine:create | write | - | - *[g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)* - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) - [g:TagKeys](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) | - | - | #### URI POST /v2/{project_id}/enginemgr/engines 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 租户子项目的唯一标识，字符长度为1\~64位，获取方法请参考[获取项目ID](https://support.huaweicloud.com/api-servicestage/servicestage_06_0164.html)。 | #### 请求参数 表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\ | 微服务引擎附加参数。 | | elbId | 否 | String | 弹性负载均衡器id。 | | elbName | 否 | String | 微服务引擎使用的elb的名称。 | 表4authConfig | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | consoleAuthEnabled | 是 | Boolean | 是否开启控制台安全认证。 | | sdkAuthEnabled | 是 | Boolean | 是否开启编程接口安全认证。 若编程接口认证参数sdkAuthEnabled值为true时，则控制台安全认证参数consoleAuthEnabled也需要设置为true。 | 表5object | 参数 | 是否必传 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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错误码](https://support.huaweicloud.com/api-servicestage/cse_06_0136.html)。