Agent Pools - Get

Servicio:: AKS

Versión de la API:: 2025-10-01

Obtiene el grupo de agentes de clúster administrado especificado.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}?api-version=2025-10-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	Nombre del grupo de agentes.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
resourceName	path	True	string minLength: 1 maxLength: 63 pattern: ^[a-zA-Z0-9]$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$	El nombre del recurso de clúster administrado.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de API que se usará para esta operación.

Respuestas

Nombre	Tipo	Description
200 OK	AgentPool	OK
Other Status Codes	ErrorResponse	Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

Get Agent Pool

Solicitud de ejemplo

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2025-10-01

from azure.identity import DefaultAzureCredential

from azure.mgmt.containerservice import ContainerServiceClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-containerservice
# USAGE
    python agent_pools_get.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ContainerServiceClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.agent_pools.get(
        resource_group_name="rg1",
        resource_name="clustername1",
        agent_pool_name="agentpool1",
    )
    print(response)


# x-ms-original-file: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-10-01/examples/AgentPoolsGet.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armcontainerservice_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/containerservice/armcontainerservice/v8"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/9cc7633f842575274f715cc02e37c5769ac2742d/specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-10-01/examples/AgentPoolsGet.json
func ExampleAgentPoolsClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcontainerservice.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewAgentPoolsClient().Get(ctx, "rg1", "clustername1", "agentpool1", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.AgentPool = armcontainerservice.AgentPool{
	// 	Name: to.Ptr("agentpool1"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1"),
	// 	Properties: &armcontainerservice.ManagedClusterAgentPoolProfileProperties{
	// 		Count: to.Ptr[int32](3),
	// 		CurrentOrchestratorVersion: to.Ptr("1.9.6"),
	// 		ETag: to.Ptr("ebwiyfneowv"),
	// 		MaxPods: to.Ptr[int32](110),
	// 		NodeImageVersion: to.Ptr("AKSUbuntu:1604:2020.03.11"),
	// 		OrchestratorVersion: to.Ptr("1.9.6"),
	// 		OSType: to.Ptr(armcontainerservice.OSTypeLinux),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		UpgradeSettings: &armcontainerservice.AgentPoolUpgradeSettings{
	// 			MaxSurge: to.Ptr("33%"),
	// 		},
	// 		VMSize: to.Ptr("Standard_DS1_v2"),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.ContainerService.Models;
using Azure.ResourceManager.ContainerService;

// Generated from example definition: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-10-01/examples/AgentPoolsGet.json
// this example is just showing the usage of "AgentPools_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ContainerServiceAgentPoolResource created on azure
// for more information of creating ContainerServiceAgentPoolResource, please refer to the document of ContainerServiceAgentPoolResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "rg1";
string resourceName = "clustername1";
string agentPoolName = "agentpool1";
ResourceIdentifier containerServiceAgentPoolResourceId = ContainerServiceAgentPoolResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, resourceName, agentPoolName);
ContainerServiceAgentPoolResource containerServiceAgentPool = client.GetContainerServiceAgentPoolResource(containerServiceAgentPoolResourceId);

// invoke the operation
ContainerServiceAgentPoolResource result = await containerServiceAgentPool.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ContainerServiceAgentPoolData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "eTag": "ebwiyfneowv",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
    "upgradeSettings": {
      "maxSurge": "33%"
    }
  }
}

Definiciones

Nombre	Description
AgentPool	Grupo de agentes.
AgentPoolGatewayProfile	Perfil del grupo de agentes de puerta de enlace de clúster administrado.
AgentPoolMode	Modo de un grupo de agentes. Un clúster debe tener al menos un grupo de agentes "System" en todo momento. Para más información sobre las restricciones del grupo de agentes y los procedimientos recomendados, consulte: https://docs.microsoft.com/azure/aks/use-system-pools
AgentPoolNetworkProfile	Configuración de red de un grupo de agentes.
AgentPoolSecurityProfile	Configuración de seguridad de un grupo de agentes.
AgentPoolSSHAccess	Método de acceso SSH de un grupo de agentes.
AgentPoolStatus	Contiene información de solo lectura sobre el grupo de agentes.
AgentPoolType	Tipo de grupo de agentes.
AgentPoolUpgradeSettings	Configuración para actualizar un grupo de agentes
AgentPoolWindowsProfile	Perfil específico del grupo de agentes de Windows.
code	Indica si el clúster está en ejecución o detenido.
CreationData	Datos usados al crear un recurso de destino a partir de un recurso de origen.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
GPUDriver	Si se van a instalar controladores de GPU. Cuando no se especifica, el valor predeterminado es Instalar.
GPUInstanceProfile	GPUInstanceProfile que se usará para especificar el perfil de instancia de MIG de GPU para la SKU de máquina virtual de GPU compatible.
GPUProfile	Configuración de GPU para el grupo de agentes.
IPTag	Contiene el IPTag asociado al objeto .
KubeletConfig	Configuraciones de Kubelet de nodos de agente. Consulte configuración de nodos personalizados de AKS para obtener más información.
KubeletDiskType	Determina la ubicación de volúmenes emptyDir, raíz de datos del entorno de ejecución del contenedor y almacenamiento efímero de Kubelet.
LinuxOSConfig	Configuraciones del sistema operativo de los nodos del agente de Linux. Consulte configuración de nodos personalizados de AKS para obtener más información.
LocalDNSForwardDestination	Servidor de destino para las consultas DNS que se van a reenviar desde localDNS.
LocalDNSForwardPolicy	Política de reenvío para seleccionar el servidor DNS ascendente. Consulte el complemento de reenvío para obtener más información.
LocalDNSMode	Modo de habilitación para localDNS.
LocalDNSOverride	Invalidaciones para el perfil localDNS.
LocalDNSProfile	Configura el DNS local por nodo, con invalidaciones de VnetDNS y KubeDNS. LocalDNS ayuda a mejorar el rendimiento y la confiabilidad de la resolución DNS en un clúster de AKS. Para obtener más información, consulte aka.ms/aks/localdns.
LocalDNSProtocol	Aplique TCP o prefiera el protocolo UDP para las conexiones desde localDNS al servidor DNS ascendente.
LocalDNSQueryLogging	Nivel de registro para consultas DNS en localDNS.
LocalDNSServeStale	Política para servir datos obsoletos. Consulte el complemento de caché para obtener más información.
LocalDNSState	Estado generado por el sistema de localDNS.
ManualScaleProfile	Especificaciones sobre el número de máquinas.
OSDiskType	Tipo de disco del sistema operativo que se va a usar para las máquinas del grupo de agentes. El valor predeterminado es "Efímero" si la máquina virtual la admite y tiene un disco de caché mayor que el OSDiskSizeGB solicitado. De lo contrario, el valor predeterminado es "Administrado". Es posible que no se cambie después de la creación. Para obtener más información, consulte del sistema operativo efímero.
OSSKU	Especifica la SKU del sistema operativo utilizada por el grupo de agentes. El valor predeterminado es Ubuntu si OSType es Linux. El valor predeterminado es Windows2019 cuando Kubernetes <= 1.24 o Windows2022 cuando Kubernetes >= 1.25 si OSType es Windows.
OSType	Tipo de sistema operativo. El valor predeterminado es Linux.
PodIPAllocationMode	Modo de asignación de IP de pod. Modo de asignación de IP para pods del grupo de agentes. Debe usarse con podSubnetId. El valor predeterminado es "DynamicIndividual".
PortRange	Intervalo de puertos.
PowerState	Describe el estado de energía del clúster.
Protocol	Protocolo de red del puerto.
ScaleDownMode	Describe cómo se agregan o eliminan las máquinas virtuales de los grupos de agentes. Consulte los estados de facturación.
ScaleProfile	Especificaciones sobre cómo escalar un grupo de agentes de VirtualMachines.
ScaleSetEvictionPolicy	Directiva de expulsión del conjunto de escalado de máquinas virtuales. La directiva de expulsión especifica qué hacer con la máquina virtual cuando se expulsa. El valor predeterminado es Eliminar. Para obtener más información sobre la expulsión, consulte Máquinas virtuales de acceso puntual
ScaleSetPriority	Prioridad del conjunto de escalado de máquinas virtuales.
SysctlConfig	Configuración de Sysctl para los nodos del agente de Linux.
UndrainableNodeBehavior	Define el comportamiento de los nodos no detectables durante la actualización. La causa más común de los nodos que no se pueden detectar es presupuestos de interrupciones de pods (PDB), pero otros problemas, como el período de gracia de terminación del pod supera el tiempo de espera de purga por nodo restante o el pod sigue estando en estado de ejecución, también puede provocar nodos que no se pueden detectar.
VirtualMachineNodes	Estado actual en un grupo de nodos del mismo tamaño de máquina virtual.
VirtualMachinesProfile	Especificaciones del grupo de agentes de VirtualMachines.
WorkloadRuntime	Determina el tipo de carga de trabajo que puede ejecutar un nodo.

