创建集群

调试

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

请求头

该接口使用公共请求头，无特殊请求头。请参见公共请求参数文档。

请求语法

POST /pop/v5/resource/cluster HTTPS|HTTP

请求参数

名称 类型 是否必选 示例值 描述
ClusterName String 是 jianwei_product_test2

集群名
ClusterType Integer 是 2

集群类型。1-Swarm 集群，2-ECS 集群，3-Kubernetes 集群
NetworkMode Integer 是 2

网络类型。1-经典网络，2-VPC
LogicalRegionId String 否 cn-beijing:tdy218

自定义命名空间的RegionId （格式：物理 Region:自定义命名空间标识符）
VpcId String 否 vpc-2zef6ob8mrlzv8x3q46kp

VPC 网络 ID。若选择 VPC 网络，此参数必选
OversoldFactor Integer 否 2

Docker集群CPU超卖：

  • 2代表1:2比例
  • 4代表1:4比例
  • 8代表1:8比例

返回数据

名称 类型 示例值 描述
Cluster Struct

创建的集群实体
ClusterId String 8705ad13-5d86-47fc-b68f-257b59edef93

集群 ID
ClusterName String jianwei_product_test2

集群名称
ClusterType Integer 2

集群类型。1-Swarm 集群，2-ECS 集群，3-Kubernetes 集群
IaasProvider String ALIYUN

提供商
NetworkMode Integer 2

网络类型。1-经典网络，2-VPC
OversoldFactor Integer 1

Docker 集群 CPU 超卖。支持 2 (1:2) / 4 (1:4) / 8 (1:8)
RegionId String cn-beijing

逻辑可用区 ID
VpcId String vpc-2zef6ob8mrlzv8x3q46kp

VPC 网络 ID
Code Integer 200

code 码
Message String success

信息
RequestId String b197-40ab-9155-7ca7

唯一请求ID

示例

请求示例

POST /pop/v5/resource/cluster HTTP/1.1
公共请求头
{
  "ClusterName": "jianwei_product_test2"
  "ClusterType": 2
  "NetworkMode": 2
}

正常返回示例

XML 格式 

<Message>success</Message>
<Cluster>
    <OversoldFactor>1</OversoldFactor>
    <ClusterName>jianwei_product_test2</ClusterName>
    <ClusterId>8705ad13-5d86-47fc-b68f-257b59edef93</ClusterId>
    <NetworkMode>2</NetworkMode>
    <RegionId>cn-beijing</RegionId>
    <ClusterType>2</ClusterType>
    <IaasProvider>ALIYUN</IaasProvider>
    <VpcId>vpc-2zef6ob8mrlzv8x3q46kp</VpcId>
</Cluster>
<Code>200</Code>

JSON 格式 

{
	"Message": "success",
	"Cluster": {
		"OversoldFactor": 1,
		"ClusterName": "jianwei_product_test2",
		"ClusterId": "8705ad13-5d86-47fc-b68f-257b59edef93",
		"NetworkMode": 2,
		"RegionId": "cn-beijing",
		"ClusterType": 2,
		"IaasProvider": "ALIYUN",
		"VpcId": "vpc-2zef6ob8mrlzv8x3q46kp"
	},
	"Code": 200
}

错误码

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