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

获取分区列表

功能介绍

获取分区列表

调用方法

请参见如何调用API。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

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

约束限制:

不涉及

取值范围:

账号的项目ID

默认取值:

不涉及

cluster_id

是

String

参数解释:

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

约束限制:

不涉及

取值范围:

集群ID

默认取值:

不涉及

请求参数

无

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

kind

String

参数解释:

API类型

取值范围:

不涉及

apiVersion

String

参数解释:

API版本

取值范围:

不涉及

items

Array of Partition objects

参数解释:

集群分区信息

表3 Partition

参数

参数类型

描述

kind

String

参数解释:

API类型

取值范围:

不涉及

apiVersion

String

参数解释:

API版本

取值范围:

不涉及

metadata

metadata object

参数解释:

分区的元数据信息

spec

spec object

参数解释:

分区的配置信息

取值范围:

不涉及

表4 metadata

参数

参数类型

描述

name

String

参数解释:

分区名称

取值范围:

不涉及

creationTimestamp

String

参数解释:

创建时间

取值范围:

不涉及

表5 spec

参数

参数类型

描述

hostNetwork

hostNetwork object

参数解释:

分区子网

取值范围:

不涉及

containerNetwork

Array of containerNetwork objects

参数解释:

分区容器子网

取值范围:

不涉及

publicBorderGroup

String

参数解释:

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

取值范围:

不涉及

category

String

参数解释:

可用区分类

取值范围:

  • Default: 中心云可用区

  • IES: 专属云可用区

  • HomeZone: 智能边缘云可用区

表6 hostNetwork

参数

参数类型

描述

subnetID

String

参数解释:

子网ID

取值范围:

不涉及

表7 containerNetwork

参数

参数类型

描述

subnetID

String

参数解释:

子网ID

取值范围:

不涉及

请求示例

无

响应示例

状态码:200

OK

{
  "kind" : "List",
  "apiVersion" : "v3",
  "items" : [ {
    "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

错误码

请参见错误码。