AgentPool

Objeto

Grupo de agentes.

Nombre	Tipo	Valor predeterminado	Description
id	string		Identificador de recurso.
name	string		Nombre del recurso que es único dentro de un grupo de recursos. Este nombre se puede usar para acceder al recurso.
properties.availabilityZones	string[]		Lista de zonas de disponibilidad que se van a usar para los nodos. Esto solo se puede especificar si la propiedad AgentPoolType es "VirtualMachineScaleSets".
properties.capacityReservationGroupID	string (arm-id)		AKS asociará el grupo de agentes especificado al grupo de reserva de capacidad.
properties.count	integer (int32)		Número de agentes (VM) para hospedar contenedores de Docker. Los valores permitidos deben estar comprendidos entre 0 y 1000 (ambos incluidos) para los grupos de usuarios y en el intervalo de 1 a 1000 (ambos incluidos) para los grupos del sistema. El valor predeterminado es 1.
properties.creationData	CreationData		CreationData que se usará para especificar el identificador de instantánea de origen si el grupo de nodos se creará o actualizará mediante una instantánea.
properties.currentOrchestratorVersion	string		La versión de Kubernetes que ejecuta el grupo de agentes. Si orchestratorVersion es una versión totalmente especificada <major.minor.patch>, este campo será exactamente igual a él. Si orchestratorVersion es <major.minor>, este campo contendrá el <principal.minor.patch> versión que se está usando.
properties.eTag	string		Cadena de solo lectura única que se usa para implementar la simultaneidad optimista. El valor de eTag cambiará cuando se actualice el recurso. Especifique un encabezado if-match o if-none-match con el valor de eTag para una solicitud posterior para habilitar la simultaneidad optimista según la convención normal de eTag.
properties.enableAutoScaling	boolean		Si se va a habilitar el escalador automático
properties.enableEncryptionAtHost	boolean		Si se va a habilitar el cifrado del sistema operativo y la unidad de datos basados en host. Esto solo se admite en determinados tamaños de máquina virtual y en determinadas regiones de Azure. Para obtener más información, consulte: https://docs.microsoft.com/azure/aks/enable-host-encryption
properties.enableFIPS	boolean		Si se usa un sistema operativo habilitado para FIPS. Consulte Agregar un grupo de nodos habilitado para FIPS para obtener más información.
properties.enableNodePublicIP	boolean		Si cada nodo tiene asignada su propia dirección IP pública. Algunos escenarios pueden requerir que los nodos de un grupo de nodos reciban sus propias direcciones IP públicas dedicadas. Un escenario común es para las cargas de trabajo de juegos, donde una consola debe realizar una conexión directa a una máquina virtual en la nube para minimizar los saltos. Para obtener más información, consulte asignación de una dirección IP pública por nodo. El valor predeterminado es false.
properties.enableUltraSSD	boolean		Si se va a habilitar UltraSSD
properties.gatewayProfile	AgentPoolGatewayProfile		Generar perfiles específicos de un grupo de agentes administrados en modo de puerta de enlace. Este campo no se puede establecer si el modo de grupo de agentes no es puerta de enlace.
properties.gpuInstanceProfile	GPUInstanceProfile		GPUInstanceProfile que se usará para especificar el perfil de instancia de MIG de GPU para la SKU de máquina virtual de GPU compatible.
properties.gpuProfile	GPUProfile		Configuración de GPU para el grupo de agentes.
properties.hostGroupID	string (arm-id)		El identificador de recurso completo del grupo host dedicado desde el que aprovisionar máquinas virtuales, que solo se usa en el escenario de creación y no se permite cambiar una vez establecido. Este es el formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Para más información, consulte hosts dedicados de Azure.
properties.kubeletConfig	KubeletConfig		Configuración de Kubelet en los nodos del grupo de agentes.
properties.kubeletDiskType	KubeletDiskType		Determina la ubicación de volúmenes emptyDir, raíz de datos del entorno de ejecución del contenedor y almacenamiento efímero de Kubelet.
properties.linuxOSConfig	LinuxOSConfig		Configuración del sistema operativo de los nodos del agente de Linux.
properties.localDNSProfile	LocalDNSProfile		Configura el DNS local por nodo, con invalidaciones de VnetDNS y KubeDNS. LocalDNS ayuda a mejorar el rendimiento y la confiabilidad de la resolución DNS en un clúster de AKS. Para obtener más información, consulte aka.ms/aks/localdns.
properties.maxCount	integer (int32)		Número máximo de nodos para el escalado automático
properties.maxPods	integer (int32)		Número máximo de pods que se pueden ejecutar en un nodo.
properties.messageOfTheDay	string		Mensaje del día para los nodos de Linux, codificados en base64. Cadena codificada en base64 que se escribirá en /etc/motd después de la descodificación. Esto permite personalizar el mensaje del día para los nodos de Linux. No se debe especificar para los nodos de Windows. Debe ser una cadena estática (es decir, se imprimirá sin procesar y no se ejecutará como un script).
properties.minCount	integer (int32)		El número mínimo de nodos para el escalado automático
properties.mode	AgentPoolMode		Modo de un grupo de agentes. Un clúster debe tener al menos un grupo de agentes "System" en todo momento. Para más información sobre las restricciones del grupo de agentes y los procedimientos recomendados, consulte: https://docs.microsoft.com/azure/aks/use-system-pools
properties.networkProfile	AgentPoolNetworkProfile		Configuración relacionada con la red de un grupo de agentes.
properties.nodeImageVersion	string		La versión de la imagen de nodo
properties.nodeLabels	object		Las etiquetas de nodo que se conservarán en todos los nodos del grupo de agentes.
properties.nodePublicIPPrefixID	string (arm-id)		Identificador de prefijo de DIRECCIÓN IP pública desde el que los nodos de máquina virtual deben usar direcciones IP. Este es el formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
properties.nodeTaints	string[]		Los taints agregados a los nuevos nodos durante la creación y escala del grupo de nodos. Por ejemplo, key=value:NoSchedule.
properties.orchestratorVersion	string		Versión de Kubernetes especificada por el usuario. Ambas versiones de revisión <principal.minor.patch> (por ejemplo, 1.20.13) y <> principal.secundaria (por ejemplo, 1.20) se admiten. Cuando se especifica <major.minor>, se elige automáticamente la versión de revisión de disponibilidad general compatible más reciente. La actualización del clúster con la misma <principal.secundaria> una vez creado (por ejemplo, 1.14.x:> 1.14) no desencadenará una actualización, incluso si hay disponible una versión de revisión más reciente. Como procedimiento recomendado, debe actualizar todos los grupos de nodos de un clúster de AKS a la misma versión de Kubernetes. La versión del grupo de nodos debe tener la misma versión principal que el plano de control. La versión secundaria del grupo de nodos debe estar dentro de dos versiones secundarias de la versión del plano de control. La versión del grupo de nodos no puede ser mayor que la versión del plano de control. Para obtener más información, consulte actualizar un grupo de nodos.
properties.osDiskSizeGB	integer (int32) minimum: 0 maximum: 2048		Tamaño del disco del sistema operativo en GB que se va a usar para especificar el tamaño del disco para cada máquina del grupo de servidores maestros o agentes. Si especifica 0, se aplicará el tamaño predeterminado de osDisk según el valor de vmSize especificado.
properties.osDiskType	OSDiskType		Tipo de disco del sistema operativo que se va a usar para las máquinas del grupo de agentes. El valor predeterminado es "Efímero" si la máquina virtual la admite y tiene un disco de caché mayor que el OSDiskSizeGB solicitado. De lo contrario, el valor predeterminado es "Administrado". Es posible que no se cambie después de la creación. Para obtener más información, consulte del sistema operativo efímero.
properties.osSKU	OSSKU		Especifica la SKU del sistema operativo utilizada por el grupo de agentes. El valor predeterminado es Ubuntu si OSType es Linux. El valor predeterminado es Windows2019 cuando Kubernetes <= 1.24 o Windows2022 cuando Kubernetes >= 1.25 si OSType es Windows.
properties.osType	OSType	Linux	Tipo de sistema operativo. El valor predeterminado es Linux.
properties.podIPAllocationMode	PodIPAllocationMode		Modo de asignación de IP de pod. Modo de asignación de IP para pods del grupo de agentes. Debe usarse con podSubnetId. El valor predeterminado es "DynamicIndividual".
properties.podSubnetID	string (arm-id)		El identificador de la subred que se unirá a los pods cuando se inicie. Si se omite, las direcciones IP de pod se asignan estáticamente en la subred del nodo (consulte vnetSubnetID para obtener más detalles). Este es el formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.powerState	PowerState		Indica si el grupo de agentes se está ejecutando o detenido. Cuando se crea por primera vez un grupo de agentes, se ejecuta inicialmente. El grupo de agentes se puede detener estableciendo este campo en Detenido. Un grupo de agentes detenido detiene todas sus máquinas virtuales y no acumula cargos de facturación. Un grupo de agentes solo se puede detener si se está ejecutando y el estado de aprovisionamiento es Correcto
properties.provisioningState	string		Estado actual de implementación o aprovisionamiento.
properties.proximityPlacementGroupID	string (arm-id)		Identificador del grupo de selección de ubicación de proximidad.
properties.scaleDownMode	ScaleDownMode		Modo de reducción vertical que se usará al escalar el grupo de agentes. Esto también afecta al comportamiento del escalador automático del clúster. Si no se especifica, el valor predeterminado es Eliminar.
properties.scaleSetEvictionPolicy	ScaleSetEvictionPolicy	Delete	Directiva de expulsión del conjunto de escalado de máquinas virtuales que se va a usar. No se puede especificar a menos que scaleSetPriority sea "Spot". Si no se especifica, el valor predeterminado es "Delete".
properties.scaleSetPriority	ScaleSetPriority	Regular	Prioridad del conjunto de escalado de máquinas virtuales. Si no se especifica, el valor predeterminado es "Regular".
properties.securityProfile	AgentPoolSecurityProfile		Configuración de seguridad de un grupo de agentes.
properties.spotMaxPrice	number	-1	El precio máximo (en dólares estadounidenses) que está dispuesto a pagar por las instancias de spot. Los valores posibles son cualquier valor decimal mayor que cero o -1 que indica que el precio predeterminado debe ser up-to a petición. Los valores posibles son cualquier valor decimal mayor que cero o -1 que indica la voluntad de pagar cualquier precio a petición. Para más información sobre los precios puntuales, consulte precios de las máquinas virtuales de acceso puntual
properties.status	AgentPoolStatus		Contiene información de solo lectura sobre el grupo de agentes.
properties.tags	object		Etiquetas que se van a conservar en el conjunto de escalado de máquinas virtuales del grupo de agentes.
properties.type	AgentPoolType		Tipo de grupo de agentes.
properties.upgradeSettings	AgentPoolUpgradeSettings		Configuración para actualizar el grupo de agentes
properties.virtualMachineNodesStatus	VirtualMachineNodes[]		Estado de los nodos de un grupo de agentes de VirtualMachines.
properties.virtualMachinesProfile	VirtualMachinesProfile		Especificaciones del grupo de agentes de VirtualMachines.
properties.vmSize	string		Tamaño de las máquinas virtuales del grupo de agentes. La disponibilidad del tamaño de máquina virtual varía según la región. Si un nodo contiene recursos de proceso insuficientes (memoria, cpu, etc.) podría no ejecutarse correctamente. Para más información sobre los tamaños de máquina virtual restringidos, consulte: https://docs.microsoft.com/azure/aks/quotas-skus-regions
properties.vnetSubnetID	string (arm-id)		Identificador de la subred a la que se unirán los nodos del grupo de agentes y, opcionalmente, los pods se unirán al inicio. Si no se especifica, se generará y usará una red virtual y una subred. Si no se especifica ningún podSubnetID, esto se aplica a nodos y pods; de lo contrario, se aplica solo a los nodos. Este es el formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.windowsProfile	AgentPoolWindowsProfile		Perfil específico del grupo de agentes de Windows.
properties.workloadRuntime	WorkloadRuntime		Determina el tipo de carga de trabajo que puede ejecutar un nodo.
type	string		Tipo de recurso

