552      阿里云

创建集群实例__集群API列表_API参考_容器服务-阿里云

描述

说明：创建一个新的集群实例，并新建指定数量的节点。

请求信息

请求行 RequestLine

POST /clusters HTTP/1.1

请求行参数 URI Param

无

特有请求头 RequestHead

无，请参考 公共请求头部。

请求体 RequestBody

ClusterCreation {
    "name": "string",
    "size": "number",
    "network_mode": "string",
    "subnet_cidr": "string",
    "instance_type": "string",
    "vpc_id": "string",
    "vswitch_id": "string",
    "password": "string",
    "data_disk_size": "number",
    "data_disk_category": "number"
    "ecs_image_id": "string",
    "io_optimized": "string",
}

请求体解释

ecs_image_id 列表

如果您需要自定义集群的 ECS 镜像的 ID，需要保证 ECS 镜像满足以下条件：

• 操作系统：Ubuntu、Centos。
• Linux Kernel version ≥ 3.18，用于支持 overlayfs 以及 overlay network。
• 镜像中删除 /etc/docker/key.json 文件。

返回信息

返回行 ResponseLine

HTTP/1.1 202 Accepted

特有返回头 ResponseHead

无，请参考 公共返回头部。

返回体 ResponseBody

{
    "cluster_id":"string",
    "request_id":"string"
}

示例

请求示例

POST /clusters HTTP/1.1
<公共请求头>
{
        "password": "Just$test",
        "instance_type": "ecs.s2.small",
        "name": "my-cluster-001",
        "size": 2,
        "network_mode": "classic",
        "data_disk_category": "cloud",
        "data_disk_size": 20,
        "charge_type": "PayByTraffic",
        "ecs_image_id":"m-xx251ll"
}

返回示例

HTTP/1.1 202 Accepted
<公共响应头>
{
    "cluster_id":"c01994faf5f364cc79b6ffb604061fa4a",
    "request_id":"b44afc3c-46a4-4087-a215-c333a1218316"
}