Agent Pools - Create Or Update

Szolgáltatás:: AKS

API-verzió:: 2026-02-01

Ügynökkészletet hoz létre vagy frissít a megadott felügyelt fürtben.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	Az ügynökkészlet neve.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
resourceName	path	True	string minLength: 1 maxLength: 63 pattern: ^[a-zA-Z0-9]$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$	A felügyelt fürterőforrás neve.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem fejléce

Name	Kötelező	Típus	Description
if-match		string	A kérés csak akkor folytatódhat, ha egy entitás megfelel ennek a sztringnek.
if-none-match		string	A kérés csak akkor folytatódhat, ha egyetlen entitás sem felel meg ennek a sztringnek.

Kérelem törzse

Name	Típus	Description
properties.availabilityZones	string[]	A csomópontokhoz használandó rendelkezésre állási zónák listája. Ez csak akkor adható meg, ha az AgentPoolType tulajdonság "VirtualMachineScaleSets".
properties.capacityReservationGroupID	string (arm-id)	A Capacity Reservation Group teljesen minősített erőforrás-azonosítója, amely virtuális gépek biztosításához egy fenntartott Virtual Machines csoportból. Ez a következő formájú: '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft. Compute/capacityreservationgroups/{capacityReservationGroupName}' Az ügyfelek ezt használják, hogy ügynökpoolt hozzanak létre egy meghatározott CRG-vel. További információért lásd a kapacitás foglalása
properties.count	integer (int32)	A Docker-tárolók üzemeltetéséhez használt ügynökök (virtuális gépek) száma. Az engedélyezett értékeknek a felhasználói készletek esetében 0 és 1000 közötti tartományban kell lenniük (beleértve), a rendszerkészletek esetében pedig 1 és 1000 közötti tartományban (beleértve). Az alapértelmezett érték 1.
properties.creationData	CreationData	A forrás pillanatkép-azonosítójának megadásához használandó CreationData, ha a csomópontkészletet pillanatkép használatával hozza létre vagy frissíti.
properties.enableAutoScaling	boolean	Az automatikus skálázás engedélyezése
properties.enableEncryptionAtHost	boolean	A gazdagépalapú operációs rendszer és az adatmeghajtó titkosításának engedélyezése. Ez csak bizonyos VM méretekben és bizonyos Azure régiókban támogatott. További információ: https://docs.microsoft.com/azure/aks/enable-host-encryption
properties.enableFIPS	boolean	FiPS-kompatibilis operációs rendszer használata. További részletekért lásd: FIPS-kompatibilis csomópontkészlet hozzáadása .
properties.enableNodePublicIP	boolean	Azt jelzi, hogy minden csomópont saját nyilvános IP-címet kap-e. Bizonyos esetekben előfordulhat, hogy a csomópontkészlet csomópontjai saját dedikált nyilvános IP-címeket kapnak. Gyakori forgatókönyv a játékterhelések esetében, ahol a konzolnak közvetlen kapcsolatot kell létesítenie egy felhőbeli virtuális géppel a ugrások minimalizálása érdekében. További információ: nyilvános IP-cím hozzárendelése csomópontonként. Az alapértelmezett érték hamis.
properties.enableUltraSSD	boolean	Az UltraSSD engedélyezése
properties.gatewayProfile	AgentPoolGatewayProfile	Egy felügyelt ügynökkészletre jellemző profil átjáró módban. Ez a mező nem állítható be, ha az ügynökkészlet üzemmódja nem átjáró.
properties.gpuInstanceProfile	GPUInstanceProfile	GPUInstanceProfile a GPU MIG-példányprofiljának megadására a támogatott GPU virtuálisgép-termékváltozathoz.
properties.gpuProfile	GPUProfile	Az ügynökkészlet GPU-beállításai.
properties.hostGroupID	string (arm-id)	A dedikált gazdagépcsoport teljes erőforrás-azonosítója, amelyből virtuális gépeket építhet ki, csak létrehozási forgatókönyvben használatos, és a beállítás után nem módosítható. Ez a következő forma van: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Compute/hostGroups/{hostGroupName}. További információért lásd: Azure dedikált húdozókat.
properties.kubeletConfig	KubeletConfig	A Kubelet-konfiguráció az ügynökkészlet csomópontjain.
properties.kubeletDiskType	KubeletDiskType	Meghatározza az emptyDir kötetek, a konténer futási idejű adatgyökerek és a Kubelet ephemeral storage elhelyezkedését.
properties.linuxOSConfig	LinuxOSConfig	Linux-ügynökcsomópontok operációsrendszer-konfigurációja.
properties.localDNSProfile	LocalDNSProfile	Konfigurálja a csomópontonkénti helyi DNS-t a VnetDNS és a KubeDNS felülbírálásával. A LocalDNS segít javítani a DNS-feloldás teljesítményét és megbízhatóságát egy AKS-fürtben. További részletekért lásd aka.ms/aks/localdns.
properties.maxCount	integer (int32)	Az automatikus skálázáshoz használható csomópontok maximális száma
properties.maxPods	integer (int32)	A csomóponton futtatható podok maximális száma.
properties.messageOfTheDay	string	A nap üzenete Linux-csomópontokhoz, base64 kódolású. Egy base64 kódolású sztring, amely a dekódolás után a /etc/motd fájlba lesz írva. Ez lehetővé teszi a nap üzenetének testreszabását Linux-csomópontok esetében. Nem szabad megadni a Windows csomópontokra. Statikus sztringnek kell lennie (azaz nyersen lesz kinyomtatva, és nem szkriptként lesz végrehajtva).
properties.minCount	integer (int32)	Az automatikus skálázáshoz szükséges csomópontok minimális száma
properties.mode	AgentPoolMode	Az ügynökkészlet módja. A fürtöknek mindig legalább egy "System" ügynökkészlettel kell rendelkezniük. Az ügynökkészlet korlátozásaival és ajánlott eljárásaival kapcsolatos további információkért lásd: https://docs.microsoft.com/azure/aks/use-system-pools
properties.networkProfile	AgentPoolNetworkProfile	Egy ügynökkészlet hálózattal kapcsolatos beállításai.
properties.nodeLabels	object	Az ügynökkészlet összes csomópontjában megőrzendő csomópontfeliratok.
properties.nodePublicIPPrefixID	string (arm-id)	A nyilvános IP-előtag azonosítója, amelyből a virtuálisgép-csomópontoknak IP-címeket kell használniuk. Ez a következő forma van: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/publicIPPrefixes/{publicIPPrefixName}
properties.nodeTaints	string[]	A csomópontkészlet létrehozása és skálázása során az új csomópontokhoz hozzáadott fertőzöttek. Például: key=value:NoSchedule.
properties.orchestratorVersion	string	A felhasználó által megadott Kubernetes-verzió. Mind a javítás verziójú <major.minor.patch> (pl. 1.20.13) és <a major.minor> (pl. 1.20) támogatott. A major.minor< megadásakor >a rendszer automatikusan kiválasztja a legújabb támogatott GA-javításverziót. A fürt létrehozása után (például 1.14.x –< 1.14) a fürt ugyanazon >major.minor> verzióval való frissítése nem indítja el a frissítést, még akkor sem, ha egy újabb javításverzió érhető el. Ajánlott eljárásként frissítse az AKS-fürtök összes csomópontkészletét ugyanarra a Kubernetes-verzióra. A csomópontkészlet verziójának a vezérlősík főverziójával kell rendelkeznie. A csomópontkészlet alverziójának a vezérlősík két alverziójában kell lennie. A csomópontkészlet verziója nem lehet nagyobb, mint a vezérlősík verziója. További információ: csomópontkészlet frissítése.
properties.osDiskSizeGB	integer (int32) minimum: 0 maximum: 2048	Az operációsrendszer-lemez mérete GB-ban a fő-/ügynökkészlet minden gépének lemezméretének megadására szolgál. Ha 0 értéket ad meg, az az alapértelmezett osDisk méretet alkalmazza a megadott vmSize szerint.
properties.osDiskType	OSDiskType	Az ügynökkészletben lévő gépekhez használandó operációsrendszer-lemez típusa. Az alapértelmezett érték a "Rövid élettartam", ha a virtuális gép támogatja, és a kért OSDiskSizeGB-nél nagyobb gyorsítótárlemezrel rendelkezik. Ellenkező esetben alapértelmezés szerint a "Managed" (Felügyelt) értékre van kapcsolva. Lehet, hogy a létrehozás után nem módosítható. További információ: Rövid élettartamú operációs rendszer.
properties.osSKU	OSSKU	Az ügynökkészlet által használt operációsrendszer-termékváltozatot adja meg. Az alapértelmezett Ubuntu, ha az OSType Linux. Az alapértelmezett Windows 2019, amikor Kubernetes <= 1.24, vagy Windows2022, amikor Kubernetes >= 1.25, ha az OSType Windows.
properties.osType	OSType	Az operációs rendszer típusa. Az alapértelmezett linuxos.
properties.podIPAllocationMode	PodIPAllocationMode	Pod IP-kiosztási mód. Az ügynökkészletben lévő podok IP-foglalási módja. PodSubnetId azonosítóval kell használni. Az alapértelmezett érték a "DynamicIndividual".
properties.podSubnetID	string (arm-id)	Annak az alhálózatnak az azonosítója, amelyhez a podok az indításkor csatlakoznak. Ha nincs megadva, a pod IP-címek statikusan vannak hozzárendelve a csomópont alhálózatához (további részletekért lásd a vnetSubnetID azonosítót). Ez a következő forma van: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.powerState	PowerState	Azt jelzi, hogy az ügynökkészlet fut-e vagy le van-e állítva. Az ügynökkészlet első létrehozásakor először fut. Az ügynökkészlet leállítható úgy, hogy ezt a mezőt Leállítva értékre állítja. A leállított ügynökkészlet leállítja az összes virtuális gépét, és nem számol fel számlázási díjakat. Az ügynökkészletek csak akkor állíthatók le, ha fut, és a kiépítési állapot sikeres
properties.proximityPlacementGroupID	string (arm-id)	A közelségi elhelyezési csoport azonosítója.
properties.scaleDownMode	ScaleDownMode	Az ügynökkészlet skálázásához használandó leskálázási mód. Ez a fürt automatikus skálázási viselkedésére is hatással van. Ha nincs megadva, akkor alapértelmezés szerint a Delete érték lesz.
properties.scaleSetEvictionPolicy	ScaleSetEvictionPolicy	A virtuálisgép-méretezési csoport kizárási szabályzata. A kilakoltatási szabályzat meghatározza, mit to do a VM-vel, amikor kilakoltatják. Az alapértelmezett érték a Törlés. További információért a kilakoltatásról lásd: spot VMs
properties.scaleSetPriority	ScaleSetPriority	A virtuálisgép-méretezési csoport prioritása.
properties.securityProfile	AgentPoolSecurityProfile	Az ügynökkészlet biztonsági beállításai.
properties.spotMaxPrice	number (float)	A maximális ár (amerikai dollárban), amit hajlandó fizetni az azonnali példányokért. A lehetséges értékek a nullánál nagyobb vagy -1 tizedesjegyek, amelyek azt jelzik, hogy az alapértelmezett ár igény szerint up-to. A lehetséges értékek a nullánál nagyobb tizedesjegyek vagy -1, amelyek jelzik, hogy hajlandóak-e bármilyen igény szerinti árat fizetni. A kihasználatlan díjszabásról további információt a kihasználatlan virtuális gépek díjszabásában talál
properties.status	AgentPoolStatus	Írásvédett információkat tartalmaz az ügynökkészletről.
properties.tags	object	Az ügynökkészlet virtuálisgép-méretezési csoportjában megőrizendő címkék.
properties.type	AgentPoolType	Az ügynökkészlet típusa.
properties.upgradeSettings	AgentPoolUpgradeSettings	Az ügynökkészlet frissítésének beállításai
properties.virtualMachineNodesStatus	VirtualMachineNodes[]	A VirtualMachines-ügynökkészlet csomópontjainak állapota.
properties.virtualMachinesProfile	VirtualMachinesProfile	A VirtualMachines-ügynökkészlet specifikációi.
properties.vmSize	string	Az ügynökkészlet virtuális gépeinek mérete. A virtuális gép mérete régiónként eltérő. Ha egy csomópont nem tartalmaz elegendő számítási erőforrást (memóriát, processzort stb.), előfordulhat, hogy a podok nem futnak megfelelően. A korlátozott virtuálisgép-méretekkel kapcsolatos további részletekért lásd: https://docs.microsoft.com/azure/aks/quotas-skus-regions
properties.vnetSubnetID	string (arm-id)	Annak az alhálózatnak az azonosítója, amelyhez az ügynökkészlet csomópontjai és opcionálisan podok csatlakoznak indításkor. Ha ez nincs megadva, a rendszer létrehoz és használ egy virtuális hálózatot és alhálózatot. Ha nincs megadva podSubnetID, ez a csomópontokra és podokra vonatkozik, ellenkező esetben csak a csomópontokra vonatkozik. Ez a következő forma van: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.windowsProfile	AgentPoolWindowsProfile	A Windows ügynök pool speciális profilja.
properties.workloadRuntime	WorkloadRuntime	Meghatározza, hogy a csomópont milyen típusú számítási feladatot futtathat.

