本接口用于创建边缘集群。

使用说明

此接口为异步接口，当此接口返回成功时，会返回集群的 ID 信息，此时不代表集群最终能够成功创建，需要您调用获取集群列表及详情接口以获取该集群当前的状态，查看集群是否创建成功。集群创建成功后，状态为{Running, [Ok]}。有关状态说明，请参见资源状态说明。

请求说明

• 请求方式：POST
• 请求地址：https://veecp.volcengineapi.com/?Action=CreateCluster&Version=2022-05-12

请求参数

下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。 其他公共参数，请参见公共参数。

请求示例

• 创建 Flannel 网络模型集群

POST /?Action=CreateCluster&Version=2022-05-12 HTTP/1.1
Content-Type:application/json
{
    "Name": "flannel-test", 
    "Description": "",
    "Profile": "Edge",
    "DeleteProtectionEnabled": false,
    "ClusterConfig": {
        "SubnetIds": ["subnet-3rf6vwbgkg9og5zsk2if****"],
        "ApiServerPublicAccessEnabled": true,
        "ApiServerPublicAccessConfig": {
          "PublicAccessNetworkConfig": {
            "Bandwidth": 10,
            "BillingType": 3
          }
    },
    "PodsConfig": {
        "PodNetworkMode": "Flannel",
        "FlannelConfig": {
            "MaxPodsPerNode": 32,
            "PodCidrs": ["172.17.31.0/19"]
        }
    },
    "ServicesConfig": {
        "ServiceCidrsv4": ["172.25.0.0/17"]
    },
    "Tags":[
        {
            "Key":"key",
            "Value":"value"
        }
    ],
    "KubernetesVersion": "1.20",
    "LoggingConfig": {
        "LogSetups": [
            {
                "LogType": "Audit",
                "LogTtl": 30,
                "Enabled": true
            }
        ]
    }
}

• 创建 VPC-CNI 网络模型集群

POST /?Action=CreateCluster&Version=2022-05-12 HTTP/1.1
Content-Type:application/json
{
    "Name": "vpc-cni-test", # 创建 VpcCni 集群
    "Description": "xxxx",
    "DeleteProtectionEnabled": false,
    "ClusterConfig": {
        "SubnetIds": ["subnet-3rf6vwbgkg9og5zsk2if****"],
        "ApiServerPublicAccessEnabled": true,
        "ResourcePublicAccessDefaultEnabled": true
    },
    "PodsConfig": {
        "PodNetworkMode": "VpcCniShared",
        "VpcCniConfig": {
            "SubnetIds": ["subnet-2d6tcun83e96o58ozfddc****"]
        }
    },
    "ServicesConfig": {
        "ServiceCidrsv4": ["172.17.*.*/21"]
    },
    "KubernetesVersion": "1.20"
}

返回参数

返回示例

HTTP/1.1 200 OK
Content-Type:application/json
{
    "ResponseMetadata": {
        "RequestId": "021635330810134****",
        "Action": "CreateCluster",
        "Version": "2022-05-12",
        "Service": "veecp_openapi",
        "Region": "cn-beijing"
    },
    "Result": {
        "Id": "nc5t5epmrsf****"
    }
}

错误码

本接口错误码如下表所示，其他错误码请参见错误码。