Auflisten der Ausführung von Azure Kubernetes Service (AKS) Clustern in einem Azure-Abonnement

Sie können Azure Kubernetes Service (AKS) Cluster in einem Abonnement mithilfe des Azure Portals, Azure CLI oder der AKS-REST-API auflisten. Verwenden Sie Azure CLI- oder REST-API-Ergebnisse, um zu ermitteln, welche Cluster ausgeführt werden.

Bevor Sie anfangen

Grundlegendes zu AKS-Clusterzuständen

AKS-Clusterdetails enthalten sowohl einen Energiezustand als auch einen Bereitstellungsstatus:

  • Die powerState.code Eigenschaft gibt an, ob der Cluster ist Running oder Stopped.
  • Die provisioningState Eigenschaft gibt den Status des aktuellen Azure Ressourcenvorgangs an, zSucceeded. B. , , Creating, Startingoder Stopping.

Um festzustellen, ob derzeit ein Cluster ausgeführt wird, verwenden Sie powerState.code. Ein provisioningState Wert, der Succeeded nicht angibt, ob der Cluster ausgeführt wird, da ein angehaltener Cluster auch einen erfolgreichen Bereitstellungsstatus aufweisen kann.

Auflisten von AKS-Clustern im Azure-Portal

  1. Melden Sie sich beim Azure-Portal an.
  2. Geben Sie im Suchfeld des Portals Kubernetes-Dienste ein, und wählen Sie dann Kubernetes-Dienste aus.
  3. Wählen Sie das Abonnement aus, das Ihre AKS-Cluster enthält. Sie können die Liste auch nach Ressourcengruppe, Standort oder anderen verfügbaren Eigenschaften filtern.
  4. Wählen Sie einen Clusternamen aus, um seine Übersichtsseite zu öffnen und seine Konfiguration anzuzeigen.

Wählen Sie auf der Clusterseite "Verbinden" aus, um Verbindungsanweisungen abzurufen. Um Ressourcen in einem ausgeführten Cluster anzuzeigen, wählen Sie Kubernetes-Ressourcen aus. Sie benötigen Berechtigungen für den AKS-Cluster, die Kubernetes-API und die Kubernetes-Objekte. Weitere Informationen finden Sie unter Access Kubernetes-Ressourcen mithilfe des Azure-Portals.

In der Portalprozedur werden Cluster aufgelistet und geöffnet. Verwenden Sie die Azure CLI- oder REST-API-Methode in diesem Artikel, um den Leistungsstatus von Clustern konsistent in einem Abonnement zu ermitteln und zu überprüfenpowerState.code.

Auflisten von AKS-Clustern mithilfe von Azure CLI

  1. Melden Sie sich bei Azure an.

    az login

  2. Wenn Sie Zugriff auf mehrere Abonnements haben, legen Sie das Abonnement fest, das die AKS-Cluster enthält.

    az account set --subscription <subscription-id>

  3. Auflisten der AKS-Cluster im ausgewählten Abonnement. Der folgende Befehl zeigt den Namen, die Ressourcengruppe, den Standort, den Energiezustand und den Bereitstellungsstatus der einzelnen Cluster an:

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

    Die Ausgabe ähnelt dem folgenden Beispiel:

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

    Um Cluster in einer bestimmten Ressourcengruppe auflisten zu können, fügen Sie den --resource-group Parameter hinzu.

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

  4. Um nur ausgeführte Cluster auflisten zu können, filtern Sie nach powerState.code.

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

Weitere Informationen zu dem Befehl und den zugehörigen Ausgabeoptionen finden Sie in der az aks list Referenz.

Auflisten von AKS-Clustern mithilfe der REST-API

Verwenden Sie den verwalteten Cluster – Listenvorgang , um AKS-Cluster in einem Abonnement abzurufen. Senden Sie die folgende Anforderung, und ersetzen <subscription-id> Sie sie durch Ihre Azure-Abonnement-ID:

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

Die Antwort enthält ein value Array von AKS-Clusterressourcen. Wenn properties.powerState.code vorhanden ist, gibt der Wert an, ob der Cluster ist Running oder Stopped. Wenn powerState der Leistungszustand des Clusters fehlt oder null ist, behandeln Sie ihn als unbekannt; führen Sie ihn nicht aus provisioningState. Wenn die Antwort enthält nextLink, senden Sie eine GET-Anforderung an diese URL, um die nächste Seite mit Ergebnissen abzurufen.

Important

Azure stellt Kubernetes-Clusterressourcen für mehrere Dienste zur Verfügung. Der Azure Operator Nexus Netzwerkcloud-Vorgang verwendet den Microsoft.NetworkCloud/kubernetesClusters Ressourcentyp und listet keine AKS-Cluster auf. Verwenden Sie zum Auflisten von AKS-Clustern den Microsoft.ContainerService/managedClusters in diesem Artikel gezeigten Vorgang.

Nächste Schritte

  • Zuletzt aktualisiert um