Agent Pools - Upgrade Node Image Version

Service:: AKS

API-versie:: 2025-04-01

Hiermee wordt de versie van de knooppuntinstallatiekopieën van een agentgroep bijgewerkt naar de meest recente versie.
Wanneer u de versie van de knooppuntinstallatiekopieën van een agentgroep bijwerken, worden het nieuwste besturingssysteem en runtime-updates toegepast op de knooppunten. AKS biedt één nieuwe afbeelding per week met de nieuwste updates. Zie voor meer informatie over versies van knooppuntinstallatiekopieën: https://docs.microsoft.com/azure/aks/node-image-upgrade

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/upgradeNodeImageVersion?api-version=2025-04-01

URI-parameters

Name	In	Vereist	Type	Description
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	De naam van de agentgroep.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
resourceName	path	True	string minLength: 1 maxLength: 63 pattern: ^[a-zA-Z0-9]$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$	De naam van de beheerde clusterresource.
subscriptionId	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.

Antwoorden

Name	Type	Description
200 OK		OK
202 Accepted	AgentPool	Geaccepteerd Kopteksten Azure-AsyncOperation: string
Other Status Codes	CloudError	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Name

Type

Description

200 OK

202 Accepted

AgentPool

Geaccepteerd

Kopteksten

Azure-AsyncOperation: string

Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Upgrade Agent Pool Node Image Version

Voorbeeldaanvraag

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/upgradeNodeImageVersion?api-version=2025-04-01


/**
 * Samples for AgentPools UpgradeNodeImageVersion.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-04-01/examples/
     * AgentPoolsUpgradeNodeImageVersion.json
     */
    /**
     * Sample code: Upgrade Agent Pool Node Image Version.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void upgradeAgentPoolNodeImageVersion(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.kubernetesClusters().manager().serviceClient().getAgentPools().upgradeNodeImageVersion("rg1",
            "clustername1", "agentpool1", com.azure.core.util.Context.NONE);
    }
}

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.containerservice import ContainerServiceClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-containerservice
# USAGE
    python agent_pools_upgrade_node_image_version.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ContainerServiceClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.agent_pools.begin_upgrade_node_image_version(
        resource_group_name="rg1",
        resource_name="clustername1",
        agent_pool_name="agentpool1",
    ).result()
    print(response)


# x-ms-original-file: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-04-01/examples/AgentPoolsUpgradeNodeImageVersion.json
if __name__ == "__main__":
    main()

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

package armcontainerservice_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/containerservice/armcontainerservice/v7"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/87bd051c295d94fffa28a4fa6b18f8b4b71c50ec/specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-04-01/examples/AgentPoolsUpgradeNodeImageVersion.json
func ExampleAgentPoolsClient_BeginUpgradeNodeImageVersion() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcontainerservice.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewAgentPoolsClient().BeginUpgradeNodeImageVersion(ctx, "rg1", "clustername1", "agentpool1", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	_, err = poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
}

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

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

/**
 * This sample demonstrates how to Upgrading the node image version of an agent pool applies the newest OS and runtime updates to the nodes. AKS provides one new image per week with the latest updates. For more details on node image versions, see: https://docs.microsoft.com/azure/aks/node-image-upgrade
 *
 * @summary Upgrading the node image version of an agent pool applies the newest OS and runtime updates to the nodes. AKS provides one new image per week with the latest updates. For more details on node image versions, see: https://docs.microsoft.com/azure/aks/node-image-upgrade
 * x-ms-original-file: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-04-01/examples/AgentPoolsUpgradeNodeImageVersion.json
 */
async function upgradeAgentPoolNodeImageVersion() {
  const subscriptionId =
    process.env["CONTAINERSERVICE_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["CONTAINERSERVICE_RESOURCE_GROUP"] || "rg1";
  const resourceName = "clustername1";
  const agentPoolName = "agentpool1";
  const credential = new DefaultAzureCredential();
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.beginUpgradeNodeImageVersionAndWait(
    resourceGroupName,
    resourceName,
    agentPoolName,
  );
  console.log(result);
}

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

Voorbeeldrespons

Statuscode:: 200

Statuscode:: 202

Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.ContainerService/locations/westus/operations/00000000-0000-0000-0000-000000000000?api-version=2018-07-31

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "UpgradingNodeImageVersion",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "nodeImageVersion": "AKSUbuntu-1604-2020.03.11",
    "upgradeSettings": {
      "maxSurge": "33%"
    }
  }
}

