Delen via


Agent Pools - Get

Hiermee haalt u de opgegeven beheerde clusteragentgroep op.

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

URI-parameters

Name In Vereist Type Description
agentPoolName
path True

string

De naam van de agentgroep.

Regex-patroon: ^[a-z][a-z0-9]{0,11}$

resourceGroupName
path True

string

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

resourceName
path True

string

De naam van de beheerde clusterresource.

Regex-patroon: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$

subscriptionId
path True

string

uuid

De id van het doelabonnement. De waarde moet een UUID zijn.

api-version
query True

string

De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name Type Description
200 OK

AgentPool

OK

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

Get Agent Pool

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
AgentPool

Agentgroep.

AgentPoolMode

De modus van een agentpool.

AgentPoolNetworkProfile

Netwerkinstellingen van een agentgroep.

AgentPoolSecurityProfile

De beveiligingsinstellingen van een 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.

GPUInstanceProfile

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

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.

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 als OSType Windows is.

OSType

Het type besturingssysteem. De standaardwaarde is Linux.

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.

ScaleSetEvictionPolicy

Het verwijderingsbeleid voor virtuele-machineschaalsets.

ScaleSetPriority

De prioriteit van de virtuele-machineschaalset.

SysctlConfig

Sysctl-instellingen voor Linux-agentknooppunten.

WorkloadRuntime

Bepaalt het type workload dat een knooppunt kan uitvoeren.

AgentPool

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

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

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 voor meer informatie het toewijzen van een openbaar IP-adres per knooppunt. De standaardwaarde is onwaar.

properties.enableUltraSSD

boolean

Of UltraSSD moet worden ingeschakeld

properties.gpuInstanceProfile

GPUInstanceProfile

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

properties.hostGroupID

string

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

Het maximum aantal knooppunten voor automatisch schalen

properties.maxPods

integer

Het maximum aantal pods dat op een knooppunt kan worden uitgevoerd.

properties.minCount

integer

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

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.
Beide patchversie <major.minor.patch> (bijvoorbeeld 1.20.13) en <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 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 bijwerkenvoor meer informatie.

properties.osDiskSizeGB

integer

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 kortstondige os-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 als OSType Windows is.

properties.osType

OSType

Linux

Het type besturingssysteem. De standaardwaarde is Linux.

properties.podSubnetID

string

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

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

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

Resourcetype

AgentPoolMode

De modus van een agentpool.

Name Type Description
System

string

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

string

Gebruikersagentgroepen zijn voornamelijk bedoeld voor het hosten van uw toepassingspods.

AgentPoolNetworkProfile

Netwerkinstellingen van een agentgroep.

Name Type Description
allowedHostPorts

PortRange[]

De poortbereiken waartoe toegang is toegestaan. De opgegeven bereiken mogen elkaar overlappen.

applicationSecurityGroups

string[]

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.

AgentPoolType

Het type agentgroep.

Name Type Description
AvailabilitySet

string

Het gebruik hiervan wordt sterk afgeraden.

VirtualMachineScaleSets

string

Maak een agentgroep die wordt ondersteund door een virtuele-machineschaalset.

AgentPoolUpgradeSettings

Instellingen voor het upgraden van een agentpool

Name Type Description
drainTimeoutInMinutes

integer

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 1. Zie voor meer informatie, inclusief aanbevolen procedures: https://docs.microsoft.com/azure/aks/upgrade-cluster#customize-node-surge-upgrade

nodeSoakDurationInMinutes

integer

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.

AgentPoolWindowsProfile

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

Een foutreactie van de Container-service.

Name Type Description
error

CloudErrorBody

Details over de fout.

CloudErrorBody

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

Hiermee wordt aangegeven of het cluster wordt uitgevoerd of gestopt

Name Type Description
Running

string

Het cluster wordt uitgevoerd.

Stopped

string

Het cluster is gestopt.

CreationData

Gegevens die worden gebruikt bij het maken van een doelresource op basis van een bronresource.

Name Type Description
sourceResourceId

string

Dit is de ARM-id van het bronobject dat moet worden gebruikt om het doelobject te maken.

GPUInstanceProfile

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

Name Type Description
MIG1g

string

MIG2g

string

MIG3g

string

MIG4g

string

MIG7g

string

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.

Name Type Description
allowedUnsafeSysctls

string[]

Toegestane lijst met onveilige sysctls of onveilige sysctl-patronen (eindigend op *).

containerLogMaxFiles

integer

Het maximum aantal containerlogboekbestanden dat aanwezig kan zijn voor een container. Het getal moet ≥ 2 zijn.

containerLogMaxSizeMB

integer

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 Kubernetes CPU-beheerbeleid 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

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

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

Het maximum aantal processen per pod.

topologyManagerPolicy

string

Het topologiebeheerbeleid dat moet worden gebruikt.
Zie Kubernetes Topology Managervoor 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.

Name Type Description
OS

string

Kubelet gebruikt de besturingssysteemschijf voor de gegevens.

Temporary

string

Kubelet gebruikt de tijdelijke schijf voor de gegevens.

LinuxOSConfig

Besturingssysteemconfiguraties van Linux-agentknooppunten.