Válaszok

Name	Típus	Description
200 OK	AgentPool	Az "AgentPool" erőforrás frissítési művelete sikeres volt
201 Created	AgentPool	Az "AgentPool" erőforrás létrehozási művelete sikeres volt Fejlécek Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Name

Típus

Description

200 OK

AgentPool

Az "AgentPool" erőforrás frissítési művelete sikeres volt

201 Created

AgentPool

Az "AgentPool" erőforrás létrehozási művelete sikeres volt

Fejlécek

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Create Agent Pool using an agent pool snapshot

Create Agent Pool with Capacity Reservation Group

Create Agent Pool with Dedicated Host Group

Create Agent Pool with EncryptionAtHost enabled

Create Agent Pool with Ephemeral OS Disk

Create Agent Pool with FIPS enabled OS

Create Agent Pool with GPUMIG

Create Agent Pool with Krustlet and the WASI runtime

Create Agent Pool with KubeletConfig and LinuxOSConfig

Create Agent Pool with Message of the Day

Create Agent Pool with OSSKU

Create Agent Pool with PPG

Create Agent Pool with UltraSSD enabled

Create Agent Pool with VirtualMachines pool type

Create Agent Pool with Windows OSSKU

Create Spot Agent Pool

Create Windows Agent Pool with disabling OutboundNAT

Create/Update Agent Pool

Start Agent Pool

Stop Agent Pool

Update Agent Pool

Create Agent Pool using an agent pool snapshot

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.CreationData;
import com.azure.resourcemanager.containerservice.models.OSType;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_Snapshot.json
     */
    /**
     * Sample code: Create Agent Pool using an agent pool snapshot.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void createAgentPoolUsingAnAgentPoolSnapshot(
        com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1", new AgentPoolInner()
            .withCount(3).withVmSize("Standard_DS2_v2").withOsType(OSType.LINUX).withOrchestratorVersion("")
            .withEnableFips(true)
            .withCreationData(new CreationData().withSourceResourceId(
                "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1")),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_Snapshot.json
 */
async function createAgentPoolUsingAnAgentPoolSnapshot() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    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",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.OSType;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_CRG.json
     */
    /**
     * Sample code: Create Agent Pool with Capacity Reservation Group.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void createAgentPoolWithCapacityReservationGroup(
        com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1", new AgentPoolInner()
            .withCount(3).withVmSize("Standard_DS2_v2").withOsType(OSType.LINUX).withOrchestratorVersion("")
            .withCapacityReservationGroupId(
                "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1"),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_CRG.json
 */
async function createAgentPoolWithCapacityReservationGroup() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    capacityReservationGroupID:
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1",
    count: 3,
    orchestratorVersion: "",
    osType: "Linux",
    vmSize: "Standard_DS2_v2",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.OSType;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_DedicatedHostGroup.json
     */
    /**
     * Sample code: Create Agent Pool with Dedicated Host Group.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void createAgentPoolWithDedicatedHostGroup(
        com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1", new AgentPoolInner()
            .withCount(3).withVmSize("Standard_DS2_v2").withOsType(OSType.LINUX).withOrchestratorVersion("")
            .withHostGroupId(
                "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_DedicatedHostGroup.json
 */
async function createAgentPoolWithDedicatedHostGroup() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    count: 3,
    hostGroupID:
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1",
    orchestratorVersion: "",
    osType: "Linux",
    vmSize: "Standard_DS2_v2",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.OSType;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_EnableEncryptionAtHost.json
     */
    /**
     * Sample code: Create Agent Pool with EncryptionAtHost enabled.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void createAgentPoolWithEncryptionAtHostEnabled(
        com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1",
            new AgentPoolInner().withCount(3).withVmSize("Standard_DS2_v2").withOsType(OSType.LINUX)
                .withOrchestratorVersion("").withEnableEncryptionAtHost(true),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_EnableEncryptionAtHost.json
 */
async function createAgentPoolWithEncryptionAtHostEnabled() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    count: 3,
    enableEncryptionAtHost: true,
    orchestratorVersion: "",
    osType: "Linux",
    vmSize: "Standard_DS2_v2",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.OSDiskType;
import com.azure.resourcemanager.containerservice.models.OSType;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_Ephemeral.json
     */
    /**
     * Sample code: Create Agent Pool with Ephemeral OS Disk.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void
        createAgentPoolWithEphemeralOSDisk(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1",
            new AgentPoolInner().withCount(3).withVmSize("Standard_DS2_v2").withOsDiskSizeGB(64)
                .withOsDiskType(OSDiskType.EPHEMERAL).withOsType(OSType.LINUX).withOrchestratorVersion(""),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_Ephemeral.json
 */
async function createAgentPoolWithEphemeralOSDisk() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    count: 3,
    orchestratorVersion: "",
    osDiskSizeGB: 64,
    osDiskType: "Ephemeral",
    osType: "Linux",
    vmSize: "Standard_DS2_v2",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.OSType;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_EnableFIPS.json
     */
    /**
     * Sample code: Create Agent Pool with FIPS enabled OS.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void
        createAgentPoolWithFIPSEnabledOS(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate(
            "rg1", "clustername1", "agentpool1", new AgentPoolInner().withCount(3).withVmSize("Standard_DS2_v2")
                .withOsType(OSType.LINUX).withOrchestratorVersion("").withEnableFips(true),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_EnableFIPS.json
 */
async function createAgentPoolWithFipsEnabledOS() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    count: 3,
    enableFips: true,
    orchestratorVersion: "",
    osType: "Linux",
    vmSize: "Standard_DS2_v2",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.GpuInstanceProfile;
import com.azure.resourcemanager.containerservice.models.KubeletConfig;
import com.azure.resourcemanager.containerservice.models.LinuxOSConfig;
import com.azure.resourcemanager.containerservice.models.OSType;
import com.azure.resourcemanager.containerservice.models.SysctlConfig;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_GPUMIG.json
     */
    /**
     * Sample code: Create Agent Pool with GPUMIG.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void
        createAgentPoolWithGPUMIG(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1",
            new AgentPoolInner().withCount(3).withVmSize("Standard_ND96asr_v4").withOsType(OSType.LINUX)
                .withOrchestratorVersion("")
                .withKubeletConfig(new KubeletConfig().withCpuManagerPolicy("static").withCpuCfsQuota(true)
                    .withCpuCfsQuotaPeriod("200ms").withImageGcHighThreshold(90).withImageGcLowThreshold(70)
                    .withTopologyManagerPolicy("best-effort")
                    .withAllowedUnsafeSysctls(Arrays.asList("kernel.msg*", "net.core.somaxconn")).withFailSwapOn(false))
                .withLinuxOSConfig(new LinuxOSConfig()
                    .withSysctls(new SysctlConfig().withNetCoreWmemDefault(12345).withNetIpv4TcpTwReuse(true)
                        .withNetIpv4IpLocalPortRange("20000 60000").withKernelThreadsMax(99999))
                    .withTransparentHugePageEnabled("always").withTransparentHugePageDefrag("madvise")
                    .withSwapFileSizeMB(1500))
                .withGpuInstanceProfile(GpuInstanceProfile.MIG2G),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_GPUMIG.json
 */
async function createAgentPoolWithGpumig() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    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",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.AgentPoolMode;
import com.azure.resourcemanager.containerservice.models.OSType;
import com.azure.resourcemanager.containerservice.models.WorkloadRuntime;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_WasmWasi.json
     */
    /**
     * Sample code: Create Agent Pool with Krustlet and the WASI runtime.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void createAgentPoolWithKrustletAndTheWASIRuntime(
        com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1",
            new AgentPoolInner().withCount(3).withVmSize("Standard_DS2_v2").withOsDiskSizeGB(64)
                .withWorkloadRuntime(WorkloadRuntime.WASM_WASI).withOsType(OSType.LINUX).withMode(AgentPoolMode.USER)
                .withOrchestratorVersion(""),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_WasmWasi.json
 */
async function createAgentPoolWithKrustletAndTheWasiRuntime() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    count: 3,
    mode: "User",
    orchestratorVersion: "",
    osDiskSizeGB: 64,
    osType: "Linux",
    vmSize: "Standard_DS2_v2",
    workloadRuntime: "WasmWasi",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.KubeletConfig;
