调用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. 无权限操作

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