Name Type Description
swapFileSizeMB

integer

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

OSDiskType

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

Name Type Description
Ephemeral

string

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

string

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

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 als OSType Windows is.

Name Type Description
AzureLinux

string

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

string

Afgeschafte OSSKU. Microsoft raadt aan dat nieuwe implementaties in plaats daarvan 'AzureLinux' kiezen.

Ubuntu

string

Gebruik Ubuntu als het besturingssysteem voor knooppuntinstallatiekopieën.

Windows2019

string

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

string

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

Het type besturingssysteem. De standaardwaarde is Linux.

Name Type Description
Linux

string

Gebruik Linux.

Windows

string

Windows gebruiken.

PortRange

Het poortbereik.

Name Type Description
portEnd

integer

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

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

Beschrijft de energiestatus van het cluster

Name Type Description
code

code

Hiermee wordt aangegeven of het cluster wordt uitgevoerd of gestopt

Protocol

Het netwerkprotocol van de poort.

Name Type Description
TCP

string

TCP-protocol.

UDP

string

UDP-protocol.

ScaleDownMode

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

Name Type Description
Deallocate

string

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

string

Maak nieuwe exemplaren tijdens het omhoog schalen en verwijderen van exemplaren tijdens omlaag schalen.

ScaleSetEvictionPolicy

Het verwijderingsbeleid voor virtuele-machineschaalsets.

Name Type Description
Deallocate

string

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

string

Knooppunten in de onderliggende schaalset van de knooppuntgroep worden verwijderd wanneer ze worden verwijderd.

ScaleSetPriority

De prioriteit van de virtuele-machineschaalset.

Name Type Description
Regular

string

Reguliere VM's worden gebruikt.

Spot

string

Vm's met spotprioriteit worden gebruikt. Er is geen SLA voor spot-knooppunten. Zie plek op AKS- voor meer informatie.

SysctlConfig

Sysctl-instellingen voor Linux-agentknooppunten.

Name Type Description
fsAioMaxNr

integer

Sysctl-instelling fs.aio-max-nr.

fsFileMax

integer

Sysctl setting fs.file-max.

fsInotifyMaxUserWatches

integer

Sysctl-instelling fs.inotify.max_user_watches.

fsNrOpen

integer

Sysctl-instelling fs.nr_open.

kernelThreadsMax

integer

Sysctl-instelling kernel.threads-max.

netCoreNetdevMaxBacklog

integer

Sysctl-instelling net.core.netdev_max_backlog.

netCoreOptmemMax

integer

Sysctl-instelling net.core.optmem_max.

netCoreRmemDefault

integer

Sysctl-instelling net.core.rmem_default.

netCoreRmemMax

integer

Sysctl-instelling net.core.rmem_max.

netCoreSomaxconn

integer

Sysctl setting net.core.somaxconn.

netCoreWmemDefault

integer

Sysctl-instelling net.core.wmem_default.

netCoreWmemMax

integer

Sysctl-instelling net.core.wmem_max.

netIpv4IpLocalPortRange

string

Sysctl-instelling net.ipv4.ip_local_port_range.

netIpv4NeighDefaultGcThresh1

integer

Sysctl-instelling net.ipv4.neigh.default.gc_thresh1.

netIpv4NeighDefaultGcThresh2

integer

Sysctl-instelling net.ipv4.neigh.default.gc_thresh2.

netIpv4NeighDefaultGcThresh3

integer

Sysctl-instelling net.ipv4.neigh.default.gc_thresh3.

netIpv4TcpFinTimeout

integer

Sysctl-instelling net.ipv4.tcp_fin_timeout.

netIpv4TcpKeepaliveProbes

integer

Sysctl-instelling net.ipv4.tcp_keepalive_probes.

netIpv4TcpKeepaliveTime

integer

Sysctl-instelling net.ipv4.tcp_keepalive_time.

netIpv4TcpMaxSynBacklog

integer

Sysctl-instelling net.ipv4.tcp_max_syn_backlog.

netIpv4TcpMaxTwBuckets

integer

Sysctl-instelling net.ipv4.tcp_max_tw_buckets.

netIpv4TcpTwReuse

boolean

Sysctl-instelling net.ipv4.tcp_tw_reuse.

netIpv4TcpkeepaliveIntvl

integer

Sysctl-instelling net.ipv4.tcp_keepalive_intvl.

netNetfilterNfConntrackBuckets

integer

Sysctl-instelling net.netfilter.nf_conntrack_buckets.

netNetfilterNfConntrackMax

integer

Sysctl-instelling net.netfilter.nf_conntrack_max.

vmMaxMapCount

integer

Sysctl-instelling vm.max_map_count.

vmSwappiness

integer

Sysctl-instelling vm.swappiness.

vmVfsCachePressure

integer

Sysctl-instelling vm.vfs_cache_pressure.

WorkloadRuntime

Bepaalt het type workload dat een knooppunt kan uitvoeren.

Name Type Description
OCIContainer

string

Knooppunten gebruiken Kubelet om standaard-OCI-containerworkloads uit te voeren.

WasmWasi

string

Knooppunten gebruiken Krustlet om WASM-workloads uit te voeren met behulp van de WASI-provider (preview).