Share via

Agent Pools - Create Or Update

  • Referens
Service:
AKS
API Version:
2024-02-01

Skapar eller uppdaterar en agentpool i det angivna hanterade klustret.

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

URI-parametrar

Name I Obligatorisk Typ Description
agentPoolName
 path True

string

Namnet på agentpoolen.

Regex pattern: ^[a-z][a-z0-9]{0,11}$
resourceGroupName
 path True

string

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
resourceName
 path True

string

Namnet på den hanterade klusterresursen.

Regex pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$
subscriptionId
 path True

string

uuid

ID för målprenumerationen. Värdet måste vara ett UUID.
api-version
 query True

string

Den API-version som ska användas för den här åtgärden.

Begärandetext

Name Typ Description
properties.availabilityZones

string[]

Listan över tillgänglighetszoner som ska användas för noder. Detta kan bara anges om egenskapen AgentPoolType är "VirtualMachineScaleSets".
properties.capacityReservationGroupID

string

Det fullständigt kvalificerade resurs-ID:t för kapacitetsreservationsgruppen för att tillhandahålla virtuella datorer från en reserverad grupp med Virtual Machines.
AKS associerar den angivna agentpoolen med kapacitetsreservationsgruppen.
properties.count

integer

Antal agenter (VM: er) som ska vara värdar för Docker-containrar. Tillåtna värden måste ligga mellan 0 och 1 000 (inklusive) för användarpooler och inom intervallet 1 till 1 000 (inklusive) för systempooler. Standardvärdet är 1.
properties.creationData

CreationData

CreationData som ska användas för att ange källans ögonblicksbilds-ID om nodpoolen ska skapas/uppgraderas med en ögonblicksbild.
properties.enableAutoScaling

boolean

Om automatisk skalning ska aktiveras
properties.enableEncryptionAtHost

boolean

Om värdbaserat operativsystem och dataenhetskryptering ska aktiveras.
Detta stöds endast på vissa VM-storlekar och i vissa Azure-regioner. För ytterligare information, se: https://docs.microsoft.com/azure/aks/enable-host-encryption
properties.enableFIPS

boolean

Om du vill använda ett FIPS-aktiverat operativsystem.
Mer information finns i Lägga till en FIPS-aktiverad nodpool .
properties.enableNodePublicIP

boolean

Om varje nod tilldelas sin egen offentliga IP-adress.
Vissa scenarier kan kräva att noder i en nodpool får sina egna dedikerade offentliga IP-adresser. Ett vanligt scenario är för spelarbetsbelastningar, där en konsol måste upprätta en direktanslutning till en virtuell molndator för att minimera hopp. Mer information finns i Tilldela en offentlig IP-adress per nod. Standardvärdet är False.
properties.enableUltraSSD

boolean

Om UltraSSD ska aktiveras
properties.gpuInstanceProfile

GPUInstanceProfile

GPUInstanceProfile som ska användas för att ange GPU MIG-instansprofil för GPU VM-SKU som stöds.
properties.hostGroupID

string

Det fullständigt kvalificerade resurs-ID:t för den dedikerade värdgruppen att etablera virtuella datorer från, som endast används i skapandescenariot och inte tillåts ändras en gång.
Detta är av formatet: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Mer information finns i Dedikerade Azure-värdar.
properties.kubeletConfig

KubeletConfig

Kubelet-konfigurationer av agentnoder.
Kubelet-konfigurationen på agentpoolnoderna.
properties.kubeletDiskType

KubeletDiskType

Avgör placeringen av emptyDir-volymer, containerns körningsdatarot och tillfällig Kubelet-lagring.
properties.linuxOSConfig

LinuxOSConfig

OS-konfigurationer för Linux-agentnoder.
OS-konfigurationen för Linux-agentnoder.
properties.maxCount

integer

Det maximala antalet noder för automatisk skalning
properties.maxPods

integer

Det maximala antalet poddar som kan köras på en nod.
properties.minCount

integer

Det minsta antalet noder för automatisk skalning
properties.mode

AgentPoolMode

Läget för en agentpool.
Ett kluster måste alltid ha minst en systemagentpool. Mer information om begränsningar och metodtips för agentpooler finns i: https://docs.microsoft.com/azure/aks/use-system-pools
properties.networkProfile

AgentPoolNetworkProfile

Nätverksrelaterade inställningar för en agentpool.
properties.nodeLabels

object

Nodetiketterna som ska bevaras över alla noder i agentpoolen.
properties.nodePublicIPPrefixID

string

Det offentliga IP-prefix-ID som VM-noder ska använda IP-adresser från.
Detta är av formatet: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
properties.nodeTaints

string[]

Taints har lagts till i nya noder när nodpoolen skapas och skalas. Till exempel key=value:NoSchedule.
properties.orchestratorVersion

string

Den version av Kubernetes som anges av användaren.
Både korrigeringsversionen <major.minor.patch> (t.ex. 1.20.13) och <major.minor> (t.ex. 1.20) stöds. När <major.minor> anges väljs den senaste ga-korrigeringsversionen som stöds automatiskt. När klustret uppdateras med samma <major.minor> när det har skapats (t.ex. 1.14.x–> 1.14) utlöses ingen uppgradering, även om det finns en nyare korrigeringsversion. Vi rekommenderar att du uppgraderar alla nodpooler i ett AKS-kluster till samma Kubernetes-version. Nodpoolversionen måste ha samma huvudversion som kontrollplanet. Nodpoolens delversion måste finnas i två delversioner av kontrollplansversionen. Nodpoolversionen får inte vara större än kontrollplanets version. Mer information finns i Uppgradera en nodpool.
properties.osDiskSizeGB