AgentPoolGatewayProfile

Objeto

Perfil del grupo de agentes de puerta de enlace de clúster administrado.

Nombre	Tipo	Valor predeterminado	Description
publicIPPrefixSize	integer (int32) minimum: 28 maximum: 31	31	El grupo de agentes de puerta de enlace asocia un IPPrefix público para cada puerta de enlace de salida estática para proporcionar salida pública. El usuario debe seleccionar el tamaño de IPPrefix público. Cada nodo del grupo de agentes se asigna con una dirección IP del IPPrefix. El tamaño de IPPrefix actúa como límite en el tamaño del grupo de agentes de puerta de enlace. Debido a la limitación de tamaño de IPPrefix pública de Azure, el intervalo de valores válido es [28, 31] (/31 = 2 nodos/IP, /30 = 4 nodos/IP, /29 = 8 nodos/IP, /28 = 16 nodos/IP). El valor predeterminado es 31.

AgentPoolMode

Enumeración

Modo de un grupo de agentes. Un clúster debe tener al menos un grupo de agentes "System" en todo momento. Para más información sobre las restricciones del grupo de agentes y los procedimientos recomendados, consulte: https://docs.microsoft.com/azure/aks/use-system-pools

Valor	Description
System	Los grupos de agentes del sistema son principalmente para alojar pods críticos del sistema, como CoreDNS y metrics-server. Los grupos de agentes del sistema osType deben ser Linux. La SKU de máquina virtual de grupos de agentes del sistema debe tener al menos 2vCPU y 4 GB de memoria.
User	Los grupos de agentes de usuario son principalmente para alojar los pods de la aplicación.
Gateway	Los grupos de agentes de puerta de enlace se dedican a proporcionar direcciones IP de salida estáticas a los pods. Para obtener más información, vea https://aka.ms/aks/static-egress-gateway.

