Todos os produtos
Search
Central de documentação

:ListCluster

Última atualização: Jul 08, 2026

Consulta clusters.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Cabeçalhos da requisição

Esta operação utiliza cabeçalhos de requisição comuns e não requer cabeçalhos especiais. Para mais informações, consulte Parâmetros comuns.

Sintaxe da requisição

POST /pop/v5/resource/cluster_list HTTPS|HTTP

Parâmetros da requisição

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

LogicalRegionId

String

Não

cn-beijing:test

ID do namespace. Este parâmetro é opcional. Se omitido, a consulta retornará o namespace padrão. Para saber como consultar um ID de namespace, consulte ListUserDefineRegion.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
ClusterList Array of Cluster

Lista de clusters.

Cluster
ClusterId String b98b5919-c111-4dad-9f74-7233********

ID do cluster.

ClusterName String cluster-test

Nome do cluster.

ClusterType Integer 2

Tipo do cluster. Valores válidos:

  • 0: clusters docker normais
  • 1: clusters Swarm
  • 2: clusters Elastic Compute Service (ECS)
  • 3: clusters Kubernetes criados pelo usuário no EDAS
  • 4: clusters Pandora com registro automático de aplicações (obsoleto)
  • 5: clusters Container Service for Kubernetes
Cpu Integer 2

Número total de núcleos de CPU.

CpuUsed Integer 1

Número de núcleos de CPU em uso.

CreateTime Long 1502888064561

Data e hora de criação do cluster.

CsClusterId String c2ce************b9203a9

ID gerado para o cluster no console do Container Service for Kubernetes.

Description String Test instance

Descrição do cluster.

IaasProvider String ALIYUN

Provedor de serviços do cluster.

Mem Integer 3072

Tamanho total da memória. Unidade: MB.

MemUsed Integer 200

Tamanho da memória em uso. Unidade: MB.

NetworkMode Integer 1

Tipo de rede. Valores válidos:

  • 1: rede clássica
  • 2: Virtual Private Cloud (VPC)
NodeNum Integer 2

Número de instâncias.

OversoldFactor Integer 1

Taxa de overcommit de CPU compatível com clusters docker normais. Valores válidos:

  • 2: 1:2
  • 4: 1:4
  • 8: 1:8
RegionId String cn-beijing

ID da região.

UpdateTime Long 1533820823203

Data e hora da última atualização do cluster.

VpcId String vpc-23727****

ID da VPC.

Code Integer 200

Código de status HTTP retornado pela requisição.

Message String success

Informações adicionais.

RequestId String 1053-08e4-47a5-b2ab-5c0323de****

ID da requisição.

Exemplos

Exemplos de requisições

POST /pop/v5/resource/cluster_list HTTP/1.1
Common request headers

Exemplos de respostas de sucesso

Formato XML

<Message>success</Message>
<Code>200</Code>
<ClusterList>
    <Cluster>
        <MemUsed>0</MemUsed>
        <Mem>0</Mem>
        <NetworkMode>2</NetworkMode>
        <UpdateTime>1557986815279</UpdateTime>
        <NodeNum>0</NodeNum>
        <VpcId>vpc-2zes5h7bxyq6se8ms****</VpcId>
        <OversoldFactor>1</OversoldFactor>
        <Cpu>0</Cpu>
        <ClusterId>0239e972-fbcd-40d5-914c-47dbc49b****</ClusterId>
        <ClusterName>doc-test</ClusterName>
        <CsClusterId>c2ce62869f4d4466b920312315f05****</CsClusterId>
        <RegionId>cn-beijing</RegionId>
        <CreateTime>1557985562153</CreateTime>
        <CpuUsed>0</CpuUsed>
        <ClusterType>2</ClusterType>
        <IaasProvider>ALIYUN</IaasProvider>
    </Cluster>
    <Cluster>
        <MemUsed>0</MemUsed>
        <Mem>24576</Mem>
        <NetworkMode>2</NetworkMode>
        <UpdateTime>1569675703492</UpdateTime>
        <NodeNum>3</NodeNum>
        <VpcId>vpc-2ze9sywarkrp0xh3d****</VpcId>
        <OversoldFactor>1</OversoldFactor>
        <Cpu>12</Cpu>
        <ClusterId>135c1bc1231706e3e37ffbdb29f97cd8502e****</ClusterId>
        <ClusterName>CN-BEIJING_vpc-2ze9sywarkrp0xh3d****_DEFAULT</ClusterName>
        <CsClusterId>c2ce62869f4d4466b920312315f05****</CsClusterId>
        <RegionId>cn-beijing</RegionId>
        <CreateTime>1569674543528</CreateTime>
        <CpuUsed>0</CpuUsed>
        <ClusterType>2</ClusterType>
        <IaasProvider>ALIYUN</IaasProvider>
    </Cluster>
    <Cluster>
        <MemUsed>0</MemUsed>
        <Mem>0</Mem>
        <NetworkMode>2</NetworkMode>
        <UpdateTime>1544687276905</UpdateTime>
        <NodeNum>0</NodeNum>
        <VpcId>vpc-2ze20lsdud3qooqec****</VpcId>
        <OversoldFactor>1</OversoldFactor>
        <Cpu>0</Cpu>
        <ClusterId>162f5a6c6a5fb584995490110c0ecab49666****</ClusterId>
        <ClusterName>CN-BEIJING_vpc-2ze20lsdud3qooqec****_DEFAULT</ClusterName>
        <RegionId>cn-beijing</RegionId>
        <CreateTime>1536641525211</CreateTime>
        <CpuUsed>0</CpuUsed>
        <ClusterType>2</ClusterType>
        <IaasProvider>ALIYUN</IaasProvider>
    </Cluster>
    <Cluster>
        <MemUsed>0</MemUsed>
        <Mem>0</Mem>
        <NetworkMode>2</NetworkMode>
        <UpdateTime>1570850383830</UpdateTime>
        <NodeNum>0</NodeNum>
        <VpcId>vpc-2zecvqz8ri0s0nqog****</VpcId>
        <OversoldFactor>1</OversoldFactor>
        <Cpu>0</Cpu>
        <ClusterId>841ca2d486e7451f996b74c758e5c6b4c13b****</ClusterId>
        <ClusterName>CN-BEIJING_vpc-2zecvqz8ri0s0nqog****_DEFAULT</ClusterName>
        <RegionId>cn-beijing</RegionId>
        <CreateTime>1570850336816</CreateTime>
        <CpuUsed>0</CpuUsed>
        <ClusterType>2</ClusterType>
        <IaasProvider>ALIYUN</IaasProvider>
    </Cluster>
