Výpis spuštěných clusterů Azure Kubernetes Service (AKS) v předplatném Azure

K výpisu Azure Kubernetes Service (AKS) clusterů v předplatném můžete použít portál Azure, Azure CLI nebo rozhraní REST API služby AKS. Pomocí Azure CLI nebo výsledků rozhraní REST API určete, které clustery jsou spuštěné.

Než začnete

Vysvětlení stavů clusteru AKS

Podrobnosti o clusteru AKS zahrnují stav napájení i stav zřizování:

  • Vlastnost powerState.code označuje, zda je Running cluster nebo Stopped.
  • Vlastnost provisioningState označuje stav poslední Azure operace prostředku, například Succeeded, Creating, Starting, nebo Stopping.

Pokud chcete zjistit, jestli je cluster aktuálně spuštěný, použijte powerState.code. Hodnota provisioningStateSucceeded nezoznačuje, jestli je cluster spuštěný, protože zastavený cluster může mít také úspěšný stav zřizování.

Výpis clusterů AKS na portálu Azure

  1. Přihlaste se k portálu Azure.
  2. Do vyhledávacího pole portálu zadejte služby Kubernetes a pak vyberte služby Kubernetes.
  3. Vyberte předplatné, které obsahuje vaše clustery AKS. Seznam můžete také filtrovat podle skupiny prostředků, umístění nebo jiných dostupných vlastností.
  4. Výběrem názvu clusteru otevřete stránku Přehled a zobrazte její konfiguraci.

Na stránce clusteru vyberte Připojit a získejte pokyny k připojení. Pokud chcete zobrazit prostředky ve spuštěném clusteru, vyberte prostředky Kubernetes. Potřebujete oprávnění pro cluster AKS, rozhraní API Kubernetes a objekty Kubernetes. Další informace najdete v tématu Přístup k prostředkům Kubernetes pomocí portálu Azure.

Portál zobrazí seznam a otevře clustery. Pokud chcete určit stav napájení clusterů konzistentně v rámci předplatného, použijte Azure CLI nebo metodu ROZHRANÍ REST API v tomto článku a zkontrolujte powerState.code.

Výpis clusterů AKS pomocí Azure CLI

  1. Přihlaste se k Azure.

    az login

  2. Pokud máte přístup k více předplatným, nastavte předplatné, které obsahuje clustery AKS.

    az account set --subscription <subscription-id>

  3. Zobrazí seznam clusterů AKS ve vybraném předplatném. Následující příkaz zobrazí název každého clusteru, skupinu prostředků, umístění, stav napájení a stav zřizování:

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

    Výstup vypadá podobně jako v následujícím příkladu:

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

    Pokud chcete zobrazit seznam clusterů v konkrétní skupině prostředků, přidejte --resource-group parametr.

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

  4. Pokud chcete zobrazit seznam pouze spuštěných clusterů, vyfiltrujte ho powerState.code.

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

Další informace o příkazu a jeho možnostech výstupu najdete v referenčních informacích az aks list .

Výpis clusterů AKS pomocí rozhraní REST API

K získání clusterů AKS v předplatném použijte operaci Výpis. Odešlete následující požadavek a nahraďte <subscription-id> ho ID Azure předplatného:

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

Odpověď obsahuje value pole prostředků clusteru AKS. Pokud properties.powerState.code je k dispozici, jeho hodnota označuje, zda je Running cluster nebo Stopped. Pokud powerState chybí nebo je null, zacházejte se stavem napájení clusteru jako neznámý, neodvozujte ho z provisioningState. Pokud odpověď obsahuje nextLink, odešlete na tuto adresu URL požadavek GET, který načte další stránku výsledků.

Important

Azure zpřístupňuje prostředky clusteru Kubernetes pro více služeb. Operace Azure Operator Nexus Network Cloud používá Microsoft.NetworkCloud/kubernetesClusters typ prostředku a nevypisuje clustery AKS. Pokud chcete zobrazit seznam clusterů AKS, použijte Microsoft.ContainerService/managedClusters operaci uvedenou v tomto článku.

Další kroky

  • Poslední aktualizace v