List running Azure Kubernetes Service (AKS) clusters in an Azure subscription

Pode listar clusters Azure Kubernetes Service (AKS) numa subscrição usando o portal Azure, CLI do Azure ou a API REST do AKS. Use os resultados da API do CLI do Azure ou REST para identificar quais os clusters que estão a correr.

Antes de começar

Compreender os estados dos clusters AKS

Os detalhes do cluster AKS incluem tanto um estado de alimentação como um estado de provisionamento:

  • A powerState.code propriedade indica se o agrupamento é Running ou Stopped.
  • A provisioningState propriedade indica o estado da última operação de recurso do Azure, como Succeeded, Creating, Starting, ou Stopping.

Para determinar se um cluster está atualmente a funcionar, use powerState.code. Um provisioningState valor de Succeeded não indica se o cluster está a funcionar, pois um cluster parado também pode ter um estado de provisionamento bem-sucedido.

Listar clusters AKS no portal Azure

  1. Inicie sessão no portal do Azure.
  2. Na caixa de pesquisa do portal, introduza serviços Kubernetes e depois selecione serviços Kubernetes.
  3. Selecione a subscrição que contém os seus clusters AKS. Também pode filtrar a lista por grupo de recursos, localização ou outras propriedades disponíveis.
  4. Selecione o nome de um cluster para abrir a sua página de Visão Geral e visualizar a sua configuração.

Na página do cluster, selecione Ligar para obter instruções de ligação. Para visualizar recursos num cluster em execução, selecione recursos Kubernetes. Precisas de permissões para o cluster AKS, a API Kubernetes e os objetos Kubernetes. Para mais informações, consulte Aceder aos recursos Kubernetes utilizando o portal Azure.

O procedimento do portal lista e abre clusters. Para determinar o estado de energia dos clusters consistentemente ao longo de uma subscrição, utilize o método CLI do Azure ou REST API neste artigo e verifique powerState.code.

Listar clusters AKS usando CLI do Azure

  1. Inicie sessão no Azure.

    az login

  2. Se tiver acesso a várias subscrições, defina a subscrição que contém os clusters AKS.

    az account set --subscription <subscription-id>

  3. Liste os clusters AKS na subscrição selecionada. O comando seguinte mostra o nome de cada cluster, grupo de recursos, localização, estado de energia e estado de provisionamento:

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

    A saída é semelhante ao seguinte exemplo:

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

    Para listar clusters num 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 mais informações sobre o comando e as suas opções de saída, consulte a az aks list referência.

Listar clusters AKS usando a API REST

Use a operação Managed Clusters - List para obter clusters AKS numa subscrição. Envie o seguinte pedido, substituindo <subscription-id> pelo seu ID de subscrição do 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 um value conjunto de recursos do cluster AKS. Quando properties.powerState.code está presente, o seu valor indica se o cluster é Running ou Stopped. Se powerState for ausente ou nulo, trate o estado de potência do cluster como desconhecido; não o infira a partir de provisioningState. Se a resposta incluir nextLink, envie um pedido GET para essa URL para recuperar a página seguinte de resultados.

Importante

O Azure expõe recursos do cluster Kubernetes para múltiplos serviços. A operação Nexus do Operador Azure Network Cloud utiliza o tipo de Microsoft.NetworkCloud/kubernetesClusters recurso e não lista clusters AKS. Para listar clusters AKS, utilize a Microsoft.ContainerService/managedClusters operação mostrada neste artigo.

Passos seguintes

  • Última atualização a