Enumeración de clústeres de Azure Kubernetes Service (AKS) en ejecución en una suscripción de Azure

Puede enumerar Azure Kubernetes Service (AKS) clústeres de una suscripción mediante el portal de Azure, CLI de Azure o la API REST de AKS. Use CLI de Azure o los resultados de la API REST para identificar qué clústeres se ejecutan.

Antes de empezar

Descripción de los estados del clúster de AKS

Los detalles del clúster de AKS incluyen un estado de energía y un estado de aprovisionamiento:

  • La powerState.code propiedad indica si el clúster es Running o Stopped.
  • La provisioningState propiedad indica el estado de la operación de recurso de Azure más reciente, como Succeeded, Creating, Startingo Stopping.

Para determinar si un clúster se está ejecutando actualmente, use powerState.code. Un provisioningState valor de Succeeded no indica si el clúster se está ejecutando porque un clúster detenido también puede tener un estado de aprovisionamiento correcto.

Enumeración de clústeres de AKS en el portal de Azure

  1. Inicie sesión en el portal de Azure.
  2. En el cuadro de búsqueda del portal, escriba Servicios de Kubernetes y, a continuación, seleccione Servicios de Kubernetes.
  3. Seleccione la suscripción que contiene los clústeres de AKS. También puede filtrar la lista por grupo de recursos, ubicación u otras propiedades disponibles.
  4. Seleccione un nombre de clúster para abrir su página Información general y ver su configuración.

En la página del clúster, seleccione Conectar para obtener instrucciones de conexión. Para ver los recursos de un clúster en ejecución, seleccione Recursos de Kubernetes. Necesita permisos para el clúster de AKS, la API de Kubernetes y los objetos de Kubernetes. Para más información, consulte Acceso a los recursos de Kubernetes mediante el portal de Azure.

El procedimiento del portal enumera y abre clústeres. Para determinar el estado de energía de los clústeres de forma coherente en una suscripción, use el método de API de REST o CLI de Azure en este artículo y compruebe powerState.code.

Enumeración de clústeres de AKS mediante CLI de Azure

  1. Inicie sesión en Azure.

    az login

  2. Si tiene acceso a varias suscripciones, establezca la suscripción que contiene los clústeres de AKS.

    az account set --subscription <subscription-id>

  3. Enumere los clústeres de AKS en la suscripción seleccionada. El comando siguiente muestra el nombre, el grupo de recursos, la ubicación, el estado de energía y el estado de aprovisionamiento de cada clúster:

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

    La salida se parece a la del ejemplo siguiente:

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

    Para enumerar los clústeres de un grupo de recursos específico, agregue el --resource-group parámetro .

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

  4. Para enumerar solo los clústeres en ejecución, filtre por powerState.code.

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

Para obtener más información sobre el comando y sus opciones de salida, consulte la az aks list referencia.

Enumeración de clústeres de AKS mediante la API REST

Use la operación Clústeres administrados: lista para obtener clústeres de AKS en una suscripción. Envíe la solicitud siguiente y reemplace <subscription-id> por el identificador de suscripción de Azure:

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

La respuesta contiene una value matriz de recursos de clúster de AKS. Cuando properties.powerState.code está presente, su valor indica si el clúster es Running o Stopped. Si powerState falta o es null, trate el estado de energía del clúster como desconocido; no lo infiere de provisioningState. Si la respuesta incluye nextLink, envíe una solicitud GET a esa dirección URL para recuperar la siguiente página de resultados.

Importante

Azure expone recursos de clúster de Kubernetes para varios servicios. La operación Azure Operator Nexus Network Cloud usa el Microsoft.NetworkCloud/kubernetesClusters tipo de recurso y no enumera los clústeres de AKS. Para enumerar los clústeres de AKS, use la Microsoft.ContainerService/managedClusters operación que se muestra en este artículo.

Pasos siguientes

  • Se actualizó por última vez el