Swarm API参考 集群API列表 创建集群实例
创建一个新的集群实例，并新建指定数量的节点。
请求信息
请求行 RequestLine
POST /clusters HTTP/1.1
请求行参数 URI Param
无
特有请求头 RequestHead
无，请参考 公共请求头部。
请求体 RequestBody
{
"password": "ECS实例root登录密码",
"region_id": "RegionID",
"instance_type": "实例规格",
"name": "集群名称",
"size": "节点数",
"network_mode": "vpc",
"vpc_id": "VPC_ID",
"vswitch_id": "交换机ID",
"subnet_cidr": "容器网段，如172.28.1.0/24",
"data_disk_category": "系统盘类型",
"data_disk_size": "系统盘大小",
"need_slb": "是否需要创建集群的负载均衡",
"ecs_image_id": "操作系统镜像",
"io_optimized": "是否IO优化",
"release_eip_flag": "是否需要在集群配置完成后释放EIP"
"rds_instances": "RDS 实例 ID"
}
请求体解释
VPC 网络 ID。只有网络模式为 vpc 的时候，才需要设置该字段。更多详细信息，参见 VPC 网络介绍。
ECS 使用的磁盘类型。更多详细信息，参见 磁盘种类表。
ecs_image_id 列表
请参考文档 查看镜像列表 获取 ecs_image_id 列表。如果您需要自定义集群的 ECS 镜像的 ID，需要保证 ECS 镜像满足以下条件：
- 操作系统：Ubuntu、CentOS。
- Linux Kernel version ≥ 3.18，用于支持 overlayfs 以及 overlay network。
- 镜像中删除 /etc/docker/key.json 文件。
返回信息
返回行 ResponseLineHTT P/1.1 202 Accepted
特有返回头 ResponseHead
无，请参考 公共返回头部。
返回体 ResponseBody{"cluster_id": "string","request_id": "string","task_id": "string"}
示例
请求示例
POST /clusters HTTP/1.1
<公共请求头>
{
"password": "TestPwd124",
"region_id": "cn-beijing",
"instance_type": "ecs.n1.small",
"name": "my-test-cluster",
"size": 1,
"network_mode": "vpc",
"vpc_id":"vpc-xxxx",
"vswitch_id":"vsw-xxxx",
"subnet_cidr":"172.28.1.0/24",
"data_disk_category": "cloud_ssd",
"data_disk_size": 40,
"need_slb":true,
"ecs_image_id":"centos_7_04_64_20G_alibase_201701015",
"io_optimized":"true",
"release_eip_flag":false
}返回示例
HTTP/1.1 202 Accepted
<公共响应头>
{
"cluster_id": "cb95aa626a47740afbf6aa099b650d7ce",
"request_id": "687C5BAA-D103-4993-884B-C35E4314A1E1",
"task_id": "T-5a54309c80282e39ea00002f"
}
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
