CreateNodePool

在指定集群下创建节点池。

使用说明

• 调用该接口前，请调用 ListSupportedResourceTypes 接口，确认创建节点池时需要用到的资源是否在指定的地域和可用区中支持。
• 此接口为异步接口，当此接口返回成功时，会返回节点池的 ID 信息，此时节点池将进入{Creating, [Progressing]}状态，直到创建执行成功。请调用 ListNodePools 接口获取该节点池当前的状态，查看节点池是否创建成功。

请求参数

调用该 API 时的请求参数如下，除此之外还需传入公共请求参数。公共请求参数说明，请参见 公共参数。

NodePoolNodeConfigRequest

NodeSecurityRequest

镜像 ID 配置说明

容器服务提供如下两种镜像。不同的镜像类型对应的镜像 ID 也不同。

• 公共镜像：火山引擎提供的 veLinux 公共镜像。容器服务提供 veLinux-VKE、veLinux-CentOS 兼容版-VKE 两种公共镜像。两种镜像对应的 ImageId（镜像 ID）如下表所示。

  注意

  • GPU 计算型、高性能计算 GPU 型、弹性裸金属型计算规格，暂不支持 veLinux-CentOS 兼容版-VKE 镜像。
  • veLinux-CentOS 兼容版-VKE 镜像仅支持如下 Kubernetes 版本的集群：
    • Kubernetes 1.20：v1.20.15-vke.9 及以上容器服务发布的 Kubernetes 版本。
    • Kubernetes 1.24：v1.24.8-vke.4 及以上容器服务发布的 Kubernetes 版本。
  • 若您有 ECS 侧正在邀测的实例规格对应的节点，请联系您容器服务业务对接人员获取该规格对应的 ImageId。
  • 公共镜像相关说明，请参见 veLinux 镜像。

  • veLinux-VKE

    节点对应 ECS 规格	华北2（北京） cn-beijing	华南1（广州） cn-guangzhou	华东2（上海） cn-shanghai
    X86计算：所有规格（含三代规格）	image-ybqi99s7yq8rx7mnk44b	image-ybqd474ge1ftrj6h7ok7	image-ybps9zgztxb1wztomg99
    X86计算：仅三代规格 g3i、c3i、r3i、g3a、c3a	image-ycail7bf23gqeeusystc	image-yca0myo9fdea3cbh1y6d	image-yca8gonfuwhu0ro9qseu
    GPU计算型	image-38df7zgbm4f6kjew2l22	image-aa7rns5opf81q7sgq92z	image-ybm3s0f9zw5id84d13h1
    高性能计算GPU型：hpcpni2、hpcg1ve	image-ebgyezjjxndvetq13t0h	无	image-ybmasrxewp5id87x1h0f
    高性能计算GPU型：ebmhpcpni2l	image-ycfak9ym0fgqefhu23kc	无	image-ycf2tffg8hm05jqrdjbc
    弹性裸金属型	image-ybqiaa5f7g8rx7sk1xep	无	image-ybpsave0h6b1wzqzvuvt
    GPU渲染型	image-yc66t71jb7dymizw3cd5	无	image-ycaicq9i20dbkthjbbff

  • veLinux-CentOS 兼容版-VKE

    节点对应 ECS 规格	华北2（北京） cn-beijing	华南1（广州） cn-guangzhou	华东2（上海） cn-shanghai
    X86计算：所有规格（含三代规格）	image-ybxij852mqb6uow354vz	image-ybwv4jtl4tea3dva0lk7	image-ybx2w7yn63m05lag4c57
    X86计算：仅三代规格 g3i、c3i、r3i、g3a、c3a	image-ycail4e1tngqeelnh40v	image-yca0mv06x5ea3cc0dpnw	image-yca8glc0kahu0qtd6t4y
    GPU计算型	image-ycfajuqrj9gqefl5a9m5	image-ycescgzok4gfws3loi1n	image-ycf2smjwzpm05ka6f90a
    高性能计算GPU型：hpcpni2、hpcg1ve	image-ycfajuqrj9gqefl5a9m5	无	image-ycf2smjwzpm05ka6f90a
    高性能计算GPU型：ebmhpcpni2l	image-ycfakevlsvggefzppjzo	无	image-ycf2tffg8em05jn08kft
    弹性裸金属型	image-yc0gb64h8lfu05cav34f	无	image-yc8ho9ibypdbksuaeb9l

• 自定义镜像：【邀测·申请试用】容器服务支持自定义镜像作为节点操作系统。功能使用说明，请参见 自定义镜像说明。

请求示例

POST /?Action=CreateNodePool&Version=2022-05-12 HTTP/1.1
Content-Type:application/json
{
    "ClusterId": "cc5silumrsfeq****",
    "Name": "test-nodepool",
    "KubernetesConfig": {
        "Labels": [
            {
                "Key": "label-key",
                "Value": "label-value"
            }
        ],
        "Taints": [
            {
                "Key": "taint-key",
                "Value": "taint-value",
                "Effect": "NoSchedule"
            }
        ],
        "Cordon": false
    },
    "NodeConfig": {
        "InstanceTypeIds": ["ecs.g1.xlarge"],
        "SubnetIds": ["subnet-3rf6vwbgkg****"],
        "SystemVolume": {
            "Size": 40,
            "Type": "ESSD_PL0"
        },
        "DataVolumes": [
            {
                "Size": 20,
                "Type": "ESSD_PL0"
            }
        ],
        "AdditionalContainerStorageEnabled": true,
        "InitializeScript": "ZWNobyAidG******",
        "Security": {
            "SecurityGroupIds": ["sg-2byy13cnsczy****"],
            "SecurityStrategies": ["Hids"],
            "Login": {
                "Password": "UHdkMTIz***"
            }
        },
        "NamePrefix": "name-prefix",
        "Tags":[
            {
                "Key":"key",
                "Value":"value"
            }
        ]
    },
    "AutoScaling": {
        "Enabled": true,
        "DesiredReplicas": 0,
        "MinReplicas": 0,
        "MaxReplicas": 10,
        "Priority": 10,
        "SubnetPolicy": "ZoneBalance"
    },
    "Tags":[
        {
            "Key":"key",
            "Value":"value"
        }
    ],
    "ClientToken": "BC028527-33B9-4990-A633-84E9F9******",
}

返回参数

返回示例

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

错误码

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