integer

OS-diskstorlek i GB som ska användas för att ange diskstorleken för varje dator i master-/agentpoolen. Om du anger 0 tillämpas standardstorleken för osDisk enligt den angivna vmSize.
properties.osDiskType

OSDiskType

Den operativsystemdisktyp som ska användas för datorer i agentpoolen.
Standardvärdet är "Tillfällig" om den virtuella datorn stöder den och har en cachedisk som är större än den begärda OSDiskSizeGB. Annars är standardvärdet "Hanterad". Kan inte ändras när du har skapat. Mer information finns i Tillfälliga operativsystem.
properties.osSKU

OSSKU

Anger os-SKU:n som används av agentpoolen. Standardvärdet är Ubuntu om OSType är Linux. Standardvärdet är Windows2019 när Kubernetes <= 1.24 eller Windows2022 när Kubernetes >= 1.25 om OSType är Windows.
properties.osType

OSType

Typ av operativsystem. Standardvärdet är Linux.
properties.podSubnetID

string

ID:t för det undernät som poddar ansluter till när de startas.
Om det utelämnas tilldelas podd-IP-adresser statiskt i nodundernätet (mer information finns i vnetSubnetID). Detta är av formatet: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.powerState

PowerState

Om agentpoolen körs eller stoppas.
När en agentpool först skapas körs den först. Agentpoolen kan stoppas genom att ställa in fältet på Stoppad. En stoppad agentpool stoppar alla sina virtuella datorer och ackumulerar inte faktureringsavgifter. En agentpool kan bara stoppas om den körs och etableringstillståndet är Lyckades
properties.proximityPlacementGroupID

string

ID för närhetsplaceringsgrupp.
properties.scaleDownMode

ScaleDownMode

Nedskalningsläget som ska användas vid skalning av agentpoolen.
Detta påverkar även beteendet för autoskalning av kluster. Om inget anges är standardinställningen Ta bort.
properties.scaleSetEvictionPolicy

ScaleSetEvictionPolicy

Den borttagningsprincip för VM-skalningsuppsättning som ska användas.
Detta kan inte anges om inte scaleSetPriority är "Spot". Om inget anges är standardvärdet "Ta bort".
properties.scaleSetPriority

ScaleSetPriority

Prioritet för VM-skalningsuppsättningen. Om inget anges är standardvärdet "Regular".
properties.spotMaxPrice

number

Det högsta priset (i AMERIKANSKA dollar) som du är villig att betala för spot-instanser. Möjliga värden är ett decimalvärde som är större än noll eller -1, vilket indikerar att standardpriset är upp till på begäran.
Möjliga värden är ett decimalvärde som är större än noll eller -1, vilket anger viljan att betala ett pris på begäran. Mer information om spotpriser finns i spot-priser för virtuella datorer
properties.tags

object

Taggarna som ska sparas i agentpoolens VM-skalningsuppsättning.
properties.type

AgentPoolType

Typ av agentpool.
properties.upgradeSettings

AgentPoolUpgradeSettings

Inställningar för att uppgradera agentpoolen
properties.vmSize

string

Storleken på de virtuella datorerna i agentpoolen.
Tillgängligheten för VM-storlek varierar beroende på region. Om en nod innehåller otillräckliga beräkningsresurser (minne, cpu osv.) kan poddar misslyckas med att köras korrekt. Mer information om begränsade VM-storlekar finns i: https://docs.microsoft.com/azure/aks/quotas-skus-regions
properties.vnetSubnetID

string

ID:t för undernätet som agentpoolnoder och poddar kan anslutas till vid start.
Om detta inte anges genereras och används ett virtuellt nätverk och undernät. Om inget podSubnetID har angetts gäller detta för noder och poddar, annars gäller det bara noder. Det här är i formuläret: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.windowsProfile

AgentPoolWindowsProfile

Windows-agentpoolens specifika profil.
properties.workloadRuntime

WorkloadRuntime

Avgör vilken typ av arbetsbelastning en nod kan köra.

Svar

Name Typ Description
200 OK

AgentPool

Den befintliga agentpoolen har uppdaterats.
201 Created

AgentPool

Den nya agentpoolen har skapats.
Other Status Codes

CloudError

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

Create Agent Pool using an agent pool snapshot
Create Agent Pool with Capacity Reservation Group
Create Agent Pool with Dedicated Host Group
Create Agent Pool with EncryptionAtHost enabled
Create Agent Pool with Ephemeral OS Disk
Create Agent Pool with FIPS enabled OS
Create Agent Pool with GPUMIG
Create Agent Pool with Krustlet and the WASI runtime
Create Agent Pool with KubeletConfig and LinuxOSConfig
Create Agent Pool with OSSKU
Create Agent Pool with PPG
Create Agent Pool with UltraSSD enabled
Create Agent Pool with Windows OSSKU
Create Spot Agent Pool
Create Windows Agent Pool with disabling OutboundNAT
Create/Update Agent Pool
Start Agent Pool
Stop Agent Pool
Update Agent Pool

Create Agent Pool using an agent pool snapshot