import com.azure.resourcemanager.containerservice.models.LinuxOSConfig;
import com.azure.resourcemanager.containerservice.models.OSType;
import com.azure.resourcemanager.containerservice.models.SysctlConfig;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_CustomNodeConfig.json
     */
    /**
     * Sample code: Create Agent Pool with KubeletConfig and LinuxOSConfig.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void createAgentPoolWithKubeletConfigAndLinuxOSConfig(
        com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1",
            new AgentPoolInner().withCount(3).withVmSize("Standard_DS2_v2").withOsType(OSType.LINUX)
                .withOrchestratorVersion("")
                .withKubeletConfig(new KubeletConfig().withCpuManagerPolicy("static").withCpuCfsQuota(true)
                    .withCpuCfsQuotaPeriod("200ms").withImageGcHighThreshold(90).withImageGcLowThreshold(70)
                    .withTopologyManagerPolicy("best-effort")
                    .withAllowedUnsafeSysctls(Arrays.asList("kernel.msg*", "net.core.somaxconn")).withFailSwapOn(false))
                .withLinuxOSConfig(new LinuxOSConfig()
                    .withSysctls(new SysctlConfig().withNetCoreWmemDefault(12345).withNetIpv4TcpTwReuse(true)
                        .withNetIpv4IpLocalPortRange("20000 60000").withKernelThreadsMax(99999))
                    .withTransparentHugePageEnabled("always").withTransparentHugePageDefrag("madvise")
                    .withSwapFileSizeMB(1500)),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_CustomNodeConfig.json
 */
async function createAgentPoolWithKubeletConfigAndLinuxOSConfig() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    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",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.AgentPoolMode;
import com.azure.resourcemanager.containerservice.models.OSType;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_MessageOfTheDay.json
     */
    /**
     * Sample code: Create Agent Pool with Message of the Day.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void
        createAgentPoolWithMessageOfTheDay(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1",
            new AgentPoolInner().withCount(3).withVmSize("Standard_DS2_v2").withOsDiskSizeGB(64)
                .withMessageOfTheDay("Zm9vCg==").withOsType(OSType.LINUX).withMode(AgentPoolMode.USER)
                .withOrchestratorVersion(""),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_MessageOfTheDay.json
 */
async function createAgentPoolWithMessageOfTheDay() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    count: 3,
    messageOfTheDay: "Zm9vCg==",
    mode: "User",
    orchestratorVersion: "",
    osDiskSizeGB: 64,
    osType: "Linux",
    vmSize: "Standard_DS2_v2",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.KubeletConfig;
import com.azure.resourcemanager.containerservice.models.LinuxOSConfig;
import com.azure.resourcemanager.containerservice.models.OSSku;
import com.azure.resourcemanager.containerservice.models.OSType;
import com.azure.resourcemanager.containerservice.models.SysctlConfig;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_OSSKU.json
     */
    /**
     * Sample code: Create Agent Pool with OSSKU.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void
        createAgentPoolWithOSSKU(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1",
            new AgentPoolInner().withCount(3).withVmSize("Standard_DS2_v2").withOsType(OSType.LINUX)
                .withOsSku(OSSku.AZURE_LINUX).withOrchestratorVersion("")
                .withKubeletConfig(new KubeletConfig().withCpuManagerPolicy("static").withCpuCfsQuota(true)
                    .withCpuCfsQuotaPeriod("200ms").withImageGcHighThreshold(90).withImageGcLowThreshold(70)
                    .withTopologyManagerPolicy("best-effort")
                    .withAllowedUnsafeSysctls(Arrays.asList("kernel.msg*", "net.core.somaxconn")).withFailSwapOn(false))
                .withLinuxOSConfig(new LinuxOSConfig()
                    .withSysctls(new SysctlConfig().withNetCoreWmemDefault(12345).withNetIpv4TcpTwReuse(true)
                        .withNetIpv4IpLocalPortRange("20000 60000").withKernelThreadsMax(99999))
                    .withTransparentHugePageEnabled("always").withTransparentHugePageDefrag("madvise")
                    .withSwapFileSizeMB(1500)),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_OSSKU.json
 */
async function createAgentPoolWithOssku() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    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",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.OSType;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_PPG.json
     */
    /**
     * Sample code: Create Agent Pool with PPG.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void
        createAgentPoolWithPPG(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1", new AgentPoolInner()
            .withCount(3).withVmSize("Standard_DS2_v2").withOsType(OSType.LINUX).withOrchestratorVersion("")
            .withProximityPlacementGroupId(
                "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1"),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_PPG.json
 */
async function createAgentPoolWithPPG() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    count: 3,
    orchestratorVersion: "",
    osType: "Linux",
    proximityPlacementGroupID:
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1",
    vmSize: "Standard_DS2_v2",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.OSType;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_EnableUltraSSD.json
     */
    /**
     * Sample code: Create Agent Pool with UltraSSD enabled.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void
        createAgentPoolWithUltraSSDEnabled(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate(
            "rg1", "clustername1", "agentpool1", new AgentPoolInner().withCount(3).withVmSize("Standard_DS2_v2")
                .withOsType(OSType.LINUX).withOrchestratorVersion("").withEnableUltraSsd(true),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_EnableUltraSSD.json
 */
async function createAgentPoolWithUltraSSDEnabled() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    count: 3,
    enableUltraSSD: true,
    orchestratorVersion: "",
    osType: "Linux",
    vmSize: "Standard_DS2_v2",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
          }
        ]
      }
    }
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.AgentPoolType;
import com.azure.resourcemanager.containerservice.models.ManualScaleProfile;
import com.azure.resourcemanager.containerservice.models.OSType;
import com.azure.resourcemanager.containerservice.models.ScaleProfile;
import com.azure.resourcemanager.containerservice.models.VirtualMachinesProfile;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_TypeVirtualMachines.json
     */
    /**
     * Sample code: Create Agent Pool with VirtualMachines pool type.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void createAgentPoolWithVirtualMachinesPoolType(
        com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1",
            new AgentPoolInner().withOsType(OSType.LINUX).withTypePropertiesType(AgentPoolType.VIRTUAL_MACHINES)
                .withOrchestratorVersion("1.9.6").withTags(mapOf("name1", "val1"))
                .withNodeLabels(mapOf("key1", "fakeTokenPlaceholder"))
                .withNodeTaints(Arrays.asList("Key1=Value1:NoSchedule"))
                .withVirtualMachinesProfile(new VirtualMachinesProfile().withScale(new ScaleProfile()
                    .withManual(Arrays.asList(new ManualScaleProfile().withSize("Standard_D2_v2").withCount(3),
                        new ManualScaleProfile().withSize("Standard_D2_v3").withCount(2))))),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_TypeVirtualMachines.json
 */
async function createAgentPoolWithVirtualMachinesPoolType() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    typePropertiesType: "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" },
        ],
      },
    },
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
          }
        ]
      }
    }
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.OSSku;
import com.azure.resourcemanager.containerservice.models.OSType;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_WindowsOSSKU.json
     */
    /**
     * Sample code: Create Agent Pool with Windows OSSKU.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void
        createAgentPoolWithWindowsOSSKU(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "wnp2",
            new AgentPoolInner().withCount(3).withVmSize("Standard_D4s_v3").withOsType(OSType.WINDOWS)
                .withOsSku(OSSku.WINDOWS2022).withOrchestratorVersion("1.23.3"),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_WindowsOSSKU.json
 */
async function createAgentPoolWithWindowsOssku() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "wnp2", {
    count: 3,
    orchestratorVersion: "1.23.3",
    osSKU: "Windows2022",
    osType: "Windows",
    vmSize: "Standard_D4s_v3",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.OSType;
import com.azure.resourcemanager.containerservice.models.ScaleSetEvictionPolicy;
import com.azure.resourcemanager.containerservice.models.ScaleSetPriority;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_Spot.json
     */
    /**
     * Sample code: Create Spot Agent Pool.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void createSpotAgentPool(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1",
            new AgentPoolInner().withCount(3).withVmSize("Standard_DS1_v2").withOsType(OSType.LINUX)
                .withOrchestratorVersion("").withScaleSetPriority(ScaleSetPriority.SPOT)
                .withScaleSetEvictionPolicy(ScaleSetEvictionPolicy.DELETE).withTags(mapOf("name1", "val1"))
                .withNodeLabels(mapOf("key1", "fakeTokenPlaceholder"))
                .withNodeTaints(Arrays.asList("Key1=Value1:NoSchedule")),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_Spot.json
 */
async function createSpotAgentPool() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    count: 3,
    nodeLabels: { key1: "val1" },
    nodeTaints: ["Key1=Value1:NoSchedule"],
    orchestratorVersion: "",
    osType: "Linux",
    scaleSetEvictionPolicy: "Delete",
    scaleSetPriority: "Spot",
    tags: { name1: "val1" },
    vmSize: "Standard_DS1_v2",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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
    }
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.AgentPoolWindowsProfile;
import com.azure.resourcemanager.containerservice.models.OSSku;
import com.azure.resourcemanager.containerservice.models.OSType;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_WindowsDisableOutboundNAT.json
     */
    /**
     * Sample code: Create Windows Agent Pool with disabling OutboundNAT.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void createWindowsAgentPoolWithDisablingOutboundNAT(
        com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "wnp2",
            new AgentPoolInner().withCount(3).withVmSize("Standard_D4s_v3").withOsType(OSType.WINDOWS)
                .withOsSku(OSSku.WINDOWS2022).withOrchestratorVersion("1.23.8")
                .withWindowsProfile(new AgentPoolWindowsProfile().withDisableOutboundNat(true)),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_WindowsDisableOutboundNAT.json
 */
async function createWindowsAgentPoolWithDisablingOutboundNAT() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "wnp2", {
    count: 3,
    orchestratorVersion: "1.23.8",
    osSKU: "Windows2022",
    osType: "Windows",
    vmSize: "Standard_D4s_v3",
    windowsProfile: { disableOutboundNat: true },
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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
    }
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.AgentPoolMode;
import com.azure.resourcemanager.containerservice.models.OSType;
import com.azure.resourcemanager.containerservice.models.ScaleSetEvictionPolicy;
import com.azure.resourcemanager.containerservice.models.ScaleSetPriority;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPoolsCreate_Update.json
     */
    /**
     * Sample code: Create/Update Agent Pool.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void
        createUpdateAgentPool(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1",
            new AgentPoolInner().withCount(3).withVmSize("Standard_DS1_v2").withOsType(OSType.LINUX)
                .withMode(AgentPoolMode.USER).withOrchestratorVersion("").withScaleSetPriority(ScaleSetPriority.SPOT)
                .withScaleSetEvictionPolicy(ScaleSetEvictionPolicy.DELETE).withTags(mapOf("name1", "val1"))
                .withNodeLabels(mapOf("key1", "fakeTokenPlaceholder"))
                .withNodeTaints(Arrays.asList("Key1=Value1:NoSchedule")),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPoolsCreate_Update.json
 */
async function createOrUpdateAgentPool() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    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",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
    }
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.Code;
import com.azure.resourcemanager.containerservice.models.PowerState;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPools_Start.json
     */
    /**
     * Sample code: Start Agent Pool.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void startAgentPool(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1",
            new AgentPoolInner().withPowerState(new PowerState().withCode(Code.RUNNING)), null, null,
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPools_Start.json
 */
async function startAgentPool() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    powerState: { code: "Running" },
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
    }
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.Code;
import com.azure.resourcemanager.containerservice.models.PowerState;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPools_Stop.json
     */
    /**
     * Sample code: Stop Agent Pool.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void stopAgentPool(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1",
            new AgentPoolInner().withPowerState(new PowerState().withCode(Code.STOPPED)), null, null,
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPools_Stop.json
 */
async function stopAgentPool() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    powerState: { code: "Stopped" },
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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

Mintakérelem

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"
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.AgentPoolInner;
import com.azure.resourcemanager.containerservice.models.OSType;
import com.azure.resourcemanager.containerservice.models.ScaleSetEvictionPolicy;
import com.azure.resourcemanager.containerservice.models.ScaleSetPriority;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for AgentPools CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-02-01/AgentPools_Update.json
     */
    /**
     * Sample code: Update Agent Pool.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void updateAgentPool(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getAgentPools().createOrUpdate("rg1", "clustername1", "agentpool1",
            new AgentPoolInner().withCount(3).withVmSize("Standard_DS1_v2").withOsType(OSType.LINUX).withMaxCount(2)
                .withMinCount(2).withEnableAutoScaling(true).withOrchestratorVersion("")
                .withScaleSetPriority(ScaleSetPriority.SPOT).withScaleSetEvictionPolicy(ScaleSetEvictionPolicy.DELETE)
                .withNodeTaints(Arrays.asList("Key1=Value1:NoSchedule")),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to creates or updates an agent pool in the specified managed cluster.
 *
 * @summary creates or updates an agent pool in the specified managed cluster.
 * x-ms-original-file: 2026-02-01/AgentPools_Update.json
 */
async function updateAgentPool() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.createOrUpdate("rg1", "clustername1", "agentpool1", {
    count: 3,
    enableAutoScaling: true,
    maxCount: 2,
    minCount: 2,
    nodeTaints: ["Key1=Value1:NoSchedule"],
    orchestratorVersion: "",
    osType: "Linux",
    scaleSetEvictionPolicy: "Delete",
    scaleSetPriority: "Spot",
    vmSize: "Standard_DS1_v2",
  });
  console.log(result);
}

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

Mintaválasz

Állapotkód:: 200

{
  "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"
  }
}

Állapotkód:: 201

{
  "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"
  }
}

Definíciók

Name	Description
AgentPool	Ügynökkészlet.
AgentPoolGatewayProfile	A felügyelt fürtátjáró-ügynökkészlet profilja.
AgentPoolMode	Az ügynökkészlet módja. A fürtöknek mindig legalább egy "System" ügynökkészlettel kell rendelkezniük. Az ügynökkészlet korlátozásaival és ajánlott eljárásaival kapcsolatos további információkért lásd: https://docs.microsoft.com/azure/aks/use-system-pools
AgentPoolNetworkProfile	Ügynökkészlet hálózati beállításai.
AgentPoolSecurityProfile	Az ügynökkészlet biztonsági beállításai.
AgentPoolSSHAccess	Az ügynök pool SSH access módszere.
AgentPoolStatus	Írásvédett információkat tartalmaz az ügynökkészletről.
AgentPoolType	Az ügynökkészlet típusa.
AgentPoolUpgradeSettings	Ügynökkészlet frissítésének beállításai
AgentPoolWindowsProfile	A Windows ügynök pool speciális profilja.
Code	Azt jelzi, hogy a fürt fut-e vagy le van-e állítva
createdByType	Az erőforrást létrehozó identitás típusa.
CreationData	A célerőforrás forráserőforrásból való létrehozásakor használt adatok.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
GPUDriver	Gpu-illesztőprogramok telepítése. Ha nincs megadva, az alapértelmezett beállítás a Telepítés.
GPUInstanceProfile	GPUInstanceProfile a GPU MIG-példányprofiljának megadására a támogatott GPU virtuálisgép-termékváltozathoz.
GPUProfile	Az ügynökkészlet GPU-beállításai.
IPTag	Az objektumhoz társított IP-címet tartalmazza.
KubeletConfig	Az ügynökcsomópontok Kubelet-konfigurációi. További részletekért lásd AKS egyéni csomópontkonfigurációs.
KubeletDiskType	Meghatározza az emptyDir kötetek, a konténer futási idejű adatgyökerek és a Kubelet ephemeral storage elhelyezkedését.
LinuxOSConfig	Linux-ügynökcsomópontok operációsrendszer-konfigurációi. További részletekért lásd AKS egyéni csomópontkonfigurációs.
LocalDNSForwardDestination	A localDNS-ből továbbítandó DNS-lekérdezések célkiszolgálója.
LocalDNSForwardPolicy	Továbbítási szabályzat a felsőbb rétegbeli DNS-kiszolgáló kiválasztásához. További információért lásd a továbbítási bővítményt .
LocalDNSMode	A localDNS engedélyezési módja.
LocalDNSOverride	A localDNS-profil felülbírálása.
LocalDNSProfile	Konfigurálja a csomópontonkénti helyi DNS-t a VnetDNS és a KubeDNS felülbírálásával. A LocalDNS segít javítani a DNS-feloldás teljesítményét és megbízhatóságát egy AKS-fürtben. További részletekért lásd aka.ms/aks/localdns.
LocalDNSProtocol	Kényszerítse ki a TCP-t, vagy részesítse előnyben az UDP protokollt a localDNS és a felsőbb rétegbeli DNS-kiszolgáló közötti kapcsolatokhoz.
LocalDNSQueryLogging	A DNS-lekérdezések naplózási szintje a localDNS-ben.
LocalDNSServeStale	Az elavult adatok kiszolgálására vonatkozó szabályzat. További információért lásd a gyorsítótár bővítményt .
LocalDNSState	A localDNS rendszer által generált állapota.
ManualScaleProfile	A gépek számának specifikációi.
OSDiskType	Az ügynökkészletben lévő gépekhez használandó operációsrendszer-lemez típusa. Az alapértelmezett érték a "Rövid élettartam", ha a virtuális gép támogatja, és a kért OSDiskSizeGB-nél nagyobb gyorsítótárlemezrel rendelkezik. Ellenkező esetben alapértelmezés szerint a "Managed" (Felügyelt) értékre van kapcsolva. Lehet, hogy a létrehozás után nem módosítható. További információ: Rövid élettartamú operációs rendszer.
OSSKU	Az ügynökkészlet által használt operációsrendszer-termékváltozatot adja meg. Az alapértelmezett Ubuntu, ha az OSType Linux. Az alapértelmezett Windows 2019, amikor Kubernetes <= 1.24, vagy Windows2022, amikor Kubernetes >= 1.25, ha az OSType Windows.
OSType	Az operációs rendszer típusa. Az alapértelmezett linuxos.
PodIPAllocationMode	Pod IP-kiosztási mód. Az ügynökkészletben lévő podok IP-foglalási módja. PodSubnetId azonosítóval kell használni. Az alapértelmezett érték a "DynamicIndividual".
PortRange	A porttartomány.
PowerState	A fürt energiaállapotának ismertetése
Protocol	A port hálózati protokollja.
ScaleDownMode	Ismerteti, hogyan lehet virtuális gépeket hozzáadni vagy eltávolítani az ügynökkészletekből. Lásd: számlázási állapotok.
ScaleProfile	A VirtualMachines-ügynökkészletek méretezésének specifikációi.
ScaleSetEvictionPolicy	A virtuálisgép-méretezési csoport kizárási szabályzata. A kilakoltatási szabályzat meghatározza, mit to do a VM-vel, amikor kilakoltatják. Az alapértelmezett érték a Törlés. További információért a kilakoltatásról lásd: spot VMs
ScaleSetPriority	A virtuálisgép-méretezési csoport prioritása.
SysctlConfig	A Linux-ügynökcsomópontok Sysctl-beállításai.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
UndrainableNodeBehavior	Meghatározza a frissítés során nem módosítható csomópontok viselkedését. A nem módosítható csomópontok leggyakoribb oka a podkimaradási költségvetések (PDB-k), de más problémák, például a podleállási türelmi időszak túllépik a csomópontonként fennmaradó időtúllépést, vagy a pod továbbra is futó állapotban van, a nem módosítható csomópontokat is okozhatja.
VirtualMachineNodes	Az azonos virtuálisgép-méretű csomópontok csoportjának aktuális állapota.
VirtualMachinesProfile	A VirtualMachines-ügynökkészlet specifikációi.
WorkloadRuntime	Meghatározza, hogy a csomópont milyen típusú számítási feladatot futtathat.

AgentPool

Tárgy

Ügynökkészlet.

Name	Típus	Alapértelmezett érték	Description
id	string (arm-id)		Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string		Az erőforrás neve
properties.availabilityZones	string[]		A csomópontokhoz használandó rendelkezésre állási zónák listája. Ez csak akkor adható meg, ha az AgentPoolType tulajdonság "VirtualMachineScaleSets".
properties.capacityReservationGroupID	string (arm-id)		A Capacity Reservation Group teljesen minősített erőforrás-azonosítója, amely virtuális gépek biztosításához egy fenntartott Virtual Machines csoportból. Ez a következő formájú: '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft. Compute/capacityreservationgroups/{capacityReservationGroupName}' Az ügyfelek ezt használják, hogy ügynökpoolt hozzanak létre egy meghatározott CRG-vel. További információért lásd a kapacitás foglalása
properties.count	integer (int32)		A Docker-tárolók üzemeltetéséhez használt ügynökök (virtuális gépek) száma. Az engedélyezett értékeknek a felhasználói készletek esetében 0 és 1000 közötti tartományban kell lenniük (beleértve), a rendszerkészletek esetében pedig 1 és 1000 közötti tartományban (beleértve). Az alapértelmezett érték 1.
properties.creationData	CreationData		A forrás pillanatkép-azonosítójának megadásához használandó CreationData, ha a csomópontkészletet pillanatkép használatával hozza létre vagy frissíti.
properties.currentOrchestratorVersion	string		Az ügynökkészlet kubernetes-verziója fut. Ha az orchestratorVersion egy teljesen megadott verzió, <major.minor.patch>, ez a mező pontosan megegyezik vele. Ha az orchestratorVersion <major.minor>, ez a mező a teljes <major.minor.patch> használt verziót tartalmazza.
properties.eTag	string		Az optimista egyidejűség megvalósításához használt egyedi írásvédett sztring. Az eTag értéke az erőforrás frissítésekor megváltozik. Adjon meg egy if-match vagy if-none-match fejlécet az eTag értékkel egy későbbi kérelemhez, hogy engedélyezze az optimista egyidejűséget a normál eTag-konvenció szerint.
properties.enableAutoScaling	boolean		Az automatikus skálázás engedélyezése
properties.enableEncryptionAtHost	boolean		A gazdagépalapú operációs rendszer és az adatmeghajtó titkosításának engedélyezése. Ez csak bizonyos VM méretekben és bizonyos Azure régiókban támogatott. További információ: https://docs.microsoft.com/azure/aks/enable-host-encryption
properties.enableFIPS	boolean		FiPS-kompatibilis operációs rendszer használata. További részletekért lásd: FIPS-kompatibilis csomópontkészlet hozzáadása .
properties.enableNodePublicIP	boolean		Azt jelzi, hogy minden csomópont saját nyilvános IP-címet kap-e. Bizonyos esetekben előfordulhat, hogy a csomópontkészlet csomópontjai saját dedikált nyilvános IP-címeket kapnak. Gyakori forgatókönyv a játékterhelések esetében, ahol a konzolnak közvetlen kapcsolatot kell létesítenie egy felhőbeli virtuális géppel a ugrások minimalizálása érdekében. További információ: nyilvános IP-cím hozzárendelése csomópontonként. Az alapértelmezett érték hamis.
properties.enableUltraSSD	boolean		Az UltraSSD engedélyezése
properties.gatewayProfile	AgentPoolGatewayProfile		Egy felügyelt ügynökkészletre jellemző profil átjáró módban. Ez a mező nem állítható be, ha az ügynökkészlet üzemmódja nem átjáró.
properties.gpuInstanceProfile	GPUInstanceProfile		GPUInstanceProfile a GPU MIG-példányprofiljának megadására a támogatott GPU virtuálisgép-termékváltozathoz.
properties.gpuProfile	GPUProfile		Az ügynökkészlet GPU-beállításai.
properties.hostGroupID	string (arm-id)		A dedikált gazdagépcsoport teljes erőforrás-azonosítója, amelyből virtuális gépeket építhet ki, csak létrehozási forgatókönyvben használatos, és a beállítás után nem módosítható. Ez a következő forma van: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Compute/hostGroups/{hostGroupName}. További információért lásd: Azure dedikált húdozókat.
properties.kubeletConfig	KubeletConfig		A Kubelet-konfiguráció az ügynökkészlet csomópontjain.
properties.kubeletDiskType	KubeletDiskType		Meghatározza az emptyDir kötetek, a konténer futási idejű adatgyökerek és a Kubelet ephemeral storage elhelyezkedését.
properties.linuxOSConfig	LinuxOSConfig		Linux-ügynökcsomópontok operációsrendszer-konfigurációja.
properties.localDNSProfile	LocalDNSProfile		Konfigurálja a csomópontonkénti helyi DNS-t a VnetDNS és a KubeDNS felülbírálásával. A LocalDNS segít javítani a DNS-feloldás teljesítményét és megbízhatóságát egy AKS-fürtben. További részletekért lásd aka.ms/aks/localdns.
properties.maxCount	integer (int32)		Az automatikus skálázáshoz használható csomópontok maximális száma
properties.maxPods	integer (int32)		A csomóponton futtatható podok maximális száma.
properties.messageOfTheDay	string		A nap üzenete Linux-csomópontokhoz, base64 kódolású. Egy base64 kódolású sztring, amely a dekódolás után a /etc/motd fájlba lesz írva. Ez lehetővé teszi a nap üzenetének testreszabását Linux-csomópontok esetében. Nem szabad megadni a Windows csomópontokra. Statikus sztringnek kell lennie (azaz nyersen lesz kinyomtatva, és nem szkriptként lesz végrehajtva).
properties.minCount	integer (int32)		Az automatikus skálázáshoz szükséges csomópontok minimális száma
properties.mode	AgentPoolMode		Az ügynökkészlet módja. A fürtöknek mindig legalább egy "System" ügynökkészlettel kell rendelkezniük. Az ügynökkészlet korlátozásaival és ajánlott eljárásaival kapcsolatos további információkért lásd: https://docs.microsoft.com/azure/aks/use-system-pools
properties.networkProfile	AgentPoolNetworkProfile		Egy ügynökkészlet hálózattal kapcsolatos beállításai.
properties.nodeImageVersion	string		A csomópont lemezképének verziója
properties.nodeLabels	object		Az ügynökkészlet összes csomópontjában megőrzendő csomópontfeliratok.
properties.nodePublicIPPrefixID	string (arm-id)		A nyilvános IP-előtag azonosítója, amelyből a virtuálisgép-csomópontoknak IP-címeket kell használniuk. Ez a következő forma van: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/publicIPPrefixes/{publicIPPrefixName}
properties.nodeTaints	string[]		A csomópontkészlet létrehozása és skálázása során az új csomópontokhoz hozzáadott fertőzöttek. Például: key=value:NoSchedule.
properties.orchestratorVersion	string		A felhasználó által megadott Kubernetes-verzió. Mind a javítás verziójú <major.minor.patch> (pl. 1.20.13) és <a major.minor> (pl. 1.20) támogatott. A major.minor< megadásakor >a rendszer automatikusan kiválasztja a legújabb támogatott GA-javításverziót. A fürt létrehozása után (például 1.14.x –< 1.14) a fürt ugyanazon >major.minor> verzióval való frissítése nem indítja el a frissítést, még akkor sem, ha egy újabb javításverzió érhető el. Ajánlott eljárásként frissítse az AKS-fürtök összes csomópontkészletét ugyanarra a Kubernetes-verzióra. A csomópontkészlet verziójának a vezérlősík főverziójával kell rendelkeznie. A csomópontkészlet alverziójának a vezérlősík két alverziójában kell lennie. A csomópontkészlet verziója nem lehet nagyobb, mint a vezérlősík verziója. További információ: csomópontkészlet frissítése.
properties.osDiskSizeGB	integer (int32) minimum: 0 maximum: 2048		Az operációsrendszer-lemez mérete GB-ban a fő-/ügynökkészlet minden gépének lemezméretének megadására szolgál. Ha 0 értéket ad meg, az az alapértelmezett osDisk méretet alkalmazza a megadott vmSize szerint.
properties.osDiskType	OSDiskType		Az ügynökkészletben lévő gépekhez használandó operációsrendszer-lemez típusa. Az alapértelmezett érték a "Rövid élettartam", ha a virtuális gép támogatja, és a kért OSDiskSizeGB-nél nagyobb gyorsítótárlemezrel rendelkezik. Ellenkező esetben alapértelmezés szerint a "Managed" (Felügyelt) értékre van kapcsolva. Lehet, hogy a létrehozás után nem módosítható. További információ: Rövid élettartamú operációs rendszer.
properties.osSKU	OSSKU		Az ügynökkészlet által használt operációsrendszer-termékváltozatot adja meg. Az alapértelmezett Ubuntu, ha az OSType Linux. Az alapértelmezett Windows 2019, amikor Kubernetes <= 1.24, vagy Windows2022, amikor Kubernetes >= 1.25, ha az OSType Windows.
properties.osType	OSType	Linux	Az operációs rendszer típusa. Az alapértelmezett linuxos.
properties.podIPAllocationMode	PodIPAllocationMode		Pod IP-kiosztási mód. Az ügynökkészletben lévő podok IP-foglalási módja. PodSubnetId azonosítóval kell használni. Az alapértelmezett érték a "DynamicIndividual".
properties.podSubnetID	string (arm-id)		Annak az alhálózatnak az azonosítója, amelyhez a podok az indításkor csatlakoznak. Ha nincs megadva, a pod IP-címek statikusan vannak hozzárendelve a csomópont alhálózatához (további részletekért lásd a vnetSubnetID azonosítót). Ez a következő forma van: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.powerState	PowerState		Azt jelzi, hogy az ügynökkészlet fut-e vagy le van-e állítva. Az ügynökkészlet első létrehozásakor először fut. Az ügynökkészlet leállítható úgy, hogy ezt a mezőt Leállítva értékre állítja. A leállított ügynökkészlet leállítja az összes virtuális gépét, és nem számol fel számlázási díjakat. Az ügynökkészletek csak akkor állíthatók le, ha fut, és a kiépítési állapot sikeres
properties.provisioningState	string		Az aktuális üzembe helyezési vagy kiépítési állapot.
properties.proximityPlacementGroupID	string (arm-id)		A közelségi elhelyezési csoport azonosítója.
properties.scaleDownMode	ScaleDownMode		Az ügynökkészlet skálázásához használandó leskálázási mód. Ez a fürt automatikus skálázási viselkedésére is hatással van. Ha nincs megadva, akkor alapértelmezés szerint a Delete érték lesz.
properties.scaleSetEvictionPolicy	ScaleSetEvictionPolicy	Delete	A virtuálisgép-méretezési csoport kizárási szabályzata. A kilakoltatási szabályzat meghatározza, mit to do a VM-vel, amikor kilakoltatják. Az alapértelmezett érték a Törlés. További információért a kilakoltatásról lásd: spot VMs
properties.scaleSetPriority	ScaleSetPriority	Regular	A virtuálisgép-méretezési csoport prioritása.
properties.securityProfile	AgentPoolSecurityProfile		Az ügynökkészlet biztonsági beállításai.
properties.spotMaxPrice	number (float)	-1	A maximális ár (amerikai dollárban), amit hajlandó fizetni az azonnali példányokért. A lehetséges értékek a nullánál nagyobb vagy -1 tizedesjegyek, amelyek azt jelzik, hogy az alapértelmezett ár igény szerint up-to. A lehetséges értékek a nullánál nagyobb tizedesjegyek vagy -1, amelyek jelzik, hogy hajlandóak-e bármilyen igény szerinti árat fizetni. A kihasználatlan díjszabásról további információt a kihasználatlan virtuális gépek díjszabásában talál
properties.status	AgentPoolStatus		Írásvédett információkat tartalmaz az ügynökkészletről.
properties.tags	object		Az ügynökkészlet virtuálisgép-méretezési csoportjában megőrizendő címkék.
properties.type	AgentPoolType		Az ügynökkészlet típusa.
properties.upgradeSettings	AgentPoolUpgradeSettings		Az ügynökkészlet frissítésének beállításai
properties.virtualMachineNodesStatus	VirtualMachineNodes[]		A VirtualMachines-ügynökkészlet csomópontjainak állapota.
properties.virtualMachinesProfile	VirtualMachinesProfile		A VirtualMachines-ügynökkészlet specifikációi.
properties.vmSize	string		Az ügynökkészlet virtuális gépeinek mérete. A virtuális gép mérete régiónként eltérő. Ha egy csomópont nem tartalmaz elegendő számítási erőforrást (memóriát, processzort stb.), előfordulhat, hogy a podok nem futnak megfelelően. A korlátozott virtuálisgép-méretekkel kapcsolatos további részletekért lásd: https://docs.microsoft.com/azure/aks/quotas-skus-regions
properties.vnetSubnetID	string (arm-id)		Annak az alhálózatnak az azonosítója, amelyhez az ügynökkészlet csomópontjai és opcionálisan podok csatlakoznak indításkor. Ha ez nincs megadva, a rendszer létrehoz és használ egy virtuális hálózatot és alhálózatot. Ha nincs megadva podSubnetID, ez a csomópontokra és podokra vonatkozik, ellenkező esetben csak a csomópontokra vonatkozik. Ez a következő forma van: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.windowsProfile	AgentPoolWindowsProfile		A Windows ügynök pool speciális profilja.
properties.workloadRuntime	WorkloadRuntime		Meghatározza, hogy a csomópont milyen típusú számítási feladatot futtathat.
systemData	systemData		A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
type	string		Az erőforrás típusa. Például: "Microsoft. Compute/virtualMachines" vagy "Microsoft. Tárhely/tárolásFiókok"

AgentPoolGatewayProfile

Tárgy

A felügyelt fürtátjáró-ügynökkészlet profilja.

Name	Típus	Alapértelmezett érték	Description
publicIPPrefixSize	integer (int32) minimum: 28 maximum: 31	31	Az átjáró-ügynökkészlet minden statikus kimenő átjáróhoz egy nyilvános IPPrefixet társít a nyilvános kimenő forgalom biztosításához. A nyilvános IPPrefix méretét a felhasználónak kell kiválasztania. Az ügynökkészlet minden csomópontja egy IP-címmel van hozzárendelve az IPPrefixből. Az IPPrefix mérete így az átjáróügynök-készlet méretének korlátjaként szolgál. A nyilvános IPPrefix méretkorlátjának Azure miatt az érvényes értéktartomány [28, 31] (/31 = 2 csomópont/IP-cím, /30 = 4 csomópont/IP-cím, /29 = 8 csomópont/IP-cím, /28 = 16 csomópont/IP-cím). Az alapértelmezett érték 31.

AgentPoolMode

Felsorolás

Az ügynökkészlet módja. A fürtöknek mindig legalább egy "System" ügynökkészlettel kell rendelkezniük. Az ügynökkészlet korlátozásaival és ajánlott eljárásaival kapcsolatos további információkért lásd: https://docs.microsoft.com/azure/aks/use-system-pools

Érték	Description
System	A rendszerügynök-készletek elsősorban olyan kritikus rendszer podok üzemeltetésére szolgálnak, mint a CoreDNS és a metrics-server. A rendszerügynök-készletek osType-nak Linuxnak kell lenniük. A rendszerügynök-készletek virtuálisgép-termékváltozatának legalább 2vCPU-val és 4 GB memóriával kell rendelkeznie.
User	A felhasználói ügynökkészletek elsősorban az alkalmazás podok üzemeltetésére használhatók.
Gateway	Az átjáróügynök-készletek statikus kimenő IP-címeket biztosítanak a podokhoz. További részletekért lásd: https://aka.ms/aks/static-egress-gateway.

AgentPoolNetworkProfile

Tárgy

Ügynökkészlet hálózati beállításai.

Name	Típus	Description
allowedHostPorts	PortRange[]	A porttartományok, amelyek access. A megadott tartományok átfedésben lehetnek.
applicationSecurityGroups	string[] (arm-id)	Azon alkalmazásbiztonsági csoportok azonosítói, amelyeket az ügynökkészlet társít a létrehozáskor.
nodePublicIPTags	IPTag[]	Példányszintű nyilvános IP-címek IP-címei.

AgentPoolSecurityProfile

Tárgy

Az ügynökkészlet biztonsági beállításai.

Name	Típus	Description
enableSecureBoot	boolean	A biztonságos rendszerindítás a megbízható indítás egyik funkciója, amely biztosítja, hogy csak aláírt operációs rendszerek és illesztőprogramok indulhatnak el. További részletekért lásd: aka.ms/aks/trustedlaunch. Ha nincs megadva, az alapértelmezett érték hamis.
enableVTPM	boolean	A vTPM egy megbízható indítási funkció egy dedikált biztonságos tároló konfigurálásához a csomóponton helyben tárolt kulcsokhoz és mérésekhez. További részletekért lásd: aka.ms/aks/trustedlaunch. Ha nincs megadva, az alapértelmezett érték hamis.
sshAccess	AgentPoolSSHAccess	Az ügynök pool SSH access módszere.

AgentPoolSSHAccess

Felsorolás

Az ügynök pool SSH access módszere.

Érték	Description
LocalUser	Az SSH helyi felhasználóként, titkos kulcs használatával adhatja meg a csomópontot.
Disabled	Az SSH szolgáltatás ki lesz kapcsolva a csomóponton.

AgentPoolStatus

Tárgy

Írásvédett információkat tartalmaz az ügynökkészletről.

Name	Típus	Description
provisioningError	ErrorDetail	Az ügynökkészlet hibainformációi. Megőrzi a hiba részletes adatait. Ha nem történt hiba, a mező nem jelenik meg.

AgentPoolType

Felsorolás

Az ügynökkészlet típusa.

Érték	Description
VirtualMachineScaleSets	Hozzon létre egy virtuálisgép-méretezési csoport által támogatott ügynökkészletet.
AvailabilitySet	Ennek használata erősen elriasztja.
VirtualMachines	Hozzon létre egy ügynökkészletet egyetlen példányos virtuálisgép-vezénylési móddal.

AgentPoolUpgradeSettings

Tárgy

Ügynökkészlet frissítésének beállításai

Name	Típus	Description
drainTimeoutInMinutes	integer (int32) minimum: 1 maximum: 1440	Egy csomópont kiürítési időtúllépése. A podok kiürítésére és a csomópontonkénti kecses befejezésre váró idő (percekben). Ez a kilakoltatási várakozási idő a podkimaradási költségvetésekre vár. Ha ezt az időt túllépi, a frissítés meghiúsul. Ha nincs megadva, az alapértelmezett érték 30 perc.
maxSurge	string	A frissítés során megugrott csomópontok maximális száma vagy százalékos aránya. Ez vagy egész számra (például '5') vagy százalékra (például '50%' lehet beállítva). Ha egy százalék meg van adva, az az ügynökkészlet teljes méretének százalékos aránya a frissítés időpontjában. Százalékértékek esetén a tört csomópontok fel vannak kerekítve. Ha nincs megadva, az alapértelmezett érték 10%. További információk, beleértve az ajánlott eljárásokat, lásd: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster
maxUnavailable	string	A frissítés során egyidejűleg elérhetetlen csomópontok maximális száma vagy százalékos aránya. Ez vagy egész számra (például '1') vagy százalékra (pl. '5%') állítható be. Ha egy százalék meg van adva, az az ügynökkészlet teljes méretének százalékos aránya a frissítés időpontjában. Százalékértékek esetén a tört csomópontok fel vannak kerekítve. Ha nincs megadva, az alapértelmezett érték 0. További információk, beleértve az ajánlott eljárásokat, lásd: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster
nodeSoakDurationInMinutes	integer (int32) minimum: 0 maximum: 30	Egy csomópont áztatási időtartama. A csomópont kiürítése és újraimálása és a következő csomópontra való áttérés után várakozási idő (percek alatt). Ha nincs megadva, az alapértelmezett érték 0 perc.
undrainableNodeBehavior	UndrainableNodeBehavior	Meghatározza a frissítés során nem módosítható csomópontok viselkedését. A nem módosítható csomópontok leggyakoribb oka a podkimaradási költségvetések (PDB-k), de más problémák, például a podleállási türelmi időszak túllépik a csomópontonként fennmaradó időtúllépést, vagy a pod továbbra is futó állapotban van, a nem módosítható csomópontokat is okozhatja.

AgentPoolWindowsProfile

Tárgy

A Windows ügynök pool speciális profilja.

Name	Típus	Description
disableOutboundNat	boolean	Letiltja-e a OutboundNAT szolgáltatást a Windows-csomópontokon. Az alapértelmezett érték hamis. A kimenő NAT csak akkor tiltható le, ha a fürt kimenő típusa NAT-átjáró, és a Windows-ügynökkészletben nincs engedélyezve a csomópont nyilvános IP-címe.

Code

Felsorolás

Azt jelzi, hogy a fürt fut-e vagy le van-e állítva

Érték	Description
Running	A fürt fut.
Stopped	A fürt leállt.

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Description
User
Application
ManagedIdentity
Key

CreationData

Tárgy

A célerőforrás forráserőforrásból való létrehozásakor használt adatok.

Name	Típus	Description
sourceResourceId	string (arm-id)	Ez a célobjektum létrehozásához használandó forrásobjektum ARM-azonosítója.

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hiba célpontja.

ErrorResponse

Tárgy

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

GPUDriver

Felsorolás

Gpu-illesztőprogramok telepítése. Ha nincs megadva, az alapértelmezett beállítás a Telepítés.

Érték	Description
Install	Telepítse az illesztőprogramot.
None	Az illesztőprogram telepítésének kihagyása.

GPUInstanceProfile

Felsorolás

GPUInstanceProfile a GPU MIG-példányprofiljának megadására a támogatott GPU virtuálisgép-termékváltozathoz.

Érték	Description
MIG1g	MIG 1g GPU instance profil.
MIG2g	MIG 2g GPU instance profil.
MIG3g	MIG 3g GPU instance profil.
MIG4g	MIG 4g GPU instance profil.
MIG7g	MIG 7g GPU instance profil.

GPUProfile

Tárgy

Az ügynökkészlet GPU-beállításai.

Name	Típus	Description
driver	GPUDriver	Gpu-illesztőprogramok telepítése. Ha nincs megadva, az alapértelmezett beállítás a Telepítés.

IPTag

Tárgy

Az objektumhoz társított IP-címet tartalmazza.

Name	Típus	Description
ipTagType	string	Az IP-címke típusa. Példa: RoutingPreference.
tag	string	A nyilvános IP-címhez társított IP-címke értéke. Példa: Internet.

KubeletConfig

Tárgy

Az ügynökcsomópontok Kubelet-konfigurációi. További részletekért lásd AKS egyéni csomópontkonfigurációs.

Name	Típus	Description
allowedUnsafeSysctls	string[]	A nem biztonságos sysctls- vagy nem biztonságos sysctl-minták engedélyezett listája (végződés: `*`).
containerLogMaxFiles	integer (int32) minimum: 2	A tárolóhoz megjeleníthető tároló naplófájljainak maximális száma. A számnak 2 ≥ kell lennie.
containerLogMaxSizeMB	integer (int32)	A tároló naplófájljának maximális mérete (pl. 10Mi) forgatás előtt.
cpuCfsQuota	boolean	Ha a CPU CFS-kvóta kikényszerítése engedélyezve van a CPU-korlátokat meghatározó tárolók esetében. Az alapértelmezett érték igaz.
cpuCfsQuotaPeriod	string	A CPU CFS kvótaidőszakának értéke. Az alapértelmezett érték a "100 ms". Az érvényes értékek decimális számok sorozatai, amelyek nem kötelező törtrészt és egység utótagot tartalmaznak. Például: "300ms", "2h45m". A támogatott egységek a következők: "ns", "us", "ms", "s", "m", és "h".
cpuManagerPolicy	string	A használni kívánt CPU Manager-szabályzat. Az alapértelmezett érték a "nincs". További információkért tekintse meg a Kubernetes CPU-kezelési szabályzatát . Az engedélyezett értékek "nincs" és "statikusak".
failSwapOn	boolean	Ha igaz értékre van állítva, a Kubelet nem indul el, ha a felcserélés engedélyezve van a csomóponton.
imageGcHighThreshold	integer (int32)	Az a lemezhasználati százalék, amely után a rendszerkép-szemétgyűjtés mindig lefut. A kép szemétgyűjtésének letiltásához állítsa be a 100 értéket. Az alapértelmezett érték 85%
imageGcLowThreshold	integer (int32)	A lemezhasználat azon százaléka, amely alatt a képek szemétgyűjtése soha nem indul el. Ez nem állítható be magasabbra az imageGcHighThreshold értéknél. Az alapértelmezett érték 80%
podMaxPids	integer (int32)	A podonkénti folyamatok maximális száma.
topologyManagerPolicy	string	A használni kívánt Topology Manager-szabályzat. További információ: Kubernetes Topology Manager. Az alapértelmezett érték a "nincs". Az engedélyezett értékek a következők: "none", "best-effort", "restricted" és "single-numa-node".