AgentPoolNetworkProfile

Objeto

Configuración de red de un grupo de agentes.

Nombre	Tipo	Description
allowedHostPorts	PortRange[]	Intervalos de puertos a los que se puede acceder. Los intervalos especificados pueden superponerse.
applicationSecurityGroups	string[] (arm-id)	Identificadores de los grupos de seguridad de aplicaciones que asociará el grupo de agentes cuando se cree.
nodePublicIPTags	IPTag[]	IPTags de direcciones IP públicas de nivel de instancia.

AgentPoolSecurityProfile

Objeto

Configuración de seguridad de un grupo de agentes.

Nombre	Tipo	Description
enableSecureBoot	boolean	El arranque seguro es una característica de inicio seguro que garantiza que solo los sistemas operativos y controladores firmados puedan arrancar. Para obtener más información, consulte aka.ms/aks/trustedlaunch. Si no se especifica, el valor predeterminado es false.
enableVTPM	boolean	vTPM es una característica de inicio seguro para configurar un almacén seguro dedicado para claves y medidas que se mantienen localmente en el nodo. Para obtener más información, consulte aka.ms/aks/trustedlaunch. Si no se especifica, el valor predeterminado es false.
sshAccess	AgentPoolSSHAccess	Método de acceso SSH de un grupo de agentes.

AgentPoolSSHAccess

Enumeración

Método de acceso SSH de un grupo de agentes.

Valor	Description
LocalUser	Puede conectarse mediante SSH al nodo como un usuario local mediante la clave privada.
Disabled	El servicio SSH se desactivará en el nodo.

AgentPoolStatus

Objeto

Contiene información de solo lectura sobre el grupo de agentes.

Nombre	Tipo	Description
provisioningError	ErrorDetail	La información detallada del error del grupo de agentes. Conserva la información detallada del error. Si no hubo ningún error, se omite este campo.

AgentPoolType

Enumeración

Tipo de grupo de agentes.

Valor	Description
VirtualMachineScaleSets	Cree un grupo de agentes respaldado por un conjunto de escalado de máquinas virtuales.
AvailabilitySet	Se desaconseja encarecidamente su uso.
VirtualMachines	Cree un grupo de agentes respaldado por un modo de orquestación de máquina virtual de instancia única.

AgentPoolUpgradeSettings

Objeto

Configuración para actualizar un grupo de agentes

Nombre	Tipo	Description
drainTimeoutInMinutes	integer (int32) minimum: 1 maximum: 1440	El tiempo de espera de drenaje de un nodo. Cantidad de tiempo (en minutos) que se espera a la expulsión de pods y terminación correcta por nodo. Este tiempo de espera de expulsión respeta la espera de los presupuestos de interrupciones del pod. Si se supera este tiempo, se produce un error en la actualización. Si no se especifica, el valor predeterminado es de 30 minutos.
maxSurge	string	Número máximo o porcentaje de nodos que se sobrecargan durante la actualización. Esto puede establecerse en un entero (por ejemplo, "5") o en un porcentaje (por ejemplo, "50%"). Si se especifica un porcentaje, es el porcentaje del tamaño total del grupo de agentes en el momento de la actualización. En porcentajes, los nodos fraccionarios se redondean hacia arriba. Si no se especifica, el valor predeterminado es 10%. Para obtener más información, incluidas las prácticas recomendadas, consulte: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster
maxUnavailable	string	Número máximo o porcentaje de nodos que pueden no estar disponibles simultáneamente durante la actualización. Esto puede establecerse en un entero (por ejemplo, "1") o en un porcentaje (por ejemplo, "5%"). Si se especifica un porcentaje, es el porcentaje del tamaño total del grupo de agentes en el momento de la actualización. En porcentajes, los nodos fraccionarios se redondean hacia arriba. Si no se especifica, el valor predeterminado es 0. Para obtener más información, incluidas las prácticas recomendadas, consulte: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster
nodeSoakDurationInMinutes	integer (int32) minimum: 0 maximum: 30	La duración de inmersión de un nodo. Cantidad de tiempo (en minutos) que se debe esperar después de purgar un nodo y antes de volver a importarlo y pasar al siguiente nodo. Si no se especifica, el valor predeterminado es 0 minutos.
undrainableNodeBehavior	UndrainableNodeBehavior	Define el comportamiento de los nodos no detectables durante la actualización. La causa más común de los nodos que no se pueden detectar es presupuestos de interrupciones de pods (PDB), pero otros problemas, como el período de gracia de terminación del pod supera el tiempo de espera de purga por nodo restante o el pod sigue estando en estado de ejecución, también puede provocar nodos que no se pueden detectar.

AgentPoolWindowsProfile

Objeto

Perfil específico del grupo de agentes de Windows.

