Agent Pools - Create Or Update
Hiermee maakt of werkt u een agentgroep in het opgegeven beheerde cluster bij.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}?api-version=2026-02-01URI-parameters
| Name | In | Vereist | Type | Description |
|---|---|---|---|---|
|
agent
|
path | True |
string minLength: 1maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$ |
De naam van de agentgroep. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
De naam van de resourcegroep. De naam is hoofdletterongevoelig. |
|
resource
|
path | True |
string minLength: 1maxLength: 63 pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$ |
De naam van de beheerde clusterresource. |
|
subscription
|
path | True |
string (uuid) |
De ID van het doelabonnement. De waarde moet een UUID zijn. |
|
api-version
|
query | True |
string minLength: 1 |
De API-versie die voor deze bewerking moet worden gebruikt. |
Aanvraagkoptekst
| Name | Vereist | Type | Description |
|---|---|---|---|
| if-match |
string |
De aanvraag mag alleen worden voortgezet als een entiteit overeenkomt met deze tekenreeks. |
|
| if-none-match |
string |
De aanvraag moet alleen worden voortgezet als er geen entiteit overeenkomt met deze tekenreeks. |
Aanvraagbody
| Name | Type | Description |
|---|---|---|
| properties.availabilityZones |
string[] |
De lijst met beschikbaarheidszones die moeten worden gebruikt voor knooppunten. Dit kan alleen worden opgegeven als de eigenschap AgentPoolType virtualMachineScaleSets is. |
| properties.capacityReservationGroupID |
string (arm-id) |
De volledig gekwalificeerde resource ID van de Capacity Reservation Group om virtual machines te leveren vanuit een gereserveerde groep Virtual Machines. Dit is van de vorm: '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft. Compute/capacityreservationgroups/{capacityReservationGroupName}' Klanten gebruiken dit om een agentpool aan te maken met een gespecificeerde CRG. Voor meer informatie, zie Capaciteitsreservering |
| properties.count |
integer (int32) |
Aantal agents (VM's) voor het hosten van Docker-containers. Toegestane waarden moeten zich in het bereik van 0 tot 1000 (inclusief) bevinden voor gebruikersgroepen en in het bereik van 1 tot 1000 (inclusief) voor systeemgroepen. De standaardwaarde is 1. |
| properties.creationData |
CreationData moet worden gebruikt om de bronmomentopname-id op te geven als de knooppuntgroep wordt gemaakt/bijgewerkt met behulp van een momentopname. |
|
| properties.enableAutoScaling |
boolean |
Of automatische schaalaanpassing moet worden ingeschakeld |
| properties.enableEncryptionAtHost |
boolean |
Hiermee wordt aangegeven of hostgebaseerde besturingssysteem- en gegevensstationsversleuteling moeten worden ingeschakeld. Dit wordt alleen ondersteund op bepaalde VM-groottes en in bepaalde Azure-regio's. Zie voor meer informatie: https://docs.microsoft.com/azure/aks/enable-host-encryption |
| properties.enableFIPS |
boolean |
Of u een besturingssysteem met FIPS wilt gebruiken. Zie Een knooppuntgroep met FIPS-functionaliteit toevoegen voor meer informatie. |
| properties.enableNodePublicIP |
boolean |
Of aan elk knooppunt een eigen openbaar IP-adres wordt toegewezen. Voor sommige scenario's moeten knooppunten in een knooppuntgroep mogelijk hun eigen toegewezen openbare IP-adressen ontvangen. Een veelvoorkomend scenario is voor gamingworkloads, waarbij een console een directe verbinding moet maken met een virtuele cloudmachine om hops te minimaliseren. Zie het toewijzen van een openbaar IP-adres per knooppunt voor meer informatie. De standaardwaarde is onwaar. |
| properties.enableUltraSSD |
boolean |
Of UltraSSD moet worden ingeschakeld |
| properties.gatewayProfile |
Profiel dat specifiek is voor een beheerde agentgroep in de gatewaymodus. Dit veld kan niet worden ingesteld als de agentgroepmodus geen gateway is. |
|
| properties.gpuInstanceProfile |
GPUInstanceProfile dat moet worden gebruikt om het GPU MIG-exemplaarprofiel op te geven voor de ondersteunde GPU VM-SKU. |
|
| properties.gpuProfile |
GPU-instellingen voor de agentgroep. |
|
| properties.hostGroupID |
string (arm-id) |
De volledig gekwalificeerde resource-id van de toegewezen hostgroep waaruit virtuele machines kunnen worden ingericht, die alleen worden gebruikt in het scenario voor het maken en niet mogen worden gewijzigd nadat deze is ingesteld. Dit is de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Compute/hostGroups/{hostGroupName}. Voor meer informatie, zie Azure dedicated hosts. |
| properties.kubeletConfig |
De Kubelet-configuratie op de agentpoolknooppunten. |
|
| properties.kubeletDiskType |
Bepaalt de plaatsing van legeDir-volumes, hoofdmap van containerruntimegegevens en tijdelijke Kubelet-opslag. |
|
| properties.linuxOSConfig |
De besturingssysteemconfiguratie van Linux-agentknooppunten. |
|
| properties.localDNSProfile |
Configureert de lokale DNS per knooppunt, met VnetDNS- en KubeDNS-overschrijvingen. LocalDNS helpt de prestaties en betrouwbaarheid van DNS-resolutie in een AKS-cluster te verbeteren. Voor meer details zie aka.ms/aks/localdns. |
|
| properties.maxCount |
integer (int32) |
Het maximum aantal knooppunten voor automatisch schalen |
| properties.maxPods |
integer (int32) |
Het maximum aantal pods dat op een knooppunt kan worden uitgevoerd. |
| properties.messageOfTheDay |
string |
Bericht van de dag voor Linux-knooppunten, met base64 gecodeerd. Een met base64 gecodeerde tekenreeks die na het decoderen naar /etc/motd wordt geschreven. Hiermee kunt u het bericht van de dag aanpassen voor Linux-knooppunten. Het mag niet worden gespecificeerd voor Windows-nodes. Het moet een statische tekenreeks zijn (dat wil bijvoorbeeld onbewerkt worden afgedrukt en niet worden uitgevoerd als een script). |
| properties.minCount |
integer (int32) |
Het minimale aantal knooppunten voor automatisch schalen |
| properties.mode |
De modus van een agentpool. Een cluster moet te allen tijde ten minste één agentgroep van het systeem hebben. Zie voor meer informatie over beperkingen en aanbevolen procedures voor agentgroepen: https://docs.microsoft.com/azure/aks/use-system-pools |
|
| properties.networkProfile |
Netwerkinstellingen van een agentgroep. |
|
| properties.nodeLabels |
object |
De knooppuntlabels die moeten worden bewaard op alle knooppunten in de agentgroep. |
| properties.nodePublicIPPrefixID |
string (arm-id) |
De id van het openbare IP-voorvoegsel waaruit VM-knooppunten IP-adressen moeten gebruiken. Dit is de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/publicIPPrefixes/{publicIPPrefixName} |
| properties.nodeTaints |
string[] |
De taints die zijn toegevoegd aan nieuwe knooppunten tijdens het maken en schalen van knooppuntgroepen. Bijvoorbeeld key=value:NoSchedule. |
| properties.orchestratorVersion |
string |
De versie van Kubernetes die door de gebruiker is opgegeven. Zowel patchversie <major.minor.patch> (bijvoorbeeld 1.20.13) als <major.minor> (bijvoorbeeld 1.20) worden ondersteund. Wanneer <major.minor> is opgegeven, wordt automatisch de meest recente ondersteunde GA-patchversie gekozen. Het cluster bijwerken met dezelfde <major.minor> nadat het is gemaakt (bijvoorbeeld 1.14.x -> 1.14) activeert geen upgrade, zelfs niet als er een nieuwere patchversie beschikbaar is. Als best practice moet u alle knooppuntgroepen in een AKS-cluster upgraden naar dezelfde Kubernetes-versie. De versie van de knooppuntgroep moet dezelfde primaire versie hebben als het besturingsvlak. De secundaire versie van de knooppuntgroep moet zich in twee secundaire versies van de versie van het besturingsvlak bevindt. De versie van de knooppuntgroep mag niet groter zijn dan de versie van het besturingsvlak. Zie Een knooppuntgroep upgraden voor meer informatie. |
| properties.osDiskSizeGB |
integer (int32) minimum: 0maximum: 2048 |
Grootte van besturingssysteemschijf in GB die moet worden gebruikt om de schijfgrootte op te geven voor elke computer in de hoofd-/agentgroep. Als u 0 opgeeft, wordt de standaard osDisk-grootte toegepast op basis van de opgegeven vmSize. |
| properties.osDiskType |
Het type besturingssysteemschijf dat moet worden gebruikt voor machines in de agentgroep. De standaardwaarde is 'kortstondig' als de VIRTUELE machine deze ondersteunt en een cacheschijf heeft die groter is dan de aangevraagde OSDiskSizeGB. Anders wordt standaard 'Beheerd' gebruikt. Kan niet worden gewijzigd na het maken. Zie Kortstondig besturingssysteem voor meer informatie. |
|
| properties.osSKU |
Hiermee geeft u de SKU van het besturingssysteem op die wordt gebruikt door de agentgroep. De standaardwaarde is Ubuntu als OSType Linux is. De standaard is Windows2019 wanneer Kubernetes <= 1.24 of Windows2022 wanneer Kubernetes >= 1.25 als OSType Windows is. |
|
| properties.osType |
Het type besturingssysteem. De standaardwaarde is Linux. |
|
| properties.podIPAllocationMode |
Pod IP-toewijzingsmodus. De IP-toewijzingsmodus voor pods in de agentgroep. Moet worden gebruikt met podSubnetId. De standaardwaarde is DynamicIndividual. |
|
| properties.podSubnetID |
string (arm-id) |
De id van het subnet waaraan pods worden samengevoegd wanneer deze worden gestart. Als u dit weglaat, worden pod-IP's statisch toegewezen aan het knooppuntsubnet (zie vnetSubnetID voor meer informatie). Dit is de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} |
| properties.powerState |
Of de agentgroep wordt uitgevoerd of gestopt. Wanneer een agentgroep voor het eerst wordt gemaakt, wordt deze in eerste instantie uitgevoerd. De agentgroep kan worden gestopt door dit veld in te stellen op Gestopt. Een gestopte agentgroep stopt alle VM's en brengt geen factureringskosten met zich mee. Een agentgroep kan alleen worden gestopt als deze actief is en de inrichtingsstatus is geslaagd |
|
| properties.proximityPlacementGroupID |
string (arm-id) |
De id voor nabijheidsplaatsingsgroep. |
| properties.scaleDownMode |
De omlaagschaalmodus die moet worden gebruikt bij het schalen van de agentgroep. Dit heeft ook invloed op het gedrag van automatische schaalaanpassing van clusters. Als dit niet is opgegeven, wordt deze standaard verwijderd. |
|
| properties.scaleSetEvictionPolicy |
Het uitzettingsbeleid voor de schaal van de virtuele machine. Het uitzettingsbeleid specificeert wat er to do is met de VM wanneer deze wordt ontruimd. De standaardinstelling is Verwijderen. Voor meer informatie over uitzettingen, zie spot VMs |
|
| properties.scaleSetPriority |
De prioriteit van de virtuele-machineschaalset. |
|
| properties.securityProfile |
De beveiligingsinstellingen van een agentgroep. |
|
| properties.spotMaxPrice |
number (float) |
De maximale prijs (in Amerikaanse dollars) die u bereid bent te betalen voor spot-instanties. Mogelijke waarden zijn een decimale waarde die groter is dan nul of -1 die aangeeft dat de standaardprijs moet worden up-to op aanvraag. Mogelijke waarden zijn een decimale waarde die groter is dan nul of -1 die de bereidheid aangeeft om een on-demand prijs te betalen. Zie prijzen voor spot-VM's voor meer informatie over spotprijzen |
| properties.status |
Bevat alleen-lezen informatie over de agentgroep. |
|
| properties.tags |
object |
De tags die moeten worden bewaard in de virtuele-machineschaalset van de agentgroep. |
| properties.type |
Het type agentgroep. |
|
| properties.upgradeSettings |
Instellingen voor het upgraden van de agentpool |
|
| properties.virtualMachineNodesStatus |
De status van knooppunten in een VirtualMachines-agentgroep. |
|
| properties.virtualMachinesProfile |
Specificaties voor VirtualMachines-agentpool. |
|
| properties.vmSize |
string |
De grootte van de VM's van de agentgroep. Beschikbaarheid van VM-grootte verschilt per regio. Als een knooppunt onvoldoende rekenresources (geheugen, cpu, enzovoort) bevat, kunnen pods mogelijk niet correct worden uitgevoerd. Zie voor meer informatie over beperkte VM-grootten: https://docs.microsoft.com/azure/aks/quotas-skus-regions |
| properties.vnetSubnetID |
string (arm-id) |
De id van het subnet waaraan agentpoolknooppunten en eventueel pods worden toegevoegd bij het opstarten. Als dit niet is opgegeven, worden er een VNET en subnet gegenereerd en gebruikt. Als er geen podSubnetID is opgegeven, is dit van toepassing op knooppunten en pods, anders geldt dit voor alleen knooppunten. Dit is de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} |
| properties.windowsProfile |
Het specifieke profiel van de Windows-agentpool. |
|
| properties.workloadRuntime |
Bepaalt het type workload dat een knooppunt kan uitvoeren. |
Antwoorden
| Name | Type | Description |
|---|---|---|
| 200 OK |
De updatebewerking van de resource 'AgentPool' is geslaagd |
|
| 201 Created |
Resource 'AgentPool' create bewerking geslaagd Kopteksten
|
|
| Other Status Codes |
Een onverwachte foutreactie. |
Beveiliging
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
| Name | Description |
|---|---|
| user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
Create Agent Pool using an agent pool snapshot
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"creationData": {
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
},
"currentOrchestratorVersion": "1.19.6",
"enableFIPS": true,
"maxPods": 110,
"orchestratorVersion": "1.19.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"creationData": {
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
},
"currentOrchestratorVersion": "1.19.6",
"enableFIPS": true,
"maxPods": 110,
"orchestratorVersion": "1.19.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}Create Agent Pool with Capacity Reservation Group
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}Create Agent Pool with Dedicated Host Group
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1",
"maxPods": 110,
"orchestratorVersion": "1.19.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1",
"maxPods": 110,
"orchestratorVersion": "1.19.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}Create Agent Pool with EncryptionAtHost enabled
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.13",
"enableEncryptionAtHost": true,
"maxPods": 110,
"orchestratorVersion": "1.17.13",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.13",
"enableEncryptionAtHost": true,
"maxPods": 110,
"orchestratorVersion": "1.17.13",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}Create Agent Pool with Ephemeral OS Disk
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osDiskSizeGB": 64,
"osDiskType": "Ephemeral",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"kubeletDiskType": "OS",
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osDiskSizeGB": 64,
"osDiskType": "Ephemeral",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}Create Agent Pool with FIPS enabled OS
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.19.6",
"enableFIPS": true,
"maxPods": 110,
"orchestratorVersion": "1.19.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.19.6",
"enableFIPS": true,
"maxPods": 110,
"orchestratorVersion": "1.19.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}Create Agent Pool with GPUMIG
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"gpuInstanceProfile": "MIG2g",
"kubeletConfig": {
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.core.somaxconn"
],
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"cpuManagerPolicy": "static",
"failSwapOn": false,
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"topologyManagerPolicy": "best-effort"
},
"linuxOSConfig": {
"swapFileSizeMB": 1500,
"sysctls": {
"kernelThreadsMax": 99999,
"netCoreWmemDefault": 12345,
"netIpv4IpLocalPortRange": "20000 60000",
"netIpv4TcpTwReuse": true
},
"transparentHugePageDefrag": "madvise",
"transparentHugePageEnabled": "always"
},
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_ND96asr_v4"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"gpuInstanceProfile": "MIG2g",
"kubeletConfig": {
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.core.somaxconn"
],
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"cpuManagerPolicy": "static",
"failSwapOn": false,
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"podMaxPids": 100,
"topologyManagerPolicy": "best-effort"
},
"linuxOSConfig": {
"swapFileSizeMB": 1500,
"sysctls": {
"kernelThreadsMax": 99999,
"netCoreWmemDefault": 65536,
"netIpv4IpLocalPortRange": "20000 60000",
"netIpv4TcpTwReuse": true
},
"transparentHugePageDefrag": "madvise",
"transparentHugePageEnabled": "always"
},
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_ND96asr_v4"
}
}Create Agent Pool with Krustlet and the WASI runtime
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"maxPods": 110,
"mode": "User",
"orchestratorVersion": "1.17.8",
"osDiskSizeGB": 64,
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2",
"workloadRuntime": "WasmWasi"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"maxPods": 110,
"mode": "User",
"orchestratorVersion": "1.17.8",
"osDiskSizeGB": 64,
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2",
"workloadRuntime": "WasmWasi"
}
}Create Agent Pool with KubeletConfig and LinuxOSConfig
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"kubeletConfig": {
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.core.somaxconn"
],
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"cpuManagerPolicy": "static",
"failSwapOn": false,
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"topologyManagerPolicy": "best-effort"
},
"linuxOSConfig": {
"swapFileSizeMB": 1500,
"sysctls": {
"kernelThreadsMax": 99999,
"netCoreWmemDefault": 12345,
"netIpv4IpLocalPortRange": "20000 60000",
"netIpv4TcpTwReuse": true
},
"transparentHugePageDefrag": "madvise",
"transparentHugePageEnabled": "always"
},
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"kubeletConfig": {
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.core.somaxconn"
],
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"cpuManagerPolicy": "static",
"failSwapOn": false,
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"podMaxPids": 100,
"topologyManagerPolicy": "best-effort"
},
"linuxOSConfig": {
"swapFileSizeMB": 1500,
"sysctls": {
"kernelThreadsMax": 99999,
"netCoreWmemDefault": 65536,
"netIpv4IpLocalPortRange": "20000 60000",
"netIpv4TcpTwReuse": true
},
"transparentHugePageDefrag": "madvise",
"transparentHugePageEnabled": "always"
},
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}Create Agent Pool with Message of the Day
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"maxPods": 110,
"messageOfTheDay": "Zm9vCg==",
"mode": "User",
"orchestratorVersion": "1.17.8",
"osDiskSizeGB": 64,
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"maxPods": 110,
"messageOfTheDay": "Zm9vCg==",
"mode": "User",
"orchestratorVersion": "1.17.8",
"osDiskSizeGB": 64,
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}Create Agent Pool with OSSKU
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"kubeletConfig": {
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.core.somaxconn"
],
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"cpuManagerPolicy": "static",
"failSwapOn": false,
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"topologyManagerPolicy": "best-effort"
},
"linuxOSConfig": {
"swapFileSizeMB": 1500,
"sysctls": {
"kernelThreadsMax": 99999,
"netCoreWmemDefault": 12345,
"netIpv4IpLocalPortRange": "20000 60000",
"netIpv4TcpTwReuse": true
},
"transparentHugePageDefrag": "madvise",
"transparentHugePageEnabled": "always"
},
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osSKU": "AzureLinux",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.8",
"kubeletConfig": {
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.core.somaxconn"
],
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"cpuManagerPolicy": "static",
"failSwapOn": false,
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"podMaxPids": 100,
"topologyManagerPolicy": "best-effort"
},
"linuxOSConfig": {
"swapFileSizeMB": 1500,
"sysctls": {
"kernelThreadsMax": 99999,
"netCoreWmemDefault": 65536,
"netIpv4IpLocalPortRange": "20000 60000",
"netIpv4TcpTwReuse": true
},
"transparentHugePageDefrag": "madvise",
"transparentHugePageEnabled": "always"
},
"maxPods": 110,
"orchestratorVersion": "1.17.8",
"osSKU": "AzureLinux",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}Create Agent Pool with PPG
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1",
"vmSize": "Standard_DS2_v2"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1",
"vmSize": "Standard_DS2_v2"
}
}Create Agent Pool with UltraSSD enabled
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.13",
"enableUltraSSD": true,
"maxPods": 110,
"orchestratorVersion": "1.17.13",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.17.13",
"enableUltraSSD": true,
"maxPods": 110,
"orchestratorVersion": "1.17.13",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
}Create Agent Pool with VirtualMachines pool type
Voorbeeldaanvraag
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"
}
]
}
}
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"type": "VirtualMachines",
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"nodeImageVersion": "AKSUbuntu-1804gen2containerd-2021.09.11",
"nodeLabels": {
"key1": "val1"
},
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"tags": {
"name1": "val1"
},
"virtualMachineNodesStatus": [
{
"count": 3,
"size": "Standard_D2_v2"
},
{
"count": 2,
"size": "Standard_D2_v3"
}
],
"virtualMachinesProfile": {
"scale": {
"manual": [
{
"count": 3,
"size": "Standard_D2_v2"
},
{
"count": 2,
"size": "Standard_D2_v3"
}
]
}
}
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"type": "VirtualMachines",
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"nodeImageVersion": "AKSUbuntu-1804gen2containerd-2021.09.11",
"nodeLabels": {
"key1": "val1"
},
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"tags": {
"name1": "val1"
},
"virtualMachineNodesStatus": [
{
"count": 3,
"size": "Standard_D2_v2"
},
{
"count": 2,
"size": "Standard_D2_v3"
}
],
"virtualMachinesProfile": {
"scale": {
"manual": [
{
"count": 3,
"size": "Standard_D2_v2"
},
{
"count": 2,
"size": "Standard_D2_v3"
}
]
}
}
}
}Create Agent Pool with Windows OSSKU
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "wnp2",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.23.3",
"maxPods": 110,
"orchestratorVersion": "1.23.3",
"osSKU": "Windows2022",
"osType": "Windows",
"provisioningState": "Succeeded",
"vmSize": "Standard_D4s_v3"
}
}{
"name": "wnp2",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.23.3",
"maxPods": 110,
"orchestratorVersion": "1.23.3",
"osSKU": "Windows2022",
"osType": "Windows",
"provisioningState": "Creating",
"vmSize": "Standard_D4s_v3"
}
}Create Spot Agent Pool
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"nodeLabels": {
"key1": "val1"
},
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"scaleSetEvictionPolicy": "Delete",
"scaleSetPriority": "Spot",
"spotMaxPrice": -1,
"tags": {
"name1": "val1"
},
"vmSize": "Standard_DS1_v2"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"nodeLabels": {
"key1": "val1"
},
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"scaleSetEvictionPolicy": "Delete",
"scaleSetPriority": "Spot",
"spotMaxPrice": -1,
"tags": {
"name1": "val1"
},
"vmSize": "Standard_DS1_v2"
}
}Create Windows Agent Pool with disabling OutboundNAT
Voorbeeldaanvraag
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
}
}
}
Voorbeeldrespons
{
"name": "wnp2",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.23.8",
"maxPods": 110,
"orchestratorVersion": "1.23.8",
"osSKU": "Windows2022",
"osType": "Windows",
"provisioningState": "Succeeded",
"vmSize": "Standard_D4s_v3",
"windowsProfile": {
"disableOutboundNat": true
}
}
}{
"name": "wnp2",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.23.8",
"maxPods": 110,
"orchestratorVersion": "1.23.8",
"osSKU": "Windows2022",
"osType": "Windows",
"provisioningState": "Creating",
"vmSize": "Standard_D4s_v3",
"windowsProfile": {
"disableOutboundNat": true
}
}
}Create/Update Agent Pool
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"mode": "User",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"nodeLabels": {
"key1": "val1"
},
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"scaleSetEvictionPolicy": "Delete",
"scaleSetPriority": "Spot",
"tags": {
"name1": "val1"
},
"vmSize": "Standard_DS1_v2"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"maxPods": 110,
"mode": "User",
"nodeLabels": {
"key1": "val1"
},
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"scaleSetEvictionPolicy": "Delete",
"scaleSetPriority": "Spot",
"tags": {
"name1": "val1"
},
"vmSize": "Standard_DS1_v2"
}
}Start Agent Pool
Voorbeeldaanvraag
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"
}
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 50,
"enableAutoScaling": true,
"maxCount": 55,
"minCount": 3,
"powerState": {
"code": "Running"
},
"provisioningState": "Starting"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 50,
"enableAutoScaling": true,
"maxCount": 55,
"minCount": 3,
"powerState": {
"code": "Running"
},
"provisioningState": "Starting"
}
}Stop Agent Pool
Voorbeeldaanvraag
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"
}
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 0,
"enableAutoScaling": false,
"powerState": {
"code": "Stopped"
},
"provisioningState": "Stopping"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 0,
"enableAutoScaling": false,
"powerState": {
"code": "Stopped"
},
"provisioningState": "Stopping"
}
}Update Agent Pool
Voorbeeldaanvraag
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"
}
}
Voorbeeldrespons
{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableAutoScaling": true,
"maxCount": 2,
"maxPods": 110,
"minCount": 2,
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"scaleSetEvictionPolicy": "Delete",
"scaleSetPriority": "Spot",
"vmSize": "Standard_DS1_v2"
}
}{
"name": "agentpool1",
"type": "Microsoft.ContainerService/managedClusters/agentPools",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
"properties": {
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableAutoScaling": true,
"maxCount": 2,
"maxPods": 110,
"minCount": 2,
"nodeTaints": [
"Key1=Value1:NoSchedule"
],
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Updating",
"scaleSetEvictionPolicy": "Delete",
"scaleSetPriority": "Spot",
"vmSize": "Standard_DS1_v2"
}
}Definities
| Name | Description |
|---|---|
|
Agent |
Agentgroep. |
|
Agent |
Profiel van de beheerde clustergatewayagentgroep. |
|
Agent |
De modus van een agentpool. Een cluster moet te allen tijde ten minste één agentgroep van het systeem hebben. Zie voor meer informatie over beperkingen en aanbevolen procedures voor agentgroepen: https://docs.microsoft.com/azure/aks/use-system-pools |
|
Agent |
Netwerkinstellingen van een agentgroep. |
|
Agent |
De beveiligingsinstellingen van een agentgroep. |
|
Agent |
SSH-access-methode van een agentpool. |
|
Agent |
Bevat alleen-lezen informatie over de agentgroep. |
|
Agent |
Het type agentgroep. |
|
Agent |
Instellingen voor het upgraden van een agentpool |
|
Agent |
Het specifieke profiel van de Windows-agentpool. |
| Code |
Hiermee wordt aangegeven of het cluster wordt uitgevoerd of gestopt |
|
created |
Het type identiteit waarmee de resource is gemaakt. |
|
Creation |
Gegevens die worden gebruikt bij het maken van een doelresource op basis van een bronresource. |
|
Error |
Aanvullende informatie over de resourcebeheerfout. |
|
Error |
De foutdetails. |
|
Error |
Foutreactie |
| GPUDriver |
Of u GPU-stuurprogramma's wilt installeren. Als deze niet is opgegeven, is de standaardwaarde Installeren. |
|
GPUInstance |
GPUInstanceProfile dat moet worden gebruikt om het GPU MIG-exemplaarprofiel op te geven voor de ondersteunde GPU VM-SKU. |
| GPUProfile |
GPU-instellingen voor de agentgroep. |
| IPTag |
Bevat de IPTag die aan het object is gekoppeld. |
|
Kubelet |
Kubelet-configuraties van agentknooppunten. Zie aangepaste AKS-knooppuntconfiguratie voor meer informatie. |
|
Kubelet |
Bepaalt de plaatsing van legeDir-volumes, hoofdmap van containerruntimegegevens en tijdelijke Kubelet-opslag. |
|
Linux |
Besturingssysteemconfiguraties van Linux-agentknooppunten. Zie aangepaste AKS-knooppuntconfiguratie voor meer informatie. |
|
Local |
Doelserver voor DNS-query's die moeten worden doorgestuurd vanuit localDNS. |
|
Local |
Beleid doorsturen voor het selecteren van upstream DNS-server. Zie forward plugin voor meer informatie. |
|
Local |
Wijze van inschakelen voor localDNS. |
|
Local |
Overschrijvingen voor het localDNS-profiel. |
|
Local |
Configureert de lokale DNS per knooppunt, met VnetDNS- en KubeDNS-overschrijvingen. LocalDNS helpt de prestaties en betrouwbaarheid van DNS-resolutie in een AKS-cluster te verbeteren. Voor meer details zie aka.ms/aks/localdns. |
|
Local |
Dwing TCP af of geef de voorkeur aan het UDP-protocol voor verbindingen van localDNS naar upstream DNS-server. |
|
Local |
Logboekniveau voor DNS-query's in localDNS. |
|
Local |
Beleid voor het leveren van verouderde gegevens. Zie cache-plug-in voor meer informatie. |
|
Local |
Door het systeem gegenereerde status van localDNS. |
|
Manual |
Specificaties op het aantal machines. |
|
OSDisk |
Het type besturingssysteemschijf dat moet worden gebruikt voor machines in de agentgroep. De standaardwaarde is 'kortstondig' als de VIRTUELE machine deze ondersteunt en een cacheschijf heeft die groter is dan de aangevraagde OSDiskSizeGB. Anders wordt standaard 'Beheerd' gebruikt. Kan niet worden gewijzigd na het maken. Zie Kortstondig besturingssysteem voor meer informatie. |
| OSSKU |
Hiermee geeft u de SKU van het besturingssysteem op die wordt gebruikt door de agentgroep. De standaardwaarde is Ubuntu als OSType Linux is. De standaard is Windows2019 wanneer Kubernetes <= 1.24 of Windows2022 wanneer Kubernetes >= 1.25 als OSType Windows is. |
| OSType |
Het type besturingssysteem. De standaardwaarde is Linux. |
|
Pod |
Pod IP-toewijzingsmodus. De IP-toewijzingsmodus voor pods in de agentgroep. Moet worden gebruikt met podSubnetId. De standaardwaarde is DynamicIndividual. |
|
Port |
Het poortbereik. |
|
Power |
Beschrijft de energiestatus van het cluster |
| Protocol |
Het netwerkprotocol van de poort. |
|
Scale |
Beschrijft hoe VM's worden toegevoegd aan of verwijderd uit agentpools. Zie factureringsstatussen. |
|
Scale |
Specificaties voor het schalen van een VirtualMachines-agentpool. |
|
Scale |
Het uitzettingsbeleid voor de schaal van de virtuele machine. Het uitzettingsbeleid specificeert wat er to do is met de VM wanneer deze wordt ontruimd. De standaardinstelling is Verwijderen. Voor meer informatie over uitzettingen, zie spot VMs |
|
Scale |
De prioriteit van de virtuele-machineschaalset. |
|
Sysctl |
Sysctl-instellingen voor Linux-agentknooppunten. |
|
system |
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource. |
|
Undrainable |
Definieert het gedrag voor oningestoorde knooppunten tijdens de upgrade. De meest voorkomende oorzaak van oningestoorde knooppunten is PDU's (Pod Disruption Budgets), maar andere problemen, zoals de respijtperiode voor podbeëindiging, overschrijden de resterende time-out voor het leegmaken van knooppunten of pods hebben nog steeds een actieve status, maar kunnen ook oningestoorde knooppunten veroorzaken. |
|
Virtual |
Huidige status van een groep knooppunten met dezelfde VM-grootte. |
|
Virtual |
Specificaties voor VirtualMachines-agentpool. |
|
Workload |
Bepaalt het type workload dat een knooppunt kan uitvoeren. |
AgentPool
Agentgroep.
| Name | Type | Default value | Description |
|---|---|---|---|
| id |
string (arm-id) |
Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}" |
|
| name |
string |
De naam van de resource |
|
| properties.availabilityZones |
string[] |
De lijst met beschikbaarheidszones die moeten worden gebruikt voor knooppunten. Dit kan alleen worden opgegeven als de eigenschap AgentPoolType virtualMachineScaleSets is. |
|
| properties.capacityReservationGroupID |
string (arm-id) |
De volledig gekwalificeerde resource ID van de Capacity Reservation Group om virtual machines te leveren vanuit een gereserveerde groep Virtual Machines. Dit is van de vorm: '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft. Compute/capacityreservationgroups/{capacityReservationGroupName}' Klanten gebruiken dit om een agentpool aan te maken met een gespecificeerde CRG. Voor meer informatie, zie Capaciteitsreservering |
|
| properties.count |
integer (int32) |
Aantal agents (VM's) voor het hosten van Docker-containers. Toegestane waarden moeten zich in het bereik van 0 tot 1000 (inclusief) bevinden voor gebruikersgroepen en in het bereik van 1 tot 1000 (inclusief) voor systeemgroepen. De standaardwaarde is 1. |
|
| properties.creationData |
CreationData moet worden gebruikt om de bronmomentopname-id op te geven als de knooppuntgroep wordt gemaakt/bijgewerkt met behulp van een momentopname. |
||
| properties.currentOrchestratorVersion |
string |
De versie van Kubernetes die de agentgroep uitvoert. Als orchestratorVersion een volledig opgegeven versie is <major.minor.patch>, is dit veld precies gelijk aan het veld. Als orchestratorVersion is <major.minor>, bevat dit veld de volledige <major.minor.patch> versie die wordt gebruikt. |
|
| properties.eTag |
string |
Unieke alleen-lezen tekenreeks die wordt gebruikt voor het implementeren van optimistische gelijktijdigheid. De eTag-waarde wordt gewijzigd wanneer de resource wordt bijgewerkt. Geef een if-match of if-none-match header op met de eTag-waarde voor een volgende aanvraag om optimistische gelijktijdigheid mogelijk te maken volgens de normale eTag-conventie. |
|
| properties.enableAutoScaling |
boolean |
Of automatische schaalaanpassing moet worden ingeschakeld |
|
| properties.enableEncryptionAtHost |
boolean |
Hiermee wordt aangegeven of hostgebaseerde besturingssysteem- en gegevensstationsversleuteling moeten worden ingeschakeld. Dit wordt alleen ondersteund op bepaalde VM-groottes en in bepaalde Azure-regio's. Zie voor meer informatie: https://docs.microsoft.com/azure/aks/enable-host-encryption |
|
| properties.enableFIPS |
boolean |
Of u een besturingssysteem met FIPS wilt gebruiken. Zie Een knooppuntgroep met FIPS-functionaliteit toevoegen voor meer informatie. |
|
| properties.enableNodePublicIP |
boolean |
Of aan elk knooppunt een eigen openbaar IP-adres wordt toegewezen. Voor sommige scenario's moeten knooppunten in een knooppuntgroep mogelijk hun eigen toegewezen openbare IP-adressen ontvangen. Een veelvoorkomend scenario is voor gamingworkloads, waarbij een console een directe verbinding moet maken met een virtuele cloudmachine om hops te minimaliseren. Zie het toewijzen van een openbaar IP-adres per knooppunt voor meer informatie. De standaardwaarde is onwaar. |
|
| properties.enableUltraSSD |
boolean |
Of UltraSSD moet worden ingeschakeld |
|
| properties.gatewayProfile |
Profiel dat specifiek is voor een beheerde agentgroep in de gatewaymodus. Dit veld kan niet worden ingesteld als de agentgroepmodus geen gateway is. |
||
| properties.gpuInstanceProfile |
GPUInstanceProfile dat moet worden gebruikt om het GPU MIG-exemplaarprofiel op te geven voor de ondersteunde GPU VM-SKU. |
||
| properties.gpuProfile |
GPU-instellingen voor de agentgroep. |
||
| properties.hostGroupID |
string (arm-id) |
De volledig gekwalificeerde resource-id van de toegewezen hostgroep waaruit virtuele machines kunnen worden ingericht, die alleen worden gebruikt in het scenario voor het maken en niet mogen worden gewijzigd nadat deze is ingesteld. Dit is de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Compute/hostGroups/{hostGroupName}. Voor meer informatie, zie Azure dedicated hosts. |
|
| properties.kubeletConfig |
De Kubelet-configuratie op de agentpoolknooppunten. |
||
| properties.kubeletDiskType |
Bepaalt de plaatsing van legeDir-volumes, hoofdmap van containerruntimegegevens en tijdelijke Kubelet-opslag. |
||
| properties.linuxOSConfig |
De besturingssysteemconfiguratie van Linux-agentknooppunten. |
||
| properties.localDNSProfile |
Configureert de lokale DNS per knooppunt, met VnetDNS- en KubeDNS-overschrijvingen. LocalDNS helpt de prestaties en betrouwbaarheid van DNS-resolutie in een AKS-cluster te verbeteren. Voor meer details zie aka.ms/aks/localdns. |
||
| properties.maxCount |
integer (int32) |
Het maximum aantal knooppunten voor automatisch schalen |
|
| properties.maxPods |
integer (int32) |
Het maximum aantal pods dat op een knooppunt kan worden uitgevoerd. |
|
| properties.messageOfTheDay |
string |
Bericht van de dag voor Linux-knooppunten, met base64 gecodeerd. Een met base64 gecodeerde tekenreeks die na het decoderen naar /etc/motd wordt geschreven. Hiermee kunt u het bericht van de dag aanpassen voor Linux-knooppunten. Het mag niet worden gespecificeerd voor Windows-nodes. Het moet een statische tekenreeks zijn (dat wil bijvoorbeeld onbewerkt worden afgedrukt en niet worden uitgevoerd als een script). |
|
| properties.minCount |
integer (int32) |
Het minimale aantal knooppunten voor automatisch schalen |
|
| properties.mode |
De modus van een agentpool. Een cluster moet te allen tijde ten minste één agentgroep van het systeem hebben. Zie voor meer informatie over beperkingen en aanbevolen procedures voor agentgroepen: https://docs.microsoft.com/azure/aks/use-system-pools |
||
| properties.networkProfile |
Netwerkinstellingen van een agentgroep. |
||
| properties.nodeImageVersion |
string |
De versie van de knooppuntinstallatiekopieën |
|
| properties.nodeLabels |
object |
De knooppuntlabels die moeten worden bewaard op alle knooppunten in de agentgroep. |
|
| properties.nodePublicIPPrefixID |
string (arm-id) |
De id van het openbare IP-voorvoegsel waaruit VM-knooppunten IP-adressen moeten gebruiken. Dit is de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/publicIPPrefixes/{publicIPPrefixName} |
|
| properties.nodeTaints |
string[] |
De taints die zijn toegevoegd aan nieuwe knooppunten tijdens het maken en schalen van knooppuntgroepen. Bijvoorbeeld key=value:NoSchedule. |
|
| properties.orchestratorVersion |
string |
De versie van Kubernetes die door de gebruiker is opgegeven. Zowel patchversie <major.minor.patch> (bijvoorbeeld 1.20.13) als <major.minor> (bijvoorbeeld 1.20) worden ondersteund. Wanneer <major.minor> is opgegeven, wordt automatisch de meest recente ondersteunde GA-patchversie gekozen. Het cluster bijwerken met dezelfde <major.minor> nadat het is gemaakt (bijvoorbeeld 1.14.x -> 1.14) activeert geen upgrade, zelfs niet als er een nieuwere patchversie beschikbaar is. Als best practice moet u alle knooppuntgroepen in een AKS-cluster upgraden naar dezelfde Kubernetes-versie. De versie van de knooppuntgroep moet dezelfde primaire versie hebben als het besturingsvlak. De secundaire versie van de knooppuntgroep moet zich in twee secundaire versies van de versie van het besturingsvlak bevindt. De versie van de knooppuntgroep mag niet groter zijn dan de versie van het besturingsvlak. Zie Een knooppuntgroep upgraden voor meer informatie. |
|
| properties.osDiskSizeGB |
integer (int32) minimum: 0maximum: 2048 |
Grootte van besturingssysteemschijf in GB die moet worden gebruikt om de schijfgrootte op te geven voor elke computer in de hoofd-/agentgroep. Als u 0 opgeeft, wordt de standaard osDisk-grootte toegepast op basis van de opgegeven vmSize. |
|
| properties.osDiskType |
Het type besturingssysteemschijf dat moet worden gebruikt voor machines in de agentgroep. De standaardwaarde is 'kortstondig' als de VIRTUELE machine deze ondersteunt en een cacheschijf heeft die groter is dan de aangevraagde OSDiskSizeGB. Anders wordt standaard 'Beheerd' gebruikt. Kan niet worden gewijzigd na het maken. Zie Kortstondig besturingssysteem voor meer informatie. |
||
| properties.osSKU |
Hiermee geeft u de SKU van het besturingssysteem op die wordt gebruikt door de agentgroep. De standaardwaarde is Ubuntu als OSType Linux is. De standaard is Windows2019 wanneer Kubernetes <= 1.24 of Windows2022 wanneer Kubernetes >= 1.25 als OSType Windows is. |
||
| properties.osType | Linux |
Het type besturingssysteem. De standaardwaarde is Linux. |
|
| properties.podIPAllocationMode |
Pod IP-toewijzingsmodus. De IP-toewijzingsmodus voor pods in de agentgroep. Moet worden gebruikt met podSubnetId. De standaardwaarde is DynamicIndividual. |
||
| properties.podSubnetID |
string (arm-id) |
De id van het subnet waaraan pods worden samengevoegd wanneer deze worden gestart. Als u dit weglaat, worden pod-IP's statisch toegewezen aan het knooppuntsubnet (zie vnetSubnetID voor meer informatie). Dit is de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} |
|
| properties.powerState |
Of de agentgroep wordt uitgevoerd of gestopt. Wanneer een agentgroep voor het eerst wordt gemaakt, wordt deze in eerste instantie uitgevoerd. De agentgroep kan worden gestopt door dit veld in te stellen op Gestopt. Een gestopte agentgroep stopt alle VM's en brengt geen factureringskosten met zich mee. Een agentgroep kan alleen worden gestopt als deze actief is en de inrichtingsstatus is geslaagd |
||
| properties.provisioningState |
string |
De huidige implementatie- of inrichtingsstatus. |
|
| properties.proximityPlacementGroupID |
string (arm-id) |
De id voor nabijheidsplaatsingsgroep. |
|
| properties.scaleDownMode |
De omlaagschaalmodus die moet worden gebruikt bij het schalen van de agentgroep. Dit heeft ook invloed op het gedrag van automatische schaalaanpassing van clusters. Als dit niet is opgegeven, wordt deze standaard verwijderd. |
||
| properties.scaleSetEvictionPolicy | Delete |
Het uitzettingsbeleid voor de schaal van de virtuele machine. Het uitzettingsbeleid specificeert wat er to do is met de VM wanneer deze wordt ontruimd. De standaardinstelling is Verwijderen. Voor meer informatie over uitzettingen, zie spot VMs |
|
| properties.scaleSetPriority | Regular |
De prioriteit van de virtuele-machineschaalset. |
|
| properties.securityProfile |
De beveiligingsinstellingen van een agentgroep. |
||
| properties.spotMaxPrice |
number (float) |
-1 |
De maximale prijs (in Amerikaanse dollars) die u bereid bent te betalen voor spot-instanties. Mogelijke waarden zijn een decimale waarde die groter is dan nul of -1 die aangeeft dat de standaardprijs moet worden up-to op aanvraag. Mogelijke waarden zijn een decimale waarde die groter is dan nul of -1 die de bereidheid aangeeft om een on-demand prijs te betalen. Zie prijzen voor spot-VM's voor meer informatie over spotprijzen |
| properties.status |
Bevat alleen-lezen informatie over de agentgroep. |
||
| properties.tags |
object |
De tags die moeten worden bewaard in de virtuele-machineschaalset van de agentgroep. |
|
| properties.type |
Het type agentgroep. |
||
| properties.upgradeSettings |
Instellingen voor het upgraden van de agentpool |
||
| properties.virtualMachineNodesStatus |
De status van knooppunten in een VirtualMachines-agentgroep. |
||
| properties.virtualMachinesProfile |
Specificaties voor VirtualMachines-agentpool. |
||
| properties.vmSize |
string |
De grootte van de VM's van de agentgroep. Beschikbaarheid van VM-grootte verschilt per regio. Als een knooppunt onvoldoende rekenresources (geheugen, cpu, enzovoort) bevat, kunnen pods mogelijk niet correct worden uitgevoerd. Zie voor meer informatie over beperkte VM-grootten: https://docs.microsoft.com/azure/aks/quotas-skus-regions |
|
| properties.vnetSubnetID |
string (arm-id) |
De id van het subnet waaraan agentpoolknooppunten en eventueel pods worden toegevoegd bij het opstarten. Als dit niet is opgegeven, worden er een VNET en subnet gegenereerd en gebruikt. Als er geen podSubnetID is opgegeven, is dit van toepassing op knooppunten en pods, anders geldt dit voor alleen knooppunten. Dit is de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} |
|
| properties.windowsProfile |
Het specifieke profiel van de Windows-agentpool. |
||
| properties.workloadRuntime |
Bepaalt het type workload dat een knooppunt kan uitvoeren. |
||
| systemData |
Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens. |
||
| type |
string |
Het type bron. Bijvoorbeeld: "Microsoft. Compute/virtualMachines" of "Microsoft. Opslag/opslagAccounts" |
AgentPoolGatewayProfile
Profiel van de beheerde clustergatewayagentgroep.
| Name | Type | Default value | Description |
|---|---|---|---|
| publicIPPrefixSize |
integer (int32) minimum: 28maximum: 31 |
31 |
De gatewayagentgroep koppelt één openbaar IPPrefix voor elke statische uitgaande gateway om openbaar uitgaand verkeer te bieden. De grootte van Public IPPrefix moet door de gebruiker worden geselecteerd. Elk knooppunt in de agentgroep wordt toegewezen met één IP van het IPPrefix. De IPPrefix-grootte fungeert dus als een limiet voor de grootte van de gatewayagentgroep. Vanwege Azure beperking van de openbare IPPrefix-grootte is het geldige waardebereik [28, 31] (/31 = 2 knooppunten/IP's, /30 = 4 knooppunten/IP's, /29 = 8 knooppunten/IP's, /28 = 16 knooppunten/IP-adressen). De standaardwaarde is 31. |
AgentPoolMode
De modus van een agentpool. Een cluster moet te allen tijde ten minste één agentgroep van het systeem hebben. Zie voor meer informatie over beperkingen en aanbevolen procedures voor agentgroepen: https://docs.microsoft.com/azure/aks/use-system-pools
| Waarde | Description |
|---|---|
| System |
Systeemagentgroepen zijn voornamelijk bedoeld voor het hosten van kritieke systeempods, zoals CoreDNS en metrics-server. Systeemagentpools osType moet Linux zijn. Vm-SKU's voor systeemagentgroepen moeten ten minste 2vCPU's en 4 GB geheugen hebben. |
| User |
Gebruikersagentgroepen zijn voornamelijk bedoeld voor het hosten van uw toepassingspods. |
| Gateway |
Gatewayagentpools zijn toegewezen aan het leveren van statische UITGAANDE IP-adressen aan pods. Zie https://aka.ms/aks/static-egress-gateway voor meer informatie. |
AgentPoolNetworkProfile
Netwerkinstellingen van een agentgroep.
| Name | Type | Description |
|---|---|---|
| allowedHostPorts |
De poortbereiken die access mogen zijn. De opgegeven bereiken mogen elkaar overlappen. |
|
| applicationSecurityGroups |
string[] (arm-id) |
De id's van de toepassingsbeveiligingsgroepen die door de agentgroep worden gekoppeld wanneer deze worden gemaakt. |
| nodePublicIPTags |
IPTag[] |
IPTags van openbare IP-adressen op exemplaarniveau. |
AgentPoolSecurityProfile
De beveiligingsinstellingen van een agentgroep.
| Name | Type | Description |
|---|---|---|
| enableSecureBoot |
boolean |
Beveiligd opstarten is een functie van Vertrouwde start die ervoor zorgt dat alleen ondertekende besturingssystemen en stuurprogramma's kunnen worden opgestart. Zie aka.ms/aks/trustedlaunch voor meer informatie. Als dit niet is opgegeven, is de standaardwaarde onwaar. |
| enableVTPM |
boolean |
vTPM is een vertrouwde startfunctie voor het configureren van een toegewezen beveiligde kluis voor sleutels en metingen die lokaal op het knooppunt worden bewaard. Zie aka.ms/aks/trustedlaunch voor meer informatie. Als dit niet is opgegeven, is de standaardwaarde onwaar. |
| sshAccess |
SSH-access-methode van een agentpool. |
AgentPoolSSHAccess
SSH-access-methode van een agentpool.
| Waarde | Description |
|---|---|
| LocalUser |
Kan SSH op het knooppunt gebruiken als lokale gebruiker met behulp van een persoonlijke sleutel. |
| Disabled |
De SSH-service wordt uitgeschakeld op het knooppunt. |
AgentPoolStatus
Bevat alleen-lezen informatie over de agentgroep.
| Name | Type | Description |
|---|---|---|
| provisioningError |
De foutgegevens van de agentgroep. Behoudt de gedetailleerde informatie over fouten. Als er geen fout is opgetreden, wordt dit veld weggelaten. |
AgentPoolType
Het type agentgroep.
| Waarde | Description |
|---|---|
| VirtualMachineScaleSets |
Maak een agentgroep die wordt ondersteund door een virtuele-machineschaalset. |
| AvailabilitySet |
Het gebruik hiervan wordt sterk afgeraden. |
| VirtualMachines |
Maak een agentgroep die wordt ondersteund door de indelingsmodus voor vm's met één exemplaar. |
AgentPoolUpgradeSettings
Instellingen voor het upgraden van een agentpool
| Name | Type | Description |
|---|---|---|
| drainTimeoutInMinutes |
integer (int32) minimum: 1maximum: 1440 |
De drain timeout voor een knooppunt. De hoeveelheid tijd (in minuten) om te wachten op verwijdering van pods en respijtvolle beëindiging per knooppunt. Deze verwijderingswachttijd eert het wachten op budgetten voor podonderbreking. Als deze tijd wordt overschreden, mislukt de upgrade. Als dit niet is opgegeven, is de standaardwaarde 30 minuten. |
| maxSurge |
string |
Het maximum aantal knooppunten of het maximumpercentage van knooppunten dat tijdens de upgrade is overgegaan. Dit kan worden ingesteld op een geheel getal (bijvoorbeeld '5') of een percentage (bijvoorbeeld '50%'). Als een percentage is opgegeven, is dit het percentage van de totale grootte van de agentgroep op het moment van de upgrade. Voor percentages worden breukknooppunten naar boven afgerond. Als dit niet is opgegeven, is de standaardwaarde 10%. Zie voor meer informatie, inclusief aanbevolen procedures: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster |
| maxUnavailable |
string |
Het maximum aantal of het percentage knooppunten dat tegelijkertijd niet beschikbaar is tijdens de upgrade. Dit kan worden ingesteld op een geheel getal (bijvoorbeeld '1') of een percentage (bijvoorbeeld '5%'). Als een percentage is opgegeven, is dit het percentage van de totale grootte van de agentgroep op het moment van de upgrade. Voor percentages worden breukknooppunten naar boven afgerond. Als dit niet is opgegeven, is de standaardwaarde 0. Zie voor meer informatie, inclusief aanbevolen procedures: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster |
| nodeSoakDurationInMinutes |
integer (int32) minimum: 0maximum: 30 |
De inweekduur voor een knoop. De hoeveelheid tijd (in minuten) die moet worden gewacht na het leegmaken van een knooppunt en voordat u het opnieuw opgeeft en verdergaat met het volgende knooppunt. Als dit niet is opgegeven, is de standaardwaarde 0 minuten. |
| undrainableNodeBehavior |
Definieert het gedrag voor oningestoorde knooppunten tijdens de upgrade. De meest voorkomende oorzaak van oningestoorde knooppunten is PDU's (Pod Disruption Budgets), maar andere problemen, zoals de respijtperiode voor podbeëindiging, overschrijden de resterende time-out voor het leegmaken van knooppunten of pods hebben nog steeds een actieve status, maar kunnen ook oningestoorde knooppunten veroorzaken. |
AgentPoolWindowsProfile
Het specifieke profiel van de Windows-agentpool.
| Name | Type | Description |
|---|---|---|
| disableOutboundNat |
boolean |
Of OutboundNAT in Windows-knooppunten moet worden uitgeschakeld. De standaardwaarde is onwaar. Uitgaande NAT kan alleen worden uitgeschakeld als het cluster uitgaandetype NAT Gateway is en de Windows-agentgroep geen openbaar IP-adres van het knooppunt heeft ingeschakeld. |
Code
Hiermee wordt aangegeven of het cluster wordt uitgevoerd of gestopt
| Waarde | Description |
|---|---|
| Running |
Het cluster wordt uitgevoerd. |
| Stopped |
Het cluster is gestopt. |
createdByType
Het type identiteit waarmee de resource is gemaakt.
| Waarde | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
CreationData
Gegevens die worden gebruikt bij het maken van een doelresource op basis van een bronresource.
| Name | Type | Description |
|---|---|---|
| sourceResourceId |
string (arm-id) |
Dit is de ARM-id van het bronobject dat moet worden gebruikt om het doelobject te maken. |
ErrorAdditionalInfo
Aanvullende informatie over de resourcebeheerfout.
| Name | Type | Description |
|---|---|---|
| info |
object |
De aanvullende informatie. |
| type |
string |
Het extra informatietype. |
ErrorDetail
De foutdetails.
| Name | Type | Description |
|---|---|---|
| additionalInfo |
De fout bevat aanvullende informatie. |
|
| code |
string |
De foutcode. |
| details |
De foutdetails. |
|
| message |
string |
Het foutbericht. |
| target |
string |
Het foutdoelwit. |
ErrorResponse
Foutreactie
| Name | Type | Description |
|---|---|---|
| error |
Het foutobject. |
GPUDriver
Of u GPU-stuurprogramma's wilt installeren. Als deze niet is opgegeven, is de standaardwaarde Installeren.
| Waarde | Description |
|---|---|
| Install |
Stuurprogramma installeren. |
| None |
Sla de installatie van het stuurprogramma over. |
GPUInstanceProfile
GPUInstanceProfile dat moet worden gebruikt om het GPU MIG-exemplaarprofiel op te geven voor de ondersteunde GPU VM-SKU.
| Waarde | Description |
|---|---|
| MIG1g |
MIG 1G GPU-instantieprofiel. |
| MIG2g |
MIG 2G GPU-instantieprofiel. |
| MIG3g |
MIG 3G GPU-instantieprofiel. |
| MIG4g |
MIG 4G GPU-instanceprofiel. |
| MIG7g |
MIG 7G GPU-instantieprofiel. |
GPUProfile
GPU-instellingen voor de agentgroep.
| Name | Type | Description |
|---|---|---|
| driver |
Of u GPU-stuurprogramma's wilt installeren. Als deze niet is opgegeven, is de standaardwaarde Installeren. |
IPTag
Bevat de IPTag die aan het object is gekoppeld.
| Name | Type | Description |
|---|---|---|
| ipTagType |
string |
Het TYPE IP-tag. Voorbeeld: RoutingPreference. |
| tag |
string |
De waarde van de IP-tag die is gekoppeld aan het openbare IP-adres. Voorbeeld: Internet. |
KubeletConfig
Kubelet-configuraties van agentknooppunten. Zie aangepaste AKS-knooppuntconfiguratie voor meer informatie.
| Name | Type | Description |
|---|---|---|
| allowedUnsafeSysctls |
string[] |
Toegestane lijst met onveilige sysctls of onveilige sysctl-patronen (eindigend op |
| containerLogMaxFiles |
integer (int32) minimum: 2 |
Het maximum aantal containerlogboekbestanden dat aanwezig kan zijn voor een container. Het getal moet ≥ 2 zijn. |
| containerLogMaxSizeMB |
integer (int32) |
De maximale grootte (bijvoorbeeld 10Mi) van het containerlogboekbestand voordat het wordt gedraaid. |
| cpuCfsQuota |
boolean |
Als het afdwingen van CPU CFS-quota is ingeschakeld voor containers die CPU-limieten opgeven. De standaardwaarde is waar. |
| cpuCfsQuotaPeriod |
string |
De waarde van de CPU CFS-quotumperiode. De standaardwaarde is '100ms'. Geldige waarden zijn een reeks decimale getallen met een optionele breuk en een eenheidsachtervoegsel. Bijvoorbeeld: '300ms', '2h45m'. Ondersteunde eenheden zijn 'ns', 'us', 'ms', 's', 'm' en 'h'. |
| cpuManagerPolicy |
string |
Het CPU Manager-beleid dat moet worden gebruikt. De standaardwaarde is 'none'. Zie Het Beleid voor CPU-beheer van Kubernetes voor meer informatie. Toegestane waarden zijn 'none' en 'static'. |
| failSwapOn |
boolean |
Als deze optie is ingesteld op true, kan de Kubelet niet worden gestart als wisselen is ingeschakeld op het knooppunt. |
| imageGcHighThreshold |
integer (int32) |
Het percentage schijfgebruik waarna de image garbage collection altijd wordt uitgevoerd. Om de garbagecollection van afbeeldingen uit te schakelen, stelt u deze in op 100. De standaardwaarde is 85% |
| imageGcLowThreshold |
integer (int32) |
Het percentage schijfgebruik waaronder de image garbagecollection niet wordt uitgevoerd. Dit kan niet hoger worden ingesteld dan imageGcHighThreshold. De standaardwaarde is 80% |
| podMaxPids |
integer (int32) |
Het maximum aantal processen per pod. |
| topologyManagerPolicy |
string |
Het topologiebeheerbeleid dat moet worden gebruikt. Zie Kubernetes Topology Manager voor meer informatie. De standaardwaarde is 'none'. Toegestane waarden zijn 'none', 'best-effort', 'restricted' en 'single-numa-node'. |
KubeletDiskType
Bepaalt de plaatsing van legeDir-volumes, hoofdmap van containerruntimegegevens en tijdelijke Kubelet-opslag.
| Waarde | Description |
|---|---|
| OS |
Kubelet gebruikt de besturingssysteemschijf voor de gegevens. |
| Temporary |
Kubelet gebruikt de tijdelijke schijf voor de gegevens. |
LinuxOSConfig
Besturingssysteemconfiguraties van Linux-agentknooppunten. Zie aangepaste AKS-knooppuntconfiguratie voor meer informatie.
| Name | Type | Description |
|---|---|---|
| swapFileSizeMB |
integer (int32) |
De grootte in MB van een wisselbestand dat op elk knooppunt wordt gemaakt. |
| sysctls |
Sysctl-instellingen voor Linux-agentknooppunten. |
|
| transparentHugePageDefrag |
string |
Of de kernel agressief gebruik moet maken van geheugencompressie om meer enorme pagina's beschikbaar te maken. Geldige waarden zijn 'altijd', 'uitstellen', 'uitstellen+madvise', 'madvise' en 'nooit'. De standaardwaarde is 'madvise'. Zie Transparent Hugepagesvoor meer informatie. |
| transparentHugePageEnabled |
string |
Of transparante enorme pagina's zijn ingeschakeld. Geldige waarden zijn 'altijd', 'madvise' en 'nooit'. De standaardwaarde is altijd. Zie Transparent Hugepagesvoor meer informatie. |
LocalDNSForwardDestination
Doelserver voor DNS-query's die moeten worden doorgestuurd vanuit localDNS.
| Waarde | Description |
|---|---|
| ClusterCoreDNS |
Stuur DNS-query's door van localDNS naar cluster CoreDNS. |
| VnetDNS |
Stuur DNS-query's door van localDNS naar de DNS-server die is geconfigureerd in het VNET. Een VNET kan meerdere DNS-servers hebben geconfigureerd. |
LocalDNSForwardPolicy
Beleid doorsturen voor het selecteren van upstream DNS-server. Zie forward plugin voor meer informatie.
| Waarde | Description |
|---|---|
| Sequential |
Implementeert sequentiële upstream DNS-serverselectie. Zie forward plugin voor meer informatie. |
| RoundRobin |
Implementeert round robin upstream DNS-serverselectie. Zie forward plugin voor meer informatie. |
| Random |
Implementeert willekeurige upstream DNS-serverselectie. Zie forward plugin voor meer informatie. |
LocalDNSMode
Wijze van inschakelen voor localDNS.
| Waarde | Description |
|---|---|
| Preferred |
Als de huidige orchestratorversie deze functie ondersteunt, geef er dan de voorkeur aan localDNS in te schakelen. |
| Required |
Schakel localDNS in. |
| Disabled |
Schakel localDNS uit. |
LocalDNSOverride
Overschrijvingen voor het localDNS-profiel.
| Name | Type | Default value | Description |
|---|---|---|---|
| cacheDurationInSeconds |
integer (int32) |
3600 |
Cache max TTL in seconden. Zie cache-plug-in voor meer informatie. |
| forwardDestination | ClusterCoreDNS |
Doelserver voor DNS-query's die moeten worden doorgestuurd vanuit localDNS. |
|
| forwardPolicy | Sequential |
Beleid doorsturen voor het selecteren van upstream DNS-server. Zie forward plugin voor meer informatie. |
|
| maxConcurrent |
integer (int32) |
1000 |
Maximaal aantal gelijktijdige query's. Zie forward plugin voor meer informatie. |
| protocol | PreferUDP |
Dwing TCP af of geef de voorkeur aan het UDP-protocol voor verbindingen van localDNS naar upstream DNS-server. |
|
| queryLogging | Error |
Logboekniveau voor DNS-query's in localDNS. |
|
| serveStale | Immediate |
Beleid voor het leveren van verouderde gegevens. Zie cache-plug-in voor meer informatie. |
|
| serveStaleDurationInSeconds |
integer (int32) |
3600 |
Serveer oud in seconden. Zie cache-plug-in voor meer informatie. |
LocalDNSProfile
Configureert de lokale DNS per knooppunt, met VnetDNS- en KubeDNS-overschrijvingen. LocalDNS helpt de prestaties en betrouwbaarheid van DNS-resolutie in een AKS-cluster te verbeteren. Voor meer details zie aka.ms/aks/localdns.
| Name | Type | Default value | Description |
|---|---|---|---|
| kubeDNSOverrides |
<string,
Local |
KubeDNS-overschrijvingen zijn van toepassing op DNS-verkeer van pods met dnsPolicy:ClusterFirst (ook wel KubeDNS-verkeer genoemd). |
|
| mode | Preferred |
Wijze van inschakelen voor localDNS. |
|
| state |
Door het systeem gegenereerde status van localDNS. |
||
| vnetDNSOverrides |
<string,
Local |
VnetDNS-overschrijvingen zijn van toepassing op DNS-verkeer van pods met dnsPolicy:default of kubelet (ook wel VnetDNS-verkeer genoemd). |
LocalDNSProtocol
Dwing TCP af of geef de voorkeur aan het UDP-protocol voor verbindingen van localDNS naar upstream DNS-server.
| Waarde | Description |
|---|---|
| PreferUDP |
Geef de voorkeur aan het UDP-protocol voor verbindingen van localDNS naar de upstream DNS-server. |
| ForceTCP |
Dwing het TCP-protocol af voor verbindingen van localDNS naar de upstream DNS-server. |
LocalDNSQueryLogging
Logboekniveau voor DNS-query's in localDNS.
| Waarde | Description |
|---|---|
| Error |
Maakt foutregistratie in localDNS mogelijk. Zie fouten plugin voor meer informatie. |
| Log |
Maakt het vastleggen van query's in localDNS mogelijk. Zie log plugin voor meer informatie. |
LocalDNSServeStale
Beleid voor het leveren van verouderde gegevens. Zie cache-plug-in voor meer informatie.
| Waarde | Description |
|---|---|
| Verify |
Lever verouderde gegevens met verificatie. Controleer eerst of een vermelding nog steeds niet beschikbaar is bij de bron voordat u de verlopen vermelding naar de client verzendt. Zie cache-plug-in voor meer informatie. |
| Immediate |
Serveer verouderde gegevens onmiddellijk. Stuur de verlopen invoer naar de klant voordat u controleert of de invoer beschikbaar is bij de bron. Zie cache-plug-in voor meer informatie. |
| Disable |
Schakel de weergave van verlopen gegevens uit. |
LocalDNSState
Door het systeem gegenereerde status van localDNS.
| Waarde | Description |
|---|---|
| Enabled |
localDNS is ingeschakeld. |
| Disabled |
localDNS is uitgeschakeld. |
ManualScaleProfile
Specificaties op het aantal machines.
| Name | Type | Description |
|---|---|---|
| count |
integer (int32) |
Aantal knooppunten. |
| size |
string |
VM-grootte die AKS gebruikt bij het maken en schalen, bijvoorbeeld 'Standard_E4s_v3', 'Standard_E16s_v3' of 'Standard_D16s_v5'. |
OSDiskType
Het type besturingssysteemschijf dat moet worden gebruikt voor machines in de agentgroep. De standaardwaarde is 'kortstondig' als de VIRTUELE machine deze ondersteunt en een cacheschijf heeft die groter is dan de aangevraagde OSDiskSizeGB. Anders wordt standaard 'Beheerd' gebruikt. Kan niet worden gewijzigd na het maken. Zie Kortstondig besturingssysteem voor meer informatie.
| Waarde | Description |
|---|---|
| Managed |
Azure repliceert de besturingssysteemschijf voor een virtuele machine naar Azure-opslag om dataverlies te voorkomen mocht de VM naar een andere host moeten worden verplaatst. Omdat containers niet zijn ontworpen om de lokale status persistent te maken, biedt dit gedrag een beperkte waarde en biedt dit enkele nadelen, waaronder tragere inrichting van knooppunten en een hogere lees-/schrijflatentie. |
| Ephemeral |
Tijdelijke besturingssysteemschijven worden alleen opgeslagen op de hostcomputer, net als een tijdelijke schijf. Dit biedt een lagere latentie voor lezen/schrijven, samen met snellere schaalaanpassing van knooppunten en clusterupgrades. |
OSSKU
Hiermee geeft u de SKU van het besturingssysteem op die wordt gebruikt door de agentgroep. De standaardwaarde is Ubuntu als OSType Linux is. De standaard is Windows2019 wanneer Kubernetes <= 1.24 of Windows2022 wanneer Kubernetes >= 1.25 als OSType Windows is.
| Waarde | Description |
|---|---|
| Ubuntu |
Gebruik Ubuntu als het besturingssysteem voor knooppuntinstallatiekopieën. |
| AzureLinux |
Gebruik AzureLinux als het besturingssysteem voor knooppuntinstallatiekopieën. Azure Linux een container-geoptimaliseerde Linux-distro is gebouwd door Microsoft, bezoek https://aka.ms/azurelinux voor meer informatie. |
| AzureLinux3 |
Gebruik AzureLinux3 als besturingssysteem voor knooppuntafbeeldingen. Azure Linux een container-geoptimaliseerde Linux-distro is gebouwd door Microsoft, bezoek https://aka.ms/azurelinux voor meer informatie. Ga voor beperkingen naar https://aka.ms/aks/node-images. Zie voor richtlijnen voor het migreren van het besturingssysteem.https://aka.ms/aks/upgrade-os-version |
| CBLMariner |
Afgeschafte OSSKU. Microsoft raadt aan dat nieuwe implementaties in plaats daarvan kiezen voor 'AzureLinux'. |
| Windows2019 |
Gebruik Windows2019 als het besturingssysteem voor knooppuntinstallatiekopieën. Niet ondersteund voor systeemknooppuntgroepen. Windows2019 ondersteunt alleen Windows2019-containers; Windows2022-containers kunnen niet worden uitgevoerd en omgekeerd. |
| Windows2022 |
Gebruik Windows2022 als het besturingssysteem voor knooppuntinstallatiekopieën. Niet ondersteund voor systeemknooppuntgroepen. Windows2022 ondersteunt alleen Windows2022-containers; Windows2019-containers kunnen niet worden uitgevoerd en omgekeerd. |
| Ubuntu2204 |
Gebruik Ubuntu2204 als besturingssysteem voor knooppuntafbeeldingen, maar Ubuntu 22.04 wordt mogelijk niet voor alle knooppuntpools ondersteund. Zie voor beperkingen en ondersteunde Kubernetes-versies https://aka.ms/aks/supported-ubuntu-versions |
| Windows2025 |
Gebruik Windows2025 als besturingssysteem voor knooppuntafbeeldingen. Niet ondersteund voor systeemknooppuntgroepen. Windows2025 ondersteunt Windows2022- en Windows 2025-containers; het kan geen Windows2019-containers draaien en omgekeerd. |
| Ubuntu2404 |
Gebruik Ubuntu2404 als besturingssysteem voor knooppuntafbeeldingen, maar Ubuntu 24.04 wordt mogelijk niet voor alle knooppuntpools ondersteund. Zie voor beperkingen en ondersteunde Kubernetes-versies https://aka.ms/aks/supported-ubuntu-versions |
OSType
Het type besturingssysteem. De standaardwaarde is Linux.
| Waarde | Description |
|---|---|
| Linux |
Gebruik Linux. |
| Windows |
Gebruik Windows. |
PodIPAllocationMode
Pod IP-toewijzingsmodus. De IP-toewijzingsmodus voor pods in de agentgroep. Moet worden gebruikt met podSubnetId. De standaardwaarde is DynamicIndividual.
| Waarde | Description |
|---|---|
| DynamicIndividual |
Elk knooppunt wordt toegewezen met een niet-aaneengesloten lijst met IP-adressen die aan pods kunnen worden toegewezen. Dit is beter voor het maximaliseren van een klein tot gemiddeld subnet van grootte /16 of kleiner. Het Azure CNI-cluster met dynamische IP-toewijzing schakelt standaard in op deze modus als de klant geen podIPAllocationMode expliciet specificeert |
| StaticBlock |
Elk knooppunt is statisch toegewezen CIDR-blok(en) van grootte /28 = 16 IP-adressen per blok om te voldoen aan de maxPods per knooppunt. Aantal CIDR-blokken >= (maxPods / 16). Het blok telt niet voor één IP, maar tegen de Azure Vnet Private IP-limiet van 65K. Daarom is de blokmodus geschikt voor het uitvoeren van grotere workloads met meer dan de huidige limiet van 65.000 pods in een cluster. Deze modus is beter geschikt voor schaalaanpassing met grotere subnetten van /15 of groter |
PortRange
Het poortbereik.
| Name | Type | Description |
|---|---|---|
| portEnd |
integer (int32) minimum: 1maximum: 65535 |
De maximale poort die is opgenomen in het bereik. Het moet variëren van 1 tot 65535 en groter zijn dan of gelijk zijn aan portStart. |
| portStart |
integer (int32) minimum: 1maximum: 65535 |
De minimale poort die is opgenomen in het bereik. Het moet variëren van 1 tot 65535 en kleiner dan of gelijk aan portEnd. |
| protocol |
Het netwerkprotocol van de poort. |
PowerState
Beschrijft de energiestatus van het cluster
| Name | Type | Description |
|---|---|---|
| code |
Hiermee wordt aangegeven of het cluster wordt uitgevoerd of gestopt |
Protocol
Het netwerkprotocol van de poort.
| Waarde | Description |
|---|---|
| TCP |
TCP-protocol. |
| UDP |
UDP-protocol. |
ScaleDownMode
Beschrijft hoe VM's worden toegevoegd aan of verwijderd uit agentpools. Zie factureringsstatussen.
| Waarde | Description |
|---|---|
| Delete |
Maak nieuwe exemplaren tijdens het omhoog schalen en verwijderen van exemplaren tijdens omlaag schalen. |
| Deallocate |
Probeer de toewijzing van instanties ongedaan te maken (indien aanwezig) tijdens het omhoog schalen en ongedaan maken van de toewijzing van instanties tijdens omlaag schalen. |
ScaleProfile
Specificaties voor het schalen van een VirtualMachines-agentpool.
| Name | Type | Description |
|---|---|---|
| manual |
Specificaties over het schalen van de VirtualMachines-agentpool naar een vaste grootte. |
ScaleSetEvictionPolicy
Het uitzettingsbeleid voor de schaal van de virtuele machine. Het uitzettingsbeleid specificeert wat er to do is met de VM wanneer deze wordt ontruimd. De standaardinstelling is Verwijderen. Voor meer informatie over uitzettingen, zie spot VMs
| Waarde | Description |
|---|---|
| Delete |
Knooppunten in de onderliggende schaalset van de knooppuntgroep worden verwijderd wanneer ze worden verwijderd. |
| Deallocate |
Knooppunten in de onderliggende schaalset van de knooppuntgroep worden ingesteld op de status gestopt-ongedaan gemaakt bij verwijdering. Knooppunten met het aantal gestopte toewijzingsstatussen ten opzichte van uw rekenquotum en kunnen problemen veroorzaken met het schalen of upgraden van clusters. |
ScaleSetPriority
De prioriteit van de virtuele-machineschaalset.
| Waarde | Description |
|---|---|
| Spot |
Vm's met spotprioriteit worden gebruikt. Er is geen SLA voor spot-knooppunten. Zie plek op AKS- voor meer informatie. |
| Regular |
Reguliere VM's worden gebruikt. |
SysctlConfig
Sysctl-instellingen voor Linux-agentknooppunten.
| Name | Type | Description |
|---|---|---|
| fsAioMaxNr |
integer (int32) |
Sysctl-instelling fs.aio-max-nr. |
| fsFileMax |
integer (int32) |
Sysctl instelling fs.file-max. |
| fsInotifyMaxUserWatches |
integer (int32) |
Sysctl-instelling fs.inotify.max_user_watches. |
| fsNrOpen |
integer (int32) |
Sysctl-instelling fs.nr_open. |
| kernelThreadsMax |
integer (int32) |
Sysctl-instelling kernel.threads-max. |
| netCoreNetdevMaxBacklog |
integer (int32) |
Sysctl-instelling net.core.netdev_max_backlog. |
| netCoreOptmemMax |
integer (int32) |
Sysctl-instelling net.core.optmem_max. |
| netCoreRmemDefault |
integer (int32) |
Sysctl-instelling net.core.rmem_default. |
| netCoreRmemMax |
integer (int32) |
Sysctl-instelling net.core.rmem_max. |
| netCoreSomaxconn |
integer (int32) |
Sysctl instelling net.core.somaxconn. |
| netCoreWmemDefault |
integer (int32) |
Sysctl-instelling net.core.wmem_default. |
| netCoreWmemMax |
integer (int32) |
Sysctl-instelling net.core.wmem_max. |
| netIpv4IpLocalPortRange |
string |
Sysctl-instelling net.ipv4.ip_local_port_range. |
| netIpv4NeighDefaultGcThresh1 |
integer (int32) |
Sysctl-instelling net.ipv4.neigh.default.gc_thresh1. |
| netIpv4NeighDefaultGcThresh2 |
integer (int32) |
Sysctl-instelling net.ipv4.neigh.default.gc_thresh2. |
| netIpv4NeighDefaultGcThresh3 |
integer (int32) |
Sysctl-instelling net.ipv4.neigh.default.gc_thresh3. |
| netIpv4TcpFinTimeout |
integer (int32) |
Sysctl-instelling net.ipv4.tcp_fin_timeout. |
| netIpv4TcpKeepaliveProbes |
integer (int32) |
Sysctl-instelling net.ipv4.tcp_keepalive_probes. |
| netIpv4TcpKeepaliveTime |
integer (int32) |
Sysctl-instelling net.ipv4.tcp_keepalive_time. |
| netIpv4TcpMaxSynBacklog |
integer (int32) |
Sysctl-instelling net.ipv4.tcp_max_syn_backlog. |
| netIpv4TcpMaxTwBuckets |
integer (int32) |
Sysctl-instelling net.ipv4.tcp_max_tw_buckets. |
| netIpv4TcpTwReuse |
boolean |
Sysctl-instelling net.ipv4.tcp_tw_reuse. |
| netIpv4TcpkeepaliveIntvl |
integer (int32) minimum: 10maximum: 90 |
Sysctl-instelling net.ipv4.tcp_keepalive_intvl. |
| netNetfilterNfConntrackBuckets |
integer (int32) minimum: 65536maximum: 524288 |
Sysctl-instelling net.netfilter.nf_conntrack_buckets. |
| netNetfilterNfConntrackMax |
integer (int32) minimum: 131072maximum: 2097152 |
Sysctl-instelling net.netfilter.nf_conntrack_max. |
| vmMaxMapCount |
integer (int32) |
Sysctl-instelling vm.max_map_count. |
| vmSwappiness |
integer (int32) |
Sysctl-instelling vm.swappiness. |
| vmVfsCachePressure |
integer (int32) |
Sysctl-instelling vm.vfs_cache_pressure. |
systemData
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
| Name | Type | Description |
|---|---|---|
| createdAt |
string (date-time) |
De tijdstempel van het maken van resources (UTC). |
| createdBy |
string |
De identiteit waarmee de resource is gemaakt. |
| createdByType |
Het type identiteit waarmee de resource is gemaakt. |
|
| lastModifiedAt |
string (date-time) |
Het tijdstempel van de laatste wijziging van de resource (UTC) |
| lastModifiedBy |
string |
De identiteit die de resource voor het laatst heeft gewijzigd. |
| lastModifiedByType |
Het type identiteit dat de resource voor het laatst heeft gewijzigd. |
UndrainableNodeBehavior
Definieert het gedrag voor oningestoorde knooppunten tijdens de upgrade. De meest voorkomende oorzaak van oningestoorde knooppunten is PDU's (Pod Disruption Budgets), maar andere problemen, zoals de respijtperiode voor podbeëindiging, overschrijden de resterende time-out voor het leegmaken van knooppunten of pods hebben nog steeds een actieve status, maar kunnen ook oningestoorde knooppunten veroorzaken.
| Waarde | Description |
|---|---|
| Cordon |
AKS stuurt de geblokkeerde knooppunten af en vervangt deze door piekknooppunten tijdens de upgrade. De geblokkeerde knooppunten worden vastgezet en vervangen door piekknooppunten. De geblokkeerde knooppunten hebben het label 'kubernetes.azure.com/upgrade-status:Quarantined'. Voor elk geblokkeerd knooppunt wordt een piekknooppunt bewaard. Er wordt een poging gedaan om alle andere piekknooppunten te verwijderen. Als er voldoende piekknooppunten zijn om geblokkeerde knooppunten te vervangen, heeft de upgradebewerking en het beheerde cluster de status Mislukt. Anders hebben de upgradebewerking en het beheerde cluster de status Geannuleerd. |
| Schedule |
AKS markeert de geblokkeerde knooppunten die kunnen worden verdeeld, maar de geblokkeerde knooppunten worden niet bijgewerkt. Er wordt een poging gedaan om alle piekknooppunten te verwijderen. De upgradebewerking en het beheerde cluster hebben de status Mislukt als er geblokkeerde knooppunten zijn. |
VirtualMachineNodes
Huidige status van een groep knooppunten met dezelfde VM-grootte.
| Name | Type | Description |
|---|---|---|
| count |
integer (int32) |
Aantal knooppunten. |
| size |
string |
De VM-grootte van de agents die worden gebruikt om deze groep knooppunten te hosten. |
VirtualMachinesProfile
Specificaties voor VirtualMachines-agentpool.
| Name | Type | Description |
|---|---|---|
| scale |
Specificaties voor het schalen van een VirtualMachines-agentpool. |
WorkloadRuntime
Bepaalt het type workload dat een knooppunt kan uitvoeren.
| Waarde | Description |
|---|---|
| OCIContainer |
Knooppunten gebruiken Kubelet om standaard-OCI-containerworkloads uit te voeren. |
| WasmWasi |
Knooppunten gebruiken Krustlet om WASM-workloads uit te voeren met behulp van de WASI-provider (preview). |
| KataVmIsolation |
Nodes kunnen (Kata + Cloud Hypervisor + Hyper-V) gebruiken om Nested VM-gebaseerde pods te activeren. Door het gebruik van Hyper-V is het AKS-node-OS zelf een geneste VM (het root-OS) van Hyper-V. Het kan dus alleen worden gebruikt met VM-serie die ondersteuning biedt voor geneste virtualisatie, zoals Dv3-serie. |