使用GetCluster获取集群列表。

调试

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

请求头

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

请求语法

GET /pop/v5/resource/cluster HTTPS|HTTP

请求参数

名称 类型 是否必选 示例值 描述
ClusterId String 是 5439271a-015b-433d-****-d76db49****

集群ID。

返回数据

名称 类型 示例值 描述
Cluster Struct

集群信息。
ClusterId String 5439271a-015b-433d-befb-d76db49xxxxx

集群ID。
ClusterImportStatus Integer 0

导入集群状态：

  • 1代表导入成功。
  • 2代表导入失败。
  • 3代表正在导入。
  • 4代表集群已删除。
  • 0代表没有导入。
ClusterName String ClusterTest

集群名称。
ClusterType Integer 2

集群类型：

  • 0-普通 Docker 集群。
  • 1-Swarm 集群
  • 2-ECS 集群
  • 3-EDAS自建 K8s 集群
  • 4-Pandora 自动注册应用集群类型
  • 5-容器服务 K8s 集群
Cpu Integer 4

CPU总核数。
CpuUsed Integer 2

已使用CPU核数。
CreateTime Long 1570708232145

集群创建时间。
CsClusterId String c2ce62869f4d4466b920312315f05****

容器服务集群ID。
Description String 测试

描述。
IaasProvider String ALIYUN

IaaS资源提供者。
Mem Integer 2048

内存总量，单位：MB。
MemUsed Integer 1024

已使用内存量。
NetworkMode Integer 2

网络类型：

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

ECS数量。
OversoldFactor Integer 2

Docker集群CPU超卖：

  • 2代表1:2比例。
  • 4代表1:4比例。
  • 8代表1:8比例。
RegionId String cn-hangzhou

逻辑可用区ID。
UpdateTime Long 1570708232145

最后变更时间。
VpcId String vpc-xxxxz1mlwpbjx3e9mwe

VPC网络ID。
Code Integer 200

code码。
Message String success

详细信息。
RequestId String d76db491

请求ID。

示例

请求示例

GET /pop/v5/resource/cluster HTTP/1.1
公共请求头
{
  "ClusterId": "5439271a-015b-433d-xxxxxxxx"
}

正常返回示例

XML 格式 

<Message>success</Message>
<Code>200</Code>
<Cluster>
    <MemUsed>2048</MemUsed>
    <Mem>2048</Mem>
    <NetworkMode>2</NetworkMode>
    <UpdateTime>1570708232145</UpdateTime>
    <NodeNum>2</NodeNum>
    <VpcId>vpc-bp19z1mlwpbjx3e9mwefe</VpcId>
    <OversoldFactor>1</OversoldFactor>
    <Cpu>2</Cpu>
    <ClusterId>5439271a-015b-433d-befb-d76db4911b7c</ClusterId>
    <ClusterName>GTSDemoTesting</ClusterName>
    <CreateTime>1561444573420</CreateTime>
    <RegionId>cn-hangzhou</RegionId>
    <CpuUsed>2</CpuUsed>
    <ClusterType>2</ClusterType>
    <IaasProvider>ALIYUN</IaasProvider>
</Cluster>

JSON 格式 

{
	"Message": "success",
	"Code": 200,
	"Cluster": {
		"MemUsed": 2048,
		"Mem": 2048,
		"NetworkMode": 2,
		"UpdateTime": 1570708232145,
		"NodeNum": 2,
		"VpcId": "vpc-xxxxz1mlwxxxx3e9mxxxx",
		"OversoldFactor": 1,
		"Cpu": 2,
		"ClusterId": "xxxxxxa-015b-xxxx-befb-xxxxxxxxx",
		"ClusterName": "xxxDemoTesting",
		"CreateTime": 1561444573420,
		"RegionId": "cn-hangzhou",
		"CpuUsed": 2,
		"ClusterType": 2,
		"IaasProvider": "ALIYUN"
	}
}

错误码

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