Nombre	Tipo	Description
disableOutboundNat	boolean	Si se va a deshabilitar OutboundNAT en los nodos de Windows. El valor predeterminado es false. NAT de salida solo se puede deshabilitar si el clúster outboundType es NAT Gateway y el grupo de agentes de Windows no tiene habilitada la dirección IP pública del nodo.

code

Enumeración

Indica si el clúster está en ejecución o detenido.

Valor	Description
Running	El clúster se está ejecutando.
Stopped	El clúster se detiene.

CreationData

Objeto

Datos usados al crear un recurso de destino a partir de un recurso de origen.

Nombre	Tipo	Description
sourceResourceId	string (arm-id)	Este es el identificador de ARM del objeto de origen que se va a usar para crear el objeto de destino.

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Objeto

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Los detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

GPUDriver

Enumeración

Si se van a instalar controladores de GPU. Cuando no se especifica, el valor predeterminado es Instalar.

Valor	Description
Install	Instale el controlador.
None	Omitir la instalación del controlador.

GPUInstanceProfile

Enumeración

GPUInstanceProfile que se usará para especificar el perfil de instancia de MIG de GPU para la SKU de máquina virtual de GPU compatible.

Valor	Description
MIG1g
MIG2g
MIG3g
MIG4g
MIG7g

GPUProfile

Objeto

Configuración de GPU para el grupo de agentes.

Nombre	Tipo	Description
driver	GPUDriver	Si se van a instalar controladores de GPU. Cuando no se especifica, el valor predeterminado es Instalar.

IPTag

Objeto

Contiene el IPTag asociado al objeto .

Nombre	Tipo	Description
ipTagType	string	Tipo de etiqueta IP. Ejemplo: RoutingPreference.
tag	string	Valor de la etiqueta IP asociada a la dirección IP pública. Ejemplo: Internet.

KubeletConfig

Objeto

Configuraciones de Kubelet de nodos de agente. Consulte configuración de nodos personalizados de AKS para obtener más información.

Nombre	Tipo	Description
allowedUnsafeSysctls	string[]	Lista permitida de sysctls no seguros o patrones sysctl no seguros (que terminan en `*`).
containerLogMaxFiles	integer (int32) minimum: 2	El número máximo de archivos de registro de contenedor que pueden estar presentes para un contenedor. El número debe ser ≥ 2.
containerLogMaxSizeMB	integer (int32)	Tamaño máximo (por ejemplo, 10Mi) del archivo de registro de contenedor antes de girarlo.
cpuCfsQuota	boolean	Si la aplicación de cuota de CFS de CPU está habilitada para contenedores que especifican límites de CPU. El valor predeterminado es true.
cpuCfsQuotaPeriod	string	Valor del período de cuota cfS de CPU. El valor predeterminado es "100ms". Los valores válidos son una secuencia de números decimales con una fracción opcional y un sufijo de unidad. Por ejemplo: "300 ms", "2h45m". Las unidades admitidas son "ns", "us", "ms", "s", "m" y "h".
cpuManagerPolicy	string	Directiva del Administrador de CPU que se va a usar. El valor predeterminado es "none". Consulte Directivas de administración de CPU de Kubernetes para obtener más información. Los valores permitidos son "none" y "static".
failSwapOn	boolean	Si se establece en true, se producirá un error al iniciar Kubelet si el intercambio está habilitado en el nodo.
imageGcHighThreshold	integer (int32)	El porcentaje de uso del disco después del cual siempre se ejecuta la recolección de elementos no utilizados de imagen. Para deshabilitar la recolección de elementos no utilizados de la imagen, establezca este valor en 100. El valor predeterminado es 85%
imageGcLowThreshold	integer (int32)	El porcentaje de uso del disco antes del cual nunca se ejecuta la recolección de elementos no utilizados de imagen. Esto no se puede establecer más alto que imageGcHighThreshold. El valor predeterminado es 80%
podMaxPids	integer (int32)	Número máximo de procesos por pod.
topologyManagerPolicy	string	Directiva del Administrador de topologías que se va a usar. Para más información, consulte Administrador de topologías de Kubernetes. El valor predeterminado es "none". Los valores permitidos son "none", "best-effort", "restricted" y "single-numa-node".

KubeletDiskType

Enumeración

Determina la ubicación de volúmenes emptyDir, raíz de datos del entorno de ejecución del contenedor y almacenamiento efímero de Kubelet.

Valor	Description
OS	Kubelet usará el disco del sistema operativo para sus datos.
Temporary	Kubelet utilizará el disco temporal para sus datos.

LinuxOSConfig

Objeto

Configuraciones del sistema operativo de los nodos del agente de Linux. Consulte configuración de nodos personalizados de AKS para obtener más información.

Nombre	Tipo	Description
swapFileSizeMB	integer (int32)	Tamaño en MB de un archivo de intercambio que se creará en cada nodo.
sysctls	SysctlConfig	Configuración de Sysctl para los nodos del agente de Linux.
transparentHugePageDefrag	string	Si el kernel debe hacer un uso agresivo de la compactación de memoria para que estén disponibles más enormes páginas. Los valores válidos son "always", "defer", "defer+madvise", "madvise" y "never". El valor predeterminado es "madvise". Para obtener más información, consulte de enormes transparentes.
transparentHugePageEnabled	string	Si están habilitadas las enormes páginas transparentes. Los valores válidos son "always", "madvise" y "never". El valor predeterminado es "always". Para obtener más información, consulte de enormes transparentes.

LocalDNSForwardDestination

Enumeración

Servidor de destino para las consultas DNS que se van a reenviar desde localDNS.

Valor	Description
ClusterCoreDNS	Reenvíe las consultas DNS de localDNS al clúster CoreDNS.
VnetDNS	Reenvíe las consultas DNS de localDNS al servidor DNS configurado en la red virtual. Una red virtual puede tener varios servidores DNS configurados.

LocalDNSForwardPolicy

Enumeración

Política de reenvío para seleccionar el servidor DNS ascendente. Consulte el complemento de reenvío para obtener más información.

Valor	Description
Sequential	Implementa la selección secuencial del servidor DNS ascendente. Consulte el complemento de reenvío para obtener más información.
RoundRobin	Implementa la selección de servidor DNS ascendente round robin. Consulte el complemento de reenvío para obtener más información.
Random	Implementa la selección aleatoria del servidor DNS ascendente. Consulte el complemento de reenvío para obtener más información.

LocalDNSMode

Enumeración

Modo de habilitación para localDNS.

Valor	Description
Preferred	Si la versión actual del orquestador admite esta característica, prefiera habilitar localDNS.
Required	Habilite localDNS.
Disabled	Deshabilite localDNS.

LocalDNSOverride

Objeto

Invalidaciones para el perfil localDNS.