Definities

Name	Description
AgentPool	Agentgroep.
AgentPoolGatewayProfile	Profiel van de beheerde clustergatewayagentgroep.
AgentPoolMode	De modus van een agentpool.
AgentPoolNetworkProfile	Netwerkinstellingen van een agentgroep.
AgentPoolSecurityProfile	De beveiligingsinstellingen van een agentgroep.
AgentPoolStatus	Bevat alleen-lezen informatie over de agentgroep.
AgentPoolType	Het type agentgroep.
AgentPoolUpgradeSettings	Instellingen voor het upgraden van een agentpool
AgentPoolWindowsProfile	Het specifieke profiel van de Windows-agentgroep.
CloudError	Een foutreactie van de Container-service.
CloudErrorBody	Een foutreactie van de Container-service.
code	Hiermee wordt aangegeven of het cluster wordt uitgevoerd of gestopt
CreationData	Gegevens die worden gebruikt bij het maken van een doelresource op basis van een bronresource.
GPUDriver	Of u GPU-stuurprogramma's wilt installeren. Als deze niet is opgegeven, is de standaardwaarde Installeren.
GPUInstanceProfile	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.
KubeletConfig	Kubelet-configuraties van agentknooppunten.
KubeletDiskType	Bepaalt de plaatsing van legeDir-volumes, hoofdmap van containerruntimegegevens en tijdelijke Kubelet-opslag.
LinuxOSConfig	Besturingssysteemconfiguraties van Linux-agentknooppunten.
ManualScaleProfile	Specificaties op het aantal machines.
OSDiskType	Het type besturingssysteemschijf dat moet worden gebruikt voor machines in de agentgroep.
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 standaardwaarde is Windows2019 wanneer Kubernetes <= 1.24 of Windows2022 wanneer Kubernetes >= 1.25 is als OSType Windows is.
OSType	Het type besturingssysteem. De standaardwaarde is Linux.
PodIPAllocationMode	Ip-toewijzingsmodus voor pods
PortRange	Het poortbereik.
PowerState	Beschrijft de energiestatus van het cluster
Protocol	Het netwerkprotocol van de poort.
ScaleDownMode	Hierin wordt beschreven hoe VM's worden toegevoegd aan of verwijderd uit agentgroepen. Zie factureringsstatussen.
ScaleProfile	Specificaties voor het schalen van een VirtualMachines-agentpool.
ScaleSetEvictionPolicy	Het verwijderingsbeleid voor virtuele-machineschaalsets.
ScaleSetPriority	De prioriteit van de virtuele-machineschaalset.
SysctlConfig	Sysctl-instellingen voor Linux-agentknooppunten.
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.
VirtualMachineNodes	Huidige status van een groep knooppunten met dezelfde VM-grootte.
VirtualMachinesProfile	Specificaties voor VirtualMachines-agentpool.
WorkloadRuntime	Bepaalt het type workload dat een knooppunt kan uitvoeren.

AgentPool

Object

Agentgroep.

