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"
}