调用GetCluster接口获取指定集群的信息。

调试

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

请求头

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

请求语法

GET /pop/v5/resource/cluster HTTP/1.1

请求参数

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

集群ID。可以通过调用ListCluster获取集群ID，具体操作，请参见ListCluster。

返回数据

名称 类型 示例值 描述
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超卖：

  • 1：1:1比例，不超卖。
  • 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"
	}
}

错误码

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