Name	Type	Default value	Description
id	string		Resource-id.
name	string		De naam van de resource die uniek is binnen een resourcegroep. Deze naam kan worden gebruikt voor toegang tot 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 capaciteitsreserveringsgroep om virtuele machines van een gereserveerde groep virtuele machines te bieden. AKS koppelt de opgegeven agentgroep aan de capaciteitsreserveringsgroep.
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		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 volgens de normale etagconventie in te schakelen.
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-grootten 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	AgentPoolGatewayProfile		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		GPUInstanceProfile dat moet worden gebruikt om het GPU MIG-exemplaarprofiel op te geven voor de ondersteunde GPU VM-SKU.
properties.gpuProfile	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 van het formulier: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Zie Toegewezen Azure-hosts voor meer informatie.
properties.kubeletConfig	KubeletConfig		Kubelet-configuraties van agentknooppunten. De Kubelet-configuratie op de agentpoolknooppunten.
properties.kubeletDiskType	KubeletDiskType		Bepaalt de plaatsing van legeDir-volumes, hoofdmap van containerruntimegegevens en tijdelijke Kubelet-opslag.
properties.linuxOSConfig	LinuxOSConfig		Besturingssysteemconfiguraties van Linux-agentknooppunten. De besturingssysteemconfiguratie van Linux-agentknooppunten.
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. Deze mag niet worden opgegeven voor Windows-knooppunten. 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	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
properties.networkProfile	AgentPoolNetworkProfile		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 van 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: 0 maximum: 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	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	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 standaardwaarde is Windows2019 wanneer Kubernetes <= 1.24 of Windows2022 wanneer Kubernetes >= 1.25 is als OSType Windows is.
properties.osType	OSType	Linux	Het type besturingssysteem. De standaardwaarde is Linux.
properties.podIPAllocationMode	PodIPAllocationMode		Ip-toewijzingsmodus voor pods 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 van het formulier: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.powerState	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	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	ScaleSetEvictionPolicy	Delete	Het verwijderingsbeleid voor virtuele-machineschaalsets dat moet worden gebruikt. Dit kan niet worden opgegeven tenzij de scaleSetPriority 'Spot' is. Als dit niet is opgegeven, is de standaardwaarde Verwijderen.
properties.scaleSetPriority	ScaleSetPriority	Regular	De prioriteit van de virtuele-machineschaalset. Als dit niet is opgegeven, is de standaardwaarde 'Normaal'.
properties.securityProfile	AgentPoolSecurityProfile		De beveiligingsinstellingen van een agentgroep.
properties.spotMaxPrice	number	-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	AgentPoolStatus		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	AgentPoolType		Het type agentgroep.
properties.upgradeSettings	AgentPoolUpgradeSettings		Instellingen voor het upgraden van de agentpool
properties.virtualMachineNodesStatus	VirtualMachineNodes[]		De status van knooppunten in een VirtualMachines-agentgroep.
properties.virtualMachinesProfile	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 van het formulier: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.windowsProfile	AgentPoolWindowsProfile		Het specifieke profiel van de Windows-agentgroep.
properties.workloadRuntime	WorkloadRuntime		Bepaalt het type workload dat een knooppunt kan uitvoeren.
type	string		Hulpmiddeltype

AgentPoolGatewayProfile

Object

Profiel van de beheerde clustergatewayagentgroep.

Name	Type	Default value	Description
publicIPPrefixSize	integer (int32) minimum: 28 maximum: 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 de beperking van de grootte van openbare IPPrefix in Azure 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

Inventarisatie

De modus van een agentpool.

Waarde	Description
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.
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.

AgentPoolNetworkProfile

Object

Netwerkinstellingen van een agentgroep.

Name	Type	Description
allowedHostPorts	PortRange[]	De poortbereiken waartoe toegang is toegestaan. 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

Object

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.

AgentPoolStatus

Object

Bevat alleen-lezen informatie over de agentgroep.

Name	Type	Description
provisioningError	CloudErrorBody	De foutgegevens van de agentgroep. Behoudt de gedetailleerde informatie over fouten. Als er geen fout is opgetreden, wordt dit veld weggelaten.

AgentPoolType

Inventarisatie

Het type agentgroep.

Waarde	Description
AvailabilitySet	Het gebruik hiervan wordt sterk afgeraden.
VirtualMachineScaleSets	Maak een agentgroep die wordt ondersteund door een virtuele-machineschaalset.
VirtualMachines	Maak een agentgroep die wordt ondersteund door de indelingsmodus voor vm's met één exemplaar.

AgentPoolUpgradeSettings

Object

Instellingen voor het upgraden van een agentpool

Name	Type	Description
drainTimeoutInMinutes	integer (int32) minimum: 1 maximum: 1440	De time-out voor afvoer 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: 0 maximum: 30	De weekduur voor een knooppunt 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	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

Object

Het specifieke profiel van de Windows-agentgroep.

Name	Type	Description
disableOutboundNat	boolean	Of uitgaandeNAT moet worden uitgeschakeld in Windows-knooppunten 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.

CloudError

Object

Een foutreactie van de Container-service.

Name	Type	Description
error	CloudErrorBody	Details over de fout.

CloudErrorBody

Object

Een foutreactie van de Container-service.

Name	Type	Description
code	string	Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
details	CloudErrorBody[]	Een lijst met aanvullende informatie over de fout.
message	string	Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.
target	string	Het doel van de specifieke fout. Bijvoorbeeld de naam van de eigenschap in fout.

code

Inventarisatie

Hiermee wordt aangegeven of het cluster wordt uitgevoerd of gestopt

Waarde	Description
Running	Het cluster wordt uitgevoerd.
Stopped	Het cluster is gestopt.

CreationData

Object

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.

GPUDriver

Inventarisatie

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

Inventarisatie

GPUInstanceProfile dat moet worden gebruikt om het GPU MIG-exemplaarprofiel op te geven voor de ondersteunde GPU VM-SKU.

Waarde	Description
MIG1g
MIG2g
MIG3g
MIG4g
MIG7g

GPUProfile

Object

GPU-instellingen voor de agentgroep.

Name	Type	Description
driver	GPUDriver	Of u GPU-stuurprogramma's wilt installeren. Als deze niet is opgegeven, is de standaardwaarde Installeren.

IPTag

Object

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

Object

Kubelet-configuraties van agentknooppunten.

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 garbagecollection van installatiekopieën altijd wordt uitgevoerd. Als u de garbagecollection van de installatiekopieën wilt uitschakelen, stelt u in op 100. De standaardwaarde is 85%
imageGcLowThreshold	integer (int32)	Het percentage schijfgebruik voordat de garbagecollection van installatiekopieën nooit 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

Inventarisatie

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

Object

Besturingssysteemconfiguraties van Linux-agentknooppunten.

Name	Type	Description
swapFileSizeMB	integer (int32)	De grootte in MB van een wisselbestand dat op elk knooppunt wordt gemaakt.
sysctls	SysctlConfig	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 Hugepages voor meer informatie.
transparentHugePageEnabled	string	Of transparante enorme pagina's zijn ingeschakeld. Geldige waarden zijn 'altijd', 'madvise' en 'nooit'. De standaardwaarde is altijd. Zie Transparent Hugepages voor meer informatie.

ManualScaleProfile

Object

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

Inventarisatie

Het type besturingssysteemschijf dat moet worden gebruikt voor machines in de agentgroep.

Waarde	Description
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.
Managed	Azure repliceert de besturingssysteemschijf voor een virtuele machine naar Azure Storage om gegevensverlies te voorkomen als de VIRTUELE machine moet worden verplaatst naar een andere host. 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.

Waarde

Description

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.

Managed

Azure repliceert de besturingssysteemschijf voor een virtuele machine naar Azure Storage om gegevensverlies te voorkomen als de VIRTUELE machine moet worden verplaatst naar een andere host. 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.

OSSKU

Inventarisatie

Hiermee geeft u de SKU van het besturingssysteem op die wordt gebruikt door de agentgroep. De standaardwaarde is Ubuntu als OSType Linux is. De standaardwaarde is Windows2019 wanneer Kubernetes <= 1.24 of Windows2022 wanneer Kubernetes >= 1.25 is als OSType Windows is.

Waarde	Description
AzureLinux	Gebruik AzureLinux als het besturingssysteem voor knooppuntinstallatiekopieën. Azure Linux is een door containers geoptimaliseerde Linux-distributie die is gebouwd door Microsoft. Ga naar https://aka.ms/azurelinux voor meer informatie.
CBLMariner	Afgeschafte OSSKU. Microsoft raadt aan dat nieuwe implementaties in plaats daarvan 'AzureLinux' kiezen.
Ubuntu	Gebruik Ubuntu als het besturingssysteem voor knooppuntinstallatiekopieën.
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
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.

OSType

Inventarisatie

Het type besturingssysteem. De standaardwaarde is Linux.

Waarde	Description
Linux	Gebruik Linux.
Windows	Windows gebruiken.

PodIPAllocationMode

Inventarisatie

Ip-toewijzingsmodus voor pods

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 wordt standaard ingesteld op deze modus als de klant niet expliciet een podIPAllocationMode opgeeft
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 in plaats van één IP-adres ten opzichte van de privé-IP-limiet van Azure Vnet van 65.000. 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

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 wordt standaard ingesteld op deze modus als de klant niet expliciet een podIPAllocationMode opgeeft

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 in plaats van één IP-adres ten opzichte van de privé-IP-limiet van Azure Vnet van 65.000. 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

Object

Het poortbereik.

Name	Type	Description
portEnd	integer (int32) minimum: 1 maximum: 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: 1 maximum: 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	Protocol	Het netwerkprotocol van de poort.

PowerState

Object

Beschrijft de energiestatus van het cluster

Name	Type	Description
code	code	Hiermee wordt aangegeven of het cluster wordt uitgevoerd of gestopt

Protocol

Inventarisatie

Het netwerkprotocol van de poort.

Waarde	Description
TCP	TCP-protocol.
UDP	UDP-protocol.

ScaleDownMode

Inventarisatie

Hierin wordt beschreven hoe VM's worden toegevoegd aan of verwijderd uit agentgroepen. Zie factureringsstatussen.

Waarde	Description
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.
Delete	Maak nieuwe exemplaren tijdens het omhoog schalen en verwijderen van exemplaren tijdens omlaag schalen.

ScaleProfile

Object

Specificaties voor het schalen van een VirtualMachines-agentpool.

Name	Type	Description
manual	ManualScaleProfile[]	Specificaties over het schalen van de VirtualMachines-agentpool naar een vaste grootte.

ScaleSetEvictionPolicy

Inventarisatie

Het verwijderingsbeleid voor virtuele-machineschaalsets.

Waarde	Description
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.
Delete	Knooppunten in de onderliggende schaalset van de knooppuntgroep worden verwijderd wanneer ze worden verwijderd.

ScaleSetPriority

Inventarisatie

De prioriteit van de virtuele-machineschaalset.

Waarde	Description
Regular	Reguliere VM's worden gebruikt.
Spot	Vm's met spotprioriteit worden gebruikt. Er is geen SLA voor spot-knooppunten. Zie spot op AKS voor meer informatie.

SysctlConfig

Object

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: 10 maximum: 90	Sysctl-instelling net.ipv4.tcp_keepalive_intvl.
netNetfilterNfConntrackBuckets	integer (int32) minimum: 65536 maximum: 524288	Sysctl-instelling net.netfilter.nf_conntrack_buckets.
netNetfilterNfConntrackMax	integer (int32) minimum: 131072 maximum: 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.

UndrainableNodeBehavior

Inventarisatie

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.

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

Object

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

Object

Specificaties voor VirtualMachines-agentpool.

Name	Type	Description
scale	ScaleProfile	Specificaties voor het schalen van een VirtualMachines-agentpool.

WorkloadRuntime

Inventarisatie

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).

Delen via

Agent Pools - Upgrade Node Image Version

URI-parameters

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

Upgrade Agent Pool Node Image Version

Voorbeeldaanvraag

Voorbeeldrespons

Definities

AgentPool

AgentPoolGatewayProfile

AgentPoolMode

AgentPoolNetworkProfile

AgentPoolSecurityProfile

AgentPoolStatus

AgentPoolType

AgentPoolUpgradeSettings

AgentPoolWindowsProfile

CloudError

CloudErrorBody

code

CreationData

GPUDriver

GPUInstanceProfile

GPUProfile

IPTag

KubeletConfig

KubeletDiskType

LinuxOSConfig

ManualScaleProfile

OSDiskType

OSSKU

OSType

PodIPAllocationMode

PortRange

PowerState

Protocol

ScaleDownMode

ScaleProfile

ScaleSetEvictionPolicy

ScaleSetPriority

SysctlConfig

UndrainableNodeBehavior

VirtualMachineNodes

VirtualMachinesProfile

WorkloadRuntime