Agent Pools - Create Or Update
Crea o actualiza un grupo de agentes en el clúster administrado especificado.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}?api-version=2026-02-01
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
agent
|
path | True |
string minLength: 1maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$ |
Nombre del grupo de agentes. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
|
resource
|
path | True |
string minLength: 1maxLength: 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. |
|
subscription
|
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 la operación. |
Encabezado de la solicitud
| Nombre | Requerido | Tipo | Description |
|---|---|---|---|
| if-match |
string |
La solicitud solo debe continuar si una entidad coincide con esta cadena. |
|
| if-none-match |
string |
La solicitud solo debe continuar si ninguna entidad coincide con esta cadena. |
Cuerpo de la solicitud
| Nombre | Tipo | Description |
|---|---|---|
| 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) |
El ID de recurso totalmente cualificado del Grupo de Reserva de Capacidad para proporcionar virtual machines de un grupo reservado de Virtual Machines. Esto es de la forma: '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft. Compute/capacityreservationgroups/{capacityReservationGroupName}' Los clientes lo utilizan para crear un grupo de agentes con un CRG especificado. Para más información, véase Reserva de Capacidad |
| properties.count |
integer (int32) |
Número de agentes (VM) para hospedar contenedores de Docker. Los valores permitidos deben estar en el intervalo de 0 a 1000 (ambos inclusive) para los grupos de usuarios y en el intervalo de 1 a 1000 (inclusive) para los grupos de sistemas. El valor predeterminado es 1. |
| properties.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.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 soporta en ciertos tamaños de máquinas virtuales y en ciertas 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 Adición de un grupo de nodos habilitado para FIPS para obtener más detalles. |
| 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 |
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 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 |
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. Esto es de la forma: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Compute/hostGroups/{hostGroupName}. Para más información, véase Azure hosts dedicados. |
| properties.kubeletConfig |
Configuración de Kubelet en los nodos del grupo de agentes. |
|
| properties.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 |
Configuración del sistema operativo de los nodos del agente de Linux. |
|
| properties.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 debe especificarse para 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 |
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 |
Configuración relacionada con la red de un grupo de agentes. |
|
| 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. Esto es de la forma: /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. Se admiten las versiones <de revisión major.minor.patch> (por ejemplo, 1.20.13) y <major.minor> (por ejemplo, 1.20). Cuando <se especifica major.minor> , se elige automáticamente la versión de revisión de disponibilidad general admitida más reciente. La actualización del clúster con el mismo <elemento major.minor> 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 Actualización de un grupo de nodos. |
| properties.osDiskSizeGB |
integer (int32) minimum: 0maximum: 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 |
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 Efímero del sistema operativo. |
|
| properties.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 |
Tipo de sistema operativo. El valor predeterminado es Linux. |
|
| properties.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). Esto es de la forma: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} |
| properties.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.proximityPlacementGroupID |
string (arm-id) |
Identificador del grupo de selección de ubicación de proximidad. |
| properties.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 |
Directiva de expulsión del conjunto de escalado de máquinas virtuales. La política de desahucios especifica qué to do con la máquina virtual cuando es desalojada. El valor predeterminado es Eliminar. Para más información sobre el desahucio, véase |
|
| properties.scaleSetPriority |
Prioridad del conjunto de escalado de máquinas virtuales. |
|
| properties.securityProfile |
Configuración de seguridad de un grupo de agentes. |
|
| properties.spotMaxPrice |
number (float) |
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 de spot, consulte Precios de máquinas virtuales de acceso puntual. |
| properties.status |
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 |
Tipo de grupo de agentes. |
|
| properties.upgradeSettings |
Configuración para actualizar el grupo de agentes |
|
| properties.virtualMachineNodesStatus |
Estado de los nodos de un grupo de agentes de VirtualMachines. |
|
| properties.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. Esto es de la forma: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} |
| properties.windowsProfile |
El perfil específico del pool de agentes de Windows. |
|
| properties.workloadRuntime |
Determina el tipo de carga de trabajo que puede ejecutar un nodo. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
La operación de actualización del recurso "AgentPool" se realizó correctamente |
|
| 201 Created |
Operación de creación del recurso "AgentPool" realizada correctamente Encabezados
|
|
| Other Status Codes |
Una respuesta de error inesperada. |
Seguridad
azure_auth
Azure Active Directory OAuth2 Flow.
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
Create Agent Pool using an agent pool snapshot
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"count": 3,
"creationData": {
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
},
"enableFIPS": true,
"orchestratorVersion": "",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"creationData": {
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
},
"currentOrchestratorVersion": "1.19.6",
"enableFIPS": true,
"maxPods": 110,
"orchestratorVersion": "1.19.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"creationData": {
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
},
"currentOrchestratorVersion": "1.19.6",
"enableFIPS": true,
"maxPods": 110,
"orchestratorVersion": "1.19.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}
Create Agent Pool with Capacity Reservation Group
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1",
"count": 3,
"orchestratorVersion": "",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}
Create Agent Pool with Dedicated Host Group
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"count": 3,
"hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1",
"orchestratorVersion": "",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1",
"maxPods": 110,
"orchestratorVersion": "1.19.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1",
"maxPods": 110,
"orchestratorVersion": "1.19.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}
Create Agent Pool with EncryptionAtHost enabled
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"count": 3,
"enableEncryptionAtHost": true,
"orchestratorVersion": "",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.13",
"enableEncryptionAtHost": true,
"maxPods": 110,
"orchestratorVersion": "1.17.13",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.13",
"enableEncryptionAtHost": true,
"maxPods": 110,
"orchestratorVersion": "1.17.13",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}
Create Agent Pool with Ephemeral OS Disk
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"count": 3,
"orchestratorVersion": "",
"osDiskSizeGB": 64,
"osDiskType": "Ephemeral",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osDiskSizeGB": 64,
"osDiskType": "Ephemeral",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"kubeletDiskType": "OS",
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osDiskSizeGB": 64,
"osDiskType": "Ephemeral",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}
Create Agent Pool with FIPS enabled OS
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"count": 3,
"enableFIPS": true,
"orchestratorVersion": "",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.19.6",
"enableFIPS": true,
"maxPods": 110,
"orchestratorVersion": "1.19.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.19.6",
"enableFIPS": true,
"maxPods": 110,
"orchestratorVersion": "1.19.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}
Create Agent Pool with GPUMIG
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"count": 3,
"gpuInstanceProfile": "MIG2g",
"kubeletConfig": {
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.core.somaxconn"
],
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"cpuManagerPolicy": "static",
"failSwapOn": false,
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"topologyManagerPolicy": "best-effort"
},
"linuxOSConfig": {
"swapFileSizeMB": 1500,
"sysctls": {
"kernelThreadsMax": 99999,
"netCoreWmemDefault": 12345,
"netIpv4IpLocalPortRange": "20000 60000",
"netIpv4TcpTwReuse": true
},
"transparentHugePageDefrag": "madvise",
"transparentHugePageEnabled": "always"
},
"orchestratorVersion": "",
"osType": "Linux",
"vmSize": "Standard_ND96asr_v4"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"gpuInstanceProfile": "MIG2g",
"kubeletConfig": {
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.core.somaxconn"
],
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"cpuManagerPolicy": "static",
"failSwapOn": false,
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"topologyManagerPolicy": "best-effort"
},
"linuxOSConfig": {
"swapFileSizeMB": 1500,
"sysctls": {
"kernelThreadsMax": 99999,
"netCoreWmemDefault": 12345,
"netIpv4IpLocalPortRange": "20000 60000",
"netIpv4TcpTwReuse": true
},
"transparentHugePageDefrag": "madvise",
"transparentHugePageEnabled": "always"
},
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_ND96asr_v4"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"gpuInstanceProfile": "MIG2g",
"kubeletConfig": {
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.core.somaxconn"
],
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"cpuManagerPolicy": "static",
"failSwapOn": false,
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"podMaxPids": 100,
"topologyManagerPolicy": "best-effort"
},
"linuxOSConfig": {
"swapFileSizeMB": 1500,
"sysctls": {
"kernelThreadsMax": 99999,
"netCoreWmemDefault": 65536,
"netIpv4IpLocalPortRange": "20000 60000",
"netIpv4TcpTwReuse": true
},
"transparentHugePageDefrag": "madvise",
"transparentHugePageEnabled": "always"
},
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_ND96asr_v4"
}
}
Create Agent Pool with Krustlet and the WASI runtime
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"count": 3,
"mode": "User",
"orchestratorVersion": "",
"osDiskSizeGB": 64,
"osType": "Linux",
"vmSize": "Standard_DS2_v2",
"workloadRuntime": "WasmWasi"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"maxPods": 110,
"mode": "User",
"orchestratorVersion": "1.17.8",
"osDiskSizeGB": 64,
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2",
"workloadRuntime": "WasmWasi"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"maxPods": 110,
"mode": "User",
"orchestratorVersion": "1.17.8",
"osDiskSizeGB": 64,
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2",
"workloadRuntime": "WasmWasi"
}
}
Create Agent Pool with KubeletConfig and LinuxOSConfig
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"count": 3,
"kubeletConfig": {
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.core.somaxconn"
],
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"cpuManagerPolicy": "static",
"failSwapOn": false,
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"topologyManagerPolicy": "best-effort"
},
"linuxOSConfig": {
"swapFileSizeMB": 1500,
"sysctls": {
"kernelThreadsMax": 99999,
"netCoreWmemDefault": 12345,
"netIpv4IpLocalPortRange": "20000 60000",
"netIpv4TcpTwReuse": true
},
"transparentHugePageDefrag": "madvise",
"transparentHugePageEnabled": "always"
},
"orchestratorVersion": "",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"kubeletConfig": {
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.core.somaxconn"
],
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"cpuManagerPolicy": "static",
"failSwapOn": false,
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"topologyManagerPolicy": "best-effort"
},
"linuxOSConfig": {
"swapFileSizeMB": 1500,
"sysctls": {
"kernelThreadsMax": 99999,
"netCoreWmemDefault": 12345,
"netIpv4IpLocalPortRange": "20000 60000",
"netIpv4TcpTwReuse": true
},
"transparentHugePageDefrag": "madvise",
"transparentHugePageEnabled": "always"
},
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"kubeletConfig": {
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.core.somaxconn"
],
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"cpuManagerPolicy": "static",
"failSwapOn": false,
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"podMaxPids": 100,
"topologyManagerPolicy": "best-effort"
},
"linuxOSConfig": {
"swapFileSizeMB": 1500,
"sysctls": {
"kernelThreadsMax": 99999,
"netCoreWmemDefault": 65536,
"netIpv4IpLocalPortRange": "20000 60000",
"netIpv4TcpTwReuse": true
},
"transparentHugePageDefrag": "madvise",
"transparentHugePageEnabled": "always"
},
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}
Create Agent Pool with Message of the Day
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"count": 3,
"messageOfTheDay": "Zm9vCg==",
"mode": "User",
"orchestratorVersion": "",
"osDiskSizeGB": 64,
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"maxPods": 110,
"messageOfTheDay": "Zm9vCg==",
"mode": "User",
"orchestratorVersion": "1.17.8",
"osDiskSizeGB": 64,
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"maxPods": 110,
"messageOfTheDay": "Zm9vCg==",
"mode": "User",
"orchestratorVersion": "1.17.8",
"osDiskSizeGB": 64,
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}
Create Agent Pool with OSSKU
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"count": 3,
"kubeletConfig": {
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.core.somaxconn"
],
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"cpuManagerPolicy": "static",
"failSwapOn": false,
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"topologyManagerPolicy": "best-effort"
},
"linuxOSConfig": {
"swapFileSizeMB": 1500,
"sysctls": {
"kernelThreadsMax": 99999,
"netCoreWmemDefault": 12345,
"netIpv4IpLocalPortRange": "20000 60000",
"netIpv4TcpTwReuse": true
},
"transparentHugePageDefrag": "madvise",
"transparentHugePageEnabled": "always"
},
"orchestratorVersion": "",
"osSKU": "AzureLinux",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"kubeletConfig": {
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.core.somaxconn"
],
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"cpuManagerPolicy": "static",
"failSwapOn": false,
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"topologyManagerPolicy": "best-effort"
},
"linuxOSConfig": {
"swapFileSizeMB": 1500,
"sysctls": {
"kernelThreadsMax": 99999,
"netCoreWmemDefault": 12345,
"netIpv4IpLocalPortRange": "20000 60000",
"netIpv4TcpTwReuse": true
},
"transparentHugePageDefrag": "madvise",
"transparentHugePageEnabled": "always"
},
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osSKU": "AzureLinux",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"kubeletConfig": {
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.core.somaxconn"
],
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"cpuManagerPolicy": "static",
"failSwapOn": false,
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"podMaxPids": 100,
"topologyManagerPolicy": "best-effort"
},
"linuxOSConfig": {
"swapFileSizeMB": 1500,
"sysctls": {
"kernelThreadsMax": 99999,
"netCoreWmemDefault": 65536,
"netIpv4IpLocalPortRange": "20000 60000",
"netIpv4TcpTwReuse": true
},
"transparentHugePageDefrag": "madvise",
"transparentHugePageEnabled": "always"
},
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osSKU": "AzureLinux",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}
Create Agent Pool with PPG
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"count": 3,
"orchestratorVersion": "",
"osType": "Linux",
"proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1",
"vmSize": "Standard_DS2_v2"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1",
"vmSize": "Standard_DS2_v2"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1",
"vmSize": "Standard_DS2_v2"
}
}
Create Agent Pool with UltraSSD enabled
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"count": 3,
"enableUltraSSD": true,
"orchestratorVersion": "",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.13",
"enableUltraSSD": true,
"maxPods": 110,
"orchestratorVersion": "1.17.13",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.13",
"enableUltraSSD": true,
"maxPods": 110,
"orchestratorVersion": "1.17.13",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}
Create Agent Pool with VirtualMachines pool type
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"type": "VirtualMachines",
"nodeLabels": {
"key1": "val1"
},
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"tags": {
"name1": "val1"
},
"virtualMachinesProfile": {
"scale": {
"manual": [
{
"count": 3,
"size": "Standard_D2_v2"
},
{
"count": 2,
"size": "Standard_D2_v3"
}
]
}
}
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"type": "VirtualMachines",
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"nodeImageVersion": "AKSUbuntu-1804gen2containerd-2021.09.11",
"nodeLabels": {
"key1": "val1"
},
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"tags": {
"name1": "val1"
},
"virtualMachineNodesStatus": [
{
"count": 3,
"size": "Standard_D2_v2"
},
{
"count": 2,
"size": "Standard_D2_v3"
}
],
"virtualMachinesProfile": {
"scale": {
"manual": [
{
"count": 3,
"size": "Standard_D2_v2"
},
{
"count": 2,
"size": "Standard_D2_v3"
}
]
}
}
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"type": "VirtualMachines",
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"nodeImageVersion": "AKSUbuntu-1804gen2containerd-2021.09.11",
"nodeLabels": {
"key1": "val1"
},
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"tags": {
"name1": "val1"
},
"virtualMachineNodesStatus": [
{
"count": 3,
"size": "Standard_D2_v2"
},
{
"count": 2,
"size": "Standard_D2_v3"
}
],
"virtualMachinesProfile": {
"scale": {
"manual": [
{
"count": 3,
"size": "Standard_D2_v2"
},
{
"count": 2,
"size": "Standard_D2_v3"
}
]
}
}
}
}
Create Agent Pool with Windows OSSKU
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2?api-version=2026-02-01
{
"properties": {
"count": 3,
"orchestratorVersion": "1.23.3",
"osSKU": "Windows2022",
"osType": "Windows",
"vmSize": "Standard_D4s_v3"
}
}
Respuesta de muestra
{
"name": "wnp2",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.23.3",
"maxPods": 110,
"orchestratorVersion": "1.23.3",
"osSKU": "Windows2022",
"osType": "Windows",
"provisioningState": "Succeeded",
"vmSize": "Standard_D4s_v3"
}
}
{
"name": "wnp2",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.23.3",
"maxPods": 110,
"orchestratorVersion": "1.23.3",
"osSKU": "Windows2022",
"osType": "Windows",
"provisioningState": "Creating",
"vmSize": "Standard_D4s_v3"
}
}
Create Spot Agent Pool
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"count": 3,
"nodeLabels": {
"key1": "val1"
},
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "",
"osType": "Linux",
"scaleSetEvictionPolicy": "Delete",
"scaleSetPriority": "Spot",
"tags": {
"name1": "val1"
},
"vmSize": "Standard_DS1_v2"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"nodeLabels": {
"key1": "val1"
},
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"scaleSetEvictionPolicy": "Delete",
"scaleSetPriority": "Spot",
"spotMaxPrice": -1,
"tags": {
"name1": "val1"
},
"vmSize": "Standard_DS1_v2"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"nodeLabels": {
"key1": "val1"
},
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"scaleSetEvictionPolicy": "Delete",
"scaleSetPriority": "Spot",
"spotMaxPrice": -1,
"tags": {
"name1": "val1"
},
"vmSize": "Standard_DS1_v2"
}
}
Create Windows Agent Pool with disabling OutboundNAT
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2?api-version=2026-02-01
{
"properties": {
"count": 3,
"orchestratorVersion": "1.23.8",
"osSKU": "Windows2022",
"osType": "Windows",
"vmSize": "Standard_D4s_v3",
"windowsProfile": {
"disableOutboundNat": true
}
}
}
Respuesta de muestra
{
"name": "wnp2",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.23.8",
"maxPods": 110,
"orchestratorVersion": "1.23.8",
"osSKU": "Windows2022",
"osType": "Windows",
"provisioningState": "Succeeded",
"vmSize": "Standard_D4s_v3",
"windowsProfile": {
"disableOutboundNat": true
}
}
}
{
"name": "wnp2",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.23.8",
"maxPods": 110,
"orchestratorVersion": "1.23.8",
"osSKU": "Windows2022",
"osType": "Windows",
"provisioningState": "Creating",
"vmSize": "Standard_D4s_v3",
"windowsProfile": {
"disableOutboundNat": true
}
}
}
Create/Update Agent Pool
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"count": 3,
"mode": "User",
"nodeLabels": {
"key1": "val1"
},
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "",
"osType": "Linux",
"scaleSetEvictionPolicy": "Delete",
"scaleSetPriority": "Spot",
"tags": {
"name1": "val1"
},
"vmSize": "Standard_DS1_v2"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"mode": "User",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"nodeLabels": {
"key1": "val1"
},
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"scaleSetEvictionPolicy": "Delete",
"scaleSetPriority": "Spot",
"tags": {
"name1": "val1"
},
"vmSize": "Standard_DS1_v2"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"mode": "User",
"nodeLabels": {
"key1": "val1"
},
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"scaleSetEvictionPolicy": "Delete",
"scaleSetPriority": "Spot",
"tags": {
"name1": "val1"
},
"vmSize": "Standard_DS1_v2"
}
}
Start Agent Pool
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"powerState": {
"code": "Running"
}
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 50,
"enableAutoScaling": true,
"maxCount": 55,
"minCount": 3,
"powerState": {
"code": "Running"
},
"provisioningState": "Starting"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 50,
"enableAutoScaling": true,
"maxCount": 55,
"minCount": 3,
"powerState": {
"code": "Running"
},
"provisioningState": "Starting"
}
}
Stop Agent Pool
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"powerState": {
"code": "Stopped"
}
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 0,
"enableAutoScaling": false,
"powerState": {
"code": "Stopped"
},
"provisioningState": "Stopping"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 0,
"enableAutoScaling": false,
"powerState": {
"code": "Stopped"
},
"provisioningState": "Stopping"
}
}
Update Agent Pool
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2026-02-01
{
"properties": {
"count": 3,
"enableAutoScaling": true,
"maxCount": 2,
"minCount": 2,
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "",
"osType": "Linux",
"scaleSetEvictionPolicy": "Delete",
"scaleSetPriority": "Spot",
"vmSize": "Standard_DS1_v2"
}
}
Respuesta de muestra
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableAutoScaling": true,
"maxCount": 2,
"maxPods": 110,
"minCount": 2,
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"scaleSetEvictionPolicy": "Delete",
"scaleSetPriority": "Spot",
"vmSize": "Standard_DS1_v2"
}
}
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableAutoScaling": true,
"maxCount": 2,
"maxPods": 110,
"minCount": 2,
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Updating",
"scaleSetEvictionPolicy": "Delete",
"scaleSetPriority": "Spot",
"vmSize": "Standard_DS1_v2"
}
}
Definiciones
| Nombre | Description |
|---|---|
|
Agent |
Grupo de agentes. |
|
Agent |
Perfil del grupo de agentes de puerta de enlace de clúster administrado. |
|
Agent |
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 |
|
Agent |
Configuración de red de un grupo de agentes. |
|
Agent |
Configuración de seguridad de un grupo de agentes. |
|
Agent |
Método de acceso SSH de un pool de agentes. |
|
Agent |
Contiene información de solo lectura sobre el grupo de agentes. |
|
Agent |
Tipo de grupo de agentes. |
|
Agent |
Configuración para actualizar un grupo de agentes |
|
Agent |
El perfil específico del pool de agentes de Windows. |
| Code |
Indica si el clúster está en ejecución o detenido. |
|
created |
Tipo de identidad que creó el recurso. |
|
Creation |
Datos usados al crear un recurso de destino a partir de un recurso de origen. |
|
Error |
Información adicional sobre el error de administración de recursos. |
|
Error |
Detalle del error. |
|
Error |
Respuesta de error |
| GPUDriver |
Si se van a instalar controladores de GPU. Cuando no se especifica, el valor predeterminado es Instalar. |
|
GPUInstance |
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 . |
|
Kubelet |
Configuraciones de Kubelet de nodos de agente. Consulte configuración de nodos personalizados de AKS para obtener más información. |
|
Kubelet |
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. |
|
Linux |
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. |
|
Local |
Servidor de destino para las consultas DNS que se van a reenviar desde localDNS. |
|
Local |
Política de reenvío para seleccionar el servidor DNS ascendente. Consulte el complemento de reenvío para obtener más información. |
|
Local |
Modo de habilitación para localDNS. |
|
Local |
Invalidaciones para el perfil localDNS. |
|
Local |
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. |
|
Local |
Aplique TCP o prefiera el protocolo UDP para las conexiones desde localDNS al servidor DNS ascendente. |
|
Local |
Nivel de registro para consultas DNS en localDNS. |
|
Local |
Política para servir datos obsoletos. Consulte el complemento de caché para obtener más información. |
|
Local |
Estado generado por el sistema de localDNS. |
|
Manual |
Especificaciones sobre el número de máquinas. |
|
OSDisk |
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 Efímero del sistema operativo. |
| 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. |
|
Pod |
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". |
|
Port |
Intervalo de puertos. |
|
Power |
Describe el estado de energía del clúster. |
| Protocol |
Protocolo de red del puerto. |
|
Scale |
Describe cómo se agregan o eliminan las máquinas virtuales de los grupos de agentes. Consulte los estados de facturación. |
|
Scale |
Especificaciones sobre cómo escalar un grupo de agentes de VirtualMachines. |
|
Scale |
Directiva de expulsión del conjunto de escalado de máquinas virtuales. La política de desahucios especifica qué to do con la máquina virtual cuando es desalojada. El valor predeterminado es Eliminar. Para más información sobre el desahucio, véase |
|
Scale |
Prioridad del conjunto de escalado de máquinas virtuales. |
|
Sysctl |
Configuración de Sysctl para los nodos del agente de Linux. |
|
system |
Metadatos relativos a la creación y última modificación del recurso. |
|
Undrainable |
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. |
|
Virtual |
Estado actual en un grupo de nodos del mismo tamaño de máquina virtual. |
|
Virtual |
Especificaciones del grupo de agentes de VirtualMachines. |
|
Workload |
Determina el tipo de carga de trabajo que puede ejecutar un nodo. |
AgentPool
Grupo de agentes.
| Nombre | Tipo | Valor predeterminado | Description |
|---|---|---|---|
| id |
string (arm-id) |
Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
| name |
string |
Nombre del 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) |
El ID de recurso totalmente cualificado del Grupo de Reserva de Capacidad para proporcionar virtual machines de un grupo reservado de Virtual Machines. Esto es de la forma: '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft. Compute/capacityreservationgroups/{capacityReservationGroupName}' Los clientes lo utilizan para crear un grupo de agentes con un CRG especificado. Para más información, véase Reserva de Capacidad |
|
| properties.count |
integer (int32) |
Número de agentes (VM) para hospedar contenedores de Docker. Los valores permitidos deben estar en el intervalo de 0 a 1000 (ambos inclusive) para los grupos de usuarios y en el intervalo de 1 a 1000 (inclusive) para los grupos de sistemas. El valor predeterminado es 1. |
|
| properties.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 soporta en ciertos tamaños de máquinas virtuales y en ciertas 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 Adición de un grupo de nodos habilitado para FIPS para obtener más detalles. |
|
| 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 |
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 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 |
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. Esto es de la forma: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Compute/hostGroups/{hostGroupName}. Para más información, véase Azure hosts dedicados. |
|
| properties.kubeletConfig |
Configuración de Kubelet en los nodos del grupo de agentes. |
||
| properties.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 |
Configuración del sistema operativo de los nodos del agente de Linux. |
||
| properties.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 debe especificarse para 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 |
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 |
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. Esto es de la forma: /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. Se admiten las versiones <de revisión major.minor.patch> (por ejemplo, 1.20.13) y <major.minor> (por ejemplo, 1.20). Cuando <se especifica major.minor> , se elige automáticamente la versión de revisión de disponibilidad general admitida más reciente. La actualización del clúster con el mismo <elemento major.minor> 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 Actualización de un grupo de nodos. |
|
| properties.osDiskSizeGB |
integer (int32) minimum: 0maximum: 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 |
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 Efímero del sistema operativo. |
||
| properties.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 | Linux |
Tipo de sistema operativo. El valor predeterminado es Linux. |
|
| properties.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). Esto es de la forma: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} |
|
| properties.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 |
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 | Delete |
Directiva de expulsión del conjunto de escalado de máquinas virtuales. La política de desahucios especifica qué to do con la máquina virtual cuando es desalojada. El valor predeterminado es Eliminar. Para más información sobre el desahucio, véase |
|
| properties.scaleSetPriority | Regular |
Prioridad del conjunto de escalado de máquinas virtuales. |
|
| properties.securityProfile |
Configuración de seguridad de un grupo de agentes. |
||
| properties.spotMaxPrice |
number (float) |
-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 de spot, consulte Precios de máquinas virtuales de acceso puntual. |
| properties.status |
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 |
Tipo de grupo de agentes. |
||
| properties.upgradeSettings |
Configuración para actualizar el grupo de agentes |
||
| properties.virtualMachineNodesStatus |
Estado de los nodos de un grupo de agentes de VirtualMachines. |
||
| properties.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. Esto es de la forma: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} |
|
| properties.windowsProfile |
El perfil específico del pool de agentes de Windows. |
||
| properties.workloadRuntime |
Determina el tipo de carga de trabajo que puede ejecutar un nodo. |
||
| systemData |
Azure Resource Manager metadatos que contienen información createdBy y modifiedBy. |
||
| type |
string |
Tipo de recurso. Por ejemplo, "Microsoft. Compute/virtualMachines" o "Microsoft. CuentasAlmacenamiento/Almacenamiento" |
AgentPoolGatewayProfile
Perfil del grupo de agentes de puerta de enlace de clúster administrado.
| Nombre | Tipo | Valor predeterminado | Description |
|---|---|---|---|
| publicIPPrefixSize |
integer (int32) minimum: 28maximum: 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 Azure limitación de tamaño de IPPrefix pública, 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
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 hospedar 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 hospedar los pods de la aplicación. |
| Gateway |
Los grupos de agentes de puerta de enlace están dedicados a proporcionar direcciones IP de salida estáticas a pods. Para obtener más información, vea https://aka.ms/aks/static-egress-gateway. |
AgentPoolNetworkProfile
Configuración de red de un grupo de agentes.
| Nombre | Tipo | Description |
|---|---|---|
| allowedHostPorts |
Los rangos de puertos a los que se permite 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
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 |
Método de acceso SSH de un pool de agentes. |
AgentPoolSSHAccess
Método de acceso SSH de un pool 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
Contiene información de solo lectura sobre el grupo de agentes.
| Nombre | Tipo | Description |
|---|---|---|
| provisioningError |
Información detallada del error del grupo de agentes. Conserva la información detallada del error. Si no se produjo ningún error, se omite este campo. |
AgentPoolType
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 recomienda encarecidamente usar esto. |
| VirtualMachines |
Cree un grupo de agentes respaldado por un modo de orquestación de máquina virtual de instancia única. |
AgentPoolUpgradeSettings
Configuración para actualizar un grupo de agentes
| Nombre | Tipo | Description |
|---|---|---|
| drainTimeoutInMinutes |
integer (int32) minimum: 1maximum: 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, incluidos los procedimientos recomendados, 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, incluidos los procedimientos recomendados, consulte: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster |
| nodeSoakDurationInMinutes |
integer (int32) minimum: 0maximum: 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 |
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
El perfil específico del pool 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
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. |
createdByType
Tipo de identidad que creó el recurso.
| Valor | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
CreationData
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
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
Detalle del error.
| Nombre | Tipo | Description |
|---|---|---|
| additionalInfo |
Información adicional del error. |
|
| code |
string |
Código de error. |
| details |
Detalles del error. |
|
| message |
string |
El mensaje de error. |
| target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
| Nombre | Tipo | Description |
|---|---|---|
| error |
Objeto de error. |
GPUDriver
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
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 |
Perfil de instancia de GPU MIG 1g. |
| MIG2g |
Perfil de instancia de GPU MIG 2G. |
| MIG3g |
Perfil de instancia de GPU MIG 3g. |
| MIG4g |
Perfil de instancia de la GPU MIG 4G. |
| MIG7g |
Perfil de instancia de GPU MIG 7g. |
GPUProfile
Configuración de GPU para el grupo de agentes.
| Nombre | Tipo | Description |
|---|---|---|
| driver |
Si se van a instalar controladores de GPU. Cuando no se especifica, el valor predeterminado es Instalar. |
IPTag
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
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) |
Porcentaje de uso del disco después del cual siempre se ejecuta la recolección de elementos no utilizados de la 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) |
Porcentaje de uso del disco antes del cual la recolección de elementos no utilizados de la imagen nunca se ejecuta. 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
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 usará el disco temporal para sus datos. |
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.
| Nombre | Tipo | Description |
|---|---|---|
| swapFileSizeMB |
integer (int32) |
Tamaño en MB de un archivo de intercambio que se creará en cada nodo. |
| sysctls |
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 |
| 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 |
LocalDNSForwardDestination
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
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
Modo de habilitación para localDNS.
| Valor | Description |
|---|---|
| Preferred |
Si la versión actual del orquestador admite esta característica, es preferible habilitar localDNS. |
| Required |
Habilite localDNS. |
| Disabled |
Deshabilite localDNS. |
LocalDNSOverride
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 | ClusterCoreDNS |
Servidor de destino para las consultas DNS que se van a reenviar desde localDNS. |
|
| forwardPolicy | 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 | PreferUDP |
Aplique TCP o prefiera el protocolo UDP para las conexiones desde localDNS al servidor DNS ascendente. |
|
| queryLogging | Error |
Nivel de registro para consultas DNS en localDNS. |
|
| serveStale | 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
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,
Local |
Las anulaciones de KubeDNS se aplican al tráfico DNS de pods con dnsPolicy:ClusterFirst (denominado tráfico de KubeDNS). |
|
| mode | Preferred |
Modo de habilitación para localDNS. |
|
| state |
Estado generado por el sistema de localDNS. |
||
| vnetDNSOverrides |
<string,
Local |
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
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 desde localDNS al servidor DNS ascendente. |
| ForceTCP |
Aplique el protocolo TCP para las conexiones desde localDNS al servidor DNS ascendente. |
LocalDNSQueryLogging
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
Política para servir datos obsoletos. Consulte el complemento de caché para obtener más información.
| Valor | Description |
|---|---|
| Verify |
Entregue 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 |
Entregue los 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 entrega de datos obsoletos. |
LocalDNSState
Estado generado por el sistema de localDNS.
| Valor | Description |
|---|---|
| Enabled |
localDNS está habilitado. |
| Disabled |
localDNS está deshabilitado. |
ManualScaleProfile
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
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 Efímero del sistema operativo.
| Valor | Description |
|---|---|
| Managed |
Azure replica el disco del sistema operativo para una máquina virtual a almacenamiento de Azure para evitar la pérdida de datos en caso de que la máquina virtual necesite ser trasladada a 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 del sistema operativo efímeros solo se almacenan en el equipo 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
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 |
|---|---|
| Ubuntu |
Use Ubuntu como sistema operativo para imágenes de nodo. |
| AzureLinux |
Use AzureLinux como sistema operativo para imágenes de nodo. Azure Linux es una distribución Linux optimizada para contenedores creada por Microsoft, visita https://aka.ms/azurelinux para 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, visita https://aka.ms/azurelinux para 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 los nuevos despliegues elijan 'AzureLinux' en su lugar. |
| 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. |
| 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 |
| Windows2025 |
Utilice Windows2025 como sistema operativo para las imágenes de nodo. No se admite para los grupos de nodos del sistema. Windows2025 es compatible con contenedores Windows2022 y Windows 2025; no puede ejecutar contenedores Windows2019 y viceversa. |
| 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 |
OSType
Tipo de sistema operativo. El valor predeterminado es Linux.
| Valor | Description |
|---|---|
| Linux |
Usa Linux. |
| Windows |
Usa Windows. |
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".
| 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 CNI de Azure con asignación dinámica de IP utiliza por defecto este modo si el cliente no especifica explícitamente un podIPAllocationMode |
| StaticBlock |
Cada nodo se asigna estáticamente bloques CIDR de tamaño /28 = 16 DIRECCIONES IP por bloque para satisfacer los maxPods por nodo. Número de bloques CIDR >= (maxPods / 16). El bloque, y no una IP única, cuenta contra el límite de IP privada de Azure Vnet de 65K. 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
Intervalo de puertos.
| Nombre | Tipo | Description |
|---|---|---|
| portEnd |
integer (int32) minimum: 1maximum: 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: 1maximum: 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 |
Protocolo de red del puerto. |
PowerState
Describe el estado de energía del clúster.
| Nombre | Tipo | Description |
|---|---|---|
| code |
Indica si el clúster está en ejecución o detenido. |
Protocol
Protocolo de red del puerto.
| Valor | Description |
|---|---|
| TCP |
Protocolo TCP. |
| UDP |
Protocolo UDP. |
ScaleDownMode
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 quite instancias durante la reducción vertical. |
| Deallocate |
Intente iniciar instancias desasignadas (si existen) durante el escalado vertical y desasignar instancias durante la reducción vertical. |
ScaleProfile
Especificaciones sobre cómo escalar un grupo de agentes de VirtualMachines.
| Nombre | Tipo | Description |
|---|---|---|
| manual |
Especificaciones sobre cómo escalar el grupo de agentes de VirtualMachines a un tamaño fijo. |
ScaleSetEvictionPolicy
Directiva de expulsión del conjunto de escalado de máquinas virtuales. La política de desahucios especifica qué to do con la máquina virtual cuando es desalojada. El valor predeterminado es Eliminar. Para más información sobre el desahucio, véase
| 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
Prioridad del conjunto de escalado de máquinas virtuales.
| Valor | Description |
|---|---|
| Spot |
Se usarán máquinas virtuales de 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
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: 10maximum: 90 |
Configuración de Sysctl net.ipv4.tcp_keepalive_intvl. |
| netNetfilterNfConntrackBuckets |
integer (int32) minimum: 65536maximum: 524288 |
Configuración de Sysctl net.netfilter.nf_conntrack_buckets. |
| netNetfilterNfConntrackMax |
integer (int32) minimum: 131072maximum: 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. |
systemData
Metadatos relativos a la creación y última modificación del recurso.
| Nombre | Tipo | Description |
|---|---|---|
| createdAt |
string (date-time) |
Marca de tiempo de creación de recursos (UTC). |
| createdBy |
string |
Identidad que creó el recurso. |
| createdByType |
Tipo de identidad que creó el recurso. |
|
| lastModifiedAt |
string (date-time) |
La marca de tiempo de la última modificación del recurso (UTC) |
| lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
| lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |
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.
| Valor | Description |
|---|---|
| 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. |
| Schedule |
AKS marcará los nodos bloqueados programables, pero los nodos bloqueados no se actualizarán. 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. |
VirtualMachineNodes
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
Especificaciones del grupo de agentes de VirtualMachines.
| Nombre | Tipo | Description |
|---|---|---|
| scale |
Especificaciones sobre cómo escalar un grupo de agentes de VirtualMachines. |
WorkloadRuntime
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 basados en VM anidados. Debido al uso de Hyper-V, el propio sistema operativo de nodos 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. |