创建集群

1. 接口描述

接口请求域名： tke.tencentcloudapi.com 。

创建集群

默认接口请求频率限制：20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 示例

示例1 创建托管集群示例

创建托管集群

输入示例

POST / HTTP/1.1
Host: tke.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateCluster
<公共请求参数>

{
    "ClusterType": "MANAGED_CLUSTER",
    "ClusterBasicSettings": {
        "ClusterOs": "centos8.0x86_64",
        "OsCustomizeType": "GENERAL",
        "ClusterVersion": "1.26.1",
        "ClusterName": "test",
        "ClusterDescription": "测试集群",
        "VpcId": "vpc-135qxjgs",
        "ProjectId": 0,
        "NeedWorkSecurityGroup": false,
        "TagSpecification": [
            {
                "ResourceType": "cluster",
                "Tags": [
                    {
                        "Key": "aa",
                        "Value": "cc"
                    }
                ]
            }
        ],
        "ClusterLevel": "L5",
        "AutoUpgradeClusterLevel": {
            "IsAutoUpgrade": true
        }
    },
    "ClusterCIDRSettings": {
        "ClusterCIDR": "172.24.0.0/16",
        "IgnoreClusterCIDRConflict": false,
        "MaxNodePodNum": 64,
        "MaxClusterServiceNum": 1024
    },
    "ClusterAdvancedSettings": {
        "AsEnabled": false,
        "IPVS": true,
        "ContainerRuntime": "containerd",
        "RuntimeVersion": "1.6.9",
        "NodeNameType": "lan-ip",
        "ExtraArgs": {
            "KubeAPIServer": [],
            "KubeControllerManager": [],
            "KubeScheduler": []
        },
        "NetworkType": "GR",
        "DeletionProtection": true,
        "AuditEnabled": true,
        "AuditLogsetId": "",
        "AuditLogTopicId": "",
        "EnableCustomizedPodCIDR": false,
        "IsDualStack": false,
        "QGPUShareEnable": true
    },
    "InstanceAdvancedSettings": {
        "DataDisks": [],
        "DockerGraphPath": "/var/lib/containerd",
        "Unschedulable": 0,
        "PreStartUserScript": "",
        "UserScript": "",
        "Labels": [],
        "Taints": [],
        "GPUArgs": {},
        "DesiredPodNumber": 0
    },
    "ExtensionAddons": [
        {
            "AddonName": "CBS",
            "AddonParam": "{\"kind\":\"App\",\"spec\":{\"chart\":{\"chartName\":\"cbs\",\"chartVersion\":\"1.1.3\"},\"values\":{\"values\":[],\"rawValues\":\"e30=\",\"rawValuesType\":\"json\"}}}"
        },
        {
            "AddonName": "APP",
            "AddonParam": "{\"kind\":\"App\",\"spec\":{\"chart\":{\"chartName\":\"user-group-access-control\",\"chartVersion\":\"1.0.0\"}}}"
        },
        {
            "AddonName": "QGPU",
            "AddonParam": "{\"kind\":\"App\",\"spec\":{\"chart\":{\"chartName\":\"qgpu\",\"chartVersion\":\"1.0.19\"},\"values\":{\"values\":[\"config.priority=binpack\",\"config.nodepriority=spread\",\"config.rootdir=/var/lib/kubelet\"]}}}"
        },
        {
            "AddonName": "KMS",
            "AddonParam": "{\"kind\":\"App\",\"spec\":{\"chart\":{\"chartName\":\"tke-kms-plugin\",\"chartVersion\":\"1.0.0\"},\"name\":\"tke-kms-plugin\",\"values\":{\"values\":[\"keyId=7d90e454-8458-11ee-b601-525400741137\",\"region=ap-guangzhou\",\"resource=secrets\"]}}}"
        }
    ],
    "RunInstancesForNode": [
        {
            "NodeRole": "WORKER",
            "RunInstancesPara": [
                "{\"Version\":\"2017-03-12\",\"InstanceChargeType\":\"POSTPAID_BY_HOUR\",\"Placement\":{\"Zone\":\"ap-shanghai-1\",\"ProjectId\":0},\"TagSpecification\":[{\"ResourceType\":\"instance\",\"Tags\":[{\"Key\":\"aa\",\"Value\":\"cc\"}]}],\"InstanceType\":\"S2.MEDIUM2\",\"ImageId\":\"img-25szkc8t\",\"SystemDisk\":{\"DiskType\":\"CLOUD_BSSD\",\"DiskSize\":50},\"VirtualPrivateCloud\":{\"VpcId\":\"vpc-135qxjgs\",\"SubnetId\":\"subnet-rtp4p7q3\",\"Ipv6AddressCount\":0},\"InternetAccessible\":{\"InternetChargeType\":\"TRAFFIC_POSTPAID_BY_HOUR\",\"InternetMaxBandwidthOut\":1,\"PublicIpAssigned\":true},\"InstanceCount\":1,\"InstanceName\":\"\",\"LoginSettings\":{\"KeyIds\":[\"skey-4h43fuxj\"]},\"SecurityGroupIds\":[\"sg-hjsb4ai4\"],\"EnhancedService\":{\"SecurityService\":{\"Enabled\":true},\"MonitorService\":{\"Enabled\":true}},\"PurchaseSource\":\"docker_dashboard\",\"UserData\":\"\"}"
            ],
            "InstanceAdvancedSettingsOverrides": [
                {
                    "DataDisks": [],
                    "MountTarget": "",
                    "DockerGraphPath": "/var/lib/containerd",
                    "Unschedulable": 0,
                    "PreStartUserScript": "",
                    "UserScript": "",
                    "DesiredPodNumber": 0,
                    "Labels": [],
                    "Taints": [],
                    "ExtraArgs": {
                        "Kubelet": []
                    },
                    "GPUArgs": {
                        "MIGEnable": false,
                        "Driver": {
                            "Version": "",
                            "Name": ""
                        },
                        "CUDA": {
                            "Version": "",
                            "Name": ""
                        },
                        "CUDNN": {
                            "Version": "",
                            "Name": "",
                            "DocName": "",
                            "DevName": ""
                        }
                    }
                }
            ]
        }
    ],
    "InstanceDataDiskMountSettings": []
}

