AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 人工智能平台 PAI 开发参考 API参考 灵骏集群API（单租） API目录 灵骏集群 CreateCluster - 创建集群

CreateCluster - 创建集群

更新时间：
产品详情
我的收藏

创建一个新的灵骏集群。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

eflo:CreateCluster

create

*Cluster

acs:eflo:{#regionId}:{#accountId}:cluster/*

 无 无

请求参数

名称

类型

必填

描述

示例值
ClusterName

string

否

集群名称

Standard_Cluster
ClusterType

string

否

集群类型

Lite
ClusterDescription

string

否

集群描述

标准集群测试
NodeGroups

array<object>

否

节点组列表

array<object>

否

节点分组信息

SystemDisk

object

否

系统盘信息

Category

string

否

磁盘类型。取值范围：

  • cloud_essd：ESSD 云盘。

cloud_essd
Size

integer

否

单位 GB。

9999
PerformanceLevel

string

否

创建 ESSD 云盘作为系统盘使用时，设置云盘的性能等级。取值范围：

  • PL0：单盘最高随机读写 IOPS 1 万。

  • PL1：单盘最高随机读写 IOPS 5 万。

PL1
NodeGroupDescription

string

否

节点组描述

默认节点组
KeyPairName

string

否

密钥对名称。

test-keypair
FileSystemMountEnabled

boolean

否

是否支持文件系统挂载

false
NodeGroupName

string

否

节点组名称

emr-default
ZoneId

string

否

可用区 ID

cn-hangzhou-i
UserData

string

否

实例自定义数据。需要以 Base64 方式编码，原始数据最多为 16 KB。

ZWNobyBoZWxsbyBlY3Mh
VirtualGpuEnabled

boolean

否

是否开启 GPU 虚拟化切分

false
MachineType

string

否

机型

efg1.nvga1
ImageId

string

否

系统镜像 ID

i190297201634099844192
Nodes

array

否

节点列表

array<object>

否

节点列表

DataDisk

array

否

数据盘规格。

object

否

数据盘规格信息。

DeleteWithNode

boolean

否

数据盘是否随节点退订删除

true
Category

string

否

类型

cloud_essd
Size

integer

否

磁盘大小

10
PerformanceLevel

string

否

数据盘性能参数

PL0
VpcId

string

否

专有网络 ID

vpc-0jlasms92fdxqd3wlf8ny
VSwitchId

string

否

虚拟交换机 ID

vsw-bp169pi5fj151rrms4sia
NodeId

string

否

节点 ID

e01poc-cn-i7m2wnivf0d
Hostname

string

否

主机名

8d13b784-17a9-11ed-bc7b-acde48001122
LoginPassword

string

否

登录密码

***
HyperNodes

array

否

超节点列表。

array<object>

否

超节点信息。

DataDisk

array

否

数据盘列表。

object

否

数据盘信息。

DeleteWithNode

boolean

否

数据盘是否随节点退订删除

true
Category

string

否

磁盘类型。取值范围：

  • cloud_essd：ESSD 云盘。

cloud_essd
Size

integer

否

磁盘大小，单位 GiB。

180
PerformanceLevel

string

否

创建 ESSD 云盘作为数据盘使用时，设置云盘的性能等级。取值范围：

  • PL0：单盘最高随机读写 IOPS 1 万。

  • PL1：单盘最高随机读写 IOPS 5 万。

  • PL2：单盘最高随机读写 IOPS 10 万。

  • PL3：单盘最高随机读写 IOPS 100 万。

默认值：PL1。

PL0
VpcId

string

否

专有网络 ID

vpc-uf689skpx56nk7yfw0jhy
VSwitchId

string

否

专有网络交换机 ID

vsw-bp1xn9iq3s3p8218c4qu4
HyperNodeId

string

否

超节点 ID

e01-dw72u2c23jk
Hostname

string

否

主机名

q25b01265.cloud.ng152
LoginPassword

string

否

登录密码

aaadddddfdsfdsfsdffd
LoginPassword

string

否

登录密码

密码
IgnoreFailedNodeTasks

boolean

否

是否允许跳过失败节点，默认值为 False

False
ResourceGroupId

string

否

资源组 ID

rg-aek2xdkc6icwfha
Networks

object

否

网络信息

NewVpdInfo

object

否

Vpd 配置信息

CenId

string

否

云企业网 ID

cen-1gb1eftc5qp2ao75fo
CloudLinkCidr

string

否

云链 cidr

172.16.0.0/24
CloudLinkId

string

否

云链 ID

vcc-cn-c4dtycm5i08
MonitorVpcId

string

否

专有网络

vpc-0jl2x45apm6odc2c10h25
MonitorVswitchId

string

否

专有网络交换机

vsw-0jl2w3ffbghkss0x2foff
VpdCidr

string

否

集群网段

192.168.0.0/16
VpdSubnets

array

否

集群子网

object

否

集群子网

SubnetCidr

string

否

子网 cidr

10.0.1.8/24
ZoneId

string

否

可用区 ID

cn-wulanchabu-b
SubnetType

string

否

子网类型

10.0.2.8/24
VpdInfo

object

否

复用 VPD 信息

VpdId

string

否

专有网络 ID

vpd-vfuz6ejv
VpdSubnets

array

否

集群子网 ID 列表

string

否

集群子网 ID

subnet-jcloe1
IpAllocationPolicy

array

否

IP 分配策略

array<object>

否

IP 分配策略

MachineTypePolicy

array

否

机型分配策略

array<object>

否

机型分配策略

Bonds

array

否

bond 信息

object

否

bond 信息

Subnet

string

否

IP 来源集群子网

192.168.1.0/24
Name

string

否

bond 名称

bond0
MachineType

string

否

机型

efg1.nvga8n
BondPolicy

object

否

bond 策略

Bonds

array

否

bond 信息

object

否

bond 信息

Subnet

string

否

IP 来源集群子网

172.16.0.0/24
Name

string

否

bond 名称

bond0
BondDefaultSubnet

string

否

默认 bond 集群子网

172.168.0.0/24
NodePolicy

array

否

节点分配策略

array<object>

否

节点分配策略

Bonds

array

否

bond 信息

object

否

bond 信息

Subnet

string

否

IP 来源集群子网

10.0.0.0/24
Name

string

否

bond 名称

bond0

NodeId

string

否

节点 ID

e01-cn-2r42vq62001
SecurityGroupId

string

否

安全组 ID

sg-bp1d3dvbh9by7j5rujax
VSwitchZoneId

string

否

交换机 ZoneID

cn-shanghai-b
VpcId

string

否

专有网络 ID

vpc-0jl36lqzmc06qogy0t5ll
VSwitchId

string

否

交换机 ID

vsw-asjdfklj
TailIpVersion

string

否

IP 版本

IPv4
Tag

array<object>

否

资源标签

object

否

标签列表

Value

string

否

值

dev
Key

string

否

键

env-name
Components

array<object>

否

组件（软件实例）

array<object>

否

组件类型

ComponentType

string

否

组件类型

枚举值：
  • ARMS :

    ARMS 监控

  • ACKEdge :

    ACK 边缘集群

ACKEdge
ComponentConfig

object

否

组件配置

BasicArgs

any

否

组件基础参数

{ "EndpointPublicAccess": false, "ContainerCidr": "10.4.0.0/24", "KeyPair": "test", "NodeCidrMask": "25", "ResourceGroupId": "rg-axsadm3sdzsdvdsndstdisd", "WorkerSystemDiskCategory": "da", "WorkerSystemDiskSize": 40, "DeletionProtection": false, "KubeProxy": "iptables", "Name": "da", "LoadBalancerSpec": "slb.s1.small", "Runtime": { "Version": "19.03.15", "Name": "docker" }, "IsEnterpriseSecurityGroup": true, "Vpcid": "192.168.23.0/24", "NumOfNodes": 1, "VswitchIds": [ "dad" ], "ServiceCidr": "10.0.0.0/16", "SnatEntry": false, "kubernetesVersion": "1.20.11-aliyunedge.1", "WorkerInstanceTypes": [ "da" ] }
NodeUnits

array

否

节点池配置， 并用于建立节点组和节点池的对应关系。 当 ComponentType=”ACKEdge“时必填，其他为空。

any

否

节点池配置， 并用于建立节点组和节点池的对应关系。 当 ComponentType=”ACKEdge“时必填，其他为空。

{ "Options": {}, "Type": "edge", "ResourceGroupId": "rg-acfm2cdxm3zvnt4dsa1s1t65fi", "RelatedNodeGroups": [ "tes" ], "NodeUnitKey": "da", "MaxNodes": 30 }
HpnZone

string

否

集群编号

A1
NimizVSwitches

array

否

Node 虚拟交换机

string

否

Node 虚拟交换机 ID

vsw-0jlx7dkziyhgf6klwnsi3
OpenEniJumboFrame

boolean

否

网络接口是否支持巨帧

false

返回参数

名称

类型

描述

示例值

object

响应体参数。

RequestId

string

请求 id

3C683243-7915-57FB-9570-A2932C1C0F78
ClusterId

string

集群 id

i116913051663373010974
TaskId

string

任务 id

i159809891662373011015

示例

正常返回示例

JSON格式

{
  "RequestId": "3C683243-7915-57FB-9570-A2932C1C0F78",
  "ClusterId": "i116913051663373010974",
  "TaskId": "i159809891662373011015"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。

上一篇：灵骏集群下一篇：DeleteCluster - 删除集群