Elencare i cluster Servizio Azure Kubernetes (AKS) in esecuzione in una sottoscrizione Azure

È possibile elencare Servizio Azure Kubernetes (AKS) cluster in una sottoscrizione usando il portale di Azure, interfaccia della riga di comando di Azure o l'API REST del servizio Azure Kubernetes. Usare interfaccia della riga di comando di Azure o i risultati dell'API REST per identificare i cluster in esecuzione.

Prima di iniziare

Informazioni sugli stati del cluster del servizio Azure Kubernetes

I dettagli del cluster del servizio Azure Kubernetes includono sia uno stato di alimentazione che uno stato di provisioning:

  • La powerState.code proprietà indica se il cluster è Running o Stopped.
  • La provisioningState proprietà indica lo stato dell'operazione di Azure risorsa più recente, ad esempio Succeeded, StartingCreating, o Stopping.

Per determinare se un cluster è attualmente in esecuzione, usare powerState.code. Un provisioningState valore di Succeeded non indica se il cluster è in esecuzione perché un cluster arrestato può avere anche uno stato di provisioning corretto.

Elencare i cluster del servizio Azure Kubernetes nel portale di Azure

  1. Accedere al portale di Azure.
  2. Nella casella di ricerca del portale immettere Servizi Kubernetes e quindi selezionare Servizi Kubernetes.
  3. Seleziona la sottoscrizione che contiene i cluster AKS. È anche possibile filtrare l'elenco in base al gruppo di risorse, alla posizione o ad altre proprietà disponibili.
  4. Selezionare un nome del cluster per aprire la relativa pagina Panoramica e visualizzarne la configurazione.

Nella pagina del cluster selezionare Connetti per ottenere le istruzioni di connessione. Per visualizzare le risorse in un cluster in esecuzione, selezionare Risorse Kubernetes. Sono necessarie autorizzazioni per il cluster del servizio Azure Kubernetes, l'API Kubernetes e gli oggetti Kubernetes. Per altre informazioni, vedere Accedere alle risorse kubernetes usando il portale di Azure.

La procedura del portale elenca e apre i cluster. Per determinare lo stato di alimentazione dei cluster in modo coerente in una sottoscrizione, usare il metodo api REST o interfaccia della riga di comando di Azure in questo articolo e controllare powerState.code.

Elencare i cluster del servizio Azure Kubernetes usando interfaccia della riga di comando di Azure

  1. Accedere ad Azure.

    az login

  2. Se si ha accesso a più sottoscrizioni, impostare la sottoscrizione che contiene i cluster del servizio Azure Kubernetes.

    az account set --subscription <subscription-id>

  3. Elencare i cluster del servizio Azure Kubernetes nella sottoscrizione selezionata. Il comando seguente visualizza il nome, il gruppo di risorse, la posizione, lo stato di alimentazione e lo stato di provisioning di ogni cluster:

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

    L'output sarà simile al seguente esempio:

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

    Per elencare i cluster in un gruppo di risorse specifico, aggiungere il --resource-group parametro .

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

  4. Per elencare solo i cluster in esecuzione, filtrare in base a powerState.code.

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

Per altre informazioni sul comando e sulle relative opzioni di output, vedere il az aks list riferimento.

Elencare i cluster del servizio Azure Kubernetes usando l'API REST

Usare l'operazione Managed Clusters - List per ottenere i cluster del servizio Azure Kubernetes in una sottoscrizione. Inviare la richiesta seguente, sostituendo <subscription-id> con l'ID sottoscrizione Azure:

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

La risposta contiene una value matrice di risorse del cluster del servizio Azure Kubernetes. Quando properties.powerState.code è presente, il valore indica se il cluster è Running o Stopped. Se powerState manca o null, considerare lo stato di alimentazione del cluster come sconosciuto; non dedurrlo da provisioningState. Se la risposta include nextLink, inviare una richiesta GET a tale URL per recuperare la pagina successiva dei risultati.

Importante

Azure espone le risorse del cluster Kubernetes per più servizi. L'operazione Operatore Nexus di Azure Network Cloud usa il Microsoft.NetworkCloud/kubernetesClusters tipo di risorsa e non elenca i cluster del servizio Azure Kubernetes. Per elencare i cluster del servizio Azure Kubernetes, usare l'operazione Microsoft.ContainerService/managedClusters illustrata in questo articolo.

Passaggi successivi

  • Ultimo aggiornamento: