Agent Pools - Create Or Update
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=2026-02-01
URI-parametrar
| Name | I | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
agent
|
path | True |
string minLength: 1maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$ |
Namnet på agentpoolen. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
|
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]$ |
Namnet på den hanterade klusterresursen. |
|
subscription
|
path | True |
string (uuid) |
ID för målprenumerationen. Värdet måste vara ett UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Den API-version som ska användas för den här åtgärden. |
Begärandehuvud
| Name | Obligatorisk | Typ | Description |
|---|---|---|---|
| if-match |
string |
Begäran bör endast fortsätta om en entitet matchar den här strängen. |
|
| if-none-match |
string |
Begäran bör endast fortsätta om ingen entitet matchar den här strängen. |
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 (arm-id) |
Det fullt kvalificerade resurs-ID:t för Capacity Reservation Group för att tillhandahålla virtual machines från en reserverad grupp av Virtual Machines. Detta är av formen: '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft. Compute/capacityreservationgroups/{capacityReservationGroupName}' Kunder använder det för att skapa en agentpool med en specificerad CRG. För mer information, se Capacity Reservation |
| properties.count |
integer (int32) |
Antal agenter (VIRTUELLA datorer) 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 i intervallet 1 till 1 000 (inklusive) för systempooler. Standardvärdet är 1. |
| properties.creationData |
CreationData som ska användas för att ange källans ögonblicksbilds-ID om nodpoolen ska skapas/uppgraderas med hjälp av en ögonblicksbild. |
|
| 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. Mer information finns i: 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 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 falskt. |
| properties.enableUltraSSD |
boolean |
Om du vill aktivera UltraSSD |
| properties.gatewayProfile |
Profil som är specifik för en hanterad agentpool i gatewayläge. Det går inte att ange det här fältet om agentpoolläget inte är gateway. |
|
| properties.gpuInstanceProfile |
GPUInstanceProfile som ska användas för att ange GPU MIG-instansprofil för GPU VM SKU som stöds. |
|
| properties.gpuProfile |
GPU-inställningar för agentpoolen. |
|
| properties.hostGroupID |
string (arm-id) |
Det fullständigt kvalificerade resurs-ID:t för den dedikerade värdgruppen som ska etablera virtuella datorer från, som endast används i skapandescenariot och som inte tillåts ändras en gång. Detta är av formen: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Compute/hostGroups/{hostGroupName}. För mer information, se Azure dedikerade värdar. |
| properties.kubeletConfig |
Kubelet-konfigurationen på agentpoolnoderna. |
|
| properties.kubeletDiskType |
Avgör placeringen av emptyDir-volymer, containerkörningsdatarot och tillfällig Kubelet-lagring. |
|
| properties.linuxOSConfig |
Operativsystemets konfiguration av Linux-agentnoder. |
|
| properties.localDNSProfile |
Konfigurerar den lokala DNS:en per nod med VnetDNS- och KubeDNS-åsidosättningar. LocalDNS hjälper till att förbättra prestanda och tillförlitlighet för DNS-matchning i ett AKS-kluster. Mer information finns i aka.ms/aks/localdns. |
|
| properties.maxCount |
integer (int32) |
Maximalt antal noder för automatisk skalning |
| properties.maxPods |
integer (int32) |
Det maximala antalet poddar som kan köras på en nod. |
| properties.messageOfTheDay |
string |
Dagens meddelande för Linux-noder, base64-kodat. En base64-kodad sträng som skrivs till /etc/motd efter avkodning. Detta möjliggör anpassning av dagens meddelande för Linux-noder. Den får inte specificeras för Windows-noder. Det måste vara en statisk sträng (d.v.s. skrivs ut rå och körs inte som ett skript). |
| properties.minCount |
integer (int32) |
Det minsta antalet noder för automatisk skalning |
| properties.mode |
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 |
Nätverksrelaterade inställningar för en agentpool. |
|
| properties.nodeLabels |
object |
Nodetiketterna som ska bevaras över alla noder i agentpoolen. |
| properties.nodePublicIPPrefixID |
string (arm-id) |
Det offentliga IP-prefix-ID som vm-noder ska använda IP-adresser från. Detta är av formen: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/publicIPPrefixes/{publicIPPrefixName} |
| properties.nodeTaints |
string[] |
Tainterna som 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 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> har angetts väljs den senaste ga-korrigeringsversionen automatiskt. När klustret uppdateras med samma <major.minor> när det har skapats (t.ex. 1.14.x–> 1.14) utlöses inte en 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 (int32) minimum: 0maximum: 2048 |
Operativsystemets diskstorlek i GB som ska användas för att ange diskstorleken för varje dator i huvud-/agentpoolen. Om du anger 0 tillämpas standardstorleken för osDisk enligt den angivna vmSize-storleken. |
| properties.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 |
Anger os-SKU:n som används av agentpoolen. Standardvärdet är Ubuntu om OSType är Linux. Standardinställningen är Windows2019 när Kubernetes <= 1.24 eller Windows2022 när Kubernetes >= 1.25 om OSType är Windows. |
|
| properties.osType |
Typ av operativsystem. Standardvärdet är Linux. |
|
| properties.podIPAllocationMode |
Läge för IP-allokering av poddar. IP-allokeringsläget för poddar i agentpoolen. Måste användas med podSubnetId. Standardvärdet är "DynamicIndividual". |
|
| properties.podSubnetID |
string (arm-id) |
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 (mer information finns i vnetSubnetID). Detta är av formen: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} |
| properties.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 har slutförts |
|
| properties.proximityPlacementGroupID |
string (arm-id) |
ID för närhetsplaceringsgrupp. |
| properties.scaleDownMode |
Nedskalningsläget som ska användas vid skalning av agentpoolen. Detta påverkar även autoskalningsbeteendet för klustret. Om det inte anges är standardinställningen Ta bort. |
|
| properties.scaleSetEvictionPolicy |
Borttagningsprincipen för VM-skalningsuppsättningen. Vräkningspolicyn specificerar vad som to do med VM:n när den vräkas. Standardvärdet är Ta bort. För mer information om vräkning, se spot VMs |
|
| properties.scaleSetPriority |
Prioritet för VM-skalningsuppsättning. |
|
| properties.securityProfile |
Säkerhetsinställningarna för en agentpool. |
|
| properties.spotMaxPrice |
number (float) |
Det högsta priset (i us-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 anger att standardpriset är up-to 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 priser för virtuella datorer med oanvänd kapacitet |
| properties.status |
Innehåller skrivskyddad information om agentpoolen. |
|
| properties.tags |
object |
Taggarna som ska sparas på vm-skalningsuppsättningen för agentpoolen. |
| properties.type |
Typ av agentpool. |
|
| properties.upgradeSettings |
Inställningar för att uppgradera agentpoolen |
|
| properties.virtualMachineNodesStatus |
Status för noder i en VirtualMachines-agentpool. |
|
| properties.virtualMachinesProfile |
Specifikationer för VirtualMachines-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, processor osv.) kan poddar inte köras korrekt. Mer information om begränsade VM-storlekar finns i: https://docs.microsoft.com/azure/aks/quotas-skus-regions |
| properties.vnetSubnetID |
string (arm-id) |
ID:t för undernätet som agentpoolnoder och eventuellt poddar ansluter till vid start. Om detta inte anges genereras och används ett VNET och undernät. Om inget podSubnetID har angetts gäller detta för noder och poddar, annars gäller det bara för noder. Detta är av formen: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} |
| properties.windowsProfile |
Windows agentpoolens specifika profil. |
|
| properties.workloadRuntime |
Avgör vilken typ av arbetsbelastning en nod kan köra. |
Svar
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Uppdateringsåtgärden för resursen "AgentPool" lyckades |
|
| 201 Created |
Resursen "AgentPool" har skapats Sidhuvuden
|
|
| Other Status Codes |
Ett oväntat felsvar. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
| Name | Description |
|---|---|
| user_impersonation | personifiera ditt användarkonto |
Exempel
Create Agent Pool using an agent pool snapshot
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
]
}
}
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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
}
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
}
Exempelsvar
{
"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
Exempelbegäran
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"
}
}
Exempelsvar
{
"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"
}
}
Definitioner
| Name | Description |
|---|---|
|
Agent |
Agentpool. |
|
Agent |
Profil för agentpoolen för den hanterade klustergatewayen. |
|
Agent |
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 |
|
Agent |
Nätverksinställningar för en agentpool. |
|
Agent |
Säkerhetsinställningarna för en agentpool. |
|
Agent |
SSH-access-metoden för en agentpool. |
|
Agent |
Innehåller skrivskyddad information om agentpoolen. |
|
Agent |
Typ av agentpool. |
|
Agent |
Inställningar för att uppgradera en agentpool |
|
Agent |
Windows agentpoolens specifika profil. |
| Code |
Anger om klustret körs eller stoppas |
|
created |
Den typ av identitet som skapade resursen. |
|
Creation |
Data som används när du skapar en målresurs från en källresurs. |
|
Error |
Resurshanteringsfelet ytterligare information. |
|
Error |
Detaljerna om felet. |
|
Error |
Felsvar |
| GPUDriver |
Om du vill installera GPU-drivrutiner. När den inte har angetts är standardinställningen Installera. |
|
GPUInstance |
GPUInstanceProfile som ska användas för att ange GPU MIG-instansprofil för GPU VM SKU som stöds. |
| GPUProfile |
GPU-inställningar för agentpoolen. |
| IPTag |
Innehåller DEN IPTag som är associerad med objektet. |
|
Kubelet |
Kubelet-konfigurationer av agentnoder. Mer information finns i konfiguration av anpassade AKS-noder. |
|
Kubelet |
Avgör placeringen av emptyDir-volymer, containerkörningsdatarot och tillfällig Kubelet-lagring. |
|
Linux |
OS-konfigurationer av Linux-agentnoder. Mer information finns i konfiguration av anpassade AKS-noder. |
|
Local |
Målserver för DNS-frågor som ska vidarebefordras från localDNS. |
|
Local |
Vidarebefordra princip för att välja överordnad DNS-server. Se vidarebefordra plugin för mer information. |
|
Local |
Aktiveringsläge för localDNS. |
|
Local |
Åsidosättningar för localDNS-profil. |
|
Local |
Konfigurerar den lokala DNS:en per nod med VnetDNS- och KubeDNS-åsidosättningar. LocalDNS hjälper till att förbättra prestanda och tillförlitlighet för DNS-matchning i ett AKS-kluster. Mer information finns i aka.ms/aks/localdns. |
|
Local |
Framtvinga TCP eller föredra UDP-protokoll för anslutningar från localDNS till överordnad DNS-server. |
|
Local |
Loggnivå för DNS-frågor i localDNS. |
|
Local |
Princip för att betjäna inaktuella data. Se cache-plugin för mer information. |
|
Local |
Systemgenererat tillstånd för localDNS. |
|
Manual |
Specifikationer för antal datorer. |
|
OSDisk |
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. |
| OSSKU |
Anger os-SKU:n som används av agentpoolen. Standardvärdet är Ubuntu om OSType är Linux. Standardinställningen är Windows2019 när Kubernetes <= 1.24 eller Windows2022 när Kubernetes >= 1.25 om OSType är Windows. |
| OSType |
Typ av operativsystem. Standardvärdet är Linux. |
|
Pod |
Läge för IP-allokering av poddar. IP-allokeringsläget för poddar i agentpoolen. Måste användas med podSubnetId. Standardvärdet är "DynamicIndividual". |
|
Port |
Portintervallet. |
|
Power |
Beskriver klustrets energitillstånd |
| Protocol |
Portens nätverksprotokoll. |
|
Scale |
Beskriver hur virtuella datorer läggs till eller tas bort från agentpooler. Se faktureringsstatus. |
|
Scale |
Specifikationer för hur du skalar en VirtualMachines-agentpool. |
|
Scale |
Borttagningsprincipen för VM-skalningsuppsättningen. Vräkningspolicyn specificerar vad som to do med VM:n när den vräkas. Standardvärdet är Ta bort. För mer information om vräkning, se spot VMs |
|
Scale |
Prioritet för VM-skalningsuppsättning. |
|
Sysctl |
Sysctl-inställningar för Linux-agentnoder. |
|
system |
Metadata som rör skapande och senaste ändring av resursen. |
|
Undrainable |
Definierar beteendet för oanvändbara noder under uppgraderingen. Den vanligaste orsaken till oanvändbara noder är poddavbrottsbudgetar (PDB), men andra problem, till exempel respitperiod för poddavslut överskrider den återstående timeouten per nod eller podden fortfarande är i ett körningstillstånd, kan också orsaka oanvändbara noder. |
|
Virtual |
Aktuell status för en grupp noder med samma vm-storlek. |
|
Virtual |
Specifikationer för VirtualMachines-agentpoolen. |
|
Workload |
Avgör vilken typ av arbetsbelastning en nod kan köra. |
AgentPool
Agentpool.
| Name | Typ | Standardvärde | Description |
|---|---|---|---|
| id |
string (arm-id) |
Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
| name |
string |
Namnet på 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 (arm-id) |
Det fullt kvalificerade resurs-ID:t för Capacity Reservation Group för att tillhandahålla virtual machines från en reserverad grupp av Virtual Machines. Detta är av formen: '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft. Compute/capacityreservationgroups/{capacityReservationGroupName}' Kunder använder det för att skapa en agentpool med en specificerad CRG. För mer information, se Capacity Reservation |
|
| properties.count |
integer (int32) |
Antal agenter (VIRTUELLA datorer) 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 i intervallet 1 till 1 000 (inklusive) för systempooler. Standardvärdet är 1. |
|
| properties.creationData |
CreationData som ska användas för att ange källans ögonblicksbilds-ID om nodpoolen ska skapas/uppgraderas med hjälp av en ögonblicksbild. |
||
| properties.currentOrchestratorVersion |
string |
Versionen av Kubernetes som agentpoolen körs. 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-> version som används. |
|
| properties.eTag |
string |
Unik skrivskyddad sträng som används för att implementera optimistisk samtidighet. ETag-värdet ändras när resursen uppdateras. Ange ett if-match- eller if-none-match-huvud med eTag-värdet för en efterföljande begäran för att aktivera optimistisk samtidighet enligt den normala eTag-konventionen. |
|
| 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. Mer information finns i: 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 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 falskt. |
|
| properties.enableUltraSSD |
boolean |
Om du vill aktivera UltraSSD |
|
| properties.gatewayProfile |
Profil som är specifik för en hanterad agentpool i gatewayläge. Det går inte att ange det här fältet om agentpoolläget inte är gateway. |
||
| properties.gpuInstanceProfile |
GPUInstanceProfile som ska användas för att ange GPU MIG-instansprofil för GPU VM SKU som stöds. |
||
| properties.gpuProfile |
GPU-inställningar för agentpoolen. |
||
| properties.hostGroupID |
string (arm-id) |
Det fullständigt kvalificerade resurs-ID:t för den dedikerade värdgruppen som ska etablera virtuella datorer från, som endast används i skapandescenariot och som inte tillåts ändras en gång. Detta är av formen: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Compute/hostGroups/{hostGroupName}. För mer information, se Azure dedikerade värdar. |
|
| properties.kubeletConfig |
Kubelet-konfigurationen på agentpoolnoderna. |
||
| properties.kubeletDiskType |
Avgör placeringen av emptyDir-volymer, containerkörningsdatarot och tillfällig Kubelet-lagring. |
||
| properties.linuxOSConfig |
Operativsystemets konfiguration av Linux-agentnoder. |
||
| properties.localDNSProfile |
Konfigurerar den lokala DNS:en per nod med VnetDNS- och KubeDNS-åsidosättningar. LocalDNS hjälper till att förbättra prestanda och tillförlitlighet för DNS-matchning i ett AKS-kluster. Mer information finns i aka.ms/aks/localdns. |
||
| properties.maxCount |
integer (int32) |
Maximalt antal noder för automatisk skalning |
|
| properties.maxPods |
integer (int32) |
Det maximala antalet poddar som kan köras på en nod. |
|
| properties.messageOfTheDay |
string |
Dagens meddelande för Linux-noder, base64-kodat. En base64-kodad sträng som skrivs till /etc/motd efter avkodning. Detta möjliggör anpassning av dagens meddelande för Linux-noder. Den får inte specificeras för Windows-noder. Det måste vara en statisk sträng (d.v.s. skrivs ut rå och körs inte som ett skript). |
|
| properties.minCount |
integer (int32) |
Det minsta antalet noder för automatisk skalning |
|
| properties.mode |
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 |
Nätverksrelaterade inställningar för en agentpool. |
||
| properties.nodeImageVersion |
string |
Version av nodbild |
|
| properties.nodeLabels |
object |
Nodetiketterna som ska bevaras över alla noder i agentpoolen. |
|
| properties.nodePublicIPPrefixID |
string (arm-id) |
Det offentliga IP-prefix-ID som vm-noder ska använda IP-adresser från. Detta är av formen: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/publicIPPrefixes/{publicIPPrefixName} |
|
| properties.nodeTaints |
string[] |
Tainterna som 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 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> har angetts väljs den senaste ga-korrigeringsversionen automatiskt. När klustret uppdateras med samma <major.minor> när det har skapats (t.ex. 1.14.x–> 1.14) utlöses inte en 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 (int32) minimum: 0maximum: 2048 |
Operativsystemets diskstorlek i GB som ska användas för att ange diskstorleken för varje dator i huvud-/agentpoolen. Om du anger 0 tillämpas standardstorleken för osDisk enligt den angivna vmSize-storleken. |
|
| properties.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 |
Anger os-SKU:n som används av agentpoolen. Standardvärdet är Ubuntu om OSType är Linux. Standardinställningen är Windows2019 när Kubernetes <= 1.24 eller Windows2022 när Kubernetes >= 1.25 om OSType är Windows. |
||
| properties.osType | Linux |
Typ av operativsystem. Standardvärdet är Linux. |
|
| properties.podIPAllocationMode |
Läge för IP-allokering av poddar. IP-allokeringsläget för poddar i agentpoolen. Måste användas med podSubnetId. Standardvärdet är "DynamicIndividual". |
||
| properties.podSubnetID |
string (arm-id) |
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 (mer information finns i vnetSubnetID). Detta är av formen: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} |
|
| properties.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 har slutförts |
||
| properties.provisioningState |
string |
Det aktuella distributions- eller etableringstillståndet. |
|
| properties.proximityPlacementGroupID |
string (arm-id) |
ID för närhetsplaceringsgrupp. |
|
| properties.scaleDownMode |
Nedskalningsläget som ska användas vid skalning av agentpoolen. Detta påverkar även autoskalningsbeteendet för klustret. Om det inte anges är standardinställningen Ta bort. |
||
| properties.scaleSetEvictionPolicy | Delete |
Borttagningsprincipen för VM-skalningsuppsättningen. Vräkningspolicyn specificerar vad som to do med VM:n när den vräkas. Standardvärdet är Ta bort. För mer information om vräkning, se spot VMs |
|
| properties.scaleSetPriority | Regular |
Prioritet för VM-skalningsuppsättning. |
|
| properties.securityProfile |
Säkerhetsinställningarna för en agentpool. |
||
| properties.spotMaxPrice |
number (float) |
-1 |
Det högsta priset (i us-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 anger att standardpriset är up-to 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 priser för virtuella datorer med oanvänd kapacitet |
| properties.status |
Innehåller skrivskyddad information om agentpoolen. |
||
| properties.tags |
object |
Taggarna som ska sparas på vm-skalningsuppsättningen för agentpoolen. |
|
| properties.type |
Typ av agentpool. |
||
| properties.upgradeSettings |
Inställningar för att uppgradera agentpoolen |
||
| properties.virtualMachineNodesStatus |
Status för noder i en VirtualMachines-agentpool. |
||
| properties.virtualMachinesProfile |
Specifikationer för VirtualMachines-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, processor osv.) kan poddar inte köras korrekt. Mer information om begränsade VM-storlekar finns i: https://docs.microsoft.com/azure/aks/quotas-skus-regions |
|
| properties.vnetSubnetID |
string (arm-id) |
ID:t för undernätet som agentpoolnoder och eventuellt poddar ansluter till vid start. Om detta inte anges genereras och används ett VNET och undernät. Om inget podSubnetID har angetts gäller detta för noder och poddar, annars gäller det bara för noder. Detta är av formen: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} |
|
| properties.windowsProfile |
Windows agentpoolens specifika profil. |
||
| properties.workloadRuntime |
Avgör vilken typ av arbetsbelastning en nod kan köra. |
||
| systemData |
Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information. |
||
| type |
string |
Resurstypen. T.ex. "Microsoft. Compute/virtualMachines" eller "Microsoft. Storage/storageAccounts" |
AgentPoolGatewayProfile
Profil för agentpoolen för den hanterade klustergatewayen.
| Name | Typ | Standardvärde | Description |
|---|---|---|---|
| publicIPPrefixSize |
integer (int32) minimum: 28maximum: 31 |
31 |
Gateway-agentpoolen associerar en offentlig IPPrefix för varje statisk utgående gateway för att tillhandahålla offentlig utgående trafik. Storleken på offentlig IPPrefix ska väljas av användaren. Varje nod i agentpoolen tilldelas en IP-adress från IPPrefix. IPPrefix-storleken fungerar därmed som ett tak för storleken på gatewayagentpoolen. På grund av Azure offentlig STORLEKsbegränsning för IPPrefix är det giltiga värdeintervallet [28, 31] (/31 = 2 noder/IP-adresser, /30 = 4 noder/IP-adresser, /29 = 8 noder/IP-adresser, /28 = 16 noder/IP-adresser). Standardvärdet är 31. |
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
| Värde | Description |
|---|---|
| System |
Systemagentpooler är främst till för att hantera 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 |
Användaragentpooler är främst till för att vara värd för dina programpoddar. |
| Gateway |
Gatewayagentpooler är dedikerade för att tillhandahålla statiska utgående IP-adresser till poddar. Mer information finns i https://aka.ms/aks/static-egress-gateway. |
AgentPoolNetworkProfile
Nätverksinställningar för en agentpool.
| Name | Typ | Description |
|---|---|---|
| allowedHostPorts |
De portområden som tillåts access. De angivna intervallen får överlappa varandra. |
|
| applicationSecurityGroups |
string[] (arm-id) |
ID:t för de programsäkerhetsgrupper som agentpoolen associerar när de skapas. |
| nodePublicIPTags |
IPTag[] |
IPTags för offentliga IP-adresser på instansnivå. |
AgentPoolSecurityProfile
Säkerhetsinställningarna för en agentpool.
| Name | Typ | Description |
|---|---|---|
| enableSecureBoot |
boolean |
Säker start är en funktion i Trusted Launch som säkerställer att endast signerade operativsystem och drivrutiner kan starta. Mer information finns i aka.ms/aks/trustedlaunch. Om det inte anges är standardvärdet falskt. |
| enableVTPM |
boolean |
vTPM är en betrodd startfunktion för att konfigurera ett dedikerat säkert valv för nycklar och mått som lagras lokalt på noden. Mer information finns i aka.ms/aks/trustedlaunch. Om det inte anges är standardvärdet falskt. |
| sshAccess |
SSH-access-metoden för en agentpool. |
AgentPoolSSHAccess
SSH-access-metoden för en agentpool.
| Värde | Description |
|---|---|
| LocalUser |
Kan SSH till noden som en lokal användare med hjälp av privat nyckel. |
| Disabled |
SSH-tjänsten stängs av på noden. |
AgentPoolStatus
Innehåller skrivskyddad information om agentpoolen.
| Name | Typ | Description |
|---|---|---|
| provisioningError |
Felinformationen för agentpoolen. Bevarar detaljerad information om fel. Om det inte uppstod något fel utelämnas det här fältet. |
AgentPoolType
Typ av agentpool.
| Värde | Description |
|---|---|
| VirtualMachineScaleSets |
Skapa en agentpool som backas upp av en VM-skalningsuppsättning. |
| AvailabilitySet |
Användning av detta rekommenderas starkt. |
| VirtualMachines |
Skapa en agentpool som backas upp av en vm-orkestreringsläge för en enskild instans. |
AgentPoolUpgradeSettings
Inställningar för att uppgradera en agentpool
| Name | Typ | Description |
|---|---|---|
| drainTimeoutInMinutes |
integer (int32) minimum: 1maximum: 1440 |
Tidsgränsen för tömning för en nod. Hur lång tid (i minuter) som ska vänta vid borttagning av poddar och graciös avslutning per nod. Den här avhysningsväntetiden hedrar väntan på poddavbrottsbudgetar. Om den här tiden överskrids misslyckas uppgraderingen. Om det inte 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 procentandel anges är det procentandelen av den totala agentpoolens storlek vid tidpunkten för uppgraderingen. För procentandelar avrundas bråknoder uppåt. Om det inte anges är standardvärdet 10%. Mer information, inklusive metodtips, finns i: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster |
| maxUnavailable |
string |
Det maximala antalet eller procentandelen noder som kan vara samtidigt otillgängliga under uppgraderingen. Detta kan antingen anges till ett heltal (t.ex. "1") eller en procentandel (t.ex. "5%"). Om en procentandel anges är det procentandelen av den totala agentpoolens storlek vid tidpunkten för uppgraderingen. För procentandelar avrundas bråknoder uppåt. Om det inte anges är standardvärdet 0. Mer information, inklusive metodtips, finns i: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster |
| nodeSoakDurationInMinutes |
integer (int32) minimum: 0maximum: 30 |
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 det inte anges är standardvärdet 0 minuter. |
| undrainableNodeBehavior |
Definierar beteendet för oanvändbara noder under uppgraderingen. Den vanligaste orsaken till oanvändbara noder är poddavbrottsbudgetar (PDB), men andra problem, till exempel respitperiod för poddavslut överskrider den återstående timeouten per nod eller podden fortfarande är i ett körningstillstånd, kan också orsaka oanvändbara noder. |
AgentPoolWindowsProfile
Windows agentpoolens specifika profil.
| Name | Typ | Description |
|---|---|---|
| disableOutboundNat |
boolean |
Om du vill inaktivera OutboundNAT i Windows-noder. Standardvärdet är falskt. Utgående NAT kan bara inaktiveras om klustret outboundType är NAT Gateway och Windows-agentpoolen inte har nodens offentliga IP-adress aktiverad. |
Code
Anger om klustret körs eller stoppas
| Värde | Description |
|---|---|
| Running |
Klustret körs. |
| Stopped |
Klustret stoppas. |
createdByType
Den typ av identitet som skapade resursen.
| Värde | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
CreationData
Data som används när du skapar en målresurs från en källresurs.
| Name | Typ | Description |
|---|---|---|
| sourceResourceId |
string (arm-id) |
Det här är ARM-ID:t för källobjektet som ska användas för att skapa målobjektet. |
ErrorAdditionalInfo
Resurshanteringsfelet ytterligare information.
| Name | Typ | Description |
|---|---|---|
| info |
object |
Den ytterligare informationen. |
| type |
string |
Typen av ytterligare information. |
ErrorDetail
Detaljerna om felet.
| Name | Typ | Description |
|---|---|---|
| additionalInfo |
Felet ytterligare information. |
|
| code |
string |
Felkoden. |
| details |
Felinformationen. |
|
| message |
string |
Felmeddelandet. |
| target |
string |
Felmålet. |
ErrorResponse
Felsvar
| Name | Typ | Description |
|---|---|---|
| error |
Felet objektet. |
GPUDriver
Om du vill installera GPU-drivrutiner. När den inte har angetts är standardinställningen Installera.
| Värde | Description |
|---|---|
| Install |
Installera drivrutin. |
| None |
Hoppa över drivrutinsinstallation. |
GPUInstanceProfile
GPUInstanceProfile som ska användas för att ange GPU MIG-instansprofil för GPU VM SKU som stöds.
| Värde | Description |
|---|---|
| MIG1g |
MIG 1G GPU-instansprofil. |
| MIG2g |
MIG 2G GPU-instansprofil. |
| MIG3g |
MIG 3G GPU-instansprofil. |
| MIG4g |
MIG 4G GPU-instansprofil. |
| MIG7g |
MIG 7G GPU-instansprofil. |
GPUProfile
GPU-inställningar för agentpoolen.
| Name | Typ | Description |
|---|---|---|
| driver |
Om du vill installera GPU-drivrutiner. När den inte har angetts är standardinställningen Installera. |
IPTag
Innehåller DEN IPTag som är associerad med objektet.
| Name | Typ | Description |
|---|---|---|
| ipTagType |
string |
Typ av IP-tagg. 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. Mer information finns i konfiguration av anpassade AKS-noder.
| Name | Typ | Description |
|---|---|---|
| allowedUnsafeSysctls |
string[] |
Tillåten lista över osäkra sysctls eller osäkra sysctl-mönster (slutar i |
| containerLogMaxFiles |
integer (int32) minimum: 2 |
Det maximala antalet containerloggfiler som kan finnas för en container. Talet måste vara ≥ 2. |
| containerLogMaxSizeMB |
integer (int32) |
Maximal storlek (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. 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 kommer Kubelet inte att starta om växlingen är aktiverad på noden. |
| imageGcHighThreshold |
integer (int32) |
Den procent av diskanvändningen varefter skräpinsamling av avbildningar alltid körs. För att inaktivera skräpinsamling av bilder, ange värdet till 100. Standardvärdet är 85% |
| imageGcLowThreshold |
integer (int32) |
Den procentuella andelen av diskanvändning före vilket skräpinsamlingen för bilder aldrig körs. Detta kan inte anges högre än imageGcHighThreshold. Standardvärdet är 80% |
| podMaxPids |
integer (int32) |
Maximalt antal processer per podd. |
| topologyManagerPolicy |
string |
Topologihanterarens princip som ska användas. Mer information finns i Kubernetes Toppology 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, containerkörningsdatarot och tillfällig Kubelet-lagring.
| Värde | Description |
|---|---|
| OS |
Kubelet använder OS-disken för sina data. |
| Temporary |
Kubelet använder den tillfälliga disken för sina data. |
LinuxOSConfig
OS-konfigurationer av Linux-agentnoder. Mer information finns i konfiguration av anpassade AKS-noder.
| Name | Typ | Description |
|---|---|---|
| swapFileSizeMB |
integer (int32) |
Storleken i MB för en växlingsfil som skapas på varje nod. |
| sysctls |
Sysctl-inställningar för Linux-agentnoder. |
|
| transparentHugePageDefrag |
string |
Om kerneln ska använda minneskomprimering aggressivt för att göra fler stora 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. |
LocalDNSForwardDestination
Målserver för DNS-frågor som ska vidarebefordras från localDNS.
| Värde | Description |
|---|---|
| ClusterCoreDNS |
Vidarebefordra DNS-frågor från localDNS till klustrets CoreDNS. |
| VnetDNS |
Vidarebefordra DNS-frågor från localDNS till DNS-servern som konfigurerats i det virtuella nätverket. Ett virtuellt nätverk kan ha flera DNS-servrar konfigurerade. |
LocalDNSForwardPolicy
Vidarebefordra princip för att välja överordnad DNS-server. Se vidarebefordra plugin för mer information.
| Värde | Description |
|---|---|
| Sequential |
Implementerar sekventiellt val av DNS-server uppströms. Se vidarebefordra plugin för mer information. |
| RoundRobin |
Implementerar val av resursallokering av överordnad DNS-server. Se vidarebefordra plugin för mer information. |
| Random |
Implementerar slumpmässigt val av DNS-server uppströms. Se vidarebefordra plugin för mer information. |
LocalDNSMode
Aktiveringsläge för localDNS.
| Värde | Description |
|---|---|
| Preferred |
Om den aktuella orkestreringsversionen stöder den här funktionen föredrar du att aktivera localDNS. |
| Required |
Aktivera localDNS. |
| Disabled |
Inaktivera localDNS. |
LocalDNSOverride
Åsidosättningar för localDNS-profil.
| Name | Typ | Standardvärde | Description |
|---|---|---|---|
| cacheDurationInSeconds |
integer (int32) |
3600 |
Cachelagring av maximalt TTL-värde i sekunder. Se cache-plugin för mer information. |
| forwardDestination | ClusterCoreDNS |
Målserver för DNS-frågor som ska vidarebefordras från localDNS. |
|
| forwardPolicy | Sequential |
Vidarebefordra princip för att välja överordnad DNS-server. Se vidarebefordra plugin för mer information. |
|
| maxConcurrent |
integer (int32) |
1000 |
Maximalt antal samtidiga frågor. Se vidarebefordra plugin för mer information. |
| protocol | PreferUDP |
Framtvinga TCP eller föredra UDP-protokoll för anslutningar från localDNS till överordnad DNS-server. |
|
| queryLogging | Error |
Loggnivå för DNS-frågor i localDNS. |
|
| serveStale | Immediate |
Princip för att betjäna inaktuella data. Se cache-plugin för mer information. |
|
| serveStaleDurationInSeconds |
integer (int32) |
3600 |
Servera inaktuell varaktighet i sekunder. Se cache-plugin för mer information. |
LocalDNSProfile
Konfigurerar den lokala DNS:en per nod med VnetDNS- och KubeDNS-åsidosättningar. LocalDNS hjälper till att förbättra prestanda och tillförlitlighet för DNS-matchning i ett AKS-kluster. Mer information finns i aka.ms/aks/localdns.
| Name | Typ | Standardvärde | Description |
|---|---|---|---|
| kubeDNSOverrides |
<string,
Local |
KubeDNS-åsidosättningar gäller för DNS-trafik från poddar med dnsPolicy:ClusterFirst (kallas KubeDNS-trafik). |
|
| mode | Preferred |
Aktiveringsläge för localDNS. |
|
| state |
Systemgenererat tillstånd för localDNS. |
||
| vnetDNSOverrides |
<string,
Local |
VnetDNS-åsidosättningar gäller för DNS-trafik från poddar med dnsPolicy:default eller kubelet (kallas VnetDNS-trafik). |
LocalDNSProtocol
Framtvinga TCP eller föredra UDP-protokoll för anslutningar från localDNS till överordnad DNS-server.
| Värde | Description |
|---|---|
| PreferUDP |
Föredra UDP-protokoll för anslutningar från localDNS till den överordnade DNS-servern. |
| ForceTCP |
Framtvinga TCP-protokoll för anslutningar från localDNS till överordnad DNS-server. |
LocalDNSQueryLogging
Loggnivå för DNS-frågor i localDNS.
| Värde | Description |
|---|---|
| Error |
Aktiverar felloggning i localDNS. Se plugin-programmet errors för mer information. |
| Log |
Aktiverar frågeloggning i localDNS. Se logg-plugin för mer information. |
LocalDNSServeStale
Princip för att betjäna inaktuella data. Se cache-plugin för mer information.
| Värde | Description |
|---|---|
| Verify |
Hantera inaktuella data med verifiering. Kontrollera först att en post fortfarande inte är tillgänglig från källan innan du skickar den utgångna posten till klienten. Se cache-plugin för mer information. |
| Immediate |
Servera inaktuella data omedelbart. Skicka den utgångna posten till klienten innan du kontrollerar om posten är tillgänglig från källan. Se cache-plugin för mer information. |
| Disable |
Inaktivera servering av inaktuella data. |
LocalDNSState
Systemgenererat tillstånd för localDNS.
| Värde | Description |
|---|---|
| Enabled |
localDNS är aktiverat. |
| Disabled |
localDNS är inaktiverat. |
ManualScaleProfile
Specifikationer för antal datorer.
| Name | Typ | Description |
|---|---|---|
| count |
integer (int32) |
Antal noder. |
| size |
string |
VM-storlek som AKS använder när du skapar och skalar, t.ex. "Standard_E4s_v3", "Standard_E16s_v3" eller "Standard_D16s_v5". |
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.
| Värde | Description |
|---|---|
| Managed |
Azure replikerar operativsystemets disk för en virtuell maskin till Azure-lagring för att undvika dataförlust om VM:n 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 vissa nackdelar, inklusive långsammare nodetablering och högre svarstid för läsning/skrivning. |
| Ephemeral |
Tillfälliga OS-diskar lagras bara på värddatorn, precis som en tillfällig disk. Detta ger lägre svarstid för läsning/skrivning, tillsammans med snabbare nodskalning och klusteruppgraderingar. |
OSSKU
Anger os-SKU:n som används av agentpoolen. Standardvärdet är Ubuntu om OSType är Linux. Standardinställningen är Windows2019 när Kubernetes <= 1.24 eller Windows2022 när Kubernetes >= 1.25 om OSType är Windows.
| Värde | Description |
|---|---|
| Ubuntu |
Använd Ubuntu som operativsystem för nodavbildningar. |
| AzureLinux |
Använd AzureLinux som operativsystem för nodavbildningar. Azure Linux är en containeroptimerad Linux-distribution byggd av Microsoft, besök https://aka.ms/azurelinux för mer information. |
| AzureLinux3 |
Använd AzureLinux3 som operativsystem för nodavbildningar. Azure Linux är en containeroptimerad Linux-distribution byggd av Microsoft, besök https://aka.ms/azurelinux för mer information. Om du vill begränsa antalet besök kan du besöka https://aka.ms/aks/node-images. Vägledning för OS-migrering finns i https://aka.ms/aks/upgrade-os-version. |
| CBLMariner |
Inaktuell OSSKU. Microsoft rekommenderar att nya implementationer väljer 'AzureLinux' istället. |
| Windows2019 |
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 |
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. |
| Ubuntu2204 |
Använd Ubuntu2204 som operativsystem för nodavbildningar, men Ubuntu 22.04 kanske inte stöds för alla nodpooler. Begränsningar och kubernetes-versioner som stöds finns i https://aka.ms/aks/supported-ubuntu-versions |
| Windows2025 |
Använd Windows2025 som operativsystem för nodavbildningar. Stöds inte för systemnodpooler. Windows2025 stöder Windows 2022 och Windows 2025-containrar; den kan inte köra Windows2019-containrar och vice versa. |
| Ubuntu2404 |
Använd Ubuntu2404 som operativsystem för nodavbildningar, men Ubuntu 24.04 kanske inte stöds för alla nodpooler. Begränsningar och kubernetes-versioner som stöds finns i se https://aka.ms/aks/supported-ubuntu-versions |
OSType
Typ av operativsystem. Standardvärdet är Linux.
| Värde | Description |
|---|---|
| Linux |
Använd Linux. |
| Windows |
Använd Windows. |
PodIPAllocationMode
Läge för IP-allokering av poddar. IP-allokeringsläget för poddar i agentpoolen. Måste användas med podSubnetId. Standardvärdet är "DynamicIndividual".
| Värde | Description |
|---|---|
| DynamicIndividual |
Varje nod allokeras med en icke-sammanhängande lista över IP-adresser som kan tilldelas till poddar. Detta är bättre för att maximera ett litet till medelstort undernät med storlek /16 eller mindre. Azure CNI-klustret med dynamisk IP-allokering går in i detta läge om kunden inte uttryckligen specificerar en podIPAllocationMode |
| StaticBlock |
Varje nod är statiskt allokerade CIDR-block av storlek /28 = 16 IP-adresser per block för att uppfylla maxPods per nod. Antal CIDR-block >= (maxPods / 16). Blocket, istället för en enskild IP, räknas mot Azure Vnet Private IP-gränsen på 65K. Därför är blockläge lämpligt för att köra större arbetsbelastningar med mer än den aktuella gränsen på 65 000 poddar i ett kluster. Det här läget passar bättre för skalning med större undernät på /15 eller större |
PortRange
Portintervallet.
| Name | Typ | Description |
|---|---|---|
| portEnd |
integer (int32) minimum: 1maximum: 65535 |
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 (int32) minimum: 1maximum: 65535 |
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 |
Portens nätverksprotokoll. |
PowerState
Beskriver klustrets energitillstånd
| Name | Typ | Description |
|---|---|---|
| code |
Anger om klustret körs eller stoppas |
Protocol
Portens nätverksprotokoll.
| Värde | Description |
|---|---|
| TCP |
TCP-protokoll. |
| UDP |
UDP-protokoll. |
ScaleDownMode
Beskriver hur virtuella datorer läggs till eller tas bort från agentpooler. Se faktureringsstatus.
| Värde | Description |
|---|---|
| Delete |
Skapa nya instanser under uppskalning och ta bort instanser under nedskalning. |
| Deallocate |
Försök att starta frigjorda instanser (om de finns) under uppskalning och frigöra instanser under nedskalning. |
ScaleProfile
Specifikationer för hur du skalar en VirtualMachines-agentpool.
| Name | Typ | Description |
|---|---|---|
| manual |
Specifikationer för hur du skalar VirtualMachines-agentpoolen till en fast storlek. |
ScaleSetEvictionPolicy
Borttagningsprincipen för VM-skalningsuppsättningen. Vräkningspolicyn specificerar vad som to do med VM:n när den vräkas. Standardvärdet är Ta bort. För mer information om vräkning, se spot VMs
| Värde | Description |
|---|---|
| Delete |
Noder i den underliggande skalningsuppsättningen för nodpoolen tas bort när de avlägsnas. |
| Deallocate |
Noder i den underliggande skalningsuppsättningen för nodpoolen är inställda på tillståndet stoppad frigjord vid borttagning. Noder i det stoppade frigjorda tillståndet räknas mot din beräkningskvot och kan orsaka problem med klusterskalning eller uppgradering. |
ScaleSetPriority
Prioritet för VM-skalningsuppsättning.
| Värde | Description |
|---|---|
| Spot |
Virtuella datorer med platsprioritet används. Det finns inget serviceavtal för skalningsnoder för oanvänd kapacitet. Mer information finns i plats på AKS-. |
| Regular |
Vanliga virtuella datorer används. |
SysctlConfig
Sysctl-inställningar för Linux-agentnoder.
| Name | Typ | Description |
|---|---|---|
| fsAioMaxNr |
integer (int32) |
Sysctl-inställning fs.aio-max-nr. |
| fsFileMax |
integer (int32) |
Sysctl-inställning fs.file-max. |
| fsInotifyMaxUserWatches |
integer (int32) |
Sysctl-inställning fs.inotify.max_user_watches. |
| fsNrOpen |
integer (int32) |
Sysctl-inställning fs.nr_open. |
| kernelThreadsMax |
integer (int32) |
Sysctl-inställning kernel.threads-max. |
| netCoreNetdevMaxBacklog |
integer (int32) |
Sysctl-inställning net.core.netdev_max_backlog. |
| netCoreOptmemMax |
integer (int32) |
Sysctl-inställning net.core.optmem_max. |
| netCoreRmemDefault |
integer (int32) |
Sysctl-inställning net.core.rmem_default. |
| netCoreRmemMax |
integer (int32) |
Sysctl-inställning net.core.rmem_max. |
| netCoreSomaxconn |
integer (int32) |
Sysctl-inställning net.core.somaxconn. |
| netCoreWmemDefault |
integer (int32) |
Sysctl-inställning net.core.wmem_default. |
| netCoreWmemMax |
integer (int32) |
Sysctl-inställning net.core.wmem_max. |
| netIpv4IpLocalPortRange |
string |
Sysctl-inställning net.ipv4.ip_local_port_range. |
| netIpv4NeighDefaultGcThresh1 |
integer (int32) |
Sysctl-inställning net.ipv4.neigh.default.gc_thresh1. |
| netIpv4NeighDefaultGcThresh2 |
integer (int32) |
Sysctl-inställning net.ipv4.neigh.default.gc_thresh2. |
| netIpv4NeighDefaultGcThresh3 |
integer (int32) |
Sysctl-inställning net.ipv4.neigh.default.gc_thresh3. |
| netIpv4TcpFinTimeout |
integer (int32) |
Sysctl-inställning net.ipv4.tcp_fin_timeout. |
| netIpv4TcpKeepaliveProbes |
integer (int32) |
Sysctl-inställning net.ipv4.tcp_keepalive_probes. |
| netIpv4TcpKeepaliveTime |
integer (int32) |
Sysctl-inställning net.ipv4.tcp_keepalive_time. |
| netIpv4TcpMaxSynBacklog |
integer (int32) |
Sysctl-inställning net.ipv4.tcp_max_syn_backlog. |
| netIpv4TcpMaxTwBuckets |
integer (int32) |
Sysctl-inställning net.ipv4.tcp_max_tw_buckets. |
| netIpv4TcpTwReuse |
boolean |
Sysctl-inställning net.ipv4.tcp_tw_reuse. |
| netIpv4TcpkeepaliveIntvl |
integer (int32) minimum: 10maximum: 90 |
Sysctl-inställning net.ipv4.tcp_keepalive_intvl. |
| netNetfilterNfConntrackBuckets |
integer (int32) minimum: 65536maximum: 524288 |
Sysctl-inställning net.netfilter.nf_conntrack_buckets. |
| netNetfilterNfConntrackMax |
integer (int32) minimum: 131072maximum: 2097152 |
Sysctl-inställning net.netfilter.nf_conntrack_max. |
| vmMaxMapCount |
integer (int32) |
Sysctl-inställning vm.max_map_count. |
| vmSwappiness |
integer (int32) |
Sysctl-inställning vm.swappiness. |
| vmVfsCachePressure |
integer (int32) |
Sysctl-inställning vm.vfs_cache_pressure. |
systemData
Metadata som rör skapande och senaste ändring av resursen.
| Name | Typ | Description |
|---|---|---|
| createdAt |
string (date-time) |
Tidsstämpeln för resursskapande (UTC). |
| createdBy |
string |
Identiteten som skapade resursen. |
| createdByType |
Den typ av identitet som skapade resursen. |
|
| lastModifiedAt |
string (date-time) |
Tidsstämpeln för senaste ändring av resurs (UTC) |
| lastModifiedBy |
string |
Identiteten som senast ändrade resursen. |
| lastModifiedByType |
Den typ av identitet som senast ändrade resursen. |
UndrainableNodeBehavior
Definierar beteendet för oanvändbara noder under uppgraderingen. Den vanligaste orsaken till oanvändbara noder är poddavbrottsbudgetar (PDB), men andra problem, till exempel respitperiod för poddavslut överskrider den återstående timeouten per nod eller podden fortfarande är i ett körningstillstånd, kan också orsaka oanvändbara noder.
| Värde | Description |
|---|---|
| Cordon |
AKS kommer att spärra de blockerade noderna och ersätta dem med överspänningsnoder under uppgraderingen. De blockerade noderna kommer att spärras av och ersättas av överspänningsnoder. De blockerade noderna har etiketten "kubernetes.azure.com/upgrade-status:Quarantined". En överspänningsnod behålls för varje blockerad nod. Ett bästa försök görs att ta bort alla andra överspänningsnoder. Om det finns tillräckligt med överspänningsnoder för att ersätta blockerade noder är uppgraderingsåtgärden och det hanterade klustret i feltillstånd. Annars avbryts uppgraderingsåtgärden och det hanterade klustret. |
| Schedule |
AKS markerar de blockerade noderna som kan schemaläggas, men de blockerade noderna uppgraderas inte. Ett bästa försök görs att ta bort alla överspänningsnoder. Uppgraderingsåtgärden och det hanterade klustret är i fel tillstånd om det finns några blockerade noder. |
VirtualMachineNodes
Aktuell status för en grupp noder med samma vm-storlek.
| Name | Typ | Description |
|---|---|---|
| count |
integer (int32) |
Antal noder. |
| size |
string |
Storleken på den virtuella datorn för de agenter som används som värd för den här gruppen med noder. |
VirtualMachinesProfile
Specifikationer för VirtualMachines-agentpoolen.
| Name | Typ | Description |
|---|---|---|
| scale |
Specifikationer för hur du skalar en VirtualMachines-agentpool. |
WorkloadRuntime
Avgör vilken typ av arbetsbelastning en nod kan köra.
| Värde | Description |
|---|---|
| OCIContainer |
Noder använder Kubelet för att köra standardarbetsbelastningar för OCI-container. |
| WasmWasi |
Noder använder Krustlet för att köra WASM-arbetsbelastningar med WASI-providern (förhandsversion). |
| KataVmIsolation |
Noder kan använda (Kata + Cloud Hypervisor + Hyper-V) för att aktivera Nested VM-baserade poddar. På grund av användningen av Hyper-V är AKS-nod-OS själv en nästlad VM (rot-OS:et) av Hyper-V. Därför kan den bara användas med VM-serier som stöder kapslad virtualisering, till exempel Dv3-serien. |