Azure 구독에서 실행 중인 AKS(Azure Kubernetes Service) 클러스터 나열

Azure 포털, Azure CLI 또는 AKS REST API를 사용하여 구독의 AKS(Azure Kubernetes Service) 클러스터를 나열할 수 있습니다. Azure CLI 또는 REST API 결과를 사용하여 실행 중인 클러스터를 식별합니다.

시작하기 전 주의 사항:

AKS 클러스터 상태 이해

AKS 클러스터 세부 정보에는 전원 상태와 프로비전 상태가 모두 포함됩니다.

  • 이 속성은 powerState.code 클러스터 RunningStopped가 있는지 여부를 나타냅니다.
  • 속성은 provisioningState 최신 Azure 리소스 작업의 상태를 나타냅니다(예: Succeeded, Creating또는 StartingStopping.

클러스터가 현재 실행 중인지 확인하려면 .를 사용합니다 powerState.code. Succeeded 값은 provisioningState 중지된 클러스터가 성공적인 프로비전 상태를 가질 수 있기 때문에 클러스터가 실행 중인지 여부를 나타내지 않습니다.

Azure 포털에서 AKS 클러스터 나열

  1. Azure Portal에 로그인합니다.
  2. 포털 검색 상자에 Kubernetes 서비스를 입력한 다음 , 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 클러스터를 가져옵니다. Azure 구독 ID로 바꿔 <subscription-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 해당 값은 클러스터 RunningStopped가 있는지 여부를 나타냅니다. 누락되거나 null인 경우 powerState 클러스터의 전원 상태를 알 수 없음으로 처리합니다. 유추 provisioningState하지 마세요. 응답에 포함된 nextLink경우 해당 URL에 GET 요청을 보내 결과의 다음 페이지를 검색합니다.

Important

Azure 여러 서비스에 대한 Kubernetes 클러스터 리소스를 노출합니다. Azure Operator Nexus 네트워크 클라우드 작업은 리소스 유형을 사용 Microsoft.NetworkCloud/kubernetesClusters 하며 AKS 클러스터를 나열하지 않습니다. AKS 클러스터를 나열하려면 이 문서에 표시된 작업을 사용합니다 Microsoft.ContainerService/managedClusters .

다음 단계

  • 에 마지막으로 업데이트됨