更新时间:2026-09-30 GMT+08:00

创建分区

功能介绍

创建分区

调用方法

请参见如何调用API。

URI

POST /api/v3/projects/{project_id}/clusters/{cluster_id}/partitions

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,获取方式请参见如何获取接口URI中参数。

约束限制:

不涉及

取值范围:

账号的项目ID

默认取值:

不涉及

cluster_id

是

String

参数解释:

集群ID,获取方式请参见如何获取接口URI中参数。

约束限制:

不涉及

取值范围:

集群ID

默认取值:

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

kind

否

String

参数解释:

API类型

约束限制:

固定值,不允许修改

取值范围:

不涉及

默认取值:

Partition

apiVersion

否

String

参数解释:

API版本

约束限制:

固定值,不允许修改

取值范围:

不涉及

默认取值:

v3

metadata

否

metadata object

参数解释:

分区的元数据信息

约束限制:

不涉及

spec

否

spec object

参数解释:

分区的配置信息

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 metadata

参数

是否必选

参数类型

描述

name

否

String

参数解释:

分区名称

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表4 spec

参数

是否必选

参数类型

描述

hostNetwork

否

hostNetwork object

参数解释:

分区子网

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

containerNetwork

否

Array of containerNetwork objects

参数解释:

分区容器子网

约束限制:

列表长度不能大于20

取值范围:

不涉及

默认取值:

不涉及

publicBorderGroup

否

String

参数解释:

群组,IES边缘场景为可用区ID,中心区统一为“center”。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

category

否

String

参数解释:

可用区分类

约束限制:

不涉及

取值范围:

  • Default: 中心云可用区

  • IES: 专属云可用区

  • HomeZone: 智能边缘云可用区

默认取值:

不涉及

表5 hostNetwork

参数

是否必选

参数类型

描述

subnetID

否

String

参数解释:

子网ID

获取方法如下:

  • 方法1:登录虚拟私有云服务的控制台界面,单击VPC下的子网,进入子网详情页面,查找IPv4子网ID。

  • 方法2:通过虚拟私有云服务的查询子网列表接口查询。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表6 containerNetwork

参数

是否必选

参数类型

描述

subnetID

否

String

参数解释:

子网ID

获取方法如下:

  • 方法1:登录虚拟私有云服务的控制台界面,单击VPC下的子网,进入子网详情页面,查找IPv4子网ID。

  • 方法2:通过虚拟私有云服务的查询子网列表接口查询。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表7 响应Body参数

参数

参数类型

描述

kind

String

参数解释:

API类型

取值范围:

不涉及

apiVersion

String

参数解释:

API版本

取值范围:

不涉及

metadata

metadata object

参数解释:

分区的元数据信息

spec

spec object

参数解释:

分区的配置信息

取值范围:

不涉及

表8 metadata

参数

参数类型

描述

name

String

参数解释:

分区名称

取值范围:

不涉及

creationTimestamp

String

参数解释:

创建时间

取值范围:

不涉及

表9 spec

参数

参数类型

描述

hostNetwork

hostNetwork object

参数解释:

分区子网

取值范围:

不涉及

containerNetwork

Array of containerNetwork objects

参数解释:

分区容器子网

取值范围:

不涉及

publicBorderGroup

String

参数解释:

群组,IES边缘场景为可用区ID,中心区统一为“center”。

取值范围:

不涉及

category

String

参数解释:

可用区分类

取值范围:

  • Default: 中心云可用区

  • IES: 专属云可用区

  • HomeZone: 智能边缘云可用区

表10 hostNetwork

参数

参数类型

描述

subnetID

String

参数解释:

子网ID

取值范围:

不涉及

表11 containerNetwork

参数

参数类型

描述

subnetID

String

参数解释:

子网ID

取值范围:

不涉及

请求示例

POST /api/v3/projects/{project_id}/clusters/{cluster_id}/partitions

{
  "kind" : "Partition",
  "apiVersion" : "v3",
  "metadata" : {
    "name" : "partitionName"
  },
  "spec" : {
    "hostNetwork" : {
      "subnetID" : "subnetID"
    },
    "containerNetwork" : [ {
      "subnetID" : "subnetID"
    } ],
    "publicBorderGroup" : "publicBorderGroup",
    "category" : "Default"
  }
}

响应示例

状态码:200

OK

{
  "kind" : "Partition",
  "apiVersion" : "v3",
  "metadata" : {
    "name" : "partitionName",
    "creationTimestamp" : "2000-1-1 00:00:35.451967 +0000 UTC"
  },
  "spec" : {
    "hostNetwork" : {
      "subnetID" : "subnetID"
    },
    "containerNetwork" : [ {
      "subnetID" : "subnetID"
    } ],
    "publicBorderGroup" : "publicBorderGroup",
    "category" : "Default"
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。