调用InsertCluster接口创建集群。

调试

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

请求头

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

请求语法

POST /pop/v5/resource/cluster HTTP/1.1

请求参数

名称 类型 位置 是否必选 示例值 描述
ClusterName String Query 是 ****_product_test2

集群名。
ClusterType Integer Query 是 2

集群类型。

  • 2：ECS集群
  • 3：EDAS自带K8s集群
  • 5：Kubernetes集群
NetworkMode Integer Query 是 2

网络类型。

  • 1：经典网络
  • 2：VPC
LogicalRegionId String Query 否 cn-beijing:td****

自定义命名空间的RegionId。

格式为：物理Region:自定义命名空间标识符，例如cn-hangzhou:test。

VpcId String Query 否 vpc-2zef6ob8mrlzv8x3q****

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

（参数已不适用）

Docker集群CPU超卖：

  • 2：1:2比例
  • 4：1:4比例
  • 8：1:8比例
IaasProvider String Query 否 ALIYUN

IaaS资源供应商。

<note>选择阿里云时，需要使用全大写的拼音，例如ALIYUN。</note>

返回数据

名称 类型 示例值 描述
Cluster Struct

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

集群ID。
ClusterName String ****_product_test2

集群名称。
ClusterType Integer 2

集群类型。

  • 2：ECS集群。
  • 3：EDAS自带K8s集群。
  • 5：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

集群所属地域。
VpcId String vpc-2zef6ob8mrlzv8x3q****

VPC网络ID。
Code Integer 200

接口状态。
Message String success

附加信息。
RequestId String b197-40ab-9155-****

请求ID。

示例

请求示例

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

正常返回示例

XML格式 

<InsertClusterResponse>
  <Message>success</Message>
  <RequestId>b197-40ab-9155-****</RequestId>
  <Cluster>
        <OversoldFactor>1</OversoldFactor>
        <VpcId>vpc-2zef6ob8mrlzv8x3q****</VpcId>
        <ClusterId>8705ad13-5d86-47fc-b68f-257b59ed****</ClusterId>
        <ClusterName>****_product_test2</ClusterName>
        <RegionId>cn-beijing</RegionId>
        <ClusterType>2</ClusterType>
        <NetworkMode>2</NetworkMode>
        <IaasProvider>ALIYUN</IaasProvider>
  </Cluster>
  <Code>200</Code>
</InsertClusterResponse>

JSON格式 

{
    "Message": "success",
    "RequestId": "b197-40ab-9155-****",
    "Cluster": {
        "OversoldFactor": 1,
        "VpcId": "vpc-2zef6ob8mrlzv8x3q****",
        "ClusterId": "8705ad13-5d86-47fc-b68f-257b59ed****",
        "ClusterName": "****_product_test2",
        "RegionId": "cn-beijing",
        "ClusterType": 2,
        "NetworkMode": 2,
        "IaasProvider": "ALIYUN"
    },
    "Code": 200
}

错误码

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