输出示例

{
    "Response": {
        "ClusterId": "cls-7ph3twqe",
        "RequestId": "eac6b301-a322-493a-8e36-83b295459397"
    }
}

示例2 创建独立集群示例

创建独立集群

输入示例

POST / HTTP/1.1
Host: tke.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateCluster
<公共请求参数>

{
    "ClusterCIDRSettings": {
        "ClusterCIDR": "10.4.0.0/14"
    },
    "ExtensionAddons": [
        {
            "AddonName": "GameApp",
            "AddonParam": "{\"kind\":\"GameApp\",\"apiVersion\":\"platform.tke/v1\",\"metadata\":{\"generateName\":\"ga\"},\"spec\":{\"clusterName\":\"xxx\"}}"
        }
    ],
    "ClusterType": "INDEPENDENT_CLUSTER",
    "RunInstancesForNode": [
        {
            "NodeRole": "WORKER",
            "RunInstancesPara": [
                "{\"VirtualPrivateCloud\":{\"SubnetId\":\"subnet-xxx\",\"VpcId\":\"vpc-xxx\"},\"Placement\":{\"Zone\":\"ap-region-1\",\"ProjectId\":1032509},\"InstanceType\":\"S3.LARGE8\",\"SystemDisk\":{\"DiskType\":\"CLOUD_PREMIUM\"},\"DataDisks\":[{\"DiskType\":\"CLOUD_PREMIUM\",\"DiskSize\":50}],\"InstanceCount\":1,\"InternetAccessible\":{\"PublicIpAssigned\":true,\"InternetMaxBandwidthOut\":1},\"LoginSettings\":{\"Password\":\"YourPassword\"},\"UserData\":\"IyEvYmluL3NoCgplY2hvIGFhYQo=\"}"
            ]
        },
        {
            "NodeRole": "MASTER_ETCD",
            "RunInstancesPara": [
                "{\"VirtualPrivateCloud\":{\"SubnetId\":\"subnet-xxx\",\"VpcId\":\"vpc-xxx\"},\"Placement\":{\"Zone\":\"ap-region-1\",\"ProjectId\":1032509},\"InstanceType\":\"S3.LARGE8\",\"SystemDisk\":{\"DiskType\":\"CLOUD_PREMIUM\"},\"DataDisks\":[{\"DiskType\":\"CLOUD_PREMIUM\",\"DiskSize\":50}],\"InstanceCount\":3,\"InternetAccessible\":{\"PublicIpAssigned\":true,\"InternetMaxBandwidthOut\":1},\"LoginSettings\":{\"Password\":\"YourPassword\"},\"UserData\":\"IyEvYmluL3NoCgplY2hvIGFhYQo=\"}"
            ]
        }
    ]
}

输出示例

{
    "Response": {
        "ClusterId": "cls-xxx",
        "RequestId": "eac6b301-a322-493a-8e36-83b295459397"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
• Tencent Cloud SDK 3.0 for C++: GitHub Gitee
• Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。