Sample Request

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "enableFIPS": true,
    "creationData": {
      "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
    }
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.19.6",
    "currentOrchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableFIPS": true,
    "creationData": {
      "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
    }
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.19.6",
    "currentOrchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableFIPS": true,
    "creationData": {
      "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
    }
  }
}

Create Agent Pool with Capacity Reservation Group

Sample Request

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1"
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1"
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1"
  }
}

Create Agent Pool with Dedicated Host Group

Sample Request

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"
  }
}

Create Agent Pool with EncryptionAtHost enabled

Sample Request

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "enableEncryptionAtHost": true
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.13",
    "currentOrchestratorVersion": "1.17.13",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableEncryptionAtHost": true
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.13",
    "currentOrchestratorVersion": "1.17.13",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableEncryptionAtHost": true
  }
}

Create Agent Pool with Ephemeral OS Disk

Sample Request

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "osDiskType": "Ephemeral",
    "osDiskSizeGB": 64
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osDiskType": "Ephemeral",
    "osDiskSizeGB": 64
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osDiskType": "Ephemeral",
    "kubeletDiskType": "OS",
    "osDiskSizeGB": 64
  }
}

Create Agent Pool with FIPS enabled OS

Sample Request

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "enableFIPS": true
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.19.6",
    "currentOrchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableFIPS": true
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.19.6",
    "currentOrchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableFIPS": true
  }
}

Create Agent Pool with GPUMIG

Sample Request

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_ND96asr_v4",
    "osType": "Linux",
    "gpuInstanceProfile": "MIG2g",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_ND96asr_v4",
    "maxPods": 110,
    "osType": "Linux",
    "gpuInstanceProfile": "MIG2g",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_ND96asr_v4",
    "maxPods": 110,
    "osType": "Linux",
    "gpuInstanceProfile": "MIG2g",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false,
      "podMaxPids": 100
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 65536,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Create Agent Pool with Krustlet and the WASI runtime

Sample Request

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "osDiskSizeGB": 64,
    "mode": "User",
    "workloadRuntime": "WasmWasi"
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osDiskSizeGB": 64,
    "mode": "User",
    "workloadRuntime": "WasmWasi"
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osDiskSizeGB": 64,
    "mode": "User",
    "workloadRuntime": "WasmWasi"
  }
}

Create Agent Pool with KubeletConfig and LinuxOSConfig

Sample Request

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false,
      "podMaxPids": 100
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 65536,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Create Agent Pool with OSSKU

Sample Request

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "osSKU": "AzureLinux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osSKU": "AzureLinux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osSKU": "AzureLinux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false,
      "podMaxPids": 100
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 65536,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Create Agent Pool with PPG

Sample Request

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1"
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1"
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1"
  }
}

Create Agent Pool with UltraSSD enabled

Sample Request

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "enableUltraSSD": true
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.13",
    "currentOrchestratorVersion": "1.17.13",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableUltraSSD": true
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.13",
    "currentOrchestratorVersion": "1.17.13",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableUltraSSD": true
  }
}

Create Agent Pool with Windows OSSKU

Sample Request

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2?api-version=2024-02-01

{
  "properties": {
    "orchestratorVersion": "1.23.3",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "osType": "Windows",
    "osSKU": "Windows2022"
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "wnp2",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.23.3",
    "currentOrchestratorVersion": "1.23.3",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "maxPods": 110,
    "osType": "Windows",
    "osSKU": "Windows2022"
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "wnp2",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.23.3",
    "currentOrchestratorVersion": "1.23.3",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "maxPods": 110,
    "osType": "Windows",
    "osSKU": "Windows2022"
  }
}

Create Spot Agent Pool

Sample Request

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete"
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete",
    "spotMaxPrice": -1
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete",
    "spotMaxPrice": -1
  }
}

Create Windows Agent Pool with disabling OutboundNAT

Sample Request

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2?api-version=2024-02-01

{
  "properties": {
    "orchestratorVersion": "1.23.8",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "osType": "Windows",
    "osSKU": "Windows2022",
    "windowsProfile": {
      "disableOutboundNat": true
    }
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "wnp2",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.23.8",
    "currentOrchestratorVersion": "1.23.8",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "maxPods": 110,
    "osType": "Windows",
    "osSKU": "Windows2022",
    "windowsProfile": {
      "disableOutboundNat": true
    }
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "wnp2",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.23.8",
    "currentOrchestratorVersion": "1.23.8",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "maxPods": 110,
    "osType": "Windows",
    "osSKU": "Windows2022",
    "windowsProfile": {
      "disableOutboundNat": true
    }
  }
}

Create/Update Agent Pool

Sample Request

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete",
    "mode": "User"
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete",
    "mode": "User",
    "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete",
    "mode": "User"
  }
}

Start Agent Pool

Sample Request

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

{
  "properties": {
    "powerState": {
      "code": "Running"
    }
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Starting",
    "count": 50,
    "enableAutoScaling": true,
    "minCount": 3,
    "maxCount": 55,
    "powerState": {
      "code": "Running"
    }
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Starting",
    "count": 50,
    "enableAutoScaling": true,
    "minCount": 3,
    "maxCount": 55,
    "powerState": {
      "code": "Running"
    }
  }
}

Stop Agent Pool

Sample Request

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

{
  "properties": {
    "powerState": {
      "code": "Stopped"
    }
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Stopping",
    "count": 0,
    "enableAutoScaling": false,
    "minCount": null,
    "maxCount": null,
    "powerState": {
      "code": "Stopped"
    }
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Stopping",
    "count": 0,
    "enableAutoScaling": false,
    "minCount": null,
    "maxCount": null,
    "powerState": {
      "code": "Stopped"
    }
  }
}

Update Agent Pool

Sample Request

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "enableAutoScaling": true,
    "minCount": 2,
    "maxCount": 2,
    "vmSize": "Standard_DS1_v2",
    "osType": "Linux",
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete"
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "enableAutoScaling": true,
    "minCount": 2,
    "maxCount": 2,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete"
  }
}
Status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Updating",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "enableAutoScaling": true,
    "minCount": 2,
    "maxCount": 2,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete"
  }
}

Definitioner

Name Description
AgentPool

Agentpool.
AgentPoolMode

Läget för en agentpool.
AgentPoolNetworkProfile

Nätverksinställningar för en agentpool.
AgentPoolType

Typ av agentpool.
AgentPoolUpgradeSettings

Inställningar för att uppgradera en agentpool
AgentPoolWindowsProfile

Windows-agentpoolens specifika profil.
CloudError

Ett felsvar från containertjänsten.
CloudErrorBody

Ett felsvar från containertjänsten.
code

Anger om klustret körs eller stoppas
CreationData

Data som används när du skapar en målresurs från en källresurs.
GPUInstanceProfile

GPUInstanceProfile som ska användas för att ange GPU MIG-instansprofil för GPU VM SKU som stöds.
IPTag

Innehåller ip-taggen som är associerad med objektet.
KubeletConfig

Kubelet-konfigurationer av agentnoder.
KubeletDiskType

Avgör placeringen av emptyDir-volymer, containerns körningsdatarot och tillfällig Kubelet-lagring.
LinuxOSConfig

OS-konfigurationer av Linux-agentnoder.
OSDiskType

Den operativsystemdisktyp som ska användas för datorer i agentpoolen.
OSSKU

Anger os-SKU:n som används av agentpoolen. Standardvärdet är Ubuntu om OSType är Linux. Standardvärdet är Windows2019 när Kubernetes <= 1.24 eller Windows2022 när Kubernetes >= 1.25 om OSType är Windows.
OSType

Operativsystemtypen. Standardvärdet är Linux.
PortRange

Portintervallet.
PowerState

Beskriver klustrets energitillstånd
Protocol

Portens nätverksprotokoll.
ScaleDownMode

Beskriver hur virtuella datorer läggs till eller tas bort från agentpooler. Se faktureringstillstånd.
ScaleSetEvictionPolicy

Borttagningsprincipen för vm-skalningsuppsättning.
ScaleSetPriority

Prioritet för VM-skalningsuppsättning.
SysctlConfig

Sysctl-inställningar för Linux-agentnoder.
WorkloadRuntime

Avgör vilken typ av arbetsbelastning en nod kan köra.

AgentPool

Agentpool.

Name Typ Standardvärde Description
id

string

Resurs-ID.
name

string

Namnet på resursen som är unik i en resursgrupp. Det här namnet kan användas för att komma åt resursen.
properties.availabilityZones

string[]

Listan över tillgänglighetszoner som ska användas för noder. Detta kan bara anges om egenskapen AgentPoolType är "VirtualMachineScaleSets".
properties.capacityReservationGroupID

string

Det fullständigt kvalificerade resurs-ID:t för kapacitetsreservationsgruppen för att tillhandahålla virtuella datorer från en reserverad grupp med Virtual Machines.
AKS associerar den angivna agentpoolen med kapacitetsreservationsgruppen.
properties.count

integer

Antal agenter (VM: er) som ska vara värdar för Docker-containrar. Tillåtna värden måste ligga mellan 0 och 1 000 (inklusive) för användarpooler och inom intervallet 1 till 1 000 (inklusive) för systempooler. Standardvärdet är 1.
properties.creationData

CreationData

CreationData som ska användas för att ange källans ögonblicksbild-ID om nodpoolen ska skapas/uppgraderas med hjälp av en ögonblicksbild.
properties.currentOrchestratorVersion

string

Versionen av Kubernetes som agentpoolen kör.
Om orchestratorVersion är en fullständigt angiven version <major.minor.patch> är det här fältet exakt lika med det. Om orchestratorVersion är <major.minor> innehåller det här fältet den fullständiga <major.minor.patch-versionen> som används.
properties.enableAutoScaling

boolean

Om du vill aktivera automatisk skalning
properties.enableEncryptionAtHost

boolean

Om värdbaserad os- och dataenhetskryptering ska aktiveras.
Detta stöds endast på vissa VM-storlekar och i vissa Azure-regioner. För ytterligare information, se: https://docs.microsoft.com/azure/aks/enable-host-encryption
properties.enableFIPS

boolean

Om du vill använda ett FIPS-aktiverat operativsystem.
Mer information finns i Lägga till en FIPS-aktiverad nodpool .
properties.enableNodePublicIP

boolean

Om varje nod allokeras till sin egen offentliga IP-adress.
Vissa scenarier kan kräva att noder i en nodpool tar emot sina egna dedikerade offentliga IP-adresser. Ett vanligt scenario är för spelarbetsbelastningar, där en konsol måste upprätta en direktanslutning till en virtuell molndator för att minimera hopp. Mer information finns i tilldela en offentlig IP-adress per nod. Standardvärdet är False.
properties.enableUltraSSD

boolean