</ClusterList>

Formato JSON

{
	"Message": "success",
	"Code": 200,
	"ClusterList": {
		"Cluster": [
			{
				"MemUsed": 0,
				"Mem": 0,
				"NetworkMode": 2,
				"UpdateTime": 1557986815279,
				"NodeNum": 0,
				"VpcId": "vpc-2zes5h7bxyq6se8ms****",
				"OversoldFactor": 1,
				"Cpu": 0,
				"ClusterId": "0239e972-fbcd-40d5-914c-47dbc49b****",
				"ClusterName": "doc-test",
                "CsClusterId": "c2ce62869f4d4466b920312315f05****",
				"RegionId": "cn-beijing",
				"CreateTime": 1557985562153,
				"CpuUsed": 0,
				"ClusterType": 2,
				"IaasProvider": "ALIYUN"
			},
			{
				"MemUsed": 0,
				"Mem": 24576,
				"NetworkMode": 2,
				"UpdateTime": 1569675703492,
				"NodeNum": 3,
				"VpcId": "vpc-2ze9sywarkrp0xh3d****",
				"OversoldFactor": 1,
				"Cpu": 12,
				"ClusterId": "135c1bc1231706e3e37ffbdb29f97cd8502e****",
				"ClusterName": "CN-BEIJING_vpc-2ze9sywarkrp0xh3d****_DEFAULT",
				"CsClusterId": "c2ce62869f4d4466b920312315f05****",
                "RegionId": "cn-beijing",
				"CreateTime": 1569674543528,
				"CpuUsed": 0,
				"ClusterType": 2,
				"IaasProvider": "ALIYUN"
			},
			{
				"MemUsed": 0,
				"Mem": 0,
				"NetworkMode": 2,
				"UpdateTime": 1544687276905,
				"NodeNum": 0,
				"VpcId": "vpc-2ze20lsdud3qooqec****",
				"OversoldFactor": 1,
				"Cpu": 0,
				"ClusterId": "162f5a6c6a5fb584995490110c0ecab49666****",
				"ClusterName": "CN-BEIJING_vpc-2ze20lsdud3qooqec****_DEFAULT",
				"RegionId": "cn-beijing",
				"CreateTime": 1536641525211,
				"CpuUsed": 0,
				"ClusterType": 2,
				"IaasProvider": "ALIYUN"
			},
			{
				"MemUsed": 0,
				"Mem": 0,
				"NetworkMode": 2,
				"UpdateTime": 1570850383830,
				"NodeNum": 0,
				"VpcId": "vpc-2zecvqz8ri0s0nqog****",
				"OversoldFactor": 1,
				"Cpu": 0,
				"ClusterId": "841ca2d486e7451f996b74c758e5c6b4c13b****",
				"ClusterName": "CN-BEIJING_vpc-2zecvqz8ri0s0nqog****_DEFAULT",
				"RegionId": "cn-beijing",
				"CreateTime": 1570850336816,
				"CpuUsed": 0,
				"ClusterType": 2,
				"IaasProvider": "ALIYUN"
			}
		]
	}
}

Códigos de erro

Acesse o Centro de Erros para ver mais códigos de erro.

Para obter uma lista de códigos de erro, visite o API Error Center.