文档首页> > API参考> API说明> 资源池> 创建单个资源池

创建单个资源池

分享
更新时间: 2019/08/02 15:22

功能介绍

该接口用于创建一个资源池。

URI

POST /v1.0/{project_id}/pools

参数说明请参见表1

表1 参数说明

参数

是否为必选

参数类型

描述

project_id

String

项目编号,获取方法请参考获取项目编号

请求消息

请求参数

请求参数如表2所示。

表2 请求参数说明

参数

是否为必选

参数类型

描述

poolName

String

资源池的名称,只能以小写字母开头,由小写字母、数字、中划线(-)组成,不能以中划线结尾,且长度为4-24个字符。

description

String

资源池的相关描述。

取值范围为0-1024个字符。只允许输入英文字符。

poolType

String

资源池类型,包括托管和非托管。默认为托管类型。

resourceSpec

ResourceSpec数据结构

资源池中资源的说明。详情可参考表3

poolScaleSpec

PoolScaleSpec数据结构

池伸缩范围,默认值为NULL。

托管模式时需配置此参数,详情可参考表8

notification

Notification数据结构

订阅消息,详情可参考表9

poolBillingModeSpec

PoolBillingModeSpec数据结构

计费模式,详情可参考表10。默认值{ "billingMode":0}

表3 resourceSpec参数说明

参数

是否为必选

参数类型

描述

availabilityZone

String

待创建资源池所在的可用区。具体参考ECS服务说明。

instanceType

String

例如:s2.large.2|s2.xlarge.2...。

imageId

String

vm的操作系统镜像Id。集群类型为CCE集群时,支持EulerOS 2.2。

取值范围:可输入的字符长度为1-256字符。

desiredNodeCount

Integer

期望节点数,非托管型资源池时需配置此参数,默认值为0,取值范围需要参考弹性云服务器中关于租户配额的说明。

disks

Disks数据结构

虚拟机的磁盘信息,详情可参考表4。默认的系统盘大小为40G,数据盘大小为100G。

ECS云服务器集群,暂不支持挂载数据盘。

networkConfig

NetworkConfig数据结构

网络信息配置,详情可参考表7。如果为配置此项,批处理服务会自动创建一个虚拟网络和子网。

默认值:NULL。

machineType

String

集群类型。目前支持CCE_LINUX_VM(云容器引擎Linux虚拟机 )。默认值为CCE_LINUX_VM。目前支持CCE_LINUX_VM(云容器引擎Linux虚拟机 )、CCE_HA_LINUX_VM(高可用云容器引擎Linux虚拟机)

maxTasksPerNode

Integer

每个节点支持的最大任务数。

取值范围:0-64,0表示不使用这个字段。

默认值:0。

表4 disks参数说明

参数

是否为必选

参数类型

描述

systemDisk

SystemDisk数据结构

系统盘信息,默认值为{"diskType":"SAS","size":40}。

详情可参考表5

dataDisks

List<DataDisk>

建议使用一个新建的evs卷做为docker数据盘。

如果配置此参数,必须填写size和mountPoint。默认值为[{"diskType":"SAS","size":100,"mountPoint":"/var/lib/docker"}]。

ECS云服务器集群,暂不支持挂载数据盘。

详情可参考表6

表5 SystemDisk参数说明

参数

是否为必选

参数类型

描述

diskType

String

支持SATA、SAS和SSD,分别指普通IO、高IO和超高IO磁盘类型,默认为SAS类型。

size

Integer

系统盘的大小。

取值范围:40-1024。

默认值:40。

单位:GB。

表6 DataDisk参数说明

参数

是否为必选

参数类型

描述

diskType

String

支持SATA、SAS和SSD,分别指普通IO、高IO和超高IO磁盘类型,默认为SAS类型。

size

Integer

数据盘的大小。目前仅支持添加一个数据盘。

取值范围:100-32768。

单位:GB。

mountPoint

String

数据盘挂载点,默认挂载在/var/lib/docker,目前不支持指定其他目录。

表7 networkConfig参数说明

参数

是否为必选

参数类型

描述

vpcCidr

String

虚拟私有云下可用子网的范围。

取值范围:192.168.0.0/16 ~ 192.168.255.0/24,必须是cidr格式,且与vpcId只能选择一填写。

vpcId

String

私有网络ID,必须与subnetIds同时配置。配置详情可参考虚拟私有云API参考。如果未配置此参数,批处理服务会新建一个私有网络。

subnetIds

List<String>

私有网络中的子网的网络ID列表,与vpcId同时配置,目前仅只支持配置一个列表。如果未配置此参数,批处理服务会新建一个子网。

表8 poolScaleSpec参数说明

参数

是否为必选

参数类型

描述

minNodeCount

Integer

托管型资源池伸缩的最小虚拟机节点数。

默认值:0。

maxNodeCount

Integer

托管型资源池伸缩的最大虚拟机节点数。

默认值:1。

取值范围:必须大于minNodeCount,最大值需参考弹性云服务器中的服务租户配额。

表9 notification参数说明

参数

是否为必选

参数类型

说明

topicName

String

订阅消息的参数名。

取值范围:只能包含大写和小写字母,数字,短横线(-)和下划线(_),长度为1~255个字符。

events

List<String>

资源池事件列表。

支持以下事件类型:OnPoolRunning、OnPoolDeleted、OnPoolScalingUp、OnPoolScalingDown或OnPoolUnavailable。

表10 poolBillingModeSpec参数说明

参数

是否为必选

参数类型

说明

billingMode

Integer

计费模式。

  • 0:onDeman按需计费
  • 1:onAutoPay包年/包月
  • 2:spot竞价计费

默认值:0。

spotPrice

String

竞价计费价格上限。设置为null时,表示自动设置价格上限。

默认值:null。

响应消息

响应参数

正常响应参数如表11所示。错误响应参考表2

表11 正常响应参数说明

参数

参数类型

说明

data

Object数据结构

返回数据信息。详情可参考表12

msg

String

操作成功的描述信息。

requestId

String

请求ID。

表12 data参数说明

参数

参数类型

说明

poolId

String

新建资源池的ID。

示例

如下以创建名称为batchPool001的资源池为例。

  • 请求示例
    {
    	"poolName" : "batchpool001",
    	"description" : "my first pool",
    	"poolType" : "UNMANAGED",
    	"resourceSpec" : {
    		"instanceType" : "s2.large.2",
    		"imageId" : "EulerOS 2.2",
    		"desiredNodeCount" : 3,
    		"disks" : {
    			"systemDisk" : {
    				"diskType" : "SATA",
    				"size" : 40
    			},
    			"dataDisks" : [{
    				"diskType" : "SATA",
    				"size" : 100,
    				"mountPoint" : "/var/lib/docker"
    			}]
    		},
    		"networkConfig" : {
    			"vpcId" : "1743e9b8-defa-4faa-8622-366352d3e529",
    			"subnetIds" : ["50b6c8d1-df0a-4cca-aa6d-b4a6f4731cd9"]
    		},
    		"machineType" : "CCE_LINUX_VM"
    	}
    }
  • 响应示例
    {
    "data": {
            "poolId": "poolwr4jr351"
    },
    "msg": "submit add pool successfully",
    "requestId": "req-735cca97-8c87-493d-a807-0dfe3fccb04b"
    }

状态码

状态码可参考表1

如果您喜欢这篇文档,您还可以:

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区