Om UltraSSD ska aktiveras
properties.gpuInstanceProfile

GPUInstanceProfile

GPUInstanceProfile som ska användas för att ange GPU MIG-instansprofil för GPU VM SKU som stöds.
properties.hostGroupID

string

Det fullständigt kvalificerade resurs-ID:t för den dedikerade värdgruppen att etablera virtuella datorer från, som endast används i skapandescenariot och inte tillåts ändras en gång.
Det här är i formuläret: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Mer information finns i Dedikerade Azure-värdar.
properties.kubeletConfig

KubeletConfig

Kubelet-konfigurationer av agentnoder.
Kubelet-konfigurationen på agentpoolnoderna.
properties.kubeletDiskType

KubeletDiskType

Avgör placeringen av emptyDir-volymer, containerns körningsdatarot och tillfällig Kubelet-lagring.
properties.linuxOSConfig

LinuxOSConfig

OS-konfigurationer av Linux-agentnoder.
Operativsystemets konfiguration av Linux-agentnoder.
properties.maxCount

integer

Det maximala antalet noder för automatisk skalning
properties.maxPods

integer

Det maximala antalet poddar som kan köras på en nod.
properties.minCount

integer

Det minsta antalet noder för automatisk skalning
properties.mode

AgentPoolMode

Läget för en agentpool.
Ett kluster måste ha minst en systemagentpool hela tiden. Mer information om begränsningar och metodtips för agentpooler finns i: https://docs.microsoft.com/azure/aks/use-system-pools
properties.networkProfile

AgentPoolNetworkProfile

Nätverksrelaterade inställningar för en agentpool.
properties.nodeImageVersion

string

Version av nodbild
properties.nodeLabels

object

Nodetiketterna som ska sparas över alla noder i agentpoolen.
properties.nodePublicIPPrefixID

string

Det offentliga IP-prefix-ID som VM-noder ska använda IP-adresser från.
Det här är i formuläret: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
properties.nodeTaints

string[]

De taints som läggs till i nya noder när nodpoolen skapas och skalas. Till exempel key=value:NoSchedule.
properties.orchestratorVersion

string

Den version av Kubernetes som angetts av användaren.
Både korrigeringsversionen <major.minor.patch> (t.ex. 1.20.13) och <major.minor> (t.ex. 1.20) stöds. När <major.minor> anges väljs den senaste ga-korrigeringsversionen som stöds automatiskt. När klustret uppdateras med samma <major.minor> när det har skapats (t.ex. 1.14.x–> 1.14) utlöses ingen uppgradering, även om en nyare korrigeringsversion är tillgänglig. Vi rekommenderar att du uppgraderar alla nodpooler i ett AKS-kluster till samma Kubernetes-version. Nodpoolversionen måste ha samma huvudversion som kontrollplanet. Delversionen av nodpoolen måste ligga inom två delversioner av kontrollplanets version. Nodpoolversionen får inte vara större än kontrollplanets version. Mer information finns i uppgradera en nodpool.
properties.osDiskSizeGB

integer

OS-diskstorlek i GB som ska användas för att ange diskstorleken för varje dator i master-/agentpoolen. Om du anger 0 tillämpas standardstorleken för osDisk enligt den angivna vmSize.
properties.osDiskType

OSDiskType

Den operativsystemdisktyp som ska användas för datorer i agentpoolen.
Standardvärdet är "Tillfällig" om den virtuella datorn stöder den och har en cachedisk som är större än den begärda OSDiskSizeGB. Annars är standardvärdet "Hanterad". Kan inte ändras när du har skapat. Mer information finns i Tillfälliga operativsystem.
properties.osSKU

OSSKU

Anger os-SKU:n som används av agentpoolen. Standardvärdet är Ubuntu om OSType är Linux. Standardvärdet är Windows2019 när Kubernetes <= 1.24 eller Windows2022 när Kubernetes >= 1.25 om OSType är Windows.
properties.osType

OSType

Linux

Operativsystemtypen. Standardvärdet är Linux.
properties.podSubnetID

string

ID för det undernät som poddar ansluter till när de startas.
Om detta utelämnas tilldelas podd-IP-adresser statiskt i nodundernätet (se vnetSubnetID för mer information). Det här är i formuläret: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.powerState

PowerState

Om agentpoolen körs eller stoppas.
När en agentpool först skapas körs den först. Agentpoolen kan stoppas genom att ställa in fältet på Stoppad. En stoppad agentpool stoppar alla sina virtuella datorer och debiteras inte faktureringsavgifter. En agentpool kan bara stoppas om den körs och etableringstillståndet har slutförts
properties.provisioningState

string

Det aktuella distributions- eller etableringstillståndet.
properties.proximityPlacementGroupID

string

ID för närhetsplaceringsgrupp.
properties.scaleDownMode

ScaleDownMode

Det nedskalningsläge som ska användas vid skalning av agentpoolen.
Detta påverkar även autoskalningsbeteendet för kluster. Om det inte anges är standardinställningen Ta bort.
properties.scaleSetEvictionPolicy

ScaleSetEvictionPolicy

Delete

Den borttagningsprincip för vm-skalningsuppsättning som ska användas.
Detta kan inte anges om inte scaleSetPriority är "Spot". Om inget anges är standardvärdet "Ta bort".
properties.scaleSetPriority

ScaleSetPriority

Regular

Prioritet för VM-skalningsuppsättning. Om inget anges är standardvärdet "Regular".
properties.spotMaxPrice