KubeletDiskType

Felsorolás

Meghatározza az emptyDir kötetek, a konténer futási idejű adatgyökerek és a Kubelet ephemeral storage elhelyezkedését.

Érték	Description
OS	A Kubelet az operációsrendszer-lemezt fogja használni az adataihoz.
Temporary	A Kubelet az ideiglenes lemezt fogja használni az adataihoz.

LinuxOSConfig

Tárgy

Linux-ügynökcsomópontok operációsrendszer-konfigurációi. További részletekért lásd AKS egyéni csomópontkonfigurációs.

Name	Típus	Description
swapFileSizeMB	integer (int32)	Az egyes csomópontokon létrehozandó felcserélési fájl MB-ban megadott mérete.
sysctls	SysctlConfig	A Linux-ügynökcsomópontok Sysctl-beállításai.
transparentHugePageDefrag	string	Azt jelzi, hogy a kernelnek agresszíven kell-e használnia a memóriatömörülést, hogy nagyobb méretű lapokat tegyen elérhetővé. Az érvényes értékek a következők: "always", "halasztás", "halasztás+madvise", "madvise" és "never". Az alapértelmezett érték a "madvise". További információ: Transzparens hatalmas lapok.
transparentHugePageEnabled	string	Azt jelzi, hogy engedélyezve vannak-e a transzparens hatalmas lapok. Az érvényes értékek a következők: "always", "madvise", és "never". Az alapértelmezett érték a "always". További információ: Transzparens hatalmas lapok.

LocalDNSForwardDestination

Felsorolás

A localDNS-ből továbbítandó DNS-lekérdezések célkiszolgálója.

Érték	Description
ClusterCoreDNS	DNS-lekérdezések továbbítása a localDNS-ből a CoreDNS fürtbe.
VnetDNS	DNS-lekérdezések továbbítása a localDNS-ről a virtuális hálózaton konfigurált DNS-kiszolgálóra. Egy virtuális hálózaton több DNS-kiszolgáló is konfigurálható.

LocalDNSForwardPolicy

Felsorolás

Továbbítási szabályzat a felsőbb rétegbeli DNS-kiszolgáló kiválasztásához. További információért lásd a továbbítási bővítményt .

Érték	Description
Sequential	Szekvenciális felsőbb rétegbeli DNS-kiszolgáló kiválasztását valósítja meg. További információért lásd a továbbítási bővítményt .
RoundRobin	Ciklikus multiplexeléses DNS-kiszolgáló kiválasztását valósítja meg. További információért lásd a továbbítási bővítményt .
Random	Véletlenszerű felsőbb rétegbeli DNS-kiszolgáló kiválasztását valósítja meg. További információért lásd a továbbítási bővítményt .

LocalDNSMode

Felsorolás

A localDNS engedélyezési módja.

Érték	Description
Preferred	Ha a vezénylési verzió támogatja ezt a funkciót, inkább engedélyezze a localDNS-t.
Required	Engedélyezze a localDNS-t.
Disabled	Tiltsa le a localDNS-t.

LocalDNSOverride

Tárgy

A localDNS-profil felülbírálása.

Name	Típus	Alapértelmezett érték	Description
cacheDurationInSeconds	integer (int32)	3600	Gyorsítótárazza a maximális TTL-t másodpercben. További információért lásd a gyorsítótár bővítményt .
forwardDestination	LocalDNSForwardDestination	ClusterCoreDNS	A localDNS-ből továbbítandó DNS-lekérdezések célkiszolgálója.
forwardPolicy	LocalDNSForwardPolicy	Sequential	Továbbítási szabályzat a felsőbb rétegbeli DNS-kiszolgáló kiválasztásához. További információért lásd a továbbítási bővítményt .
maxConcurrent	integer (int32)	1000	Egyidejű lekérdezések maximális száma. További információért lásd a továbbítási bővítményt .
protocol	LocalDNSProtocol	PreferUDP	Kényszerítse ki a TCP-t, vagy részesítse előnyben az UDP protokollt a localDNS és a felsőbb rétegbeli DNS-kiszolgáló közötti kapcsolatokhoz.
queryLogging	LocalDNSQueryLogging	Error	A DNS-lekérdezések naplózási szintje a localDNS-ben.
serveStale	LocalDNSServeStale	Immediate	Az elavult adatok kiszolgálására vonatkozó szabályzat. További információért lásd a gyorsítótár bővítményt .
serveStaleDurationInSeconds	integer (int32)	3600	Elavult időtartam másodpercben. További információért lásd a gyorsítótár bővítményt .

LocalDNSProfile

Tárgy

Konfigurálja a csomópontonkénti helyi DNS-t a VnetDNS és a KubeDNS felülbírálásával. A LocalDNS segít javítani a DNS-feloldás teljesítményét és megbízhatóságát egy AKS-fürtben. További részletekért lásd aka.ms/aks/localdns.

Name	Típus	Alapértelmezett érték	Description
kubeDNSOverrides	<string, LocalDNSOverride>		A KubeDNS-felülbírálások a hüvelyekből származó DNS-forgalomra vonatkoznak a dnsPolicy:ClusterFirst (más néven KubeDNS-forgalom).
mode	LocalDNSMode	Preferred	A localDNS engedélyezési módja.
state	LocalDNSState		A localDNS rendszer által generált állapota.
vnetDNSOverrides	<string, LocalDNSOverride>		A VnetDNS-felülbírálások a hüvelyekből származó DNS-forgalomra vonatkoznak a dnsPolicy:default vagy a kubelet (más néven VnetDNS-forgalom).

LocalDNSProtocol

Felsorolás

Kényszerítse ki a TCP-t, vagy részesítse előnyben az UDP protokollt a localDNS és a felsőbb rétegbeli DNS-kiszolgáló közötti kapcsolatokhoz.

Érték	Description
PreferUDP	Az UDP protokoll előnyben részesítése a localDNS és a felsőbb rétegbeli DNS-kiszolgáló közötti kapcsolatokhoz.
ForceTCP	TCP protokoll kényszerítése a localDNS és a felsőbb rétegbeli DNS-kiszolgáló közötti kapcsolatokhoz.

LocalDNSQueryLogging

Felsorolás

A DNS-lekérdezések naplózási szintje a localDNS-ben.

Érték	Description
Error	Engedélyezi a hibanaplózást a localDNS-ben. További információért lásd a hibák beépülő modulját .
Log	Engedélyezi a lekérdezésnaplózást a localDNS-ben. További információért lásd a naplóbővítményt .

LocalDNSServeStale

Felsorolás

Az elavult adatok kiszolgálására vonatkozó szabályzat. További információért lásd a gyorsítótár bővítményt .

Érték	Description
Verify	Elavult adatok kiszolgálása ellenőrzéssel. Először ellenőrizze, hogy egy bejegyzés még mindig nem érhető el a forrásból, mielőtt elküldi a lejárt bejegyzést az ügyfélnek. További információért lásd a gyorsítótár bővítményt .
Immediate	Az elavult adatok azonnali kiszolgálása. Küldje el a lejárt bejegyzést az ügyfélnek, mielőtt ellenőrizze, hogy a bejegyzés elérhető-e a forrásból. További információért lásd a gyorsítótár bővítményt .
Disable	Tiltsa le az elavult adatok kiszolgálását.

LocalDNSState

Felsorolás

A localDNS rendszer által generált állapota.

Érték	Description
Enabled	localDNS engedélyezve van.
Disabled	localDNS le van tiltva.

ManualScaleProfile

Tárgy

A gépek számának specifikációi.

Name	Típus	Description
count	integer (int32)	Csomópontok száma.
size	string	Az AKS által a létrehozáskor és skálázáskor használt virtuálisgép-méret, például "Standard_E4s_v3", "Standard_E16s_v3" vagy "Standard_D16s_v5".

OSDiskType

Felsorolás

Az ügynökkészletben lévő gépekhez használandó operációsrendszer-lemez típusa. Az alapértelmezett érték a "Rövid élettartam", ha a virtuális gép támogatja, és a kért OSDiskSizeGB-nél nagyobb gyorsítótárlemezrel rendelkezik. Ellenkező esetben alapértelmezés szerint a "Managed" (Felügyelt) értékre van kapcsolva. Lehet, hogy a létrehozás után nem módosítható. További információ: Rövid élettartamú operációs rendszer.

Érték	Description
Managed	Az Azure lemásolja a virtuális gép operációs rendszer lemezét Azure tárolóra, hogy elkerülje az adatvesztést, ha a VM-et át kell költöztetni egy másik hosztra. Mivel a tárolók nem úgy vannak kialakítva, hogy a helyi állapot megmaradjon, ez a viselkedés korlátozott értéket kínál, ugyanakkor hátrányokat is biztosít, beleértve a lassabb csomópontkiépítést és a nagyobb olvasási/írási késést.
Ephemeral	A rövid élettartamú operációsrendszer-lemezek csak a gazdaszámítógépen vannak tárolva, csakúgy, mint egy ideiglenes lemezen. Ez alacsonyabb olvasási/írási késést, valamint gyorsabb csomópontméretezést és fürtfrissítéseket biztosít.

Érték

Description

Managed

Az Azure lemásolja a virtuális gép operációs rendszer lemezét Azure tárolóra, hogy elkerülje az adatvesztést, ha a VM-et át kell költöztetni egy másik hosztra. Mivel a tárolók nem úgy vannak kialakítva, hogy a helyi állapot megmaradjon, ez a viselkedés korlátozott értéket kínál, ugyanakkor hátrányokat is biztosít, beleértve a lassabb csomópontkiépítést és a nagyobb olvasási/írási késést.

Ephemeral

A rövid élettartamú operációsrendszer-lemezek csak a gazdaszámítógépen vannak tárolva, csakúgy, mint egy ideiglenes lemezen. Ez alacsonyabb olvasási/írási késést, valamint gyorsabb csomópontméretezést és fürtfrissítéseket biztosít.

OSSKU

Felsorolás

Az ügynökkészlet által használt operációsrendszer-termékváltozatot adja meg. Az alapértelmezett Ubuntu, ha az OSType Linux. Az alapértelmezett Windows 2019, amikor Kubernetes <= 1.24, vagy Windows2022, amikor Kubernetes >= 1.25, ha az OSType Windows.

