备案控制台
文档
产品文档
输入文档关键字查找
首页 人工智能平台 PAI 操作指南 API参考 灵骏集群API参考（单租） API目录 灵骏集群 CreateCluster - 创建集群

CreateCluster - 创建集群

更新时间：
一键部署
产品详情
相关技术圈
我的收藏

创建一个新的灵骏集群。

调试

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

授权信息

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

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用背景高亮的方式表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
eflo:CreateClusterWrite
  • Cluster
    acs:eflo:{#regionId}:{#accountId}:cluster/*
    无
无

请求参数

名称类型必填描述示例值
ClusterNamestring否

集群名称

Standard_Cluster
ClusterTypestring否

集群类型

Lite
ClusterDescriptionstring否

集群描述

标准集群测试
NodeGroupsobject []否

节点组列表

Nodesobject []否

节点列表

NodeIdstring否

节点 id

e01poc-cn-i7m2wnivf0d
Hostnamestring否

主机名

8d13b784-17a9-11ed-bc7b-acde48001122
LoginPasswordstring否

登录密码

***
VSwitchIdstring否

虚拟交换机 ID。

vsw-bp169pi5fj151rrms4sia
VpcIdstring否

专有网络 ID

vpc-0jlasms92fdxqd3wlf8ny
NodeGroupNamestring否

节点组名称

emr-default
NodeGroupDescriptionstring否

节点组描述

默认节点组
MachineTypestring否

机型

efg1.nvga1
ImageIdstring否

系统镜像 id

i190297201634099844192
ZoneIdstring否

可用区 id

cn-hangzhou-i
UserDatastring否

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

ZWNobyBoZWxsbyBlY3Mh
IgnoreFailedNodeTasksboolean否

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

False
ResourceGroupIdstring否

资源组 id

rg-aek2xdkc6icwfha
Networksobject否

网络信息

NewVpdInfoobject否

Vpd 配置信息

CenIdstring否

云企业网 id

cen-1gb1eftc5qp2ao75fo
CloudLinkCidrstring否

云链 cidr

172.16.0.0/24
CloudLinkIdstring否

云链 id

vcc-cn-c4dtycm5i08
MonitorVpcIdstring否

专有网络

vpc-0jl2x45apm6odc2c10h25
MonitorVswitchIdstring否

专有网络交换机

vsw-0jl2w3ffbghkss0x2foff
VpdCidrstring否

集群网段

192.168.0.0/16
VpdSubnetsobject []否

集群子网

SubnetCidrstring否

子网 cidr

10.0.1.8/24
SubnetTypestring否

子网类型

10.0.2.8/24
ZoneIdstring否

可用区 id

cn-wulanchabu-b
VpdInfoobject否

复用 VPD 信息

VpdIdstring否

专有网络 id

vpd-vfuz6ejv
VpdSubnetsarray否

集群子网 id 列表

string否

集群子网 id

subnet-jcloe1
IpAllocationPolicyobject []否

IP 分配策略

BondPolicyobject否

bond 策略

BondDefaultSubnetstring否

默认 bond 集群子网

172.168.0.0/24
Bondsobject []否

bond 信息

Namestring否

bond 名称

bond0
Subnetstring否

ip 来源集群子网

172.16.0.0/24
MachineTypePolicyobject []否

机型分配策略

Bondsobject []否

bond 信息

Namestring否

bond 名称

bond0
Subnetstring否

ip 来源集群子网

192.168.1.0/24
MachineTypestring否

机型

efg1.nvga8n
NodePolicyobject []否

节点分配策略

Bondsobject []否

bond 信息

Namestring否

bond 名称

bond0
Subnetstring否

ip 来源集群子网

10.0.0.0/24
NodeIdstring否

节点 id

e01-cn-2r42vq62001
Tagobject []否

资源标签

Keystring否

键

env-name
Valuestring否

值

dev
Componentsobject []否

组件（软件实例）

ComponentTypestring否

组件类型

枚举值：
  • ARMS：ARMS监控。
  • ACKEdge：ACK边缘集群。
ACKEdge
ComponentConfigobject否

组件配置

BasicArgsany否

组件基础参数

{ "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" ] }
NodeUnitsarray否

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

any否

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

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

集群编号

A1
NimizVSwitchesarray否

Node 虚拟交换机

string否

Node 虚拟交换机 id

vsw-0jlx7dkziyhgf6klwnsi3

返回参数

名称类型描述示例值
object
RequestIdstring

请求 id

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

集群 id

i116913051663373010974
TaskIdstring

任务 id

i159809891662373011015

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

变更时间变更内容概要操作
2024-01-10API 内部配置变更，不影响调用看变更集
变更项变更内容
API 内部配置变更，不影响调用。
2023-10-26API 内部配置变更，不影响调用看变更集
变更项变更内容
API 内部配置变更，不影响调用。
2023-09-21OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更。
    新增入参：HpnZone
    新增入参：NimizVSwitches
2023-08-20API 内部配置变更，不影响调用看变更集
变更项变更内容
API 内部配置变更，不影响调用。
2023-08-15API 内部配置变更，不影响调用看变更集
变更项变更内容
API 内部配置变更，不影响调用。
2023-03-21API 内部配置变更，不影响调用看变更集
变更项变更内容
API 内部配置变更，不影响调用。
文档推荐
  • 本页导读 （1）
文档反馈