number

-1

Det högsta priset (i amerikanska dollar) som du är villig att betala för spotinstanser. Möjliga värden är ett decimalvärde som är större än noll eller -1, vilket indikerar att standardpriset är upp till på begäran.
Möjliga värden är ett decimalvärde som är större än noll eller -1, vilket indikerar viljan att betala ett pris på begäran. Mer information om spotpriser finns i prissättning för virtuella datorer med oanvänd kapacitet
properties.tags

object

Taggarna som ska sparas i agentpoolens VM-skalningsuppsättning.
properties.type

AgentPoolType

Typ av agentpool.
properties.upgradeSettings

AgentPoolUpgradeSettings

Inställningar för att uppgradera agentpoolen
properties.vmSize

string

Storleken på de virtuella datorerna i agentpoolen.
Tillgängligheten för VM-storlek varierar beroende på region. Om en nod innehåller otillräckliga beräkningsresurser (minne, cpu osv.) kan poddar misslyckas med att köras korrekt. Mer information om begränsade VM-storlekar finns i: https://docs.microsoft.com/azure/aks/quotas-skus-regions
properties.vnetSubnetID

string

ID:t för undernätet som agentpoolnoder och poddar kan anslutas till vid start.
Om detta inte anges genereras och används ett virtuellt nätverk och undernät. Om inget podSubnetID har angetts gäller detta för noder och poddar, annars gäller det bara noder. Det här är i formuläret: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.windowsProfile

AgentPoolWindowsProfile

Windows-agentpoolens specifika profil.
properties.workloadRuntime

WorkloadRuntime

Avgör vilken typ av arbetsbelastning en nod kan köra.
type

string

Resurstyp

AgentPoolMode

Läget för en agentpool.

Name Typ Description
System

string

Systemagentpooler är främst till för att vara värd för kritiska systempoddar som CoreDNS och metrics-server. Systemagentpooler osType måste vara Linux. Systemagentpooler VM SKU måste ha minst 2vCPU:er och 4 GB minne.
User

string

Användaragentpooler är främst till för programpoddar.

AgentPoolNetworkProfile

Nätverksinställningar för en agentpool.

Name Typ Description
allowedHostPorts

PortRange[]

De portintervall som tillåts att komma åt. De angivna intervallen får överlappa varandra.
applicationSecurityGroups

string[]

ID:t för de programsäkerhetsgrupper som agentpoolen associerar när de skapas.
nodePublicIPTags

IPTag[]

IPTags för offentliga IP-adresser på instansnivå.

AgentPoolType

Typ av agentpool.

Name Typ Description
AvailabilitySet

string

Användning av detta rekommenderas starkt.
VirtualMachineScaleSets

string

Skapa en agentpool som backas upp av en VM-skalningsuppsättning.

AgentPoolUpgradeSettings

Inställningar för att uppgradera en agentpool

Name Typ Description
drainTimeoutInMinutes

integer

Tidsgränsen för tömning för en nod
Hur lång tid (i minuter) som ska vänta vid avlägsnande av poddar och respitfull avslutning per nod. Den här avhysningsväntetiden är den som väntar på poddavbrottsbudgetar. Om den här tiden överskrids misslyckas uppgraderingen. Om inget anges är standardvärdet 30 minuter.
maxSurge

string

Det maximala antalet eller procentandelen noder som ökar under uppgraderingen.
Detta kan antingen anges till ett heltal (t.ex. "5") eller en procentandel (t.ex. "50 %"). Om en procentsats anges är det procentandelen av den totala agentpoolens storlek vid tidpunkten för uppgraderingen. För procentandelar avrundas bråknoder uppåt. Om inget anges är standardvärdet 1. Mer information, inklusive metodtips, finns i: https://docs.microsoft.com/azure/aks/upgrade-cluster#customize-node-surge-upgrade
nodeSoakDurationInMinutes

integer

Blötläggningstiden för en nod
Hur lång tid (i minuter) som ska vänta efter tömning av en nod och innan du återskapar den och går vidare till nästa nod. Om inget anges är standardvärdet 0 minuter.

AgentPoolWindowsProfile

Windows-agentpoolens specifika profil.

Name Typ Description
disableOutboundNat

boolean

Om du vill inaktivera OutboundNAT i Windows-noder
Standardvärdet är false. Utgående NAT kan bara inaktiveras om klustret outboundType är NAT Gateway och Windows-agentpoolen inte har nodens offentliga IP-adress aktiverad.

CloudError

Ett felsvar från containertjänsten.

Name Typ Description
error

CloudErrorBody

Information om felet.

CloudErrorBody

Ett felsvar från containertjänsten.

Name Typ Description
code

string

En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt.
details

CloudErrorBody[]

En lista med ytterligare information om felet.
message

string

Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt.
target

string

Målet för det specifika felet. Till exempel namnet på egenskapen i fel.

code

Anger om klustret körs eller stoppas

Name Typ Description
Running

string

Klustret körs.
Stopped

string

Klustret stoppas.

CreationData

Data som används när du skapar en målresurs från en källresurs.

Name Typ Description
sourceResourceId

string

Det här är ARM-ID:t för källobjektet som ska användas för att skapa målobjektet.

GPUInstanceProfile

GPUInstanceProfile som ska användas för att ange GPU MIG-instansprofil för GPU VM SKU som stöds.

Name Typ Description
MIG1g

string

MIG2g

