Listar clusters AKS (Serviço de Kubernetes do Azure) em execução em uma assinatura de Azure

Você pode listar AKS (Serviço de Kubernetes do Azure) clusters em uma assinatura usando o portal Azure, CLI do Azure ou a API REST do AKS. Use CLI do Azure ou resultados da API REST para identificar quais clusters estão em execução.

Antes de começar

Entender os estados do cluster do AKS

Os detalhes do cluster do AKS incluem um estado de energia e um estado de provisionamento:

  • A powerState.code propriedade indica se o cluster é Running ou Stopped.
  • A provisioningState propriedade indica o status da operação de recurso de Azure mais recente, como Succeeded, , Creatingou StartingStopping.

Para determinar se um cluster está em execução no momento, use powerState.code. Um provisioningState valor não Succeeded indica se o cluster está em execução porque um cluster parado também pode ter um estado de provisionamento bem-sucedido.

Listar clusters do AKS no portal Azure

  1. Entre no Portal do Azure.
  2. Na caixa de pesquisa do portal, insira os serviços do Kubernetes e selecione os serviços do Kubernetes.
  3. Selecione a assinatura que contém os clusters do AKS. Você também pode filtrar a lista por grupo de recursos, local ou outras propriedades disponíveis.
  4. Selecione um nome de cluster para abrir sua página visão geral e exibir sua configuração.

Na página do cluster, selecione Conectar para obter instruções de conexão. Para exibir recursos em um cluster em execução, selecione recursos do Kubernetes. Você precisa de permissões para o cluster do AKS, a API do Kubernetes e os objetos kubernetes. Para obter mais informações, consulte Acessar recursos do Kubernetes usando o portal Azure.

O procedimento do portal lista e abre clusters. Para determinar o estado de energia dos clusters consistentemente em uma assinatura, use o método CLI do Azure ou da API REST neste artigo e verifique powerState.code.

Listar clusters do AKS usando CLI do Azure

  1. Inicie sessão no Azure.

    az login

  2. Se você tiver acesso a várias assinaturas, defina a assinatura que contém os clusters do AKS.

    az account set --subscription <subscription-id>

  3. Liste os clusters do AKS na assinatura selecionada. O comando a seguir exibe o nome, o grupo de recursos, o local, o estado de energia e o estado de provisionamento de cada cluster:

    az aks list --query "[].{Name:name, ResourceGroup:resourceGroup, Location:location, PowerState:powerState.code, ProvisioningState:provisioningState}" --output table

    A saída é semelhante ao exemplo a seguir:

    Name          ResourceGroup    Location    PowerState    ProvisioningState
------------  ---------------  ----------  ------------  -------------------
aks-prod      rg-aks-prod      eastus      Running       Succeeded
aks-dev       rg-aks-dev       westus2     Stopped       Succeeded

    Para listar clusters em um grupo de recursos específico, adicione o --resource-group parâmetro.

    az aks list --resource-group <resource-group-name> --query "[].{Name:name, PowerState:powerState.code}" --output table

  4. Para listar apenas clusters em execução, filtre em powerState.code.

    az aks list --query "[?powerState.code=='Running'].{Name:name, ResourceGroup:resourceGroup, Location:location}" --output table

Para obter mais informações sobre o comando e suas opções de saída, consulte a az aks list referência.

Listar clusters do AKS usando a API REST

Use a operação Clusters Gerenciados – Listar para obter clusters do AKS em uma assinatura. Envie a seguinte solicitação, substituindo <subscription-id> sua ID de assinatura Azure:

GET https://management.azure.com/subscriptions/<subscription-id>/providers/Microsoft.ContainerService/managedClusters?api-version=2025-09-01
Authorization: Bearer <access-token>

A resposta contém uma value matriz de recursos de cluster do AKS. Quando properties.powerState.code estiver presente, seu valor indica se o cluster é Running ou Stopped. Se powerState estiver ausente ou nulo, trate o estado de energia do cluster como desconhecido; não infera de provisioningState. Se a resposta incluir nextLink, envie uma solicitação GET para essa URL para recuperar a próxima página de resultados.

Importante

Azure expõe recursos de cluster do Kubernetes para vários serviços. A operação Nexus do Operador do Azure Network Cloud usa o Microsoft.NetworkCloud/kubernetesClusters tipo de recurso e não lista clusters aks. Para listar clusters do AKS, use a Microsoft.ContainerService/managedClusters operação mostrada neste artigo.

Próximas Etapas 

  • Última atualização em