Érték	Description
Ubuntu	Csomópontképekhez használja az Ubuntu operációs rendszert.
AzureLinux	Használja az AzureLinuxot operációs rendszerként a csomópontrendszerképekhez. Azure a Linux egy konténerre optimalizált Linux disztribúció, amelyet Microsoft készített, további információkért látogasson el https://aka.ms/azurelinux oldalra.
AzureLinux3	Használja az AzureLinux3-at a csomópont-rendszerképek operációs rendszereként. Azure a Linux egy konténerre optimalizált Linux disztribúció, amelyet Microsoft készített, további információkért látogasson el https://aka.ms/azurelinux oldalra. A korlátozásokért látogasson el a .https://aka.ms/aks/node-images Az operációs rendszer migrálási útmutatójáért lásd: https://aka.ms/aks/upgrade-os-version.
CBLMariner	Elavult OSSKU. A Microsoft azt javasolja, hogy az új telepítések inkább az 'AzureLinux' opciót válasszák.
Windows2019	Használja a Windows2019-et operációs rendszerként csomópontlemezképekhez. A rendszercsomópont-készletek nem támogatottak. A Windows2019 csak a Windows2019-tárolókat támogatja; Nem futtathat Windows2022-tárolókat, és fordítva.
Windows2022	Használja a Windows2022 rendszert a csomópontlemezképek operációs rendszereként. A rendszercsomópont-készletek nem támogatottak. A Windows2022 csak a Windows2022-tárolókat támogatja; Nem futtathat Windows2019-tárolókat, és fordítva.
Ubuntu2204	Használja az Ubuntu2204-et a csomópont-rendszerképek operációs rendszereként, azonban előfordulhat, hogy az Ubuntu 22.04 nem támogatott minden csomópontkészlethez. A korlátozásokat és a támogatott Kubernetes-verziókat lásd: https://aka.ms/aks/supported-ubuntu-versions
Windows2025	Használja a Windows2025-öt a csomópont-rendszerképek operációs rendszereként. A rendszercsomópont-készletek nem támogatottak. A Windows2025 támogatja a Windows2022 és a Windows 2025 konténereket; nem futtathatja a Windows2019 konténereket, és fordítva.
Ubuntu2404	Használja az Ubuntu2404-et a csomópontképek operációs rendszereként, azonban előfordulhat, hogy az Ubuntu 24.04 nem támogatott minden csomópontkészlethez. A korlátozásokat és a támogatott Kubernetes-verziókat lásd: https://aka.ms/aks/supported-ubuntu-versions

OSType

Felsorolás

Az operációs rendszer típusa. Az alapértelmezett linuxos.

Érték	Description
Linux	Linux használata.
Windows	Használd a Windows-t.

PodIPAllocationMode

Felsorolás

Pod IP-kiosztási mód. Az ügynökkészletben lévő podok IP-foglalási módja. PodSubnetId azonosítóval kell használni. Az alapértelmezett érték a "DynamicIndividual".

Érték	Description
DynamicIndividual	Minden csomópont a hüvelyekhez rendelhető IP-címek nem összefüggő listájával lesz lefoglalva. Ez jobb egy kis és közepes méretű /16 vagy kisebb alhálózat maximalizálásához. Az Azure CNI klaszter, amely dinamikus IP-allokációval rendelkezik, alapértelmezett módon erre a módra lép, ha az ügyfél nem jelöl meg kifejezetten podIPAllocationMode-ot
StaticBlock	Minden csomópont statikusan le van foglalva /28 = 16 IP-cím/blokk méretű CIDR-blokk(ok) a csomópontonkénti maxPods kielégítése érdekében. CIDR-blokkok száma >= (maxPods / 16). A blokk, nem egyetlen IP, számít bele az Azure VNET Private IP korlátba, amely 65K. Ezért a blokk mód alkalmas nagyobb számítási feladatok futtatására, ha a fürtben a jelenlegi korlátnál több 65 000 pod van. Ez a mód jobban megfelel a nagyobb /15 vagy nagyobb alhálózatokkal való méretezéshez

Érték

Description

DynamicIndividual

Minden csomópont a hüvelyekhez rendelhető IP-címek nem összefüggő listájával lesz lefoglalva. Ez jobb egy kis és közepes méretű /16 vagy kisebb alhálózat maximalizálásához. Az Azure CNI klaszter, amely dinamikus IP-allokációval rendelkezik, alapértelmezett módon erre a módra lép, ha az ügyfél nem jelöl meg kifejezetten podIPAllocationMode-ot

StaticBlock

Minden csomópont statikusan le van foglalva /28 = 16 IP-cím/blokk méretű CIDR-blokk(ok) a csomópontonkénti maxPods kielégítése érdekében. CIDR-blokkok száma >= (maxPods / 16). A blokk, nem egyetlen IP, számít bele az Azure VNET Private IP korlátba, amely 65K. Ezért a blokk mód alkalmas nagyobb számítási feladatok futtatására, ha a fürtben a jelenlegi korlátnál több 65 000 pod van. Ez a mód jobban megfelel a nagyobb /15 vagy nagyobb alhálózatokkal való méretezéshez

PortRange

Tárgy

A porttartomány.

Name	Típus	Description
portEnd	integer (int32) minimum: 1 maximum: 65535	A tartományhoz tartozó maximális port. 1 és 65535 között kell lennie, és nagyobbnak vagy egyenlőnek kell lennie a portStart értékénél.
portStart	integer (int32) minimum: 1 maximum: 65535	A tartományba tartozó minimális port. A tartománynak 1 és 65535 között kell lennie, és kisebbnek vagy egyenlőnek kell lennie a portEnd értékénél.
protocol	Protocol	A port hálózati protokollja.

PowerState

Tárgy

A fürt energiaállapotának ismertetése

Name	Típus	Description
code	Code	Azt jelzi, hogy a fürt fut-e vagy le van-e állítva

Protocol

Felsorolás

A port hálózati protokollja.

Érték	Description
TCP	TCP protokoll.
UDP	UDP protokoll.

ScaleDownMode

Felsorolás

Ismerteti, hogyan lehet virtuális gépeket hozzáadni vagy eltávolítani az ügynökkészletekből. Lásd: számlázási állapotok.

Érték	Description
Delete	Hozzon létre új példányokat a vertikális felskálázás során, és távolítsa el a példányokat a leskálázás során.
Deallocate	Megkísérli elindítani a felszabadított példányokat (ha léteznek) a vertikális felskálázás és a példányok felszabadítása során a leskálázás során.

ScaleProfile

Tárgy

A VirtualMachines-ügynökkészletek méretezésének specifikációi.

Name	Típus	Description
manual	ManualScaleProfile[]	A VirtualMachines-ügynökkészlet rögzített méretre történő skálázásának specifikációi.

ScaleSetEvictionPolicy

Felsorolás

A virtuálisgép-méretezési csoport kizárási szabályzata. A kilakoltatási szabályzat meghatározza, mit to do a VM-vel, amikor kilakoltatják. Az alapértelmezett érték a Törlés. További információért a kilakoltatásról lásd: spot VMs

Érték	Description
Delete	A csomópontkészlet mögöttes méretezési csoportjában lévő csomópontok törlődnek, amikor kiürítik őket.
Deallocate	A csomópontkészlet alapjául szolgáló méretezési csoportban lévő csomópontok a kiürítéskor leállított felszabadított állapotra vannak állítva. A leállított felszabadított állapotban lévő csomópontok száma a számítási kvótához viszonyított, és problémákat okozhat a fürtök skálázásával vagy frissítésével kapcsolatban.

ScaleSetPriority

Felsorolás

A virtuálisgép-méretezési csoport prioritása.

Érték	Description
Spot	A rendszer kihasználatlan prioritású virtuális gépeket használ. A kihasználatlan csomópontokhoz nincs SLA. További információt az AKS- helyszínen talál.
Regular	A rendszer normál virtuális gépeket használ.

SysctlConfig

Tárgy

A Linux-ügynökcsomópontok Sysctl-beállításai.

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

systemData

Tárgy

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

UndrainableNodeBehavior

Felsorolás

Meghatározza a frissítés során nem módosítható csomópontok viselkedését. A nem módosítható csomópontok leggyakoribb oka a podkimaradási költségvetések (PDB-k), de más problémák, például a podleállási türelmi időszak túllépik a csomópontonként fennmaradó időtúllépést, vagy a pod továbbra is futó állapotban van, a nem módosítható csomópontokat is okozhatja.

Érték

Description

Cordon

Az AKS a frissítés során kordonozza a letiltott csomópontokat, és lecseréli őket túlfeszültség-csomópontokra. A letiltott csomópontokat a rendszer kordonozza, és túlfeszültség-csomópontok váltják fel. A blokkolt csomópontok címkéje "kubernetes.azure.com/upgrade-status:Quarantined". A rendszer minden blokkolt csomóponthoz megtart egy túlfeszültség-csomópontot. A rendszer minden tőle telhetőt megtesz az összes többi túlfeszültség-csomópont törlésére. Ha elegendő túlfeszültség-csomópont van a blokkolt csomópontok cseréjéhez, akkor a frissítési művelet és a felügyelt fürt sikertelen állapotban lesz. Ellenkező esetben a frissítési művelet és a felügyelt fürt megszakított állapotban lesz.

Schedule

Az AKS megjelöli a letiltott csomópontokat, de a letiltott csomópontok nem frissülnek. A rendszer minden erőfeszítést megtesz az összes túlfeszültség-csomópont törlésére. A frissítési művelet és a felügyelt fürt sikertelen állapotban lesz, ha vannak blokkolt csomópontok.

VirtualMachineNodes

Tárgy

Az azonos virtuálisgép-méretű csomópontok csoportjának aktuális állapota.

Name	Típus	Description
count	integer (int32)	Csomópontok száma.
size	string	A csomópontcsoport üzemeltetéséhez használt ügynökök virtuálisgép-mérete.

VirtualMachinesProfile

Tárgy

A VirtualMachines-ügynökkészlet specifikációi.

Name	Típus	Description
scale	ScaleProfile	A VirtualMachines-ügynökkészletek méretezésének specifikációi.

WorkloadRuntime

Felsorolás

Meghatározza, hogy a csomópont milyen típusú számítási feladatot futtathat.

Érték	Description
OCIContainer	A csomópontok a Kubelet használatával futtatják a standard OCI-tároló számítási feladatait.
WasmWasi	A csomópontok a Krustlet használatával futtatják a WASM-számítási feladatokat a WASI-szolgáltató (előzetes verzió) használatával.
KataVmIsolation	A csomópontok (Kata + Cloud Hypervisor + Hyper-V) segítségével engedélyezhetik a Nested VM-alapú podokat. A Hyper-V használata miatt az AKS node OS maga a Hyper-V beágyazott VM-je (a gyökér operációs rendszere). Így csak olyan virtuálisgép-sorozatokkal használható, amelyek támogatják a beágyazott virtualizálást, például a Dv3 sorozatot.