string

MIG3g

string

MIG4g

string

MIG7g

string

IPTag

Innehåller ip-taggen som är associerad med objektet.

Name Typ Description
ipTagType

string

IP-taggtypen. Exempel: RoutingPreference.
tag

string

Värdet för IP-taggen som är associerad med den offentliga IP-adressen. Exempel: Internet.

KubeletConfig

Kubelet-konfigurationer av agentnoder.

Name Typ Description
allowedUnsafeSysctls

string[]

Tillåten lista över osäkra sysctls eller osäkra sysctl-mönster (slutar i *).
containerLogMaxFiles

integer

Det maximala antalet containerloggfiler som kan finnas för en container. Talet måste vara ≥ 2.
containerLogMaxSizeMB

integer

Den maximala storleken (t.ex. 10Mi) för containerloggfilen innan den roteras.
cpuCfsQuota

boolean

Om CPU CFS-kvottillämpning är aktiverat för containrar som anger CPU-gränser.
Standardvärdet är sant.
cpuCfsQuotaPeriod

string

Värdet för CPU CFS-kvotperiod.
Standardvärdet är "100 ms". Giltiga värden är en sekvens med decimaltal med ett valfritt bråk och ett enhetssuffix. Till exempel: "300ms", "2h45m". Enheter som stöds är "ns", "us", "ms", "s", "m" och "h".
cpuManagerPolicy

string

Cpu Manager-principen som ska användas.
Standardvärdet är "none". Mer information finns i Kubernetes CPU-hanteringsprinciper . Tillåtna värden är "none" och "static".
failSwapOn

boolean

Om värdet är sant gör det att Kubelet inte startar om växlingen är aktiverad på noden.
imageGcHighThreshold

integer

Den procent av diskanvändningen varefter skräpinsamling av avbildningar alltid körs.
Om du vill inaktivera skräpinsamling av avbildningar anger du till 100. Standardvärdet är 85 %
imageGcLowThreshold

integer

Den procent av diskanvändningen före vilken skräpinsamling av avbildningar aldrig körs.
Det går inte att ange högre än imageGcHighThreshold. Standardvärdet är 80 %
podMaxPids

integer

Det maximala antalet processer per podd.
topologyManagerPolicy

string

Topologihanterarens princip som ska användas.
Mer information finns i Kubernetes Topology Manager. Standardvärdet är "none". Tillåtna värden är "none", "best-effort", "restricted" och "single-numa-node".

KubeletDiskType

Avgör placeringen av emptyDir-volymer, containerns körningsdatarot och tillfällig Kubelet-lagring.

Name Typ Description
OS

string

Kubelet använder OS-disken för sina data.
Temporary

string

Kubelet använder den tillfälliga disken för sina data.

LinuxOSConfig

OS-konfigurationer av Linux-agentnoder.

Name Typ Description
swapFileSizeMB

integer

Storleken i MB för en växlingsfil som skapas på varje nod.
sysctls

SysctlConfig

Sysctl-inställningar för Linux-agentnoder.
transparentHugePageDefrag

string

Om kerneln ska använda minneskomprimering aggressivt för att göra fler enorma sidor tillgängliga.
Giltiga värden är "always", "defer", "defer+madvise", "madvise" och "never". Standardvärdet är "madvise". Mer information finns i Transparenta enorma sidor.
transparentHugePageEnabled

string

Om transparenta enorma sidor är aktiverade.
Giltiga värden är "always", "madvise" och "never". Standardvärdet är "always". Mer information finns i Transparenta enorma sidor.

OSDiskType

Den operativsystemdisktyp som ska användas för datorer i agentpoolen.

Name Typ Description
Ephemeral

string

Tillfälliga OS-diskar lagras bara på värddatorn, precis som en tillfällig disk. Detta ger kortare svarstid för läsning/skrivning, samt snabbare nodskalning och klusteruppgraderingar.
Managed

string

Azure replikerar operativsystemdisken för en virtuell dator till Azure Storage för att undvika dataförlust om den virtuella datorn behöver flyttas till en annan värd. Eftersom containrar inte är utformade för att ha kvar lokalt tillstånd ger det här beteendet ett begränsat värde samtidigt som det ger vissa nackdelar, inklusive långsammare nodetablering och högre svarstid för läsning/skrivning.

OSSKU

Anger os-SKU:n som används av agentpoolen. Standardvärdet är Ubuntu om OSType är Linux. Standardvärdet är Windows2019 när Kubernetes <= 1.24 eller Windows2022 när Kubernetes >= 1.25 om OSType är Windows.

Name Typ Description
AzureLinux

string

Använd AzureLinux som operativsystem för nodavbildningar. Azure Linux är en containeroptimerad Linux-distribution som skapats av Microsoft för https://aka.ms/azurelinux mer information.
CBLMariner

string

Inaktuell OSSKU. Microsoft rekommenderar att nya distributioner väljer "AzureLinux" i stället.
Ubuntu

string

Använd Ubuntu som operativsystem för nodavbildningar.
Windows2019

string

Använd Windows2019 som operativsystem för nodavbildningar. Stöds inte för systemnodpooler. Windows2019 stöder endast Windows2019-containrar. Det går inte att köra Windows2022-containrar och vice versa.
Windows2022

string

Använd Windows2022 som operativsystem för nodavbildningar. Stöds inte för systemnodpooler. Windows2022 stöder endast Windows2022-containrar. Det går inte att köra Windows2019-containrar och vice versa.

