调用GetK8sCluster接口获取容器服务K8s集群或Serverless K8s集群列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求头

该接口使用公共请求头，无特殊请求头。请参见公共请求参数文档。

请求语法

POST /pop/v5/k8s_clusters HTTPS|HTTP

请求参数

名称 类型 是否必选 示例值 描述
RegionTag String 是 cn-hangzhou

地域
CurrentPage Integer 否 1

分页查询时当前显示第几页，默认值为1。
PageSize Integer 否 10

分页查询时每页显示几条，默认值为1000。
ClusterType Integer 否 5

集群类型

返回数据

名称 类型 示例值 描述
ClusterPage Struct

集群分页显示列表
ClusterList Array of Cluster

集群列表
Cluster
ClusterId String 81453e4b-4df0-4592-****-b835a2ee****

集群ID
ClusterImportStatus Integer 1

集群的导入状态：

  • 0：没有导入
  • 1：导入成功
  • 2：导入失败
  • 3：正在导入
  • 4：集群已删除
ClusterName String test

集群名称
ClusterStatus Integer 1

集群运行状态：

  • 1：正常
  • 2：异常
  • 3：离线
ClusterType Integer 5

集群类型：

  • 2：ECS集群
  • 5：容器服务K8s集群或Serverless K8s集群
Cpu Integer 4

CPU总核数
CsClusterId String 2ce62869f4d4466b920312315f05****

容器服务集群ID
CsClusterStatus String running

容器集群运行状态：

  • initial：初始化中
  • failed：创建失败
  • running：运行中
  • updating：更新中
  • scaling：扩容中
  • removing：移除节点中
  • upgrading：升级中
  • deleting：删除中
  • delete_failed：删除失败
  • deleted：已删除（该状态用户不可见）
Description String test

集群描述
Mem Integer 2048

内存总量，单位：MB。
NetworkMode Integer 2

网络类型：

  • 1：经典网络
  • 2：VPC
NodeNum Integer 4

节点数量
RegionId String test

命名空间ID
SubNetCidr String 172.20.0.0/16

子网的网段
VpcId String vpc-**z1mlwpbjx3e9m**

VPC ID
VswitchId String vsw-bp1uf97****xjxgip****

交换机ID
CurrentPage Integer 1

分页查询时当前显示第几页，默认值为1。
PageSize Integer 10

分页查询时每页显示几条，默认值为1000。
TotalSize Integer 5

显示总页数
Code Integer 200

接口状态或POP错误码
Message String success

附加信息
RequestId String C3CE915C-0C83-4AA5-8D66-E8BEED62939E

请求ID

示例

请求示例

POST /pop/v5/k8s_clusters HTTP/1.1
公共请求头
{
"RegionTag": ""
}

正常返回示例

XML 格式 

<RequestId>C3CE915C-0C83-4AA5-8D66-E8BEED62939E</RequestId>
<Message>success</Message>
<ClusterPage>
    <ClusterList>
        <Cluster>
            <ClusterImportStatus>1</ClusterImportStatus>
            <NodeNum>3</NodeNum>
            <ClusterId>6cd7d5d3-2c7b-48be-a874-3e746708****</ClusterId>
            <Cpu>0</Cpu>
            <ClusterType>5</ClusterType>
            <NetworkMode>2</NetworkMode>
            <CsClusterId>c0b7a530b96d24b46bd02da2316c****</CsClusterId>
            <VswitchId>vsw-bp1y77ga5pz9lianh****</VswitchId>
            <VpcId>vpc-bp1jmhiplgziujhw0****</VpcId>
            <Mem>0</Mem>
            <ClusterName>gray</ClusterName>
            <SubNetCidr>172.20.0.0/16</SubNetCidr>
            <RegionId>cn-hangzhou:test</RegionId>
            <CsClusterStatus>running</CsClusterStatus>
            <ClusterStatus>0</ClusterStatus>
        </Cluster>
    </ClusterList>
    <PageSize>17</PageSize>
    <CurrentPage>0</CurrentPage>
    <TotalSize>17</TotalSize>
</ClusterPage>
<Code>200</Code>

JSON 格式 

{
	"RequestId": "C3CE915C-0C83-4AA5-8D66-E8BEED62939E",
	"Message": "success",
	"ClusterPage": {
		"ClusterList": {
			"Cluster": [
				{
					"ClusterImportStatus": 1,
					"NodeNum": 3,
					"ClusterId": "6cd7d5d3-2c7b-48be-a874-3e746708****",
					"Cpu": 0,
					"ClusterType": 5,
					"NetworkMode": 2,
					"CsClusterId": "c0b7a530b96d24b46bd02da2316c****",
					"VswitchId": "vsw-bp1y77ga5pz9lianh****",
					"VpcId": "vpc-bp1jmhiplgziujhw0****",
					"Mem": 0,
					"ClusterName": "gray",
					"SubNetCidr": "172.20.0.0/16",
					"RegionId": "cn-hangzhou:test",
					"CsClusterStatus": "running",
					"ClusterStatus": 0
				}
			]
		},
		"PageSize": 17,
		"CurrentPage": 0,
		"TotalSize": 17
	},
	"Code": 200
}

错误码

HttpCode 错误码 错误信息 描述
500 Edas.errorcode.PermissionDenied.message You are not authorized to perform the operation. 无权限操作

访问错误中心查看更多错误码。