创建边缘集群
功能介绍
应用服务器可调用此接口为创建边缘集群。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
cluster_name |
是 |
String |
集群名称 最小长度:4 最大长度:32 |
description |
否 |
String |
集群描述 最小长度:0 最大长度:1024 |
cluster_node_config |
否 |
ClusterNodeConfig object |
集群节点配置 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
master_node_vip |
否 |
String |
master虚拟ip 最小长度:1 最大长度:64 |
master_nodes |
否 |
Array of NodeConfig objects |
master节点数 |
work_nodes |
否 |
Array of NodeConfig objects |
work节点数 |
响应参数
状态码: 201
参数 |
参数类型 |
描述 |
---|---|---|
cluster_id |
String |
集群ID |
cluster_name |
String |
集群名称 最小长度:4 最大长度:32 |
description |
String |
集群描述 |
version |
String |
边缘集群版本 |
state |
String |
边缘集群状态 |
create_time |
String |
创建时间 最小长度:0 最大长度:256 |
update_time |
String |
最后一次修改时间 最小长度:0 最大长度:256 |
is_upgradeable |
Boolean |
是否可升级 |
请求示例
GET https://{endpoint}/v3/{project_id}/clusters { "cluster_name" : "test-cluster", "description" : "this is a test cluster", "cluster_node_config" : { "master_node_vip" : "string", "master_nodes" : [ { "node_ip" : "string", "node_name" : "string" } ], "work_nodes" : [ { "node_ip" : "string", "node_name" : "string" } ] } }
响应示例
状态码: 201
Created
{ "cluster_id" : "123343534", "cluster_name" : "test-cluster", "description" : "this is a test cluster", "version" : "string", "state" : "string", "create_time" : "string", "update_time" : "string", "is_upgradeable" : true }
状态码
状态码 |
描述 |
---|---|
201 |
Created |
400 |
BAD REQUEST |
401 |
Unauthorized |
403 |
FORBIDDEN |
500 |
Internal Server Error |
错误码
请参见错误码。