Lista uruchomionych klastrów Azure Kubernetes Service (AKS) w subskrypcji Azure

Klastry Azure Kubernetes Service (AKS) można wyświetlić w subskrypcji przy użyciu portalu Azure, Azure CLI lub interfejsu API REST usługi AKS. Użyj Azure CLI lub wyników interfejsu API REST, aby określić, które klastry są uruchomione.

Zanim rozpoczniesz

Omówienie stanów klastra usługi AKS

Szczegóły klastra usługi AKS obejmują stan zasilania i stan aprowizacji:

  • Właściwość powerState.code wskazuje, czy klaster ma wartość Running , czy Stopped.
  • Właściwość provisioningState wskazuje stan najnowszej operacji Azure zasobu, na przykład Succeeded, Creating, Startinglub Stopping.

Aby określić, czy klaster jest aktualnie uruchomiony, użyj polecenia powerState.code. Wartość provisioningStateSucceeded nie wskazuje, czy klaster jest uruchomiony, ponieważ zatrzymany klaster może również mieć stan pomyślnej aprowizacji.

Wyświetlanie listy klastrów usługi AKS w portalu Azure

  1. Zaloguj się do portalu Azure.
  2. W polu wyszukiwania portalu wprowadź ciąg Usługi Kubernetes, a następnie wybierz pozycję Usługi Kubernetes.
  3. Wybierz subskrypcję zawierającą klastry usługi AKS. Listę można również filtrować według grupy zasobów, lokalizacji lub innych dostępnych właściwości.
  4. Wybierz nazwę klastra, aby otworzyć stronę Przegląd i wyświetlić jego konfigurację.

Na stronie klastra wybierz pozycję Połącz , aby uzyskać instrukcje dotyczące połączenia. Aby wyświetlić zasoby w uruchomionym klastrze, wybierz pozycję Zasoby Kubernetes. Potrzebujesz uprawnień do klastra AKS, interfejsu API Kubernetes i obiektów Kubernetes. Aby uzyskać więcej informacji, zobacz Access Kubernetes resources by using the Azure portal (Uzyskiwanie dostępu do zasobów platformy Kubernetes przy użyciu portalu Azure).

Procedura portalu wyświetla listę i otwiera klastry. Aby określić stan zasilania klastrów spójnie w ramach subskrypcji, użyj metody Azure CLI lub interfejsu API REST w tym artykule i sprawdź powerState.code.

Wyświetlanie listy klastrów usługi AKS przy użyciu Azure CLI

  1. Zaloguj się do Azure.

    az login

  2. Jeśli masz dostęp do wielu subskrypcji, ustaw subskrypcję zawierającą klastry usługi AKS.

    az account set --subscription <subscription-id>

  3. Wyświetl listę klastrów usługi AKS w wybranej subskrypcji. Następujące polecenie wyświetla nazwę każdego klastra, grupę zasobów, lokalizację, stan zasilania i stan aprowizacji:

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

    Dane wyjściowe przypominają następujący przykład:

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

    Aby wyświetlić listę klastrów w określonej grupie zasobów, dodaj --resource-group parametr .

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

  4. Aby wyświetlić listę tylko uruchomionych klastrów, przefiltruj wartość .powerState.code

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

Aby uzyskać więcej informacji na temat polecenia i jego opcji wyjściowych, zobacz dokumentację az aks list .

Wyświetlanie listy klastrów usługi AKS przy użyciu interfejsu API REST

Użyj operacji Zarządzane klastry — lista , aby pobrać klastry usługi AKS w subskrypcji. Wyślij następujące żądanie, zastępując <subscription-id> ciąg identyfikatorem subskrypcji Azure:

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

Odpowiedź zawiera tablicę value zasobów klastra usługi AKS. Gdy properties.powerState.code element jest obecny, jego wartość wskazuje, czy klaster ma Running wartość , czy Stopped. Jeśli powerState brakuje lub ma wartość null, traktuj stan zasilania klastra jako nieznany; nie wywnioskuj go z provisioningState. Jeśli odpowiedź zawiera nextLink, wyślij żądanie GET do tego adresu URL, aby pobrać następną stronę wyników.

Ważna

Azure uwidacznia zasoby klastra Kubernetes dla wielu usług. Operacja Azure Operator Nexus Chmura sieciowa używa Microsoft.NetworkCloud/kubernetesClusters typu zasobu i nie wyświetla listy klastrów usługi AKS. Aby wyświetlić listę klastrów usługi AKS, użyj operacji pokazanej Microsoft.ContainerService/managedClusters w tym artykule.

Następne kroki

  • Ostatnia aktualizacja o