全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
容器服务

创建集群实例

更新时间:2017-10-21 10:22:34

描述

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

请求信息

请求行 RequestLine

  1. POST /clusters HTTP/1.1

请求行参数 URI Param

特有请求头 RequestHead

无,请参考 公共请求头部

请求体 RequestBody

  1. ClusterCreation {
  2. "name": "string",
  3. "size": "number",
  4. "network_mode": "string",
  5. "subnet_cidr": "string",
  6. "instance_type": "string",
  7. "vpc_id": "string",
  8. "vswitch_id": "string",
  9. "password": "string",
  10. "data_disk_size": "number",
  11. "data_disk_category": "number"
  12. "ecs_image_id": "string",
  13. "io_optimized": "string",
  14. }

请求体解释

名称 类型 必须 描述
name string 集群名称, 集群名称可以使用大小写英文字母、中文、数字、中划线。
size int 集群 ECS 节点数量。
instance_type string ECS 规格类型代码。更多详细信息,参见 实例规格族
network_mode string 集群网络模式(经典网络: classic、VPC 网络: vpc)。
subnet_cidr string 集群可以使用的网络地址块,例如:192.168.24.0/22。只有网络模式为 vpc 的时候,才需要设置该字段。
vpc_id string VPC 网络 ID。只有网络模式为 vpc 的时候,才需要设置该字段。更多详细信息,参见 VPC 网络介绍
vswitch_id string VPC 网络的交换机 ID。只有网络模式为 vpc 的时候,才需要设置该字段。
password string root 账号密码。
data_disk_category string ECS 使用的磁盘类型。更多详细信息,参见 磁盘种类表
data_disk_size number 节点共享磁盘大小。
ecs_image_id string 可选 ECS 使用的系统镜像 ID。
io_optimized string 可选 根据 ECS 实例规则来确定。取值为 none 或者 optimized。

ecs_image_id 列表

系统 ecs_image_id
Ubuntu 14.04 64 位 ubuntu_14_0405_64_40G_base_20170222.vhd
CentOS 7.0 64 位 centos_7_2_64_40G_base_20170222.vhd

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

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

返回信息

返回行 ResponseLine

  1. HTTP/1.1 202 Accepted

特有返回头 ResponseHead

无,请参考 公共返回头部

返回体 ResponseBody

  1. {
  2. "cluster_id":"string",
  3. "request_id":"string",
  4. "task_id":"string"
  5. }

示例

请求示例

  1. POST /clusters HTTP/1.1
  2. <公共请求头>
  3. {
  4. "password": "Just$test",
  5. "instance_type": "ecs.s2.small",
  6. "name": "my-cluster-001",
  7. "size": 2,
  8. "network_mode": "classic",
  9. "data_disk_category": "cloud",
  10. "data_disk_size": 20,
  11. "charge_type": "PayByTraffic",
  12. "ecs_image_id":"ubuntu_14_0405_64_40G_base_20170222.vhd"
  13. }

返回示例

  1. HTTP/1.1 202 Accepted
  2. <公共响应头>
  3. {
  4. "cluster_id":"c01994faf5f364cc79b6ffb604061fa4a",
  5. "request_id":"b44afc3c-46a4-4087-a215-c333a1218316",
  6. "task_id":"T-8277xsdfsdf"
  7. }
本文导读目录