Todos os produtos
Search
Central de documentação

:Consultar recursos em um cluster

Última atualização: Jul 09, 2026

Use a operação DescribeClusterResources para consultar todos os recursos de um cluster pelo ID do cluster.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo para diferentes SDKs.

Cabeçalho da requisição

Esta operação usa apenas cabeçalhos de requisição comuns. Para mais informações, consulte Parâmetros de requisição comuns.

Sintaxe da requisição

GET /clusters/{ClusterId}/resources HTTP/1.1

Parâmetros da requisição

Parâmetro

Tipo

Posição

Obrigatório

Exemplo

Descrição

ClusterId String Path Sim cb95aa626a47740afbf6aa099b65****

ID do cluster.

Para saber como consultar IDs de cluster, veja Visualizar informações do cluster.

Você também pode chamar a operação de API DescribeClustersV1 para listar todos os clusters da conta Alibaba Cloud.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

Array

Lista de recursos no cluster.

cluster_id String cb95aa626a47740afbf6aa099b65****

ID do cluster.

created String 2023-08-15T14:34:42+08:00

Horário de criação do recurso.

instance_id String ngw-wz9sphwk42sdtjixo****

ID do recurso.

resource_info String {\"Id\":\"k8s_NAT_Gateway\",\"Name\":\"k8s_NAT_Gateway\",\"Type\":\"ALIYUN::VPC::NatGateway\",\"Status\":\"CREATE_COMPLETE\",\"StatusReason\":\"state changed\",\"Updated\":\"2023-08-15T06:33:10\",\"PhysicalId\":\"ngw-wz9sphwk42sdtjixo****\"}

Informações do recurso. Para consultar dados de source de um recurso, veja ListStackResources.

resource_type String ALIYUN::VPC::NatGateway

Tipo do recurso.

state String CREATE_COMPLETE

Status do recurso. Valores válidos:

  • CREATE_COMPLETE: Recurso criado.
  • CREATE_FAILED: Falha na criação do recurso.
  • CREATE_IN_PROGRESS: Criação do recurso em andamento.
  • DELETE_FAILED: Falha na exclusão do recurso.
  • DELETE_IN_PROGRESS: Exclusão do recurso em andamento.
  • ROLLBACK_COMPLETE: Rollback do recurso concluído.
  • ROLLBACK_FAILED: Falha no rollback do recurso.
  • ROLLBACK_IN_PROGRESS: Rollback do recurso em andamento.
auto_create Long 1

Indica se o Container Service for Kubernetes (ACK) criou o recurso. Valores válidos:

  • 1: Recurso criado pelo ACK.
  • 0: Recurso preexistente.
dependencies Array

Lista de recursos dependentes.

cluster_id String cc5ee03f63e43425cb6f71f1a1756****

ID do cluster onde os recursos dependentes estão implantados.

resource_type String ALIYUN::VPC::NatGateway

Tipo do recurso dependente.

instance_id String ngw-wz9sphwk42sdtjixo****

ID do recurso dependente.

Exemplos

Exemplos de requisições

GET /clusters/cb95aa626a47740afbf6aa099b65****/resources HTTP/1.1
Host:cs.aliyuncs.com
Content-Type:application/json

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeClusterResourcesResponse>
    <cluster_id>cb95aa626a47740afbf6aa099b65****</cluster_id>
    <created>2023-08-15T14:34:42+08:00</created>
    <instance_id>ngw-wz9sphwk42sdtjixo****</instance_id>
    <resource_info>{\"Id\":\"k8s_NAT_Gateway\",\"Name\":\"k8s_NAT_Gateway\",\"Type\":\"ALIYUN::VPC::NatGateway\",\"Status\":\"CREATE_COMPLETE\",\"StatusReason\":\"state changed\",\"Updated\":\"2023-08-15T06:33:10\",\"PhysicalId\":\"ngw-wz9sphwk42sdtjixo****\"}</resource_info>
    <resource_type>ALIYUN::VPC::NatGateway</resource_type>
    <state>CREATE_COMPLETE</state>
    <auto_create>1</auto_create>
    <dependencies>
        <cluster_id>cc5ee03f63e43425cb6f71f1a1756****</cluster_id>
        <resource_type>ALIYUN::VPC::NatGateway</resource_type>
        <instance_id>ngw-wz9sphwk42sdtjixo****</instance_id>
    </dependencies>
</DescribeClusterResourcesResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

[ {
  "cluster_id" : "cb95aa626a47740afbf6aa099b65****",
  "created" : "2023-08-15T14:34:42+08:00",
  "instance_id" : "ngw-wz9sphwk42sdtjixo****",
  "resource_info" : "{\\\"Id\\\":\\\"k8s_NAT_Gateway\\\",\\\"Name\\\":\\\"k8s_NAT_Gateway\\\",\\\"Type\\\":\\\"ALIYUN::VPC::NatGateway\\\",\\\"Status\\\":\\\"CREATE_COMPLETE\\\",\\\"StatusReason\\\":\\\"state changed\\\",\\\"Updated\\\":\\\"2023-08-15T06:33:10\\\",\\\"PhysicalId\\\":\\\"ngw-wz9sphwk42sdtjixo****\\\"}",
  "resource_type" : "ALIYUN::VPC::NatGateway",
  "state" : "CREATE_COMPLETE",
  "auto_create" : 1,
  "dependencies" : {
    "cluster_id" : "cc5ee03f63e43425cb6f71f1a1756****",
    "resource_type" : "ALIYUN::VPC::NatGateway",
    "instance_id" : "ngw-wz9sphwk42sdtjixo****"
  }
} ]

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.