更新时间:2024-12-04 GMT+08:00
分享

创建微服务引擎专享版

功能介绍

创建微服务引擎专享版。

调试

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

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 String

当前局点可用区列表。

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>

微服务引擎专享版附加参数。

表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错误码

相关文档