功能介绍

为具有cs_adm角色的CS用户创建一个独享集群, 独享的集群会折算成SPU, 按需计费。

URI

• URI格式

  POST /v1.0/{project_id}/reserved_cluster

• 参数说明

  表1 URI参数说明

  名称	是否必选	说明
  project_id	是	项目编号。获取方法，请参见获取项目ID。

请求消息

创建一个新的独享集群, 请求参数为json格式。

• 请求样例

  {
    "name": "mycluster",
    "desc": "This is my cluster.",
    "maximum_spu_quota": 100,
    "vpc_cidr": "172.16.0.0/23",
    "subnet_cidr": "172.16.0.0/23",
    "subnet_gateway": "172.16.0.1"
  }

• 参数说明

  表2 请求参数说明

  参数名	是否必选	参数类型	说明
  name	是	String	集群名称。
  desc	否	String	集群描述。
  maximum_spu_quota	否	Int	集群最大SPU配额。
  vpc_cidr	否	String	集群VPC网段。
  subnet_cidr	否	String	集群子网网段。
  subnet_gateway	否	String	集群子网网关。
  tags	否	String	作业标签。
  sys_enterprise_project_id	否	String	作业所属的企业项目ID。
  manager_node_spu	否	String	集群管理节点spu规格。
  is_arm_arch	否	Boolean	集群cpu类型。

响应消息

• 响应样例

  {
    "message_id": "CS.21000",
    "message": "创建集群1000000成功",
    "payload": {
      "cluster_id": "1000000"
    },
    "current_time": 1550197806373
  }

• 参数说明

  表3 响应参数说明

  参数名	是否必选	参数类型	说明
  message_id	否	String	消息类型ID。
  message	否	String	消息内容。
  payload	否	无	独享集群信息。
  cluster_id	否	String	集群ID。
  current_time	否	Int	当前时间, 毫秒数。

状态码

状态码如表4所示。

错误码

请参见错误码。