Nombre	Tipo	Valor predeterminado	Description
cacheDurationInSeconds	integer (int32)	3600	Caché TTL máximo en segundos. Consulte el complemento de caché para obtener más información.
forwardDestination	LocalDNSForwardDestination	ClusterCoreDNS	Servidor de destino para las consultas DNS que se van a reenviar desde localDNS.
forwardPolicy	LocalDNSForwardPolicy	Sequential	Política de reenvío para seleccionar el servidor DNS ascendente. Consulte el complemento de reenvío para obtener más información.
maxConcurrent	integer (int32)	1000	Número máximo de consultas simultáneas. Consulte el complemento de reenvío para obtener más información.
protocol	LocalDNSProtocol	PreferUDP	Aplique TCP o prefiera el protocolo UDP para las conexiones desde localDNS al servidor DNS ascendente.
queryLogging	LocalDNSQueryLogging	Error	Nivel de registro para consultas DNS en localDNS.
serveStale	LocalDNSServeStale	Immediate	Política para servir datos obsoletos. Consulte el complemento de caché para obtener más información.
serveStaleDurationInSeconds	integer (int32)	3600	Sirve la duración obsoleta en segundos. Consulte el complemento de caché para obtener más información.

LocalDNSProfile

Objeto

Configura el DNS local por nodo, con invalidaciones de VnetDNS y KubeDNS. LocalDNS ayuda a mejorar el rendimiento y la confiabilidad de la resolución DNS en un clúster de AKS. Para obtener más información, consulte aka.ms/aks/localdns.

Nombre	Tipo	Valor predeterminado	Description
kubeDNSOverrides	<string, LocalDNSOverride>		Las anulaciones de KubeDNS se aplican al tráfico DNS de pods con dnsPolicy:ClusterFirst (denominado tráfico de KubeDNS).
mode	LocalDNSMode	Preferred	Modo de habilitación para localDNS.
state	LocalDNSState		Estado generado por el sistema de localDNS.
vnetDNSOverrides	<string, LocalDNSOverride>		Las invalidaciones de VnetDNS se aplican al tráfico DNS de pods con dnsPolicy:default o kubelet (lo que se conoce como tráfico de VnetDNS).

LocalDNSProtocol

Enumeración

Aplique TCP o prefiera el protocolo UDP para las conexiones desde localDNS al servidor DNS ascendente.

Valor	Description
PreferUDP	Prefiera el protocolo UDP para las conexiones de localDNS al servidor DNS ascendente.
ForceTCP	Aplique el protocolo TCP para las conexiones de localDNS al servidor DNS ascendente.

LocalDNSQueryLogging

Enumeración

Nivel de registro para consultas DNS en localDNS.

Valor	Description
Error	Habilita el registro de errores en localDNS. Consulte el complemento de errores para obtener más información.
Log	Habilita el registro de consultas en localDNS. Consulte el complemento de registro para obtener más información.

LocalDNSServeStale

Enumeración

Política para servir datos obsoletos. Consulte el complemento de caché para obtener más información.

Valor	Description
Verify	Sirva datos obsoletos con verificación. En primer lugar, compruebe que una entrada sigue sin estar disponible en el origen antes de enviar la entrada caducada al cliente. Consulte el complemento de caché para obtener más información.
Immediate	Sirva datos obsoletos de inmediato. Envíe la entrada caducada al cliente antes de comprobar si la entrada está disponible en el origen. Consulte el complemento de caché para obtener más información.
Disable	Deshabilite la publicación de datos obsoletos.

LocalDNSState

Enumeración

Estado generado por el sistema de localDNS.

Valor	Description
Enabled	localDNS está habilitado.
Disabled	localDNS está deshabilitado.

ManualScaleProfile

Objeto

Especificaciones sobre el número de máquinas.

Nombre	Tipo	Description
count	integer (int32)	Número de nodos.
size	string	Tamaño de máquina virtual que AKS usará al crear y escalar, por ejemplo, "Standard_E4s_v3", "Standard_E16s_v3" o "Standard_D16s_v5".

OSDiskType

Enumeración

Tipo de disco del sistema operativo que se va a usar para las máquinas del grupo de agentes. El valor predeterminado es "Efímero" si la máquina virtual la admite y tiene un disco de caché mayor que el OSDiskSizeGB solicitado. De lo contrario, el valor predeterminado es "Administrado". Es posible que no se cambie después de la creación. Para obtener más información, consulte del sistema operativo efímero.

Valor	Description
Managed	Azure replica el disco del sistema operativo de una máquina virtual en Azure Storage para evitar la pérdida de datos en caso de que sea necesario reubicar la máquina virtual en otro host. Dado que los contenedores no están diseñados para conservar el estado local, este comportamiento ofrece un valor limitado al proporcionar algunos inconvenientes, incluido el aprovisionamiento de nodos más lento y una mayor latencia de lectura y escritura.
Ephemeral	Los discos de sistema operativo efímeros se almacenan solo en la máquina host, al igual que un disco temporal. Esto proporciona una menor latencia de lectura y escritura, junto con el escalado de nodos y las actualizaciones de clúster más rápidas.

Valor

Description

Managed

Azure replica el disco del sistema operativo de una máquina virtual en Azure Storage para evitar la pérdida de datos en caso de que sea necesario reubicar la máquina virtual en otro host. Dado que los contenedores no están diseñados para conservar el estado local, este comportamiento ofrece un valor limitado al proporcionar algunos inconvenientes, incluido el aprovisionamiento de nodos más lento y una mayor latencia de lectura y escritura.

Ephemeral

Los discos de sistema operativo efímeros se almacenan solo en la máquina host, al igual que un disco temporal. Esto proporciona una menor latencia de lectura y escritura, junto con el escalado de nodos y las actualizaciones de clúster más rápidas.

OSSKU

Enumeración

Especifica la SKU del sistema operativo utilizada por el grupo de agentes. El valor predeterminado es Ubuntu si OSType es Linux. El valor predeterminado es Windows2019 cuando Kubernetes <= 1.24 o Windows2022 cuando Kubernetes >= 1.25 si OSType es Windows.

Valor	Description
AzureLinux	Use AzureLinux como sistema operativo para imágenes de nodo. Azure Linux es una distribución linux optimizada para contenedores creada por Microsoft, visite https://aka.ms/azurelinux para obtener más información.
AzureLinux3	Use AzureLinux3 como sistema operativo para las imágenes de nodo. Azure Linux es una distribución linux optimizada para contenedores creada por Microsoft, visite https://aka.ms/azurelinux para obtener más información. Para conocer las limitaciones, visite https://aka.ms/aks/node-images. Para obtener instrucciones sobre la migración del sistema operativo, consulte https://aka.ms/aks/upgrade-os-version.
CBLMariner	OSSKU en desuso. Microsoft recomienda que las nuevas implementaciones elijan "AzureLinux" en su lugar.
Ubuntu	Use Ubuntu como sistema operativo para imágenes de nodo.
Ubuntu2204	Utilice Ubuntu2204 como sistema operativo para las imágenes de nodo, sin embargo, es posible que Ubuntu 22.04 no sea compatible con todos los grupos de nodos. Para conocer las limitaciones y las versiones de Kubernetes compatibles, consulte https://aka.ms/aks/supported-ubuntu-versions
Ubuntu2404	Use Ubuntu2404 como sistema operativo para las imágenes de nodo, sin embargo, es posible que Ubuntu 24.04 no sea compatible con todos los grupos de nodos. Para conocer las limitaciones y las versiones de Kubernetes compatibles, consulte https://aka.ms/aks/supported-ubuntu-versions
Windows2019	Use Windows2019 como sistema operativo para imágenes de nodo. No se admite para los grupos de nodos del sistema. Windows2019 solo admite contenedores de Windows2019; no puede ejecutar contenedores de Windows2022 y viceversa.
Windows2022	Use Windows2022 como sistema operativo para imágenes de nodo. No se admite para los grupos de nodos del sistema. Windows2022 solo admite contenedores de Windows2022; no puede ejecutar contenedores de Windows2019 y viceversa.

OSType

Enumeración

Tipo de sistema operativo. El valor predeterminado es Linux.

Valor	Description
Linux	Usa Linux.
Windows	Usa Windows.

PodIPAllocationMode

Enumeración

Modo de asignación de IP de pod. Modo de asignación de IP para pods del grupo de agentes. Debe usarse con podSubnetId. El valor predeterminado es "DynamicIndividual".

Valor	Description
DynamicIndividual	A cada nodo se le asigna una lista no contigua de direcciones IP asignables a pods. Esto es mejor para maximizar una subred pequeña a mediana de tamaño /16 o menor. El clúster de Azure CNI con asignación de IP dinámica tiene como valor predeterminado este modo si el cliente no especifica explícitamente un podIPAllocationMode
StaticBlock	A cada nodo se le asignan estáticamente bloques CIDR de tamaño /28 = 16 IP por bloque para satisfacer los maxPods por nodo. Número de bloques CIDR >= (maxPods / 16). El bloque, en lugar de una sola dirección IP, cuenta con el límite de IP privada de red virtual de Azure de 65 000. Por lo tanto, el modo de bloqueo es adecuado para ejecutar cargas de trabajo más grandes con más del límite actual de 65 000 pods en un clúster. Este modo es más adecuado para escalar con subredes más grandes de /15 o más

Valor

Description

DynamicIndividual

A cada nodo se le asigna una lista no contigua de direcciones IP asignables a pods. Esto es mejor para maximizar una subred pequeña a mediana de tamaño /16 o menor. El clúster de Azure CNI con asignación de IP dinámica tiene como valor predeterminado este modo si el cliente no especifica explícitamente un podIPAllocationMode

StaticBlock

A cada nodo se le asignan estáticamente bloques CIDR de tamaño /28 = 16 IP por bloque para satisfacer los maxPods por nodo. Número de bloques CIDR >= (maxPods / 16). El bloque, en lugar de una sola dirección IP, cuenta con el límite de IP privada de red virtual de Azure de 65 000. Por lo tanto, el modo de bloqueo es adecuado para ejecutar cargas de trabajo más grandes con más del límite actual de 65 000 pods en un clúster. Este modo es más adecuado para escalar con subredes más grandes de /15 o más

PortRange

Objeto

Intervalo de puertos.

Nombre	Tipo	Description
portEnd	integer (int32) minimum: 1 maximum: 65535	Puerto máximo que se incluye en el intervalo. Debe oscilar entre 1 y 65535 y debe ser mayor o igual que portStart.
portStart	integer (int32) minimum: 1 maximum: 65535	Puerto mínimo que se incluye en el intervalo. Debe oscilar entre 1 y 65535 y debe ser menor o igual que portEnd.
protocol	Protocol	Protocolo de red del puerto.

PowerState

Objeto

Describe el estado de energía del clúster.

Nombre	Tipo	Description
code	code	Indica si el clúster está en ejecución o detenido.

Protocol

Enumeración

Protocolo de red del puerto.

Valor	Description
TCP	TCP.
UDP	Protocolo UDP.

ScaleDownMode

Enumeración

Describe cómo se agregan o eliminan las máquinas virtuales de los grupos de agentes. Consulte los estados de facturación.

Valor	Description
Delete	Cree nuevas instancias durante el escalado vertical y elimine instancias durante el escalado descendente.
Deallocate	Intente iniciar instancias desasignadas (si existen) durante el escalado vertical y desasignar instancias durante el escalado descendente.

ScaleProfile

Objeto

Especificaciones sobre cómo escalar un grupo de agentes de VirtualMachines.

Nombre	Tipo	Description
manual	ManualScaleProfile[]	Especificaciones sobre cómo escalar el grupo de agentes de VirtualMachines a un tamaño fijo.

ScaleSetEvictionPolicy

Enumeración

Directiva de expulsión del conjunto de escalado de máquinas virtuales. La directiva de expulsión especifica qué hacer con la máquina virtual cuando se expulsa. El valor predeterminado es Eliminar. Para obtener más información sobre la expulsión, consulte Máquinas virtuales de acceso puntual

Valor	Description
Delete	Los nodos del conjunto de escalado subyacente del grupo de nodos se eliminan cuando se expulsan.
Deallocate	Los nodos del conjunto de escalado subyacente del grupo de nodos se establecen en el estado detenido-desasignado tras la expulsión. Los nodos del recuento de estados detenidos y desasignados en la cuota de proceso pueden causar problemas con el escalado o la actualización del clúster.

ScaleSetPriority

Enumeración

Prioridad del conjunto de escalado de máquinas virtuales.

Valor	Description
Spot	Se utilizarán máquinas virtuales con prioridad de acceso puntual. No hay ningún Acuerdo de Nivel de Servicio para los nodos de acceso puntual. Consulte spot en AKS para obtener más información.
Regular	Se usarán máquinas virtuales normales.

SysctlConfig

Objeto

Configuración de Sysctl para los nodos del agente de Linux.

Nombre	Tipo	Description
fsAioMaxNr	integer (int32)	Configuración de Sysctl fs.aio-max-nr.
fsFileMax	integer (int32)	Configuración de Sysctl fs.file-max.
fsInotifyMaxUserWatches	integer (int32)	Configuración de Sysctl fs.inotify.max_user_watches.
fsNrOpen	integer (int32)	Configuración de Sysctl fs.nr_open.
kernelThreadsMax	integer (int32)	Configuración de Sysctl kernel.threads-max.
netCoreNetdevMaxBacklog	integer (int32)	Configuración de Sysctl net.core.netdev_max_backlog.
netCoreOptmemMax	integer (int32)	Configuración de Sysctl net.core.optmem_max.
netCoreRmemDefault	integer (int32)	Configuración de Sysctl net.core.rmem_default.
netCoreRmemMax	integer (int32)	Configuración de Sysctl net.core.rmem_max.
netCoreSomaxconn	integer (int32)	Configuración de Sysctl net.core.somaxconn.
netCoreWmemDefault	integer (int32)	Configuración de Sysctl net.core.wmem_default.
netCoreWmemMax	integer (int32)	Configuración de Sysctl net.core.wmem_max.
netIpv4IpLocalPortRange	string	Configuración de Sysctl net.ipv4.ip_local_port_range.
netIpv4NeighDefaultGcThresh1	integer (int32)	Configuración de Sysctl net.ipv4.neigh.default.gc_thresh1.
netIpv4NeighDefaultGcThresh2	integer (int32)	Configuración de Sysctl net.ipv4.neigh.default.gc_thresh2.
netIpv4NeighDefaultGcThresh3	integer (int32)	Configuración de Sysctl net.ipv4.neigh.default.gc_thresh3.
netIpv4TcpFinTimeout	integer (int32)	Configuración de Sysctl net.ipv4.tcp_fin_timeout.
netIpv4TcpKeepaliveProbes	integer (int32)	Configuración de Sysctl net.ipv4.tcp_keepalive_probes.
netIpv4TcpKeepaliveTime	integer (int32)	Configuración de Sysctl net.ipv4.tcp_keepalive_time.
netIpv4TcpMaxSynBacklog	integer (int32)	Configuración de Sysctl net.ipv4.tcp_max_syn_backlog.
netIpv4TcpMaxTwBuckets	integer (int32)	Configuración de Sysctl net.ipv4.tcp_max_tw_buckets.
netIpv4TcpTwReuse	boolean	Configuración de Sysctl net.ipv4.tcp_tw_reuse.
netIpv4TcpkeepaliveIntvl	integer (int32) minimum: 10 maximum: 90	Configuración de Sysctl net.ipv4.tcp_keepalive_intvl.
netNetfilterNfConntrackBuckets	integer (int32) minimum: 65536 maximum: 524288	Configuración de Sysctl net.netfilter.nf_conntrack_buckets.
netNetfilterNfConntrackMax	integer (int32) minimum: 131072 maximum: 2097152	Configuración de Sysctl net.netfilter.nf_conntrack_max.
vmMaxMapCount	integer (int32)	Configuración de Sysctl vm.max_map_count.
vmSwappiness	integer (int32)	Configuración de Sysctl vm.swappiness.
vmVfsCachePressure	integer (int32)	Configuración de Sysctl vm.vfs_cache_pressure.

UndrainableNodeBehavior

Enumeración

Define el comportamiento de los nodos no detectables durante la actualización. La causa más común de los nodos que no se pueden detectar es presupuestos de interrupciones de pods (PDB), pero otros problemas, como el período de gracia de terminación del pod supera el tiempo de espera de purga por nodo restante o el pod sigue estando en estado de ejecución, también puede provocar nodos que no se pueden detectar.

Valor	Description
Schedule	AKS marcará los nodos bloqueados como programables, pero los nodos bloqueados no se actualizan. Se intentará eliminar todos los nodos de sobrecarga. La operación de actualización y el clúster administrado estarán en estado de error si hay nodos bloqueados.
Cordon	AKS acordonará los nodos bloqueados y los reemplazará por nodos de sobrecarga durante la actualización. Los nodos bloqueados se acordonarán y reemplazarán por nodos de sobrecarga. Los nodos bloqueados tendrán la etiqueta "kubernetes.azure.com/upgrade-status:Quarantined". Se conservará un nodo de sobrecarga para cada nodo bloqueado. Se realizará un intento de mejor esfuerzo para eliminar todos los demás nodos de sobrecarga. Si hay suficientes nodos de sobrecarga para reemplazar los nodos bloqueados, la operación de actualización y el clúster administrado estarán en estado de error. De lo contrario, la operación de actualización y el clúster administrado estarán en estado cancelado.

Valor

Description

Schedule

AKS marcará los nodos bloqueados como programables, pero los nodos bloqueados no se actualizan. Se intentará eliminar todos los nodos de sobrecarga. La operación de actualización y el clúster administrado estarán en estado de error si hay nodos bloqueados.

Cordon

AKS acordonará los nodos bloqueados y los reemplazará por nodos de sobrecarga durante la actualización. Los nodos bloqueados se acordonarán y reemplazarán por nodos de sobrecarga. Los nodos bloqueados tendrán la etiqueta "kubernetes.azure.com/upgrade-status:Quarantined". Se conservará un nodo de sobrecarga para cada nodo bloqueado. Se realizará un intento de mejor esfuerzo para eliminar todos los demás nodos de sobrecarga. Si hay suficientes nodos de sobrecarga para reemplazar los nodos bloqueados, la operación de actualización y el clúster administrado estarán en estado de error. De lo contrario, la operación de actualización y el clúster administrado estarán en estado cancelado.

VirtualMachineNodes

Objeto

Estado actual en un grupo de nodos del mismo tamaño de máquina virtual.

Nombre	Tipo	Description
count	integer (int32)	Número de nodos.
size	string	Tamaño de máquina virtual de los agentes usados para hospedar este grupo de nodos.

VirtualMachinesProfile

Objeto

Especificaciones del grupo de agentes de VirtualMachines.

Nombre	Tipo	Description
scale	ScaleProfile	Especificaciones sobre cómo escalar un grupo de agentes de VirtualMachines.

WorkloadRuntime

Enumeración

Determina el tipo de carga de trabajo que puede ejecutar un nodo.

Valor	Description
OCIContainer	Los nodos usarán Kubelet para ejecutar cargas de trabajo de contenedor OCI estándar.
WasmWasi	Los nodos usarán Krustlet para ejecutar cargas de trabajo WASM mediante el proveedor WASI (versión preliminar).
KataVmIsolation	Los nodos pueden usar (Kata + Cloud Hypervisor + Hyper-V) para habilitar pods anidados basados en máquinas virtuales. Debido al uso de Hyper-V, el propio sistema operativo del nodo de AKS es una máquina virtual anidada (el sistema operativo raíz) de Hyper-V. Por lo tanto, solo se puede usar con la serie de máquinas virtuales que admiten la virtualización anidada, como la serie Dv3.

Compartir a través de

Agent Pools - Get

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

Get Agent Pool

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AgentPool

AgentPoolGatewayProfile

AgentPoolMode

AgentPoolNetworkProfile

AgentPoolSecurityProfile

AgentPoolSSHAccess

AgentPoolStatus

AgentPoolType

AgentPoolUpgradeSettings

AgentPoolWindowsProfile

code

CreationData

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GPUDriver

GPUInstanceProfile

GPUProfile

IPTag

KubeletConfig

KubeletDiskType

LinuxOSConfig

LocalDNSForwardDestination

LocalDNSForwardPolicy

LocalDNSMode

LocalDNSOverride

LocalDNSProfile

LocalDNSProtocol

LocalDNSQueryLogging

LocalDNSServeStale

LocalDNSState

ManualScaleProfile

OSDiskType

OSSKU

OSType

PodIPAllocationMode

PortRange

PowerState

Protocol

ScaleDownMode

ScaleProfile

ScaleSetEvictionPolicy

ScaleSetPriority

SysctlConfig

UndrainableNodeBehavior

VirtualMachineNodes

VirtualMachinesProfile

WorkloadRuntime