OSType

Operativsystemtypen. Standardvärdet är Linux.

Name Typ Description
Linux

string

Använd Linux.
Windows

string

Använd Windows.

PortRange

Portintervallet.

Name Typ Description
portEnd

integer

Den maximala port som ingår i intervallet. Den bör vara mellan 1 och 65535 och vara större än eller lika med portStart.
portStart

integer

Den minsta port som ingår i intervallet. Den bör vara mellan 1 och 65535 och vara mindre än eller lika med portEnd.
protocol

Protocol

Portens nätverksprotokoll.

PowerState

Beskriver klustrets energitillstånd

Name Typ Description
code

code

Anger om klustret körs eller stoppas

Protocol

Portens nätverksprotokoll.

Name Typ Description
TCP

string

TCP-protokoll.
UDP

string

UDP-protokoll.

ScaleDownMode

Beskriver hur virtuella datorer läggs till eller tas bort från agentpooler. Se faktureringstillstånd.

Name Typ Description
Deallocate

string

Försök att starta frigjorda instanser (om de finns) under uppskalning och frigöra instanser under nedskalning.
Delete

string

Skapa nya instanser under uppskalning och ta bort instanser under nedskalning.

ScaleSetEvictionPolicy

Borttagningsprincipen för vm-skalningsuppsättning.

Name Typ Description
Deallocate

string

Noder i den underliggande skalningsuppsättningen för nodpoolen är inställda på det stoppade frigjorda tillståndet vid borttagning. Noder i det stoppade frigjorda tillståndet räknas mot din beräkningskvot och kan orsaka problem med klusterskalning eller uppgradering.
Delete

string

Noder i den underliggande skalningsuppsättningen för nodpoolen tas bort när de tas bort.

ScaleSetPriority

Prioritet för VM-skalningsuppsättning.

Name Typ Description
Regular

string

Vanliga virtuella datorer används.
Spot

string

Virtuella datorer med spotprioritet används. Det finns inget serviceavtal för skalningsnoder för oanvänd kapacitet. Mer information finns i punkt på AKS .

SysctlConfig

Sysctl-inställningar för Linux-agentnoder.

Name Typ Description
fsAioMaxNr

integer

Sysctl-inställning fs.aio-max-nr.
fsFileMax

integer

Sysctl-inställning fs.file-max.
fsInotifyMaxUserWatches

integer

Sysctl-inställning fs.inotify.max_user_watches.
fsNrOpen

integer

Sysctl-inställning fs.nr_open.
kernelThreadsMax

integer

Sysctl-inställning kernel.threads-max.
netCoreNetdevMaxBacklog

integer

Sysctl-inställning net.core.netdev_max_backlog.
netCoreOptmemMax

integer

Sysctl-inställning net.core.optmem_max.
netCoreRmemDefault

integer

Sysctl-inställning net.core.rmem_default.
netCoreRmemMax

integer

Sysctl-inställning net.core.rmem_max.
netCoreSomaxconn

integer

Sysctl-inställning net.core.somaxconn.
netCoreWmemDefault

integer

Sysctl-inställning net.core.wmem_default.
netCoreWmemMax

integer

Sysctl-inställning net.core.wmem_max.
netIpv4IpLocalPortRange

string

Sysctl-inställning net.ipv4.ip_local_port_range.
netIpv4NeighDefaultGcThresh1

integer

Sysctl-inställning net.ipv4.neigh.default.gc_thresh1.
netIpv4NeighDefaultGcThresh2

integer

Sysctl-inställning net.ipv4.neigh.default.gc_thresh2.
netIpv4NeighDefaultGcThresh3

integer

Sysctl-inställning net.ipv4.neigh.default.gc_thresh3.
netIpv4TcpFinTimeout

integer

Sysctl-inställning net.ipv4.tcp_fin_timeout.
netIpv4TcpKeepaliveProbes

integer

Sysctl-inställning net.ipv4.tcp_keepalive_probes.
netIpv4TcpKeepaliveTime

integer

Sysctl-inställning net.ipv4.tcp_keepalive_time.
netIpv4TcpMaxSynBacklog

integer

Sysctl-inställning net.ipv4.tcp_max_syn_backlog.
netIpv4TcpMaxTwBuckets

integer

Sysctl-inställning net.ipv4.tcp_max_tw_buckets.
netIpv4TcpTwReuse

boolean

Sysctl-inställning net.ipv4.tcp_tw_reuse.
netIpv4TcpkeepaliveIntvl

integer

Sysctl-inställning net.ipv4.tcp_keepalive_intvl.
netNetfilterNfConntrackBuckets

integer

Sysctl-inställning net.netfilter.nf_conntrack_buckets.
netNetfilterNfConntrackMax

integer

Sysctl-inställning net.netfilter.nf_conntrack_max.
vmMaxMapCount

integer

Sysctl-inställning vm.max_map_count.
vmSwappiness

integer

Sysctl-inställning vm.swappiness.
vmVfsCachePressure

integer

Sysctl-inställning vm.vfs_cache_pressure.

WorkloadRuntime

Avgör vilken typ av arbetsbelastning en nod kan köra.

Name Typ Description
OCIContainer

string

Noder använder Kubelet för att köra standard OCI-containerarbetsbelastningar.
WasmWasi

string

Noder använder Krustlet för att köra WASM-arbetsbelastningar med WASI-providern (förhandsversion).