Azure サブスクリプションで実行中Azure Kubernetes Service (AKS)クラスターを一覧表示する

Azure ポータル、Azure CLI、または AKS REST API を使用して、サブスクリプション内Azure Kubernetes Service (AKS)クラスターを一覧表示できます。 Azure CLIまたは REST API の結果を使用して、実行されているクラスターを識別します。

始める前の準備

AKS クラスターの状態について

AKS クラスターの詳細には、電源状態とプロビジョニング状態の両方が含まれます。

  • powerState.code プロパティは、クラスターがRunningかStoppedかを示します。
  • provisioningState プロパティは、Succeeded、Creating、Starting、Stoppingなど、最新のAzure リソース操作の状態を示します。

クラスターが現在実行されているかどうかを確認するには、 powerState.codeを使用します。 SucceededのprovisioningState値は、停止したクラスターでもプロビジョニング状態が成功する可能性があるため、クラスターが実行されているかどうかを示しません。

Azure ポータルで AKS クラスターを一覧表示する

  1. Azure Portal にサインインします。
  2. ポータルの検索ボックスに「 Kubernetes services」と入力し、 Kubernetes サービスを選択します。
  3. AKS クラスターを含むサブスクリプションを選択します。 リソース グループ、場所、またはその他の使用可能なプロパティで一覧をフィルター処理することもできます。
  4. クラスター名を選択して 概要 ページを開き、その構成を表示します。

クラスター ページで、[ 接続 ] を選択して接続手順を取得します。 実行中のクラスター内のリソースを表示するには、 Kubernetes リソースを選択します。 AKS クラスター、Kubernetes API、および Kubernetes オブジェクトのアクセス許可が必要です。 詳細については、「Azure ポータルを使用して Kubernetes リソースにアクセスする」を参照してください。

ポータル の手順では、クラスターの一覧が表示され、開きます。 サブスクリプション全体でクラスターの電源状態を一貫して判断するには、この記事のAzure CLIまたは REST API メソッドを使用して、powerState.code確認します。

Azure CLIを使用して AKS クラスターを一覧表示する

  1. Azure にサインインします。

    az login

  2. 複数のサブスクリプションにアクセスできる場合は、AKS クラスターを含むサブスクリプションを設定します。

    az account set --subscription <subscription-id>

  3. 選択したサブスクリプションの AKS クラスターを一覧表示します。 次のコマンドは、各クラスターの名前、リソース グループ、場所、電源状態、プロビジョニング状態を表示します。

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

    出力は次の例のようになります。

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

    特定のリソース グループ内のクラスターを一覧表示するには、 --resource-group パラメーターを追加します。

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

  4. 実行中のクラスターのみを一覧表示するには、 powerState.codeでフィルター処理します。

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

コマンドとその出力オプションの詳細については、 az aks list リファレンスを参照してください。

REST API を使用して AKS クラスターを一覧表示する

マネージド クラスター - 一覧表示操作を使用して、サブスクリプション内の AKS クラスターを取得します。 <subscription-id>を Azure サブスクリプション ID に置き換えて、次の要求を送信します。

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

応答には、AKS クラスター リソースの value 配列が含まれています。 properties.powerState.codeが存在する場合、その値はクラスターがRunningかStoppedかを示します。 powerStateが見つからないか null の場合は、クラスターの電源状態を不明として扱います。provisioningStateから推測しないでください。 応答に nextLinkが含まれている場合は、その URL に GET 要求を送信して、結果の次のページを取得します。

Important

Azureは、複数のサービスの Kubernetes クラスター リソースを公開します。 Azure Operator Nexus ネットワーク クラウド操作では、Microsoft.NetworkCloud/kubernetesClusters リソースの種類が使用され、AKS クラスターは一覧表示されません。 AKS クラスターを一覧表示するには、この記事に示す Microsoft.ContainerService/managedClusters 操作を使用します。

次のステップ

  • 最終更新: