Megosztás a következőn keresztül:


Agent Pools - List

Lekéri a megadott felügyelt fürt ügynökkészleteinek listáját.

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

URI-paraméterek

Name In Kötelező Típus Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

resourceName
path True

string

minLength: 1
maxLength: 63
pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$

A felügyelt fürterőforrás neve.

subscriptionId
path True

string (uuid)

A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.

api-version
query True

string

minLength: 1

A művelethez használandó API-verzió.

Válaszok

Name Típus Description
200 OK

AgentPoolListResult

OKÉ

Other Status Codes

CloudError

Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat

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

Hatókörök

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

Példák

List Agent Pools by Managed Cluster

Mintakérelem

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

Mintaválasz

{
  "value": [
    {
      "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",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "eTag": "ewnfuib"
      }
    }
  ]
}

Definíciók

Name Description
AgentPool

Ügynökkészlet.

AgentPoolGatewayProfile

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

AgentPoolListResult

A Listaügynökkészletek művelet válasza.

AgentPoolMode

Az ügynökkészlet módja.

AgentPoolNetworkProfile

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

AgentPoolSecurityProfile

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

AgentPoolStatus

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

AgentPoolType

Az ügynökkészlet típusa.

AgentPoolUpgradeSettings

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

AgentPoolWindowsProfile

A Windows-ügynökkészlet konkrét profilja.

CloudError

Hibaválasz a Container service-től.

CloudErrorBody

Hibaválasz a Container service-től.

code

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

CreationData

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

GPUDriver

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

GPUInstanceProfile

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

GPUProfile

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

IPTag

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

KubeletConfig

Az ügynökcsomópontok Kubelet-konfigurációi.

KubeletDiskType

Meghatározza az emptyDir-kötetek, a tároló futtatókörnyezeti adatgyökerének és a Kubelet rövid élettartamú tárolójának elhelyezését.

LinuxOSConfig

Linux-ügynökcsomópontok operációsrendszer-konfigurációi.

ManualScaleProfile

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

OSDiskType

Az ügynökkészletben lévő gépekhez használandó operációsrendszer-lemez típusa.

OSSKU

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

OSType

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

PodIPAllocationMode

Pod IP-foglalási módja

PortRange

A porttartomány.

PowerState

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

Protocol

A port hálózati protokollja.

ScaleDownMode

A virtuális gépek ügynökkészletekhez való hozzáadásának vagy eltávolításának módját ismerteti. Lásd a számlázási állapotokat.

ScaleProfile

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

ScaleSetEvictionPolicy

A virtuálisgép-méretezési csoport kizárási szabályzata.

ScaleSetPriority

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

SysctlConfig

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

UndrainableNodeBehavior

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

VirtualMachineNodes

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

VirtualMachinesProfile

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

WorkloadRuntime

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

AgentPool

Ügynökkészlet.

Name Típus Alapértelmezett érték Description
id

string

Erőforrás-azonosító.

name

string

Az erőforráscsoporton belül egyedi erőforrás neve. Ez a név használható az erőforrás eléréséhez.

properties.availabilityZones

string[]

A csomópontokhoz használandó rendelkezésre állási zónák listája. Ez csak akkor adható meg, ha az AgentPoolType tulajdonság "VirtualMachineScaleSets".

properties.capacityReservationGroupID

string (arm-id)

A kapacitásfoglalási csoport teljes erőforrás-azonosítója, amely virtuális gépeket biztosít a virtuális gépek fenntartott csoportjából.
Az AKS társítja a megadott ügynökkészletet a kapacitásfoglalási csoporttal.

properties.count

integer (int32)

A Docker-tárolók üzemeltetéséhez használt ügynökök (virtuális gépek) száma. Az engedélyezett értékeknek 0 és 1000 közötti tartományban kell lenniük (beleértve a felhasználói készleteket), a rendszerkészletek esetében pedig 1 és 1000 közötti tartományban (beleértve az értékeket). Az alapértelmezett érték 1.

properties.creationData

CreationData

A forrás pillanatkép-azonosítójának megadásához használandó CreationData, ha a csomópontkészletet pillanatkép használatával hozza létre vagy frissíti.

properties.currentOrchestratorVersion

string

Az ügynökkészlet kubernetes-verziója fut.
Ha az orchestratorVersion egy teljesen megadott verzió, <major.minor.patch>, ez a mező pontosan megegyezik vele. Ha az orchestratorVersion <major.minor>, ez a mező a teljes <major.minor.patch> használt verziót tartalmazza.

properties.eTag

string

Az optimista egyidejűség megvalósításához használt egyedi írásvédett sztring. Az eTag értéke az erőforrás frissítésekor megváltozik. Adjon meg egy if-match vagy if-none-match fejlécet az eTag értékkel egy későbbi kéréshez, amely lehetővé teszi az optimista egyidejűséget a normál etag-konvenciónként.

properties.enableAutoScaling

boolean

Az automatikus skálázás engedélyezése

properties.enableEncryptionAtHost

boolean

A gazdagépalapú operációs rendszer és az adatmeghajtó titkosításának engedélyezése.
Ez csak bizonyos virtuálisgép-méretekben és bizonyos Azure-régiókban támogatott. További információ: https://docs.microsoft.com/azure/aks/enable-host-encryption

properties.enableFIPS

boolean

FiPS-kompatibilis operációs rendszer használata.
További részletekért lásd: FIPS-kompatibilis csomópontkészlet hozzáadása .

properties.enableNodePublicIP

boolean

Azt jelzi, hogy minden csomópont saját nyilvános IP-címet kap-e.
Bizonyos esetekben előfordulhat, hogy a csomópontkészlet csomópontjai saját dedikált nyilvános IP-címeket kapnak. Gyakori forgatókönyv a játékterhelések esetében, ahol a konzolnak közvetlen kapcsolatot kell létesítenie egy felhőbeli virtuális géppel a ugrások minimalizálása érdekében. További információ: nyilvános IP-cím hozzárendelése csomópontonként. Az alapértelmezett érték hamis.

properties.enableUltraSSD

boolean

Az UltraSSD engedélyezése

properties.gatewayProfile

AgentPoolGatewayProfile

Egy felügyelt ügynökkészletre jellemző profil átjáró módban. Ez a mező nem állítható be, ha az ügynökkészlet üzemmódja nem átjáró.

properties.gpuInstanceProfile

GPUInstanceProfile

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

properties.gpuProfile

GPUProfile

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

properties.hostGroupID

string (arm-id)

A dedikált gazdagépcsoport teljes erőforrás-azonosítója, amelyből virtuális gépeket építhet ki, csak létrehozási forgatókönyvben használatos, és a beállítás után nem módosítható.
Ez a következő űrlapon érhető el: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. További információ: Dedikált Azure-gazdagépek.

properties.kubeletConfig

KubeletConfig

Az ügynökcsomópontok Kubelet-konfigurációi.
A Kubelet-konfiguráció az ügynökkészlet csomópontjain.

properties.kubeletDiskType

KubeletDiskType

Meghatározza az emptyDir-kötetek, a tároló futtatókörnyezeti adatgyökerének és a Kubelet rövid élettartamú tárolójának elhelyezését.

properties.linuxOSConfig

LinuxOSConfig

Linux-ügynökcsomópontok operációsrendszer-konfigurációi.
Linux-ügynökcsomópontok operációsrendszer-konfigurációja.

properties.maxCount

integer (int32)

Az automatikus skálázáshoz használható csomópontok maximális száma

properties.maxPods

integer (int32)

A csomóponton futtatható podok maximális száma.

properties.messageOfTheDay

string

A nap üzenete Linux-csomópontokhoz, base64 kódolású.
Egy base64 kódolású sztring, amely a dekódolás után a /etc/motd fájlba lesz írva. Ez lehetővé teszi a nap üzenetének testreszabását Linux-csomópontok esetében. Windows-csomópontokhoz nem adható meg. Statikus sztringnek kell lennie (azaz nyersen lesz kinyomtatva, és nem szkriptként lesz végrehajtva).

properties.minCount

integer (int32)

Az automatikus skálázáshoz szükséges csomópontok minimális száma

properties.mode

AgentPoolMode

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

properties.networkProfile

AgentPoolNetworkProfile

Egy ügynökkészlet hálózattal kapcsolatos beállításai.

properties.nodeImageVersion

string

A csomópont lemezképének verziója

properties.nodeLabels

object

Az ügynökkészlet összes csomópontjában megőrzendő csomópontfeliratok.

properties.nodePublicIPPrefixID

string (arm-id)

A nyilvános IP-előtag azonosítója, amelyből a virtuálisgép-csomópontoknak IP-címeket kell használniuk.
Ez az űrlap: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}

properties.nodeTaints

string[]

A csomópontkészlet létrehozása és skálázása során az új csomópontokhoz hozzáadott fertőzöttek. Például: key=value:NoSchedule.

properties.orchestratorVersion

string

A felhasználó által megadott Kubernetes-verzió.
Mind a javítás verziójú <major.minor.patch> (pl. 1.20.13) és <a major.minor> (pl. 1.20) támogatott. A major.minor< megadásakor >a rendszer automatikusan kiválasztja a legújabb támogatott GA-javításverziót. A fürt létrehozása után (például 1.14.x –< 1.14) a fürt ugyanazon >major.minor> verzióval való frissítése nem indítja el a frissítést, még akkor sem, ha egy újabb javításverzió érhető el. Ajánlott eljárásként frissítse az AKS-fürtök összes csomópontkészletét ugyanarra a Kubernetes-verzióra. A csomópontkészlet verziójának a vezérlősík főverziójával kell rendelkeznie. A csomópontkészlet alverziójának a vezérlősík két alverziójában kell lennie. A csomópontkészlet verziója nem lehet nagyobb, mint a vezérlősík verziója. További információ: csomópontkészlet frissítése.

properties.osDiskSizeGB

integer (int32)

minimum: 0
maximum: 2048

Az operációsrendszer-lemez mérete GB-ban a fő-/ügynökkészlet minden gépének lemezméretének megadására szolgál. Ha 0 értéket ad meg, az az alapértelmezett osDisk méretet alkalmazza a megadott vmSize szerint.

properties.osDiskType

OSDiskType

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

properties.osSKU

OSSKU

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

properties.osType

OSType

Linux

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

properties.podIPAllocationMode

PodIPAllocationMode

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

properties.podSubnetID

string (arm-id)

Annak az alhálózatnak az azonosítója, amelyhez a podok az indításkor csatlakoznak.
Ha nincs megadva, a pod IP-címek statikusan vannak hozzárendelve a csomópont alhálózatához (további részletekért lásd a vnetSubnetID azonosítót). Ez az űrlap: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

properties.powerState

PowerState

Azt jelzi, hogy az ügynökkészlet fut-e vagy le van-e állítva.
Az ügynökkészlet első létrehozásakor először fut. Az ügynökkészlet leállítható úgy, hogy ezt a mezőt Leállítva értékre állítja. A leállított ügynökkészlet leállítja az összes virtuális gépét, és nem számol fel számlázási díjakat. Az ügynökkészletek csak akkor állíthatók le, ha fut, és a kiépítési állapot sikeres

properties.provisioningState

string

Az aktuális üzembe helyezési vagy kiépítési állapot.

properties.proximityPlacementGroupID

string (arm-id)

A közelségi elhelyezési csoport azonosítója.

properties.scaleDownMode

ScaleDownMode

Az ügynökkészlet skálázásához használandó leskálázási mód.
Ez a fürt automatikus skálázási viselkedésére is hatással van. Ha nincs megadva, akkor alapértelmezés szerint a Delete érték lesz.

properties.scaleSetEvictionPolicy

ScaleSetEvictionPolicy

Delete

A használni kívánt virtuálisgép-méretezési csoport kizárási szabályzata.
Ez csak akkor adható meg, ha a scaleSetPriority "Spot". Ha nincs megadva, az alapértelmezett beállítás a "Törlés".

properties.scaleSetPriority

ScaleSetPriority

Regular

A virtuálisgép-méretezési csoport prioritása. Ha nincs megadva, az alapértelmezett érték a "Normál".

properties.securityProfile

AgentPoolSecurityProfile

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

properties.spotMaxPrice

number

-1

A maximális ár (amerikai dollárban), amit hajlandó fizetni az azonnali példányokért. A lehetséges értékek a nullánál nagyobb vagy -1 tizedesjegyek, amelyek azt jelzik, hogy az alapértelmezett ár igény szerint up-to.
A lehetséges értékek a nullánál nagyobb tizedesjegyek vagy -1, amelyek jelzik, hogy hajlandóak-e bármilyen igény szerinti árat fizetni. A kihasználatlan díjszabásról további információt a kihasználatlan virtuális gépek díjszabásában talál

properties.status

AgentPoolStatus

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

properties.tags

object

Az ügynökkészlet virtuálisgép-méretezési csoportjában megőrizendő címkék.

properties.type

AgentPoolType

Az ügynökkészlet típusa.

properties.upgradeSettings

AgentPoolUpgradeSettings

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

properties.virtualMachineNodesStatus

VirtualMachineNodes[]

A VirtualMachines-ügynökkészlet csomópontjainak állapota.

properties.virtualMachinesProfile

VirtualMachinesProfile

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

properties.vmSize

string

Az ügynökkészlet virtuális gépeinek mérete.
A virtuális gép mérete régiónként eltérő. Ha egy csomópont nem tartalmaz elegendő számítási erőforrást (memóriát, processzort stb.), előfordulhat, hogy a podok nem futnak megfelelően. A korlátozott virtuálisgép-méretekkel kapcsolatos további részletekért lásd: https://docs.microsoft.com/azure/aks/quotas-skus-regions

properties.vnetSubnetID

string (arm-id)

Annak az alhálózatnak az azonosítója, amelyhez az ügynökkészlet csomópontjai és opcionálisan podok csatlakoznak indításkor.
Ha ez nincs megadva, a rendszer létrehoz és használ egy virtuális hálózatot és alhálózatot. Ha nincs megadva podSubnetID, ez a csomópontokra és podokra vonatkozik, ellenkező esetben csak a csomópontokra vonatkozik. Ez az űrlap: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

properties.windowsProfile

AgentPoolWindowsProfile

A Windows-ügynökkészlet konkrét profilja.

properties.workloadRuntime

WorkloadRuntime

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

type

string

Erőforrás típusa

AgentPoolGatewayProfile

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

Name Típus Alapértelmezett érték Description
publicIPPrefixSize

integer (int32)

minimum: 28
maximum: 31
31

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

AgentPoolListResult

A Listaügynökkészletek művelet válasza.

Name Típus Description
nextLink

string

Az ügynökkészlet következő eredményeinek lekéréséhez tartozó URL-cím.

value

AgentPool[]

Az ügynökkészletek listája.

AgentPoolMode

Az ügynökkészlet módja.

Érték Description
Gateway

Az átjáróügynök-készletek statikus kimenő IP-címeket biztosítanak a podokhoz. További részletekért lásd: https://aka.ms/aks/static-egress-gateway.

System

A rendszerügynök-készletek elsősorban olyan kritikus rendszer podok üzemeltetésére szolgálnak, mint a CoreDNS és a metrics-server. A rendszerügynök-készletek osType-nak Linuxnak kell lenniük. A rendszerügynök-készletek virtuálisgép-termékváltozatának legalább 2vCPU-val és 4 GB memóriával kell rendelkeznie.

User

A felhasználói ügynökkészletek elsősorban az alkalmazás podok üzemeltetésére használhatók.

AgentPoolNetworkProfile

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

Name Típus Description
allowedHostPorts

PortRange[]

A hozzáférésre jogosult porttartományok. A megadott tartományok átfedésben lehetnek.

applicationSecurityGroups

string[] (arm-id)

Azon alkalmazásbiztonsági csoportok azonosítói, amelyeket az ügynökkészlet társít a létrehozáskor.

nodePublicIPTags

IPTag[]

Példányszintű nyilvános IP-címek IP-címei.

AgentPoolSecurityProfile

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

Name Típus Description
enableSecureBoot

boolean

A biztonságos rendszerindítás a megbízható indítás egyik funkciója, amely biztosítja, hogy csak aláírt operációs rendszerek és illesztőprogramok indulhatnak el. További részletekért lásd: aka.ms/aks/trustedlaunch. Ha nincs megadva, az alapértelmezett érték hamis.

enableVTPM

boolean

A vTPM egy megbízható indítási funkció egy dedikált biztonságos tároló konfigurálásához a csomóponton helyben tárolt kulcsokhoz és mérésekhez. További részletekért lásd: aka.ms/aks/trustedlaunch. Ha nincs megadva, az alapértelmezett érték hamis.

AgentPoolStatus

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

Name Típus Description
provisioningError

CloudErrorBody

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

AgentPoolType

Az ügynökkészlet típusa.

Érték Description
AvailabilitySet

Ennek használata erősen elriasztja.

VirtualMachineScaleSets

Hozzon létre egy virtuálisgép-méretezési csoport által támogatott ügynökkészletet.

VirtualMachines

Hozzon létre egy ügynökkészletet egyetlen példányos virtuálisgép-vezénylési móddal.

AgentPoolUpgradeSettings

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

Name Típus Description
drainTimeoutInMinutes

integer (int32)

minimum: 1
maximum: 1440

A csomópont ürítési időtúllépése
A podok kiürítésére és a csomópontonkénti kecses befejezésre váró idő (percekben). Ez a kilakoltatási várakozási idő a podkimaradási költségvetésekre vár. Ha ezt az időt túllépi, a frissítés meghiúsul. Ha nincs megadva, az alapértelmezett érték 30 perc.

maxSurge

string

A frissítés során megugrott csomópontok maximális száma vagy százalékos aránya.
Ez vagy egész számra (például '5') vagy százalékra (például '50%' lehet beállítva). Ha egy százalék meg van adva, az az ügynökkészlet teljes méretének százalékos aránya a frissítés időpontjában. Százalékértékek esetén a tört csomópontok fel vannak kerekítve. Ha nincs megadva, az alapértelmezett érték 10%. További információk, beleértve az ajánlott eljárásokat, lásd: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster

maxUnavailable

string

A frissítés során egyidejűleg elérhetetlen csomópontok maximális száma vagy százalékos aránya.
Ez vagy egész számra (például '1') vagy százalékra (pl. '5%') állítható be. Ha egy százalék meg van adva, az az ügynökkészlet teljes méretének százalékos aránya a frissítés időpontjában. Százalékértékek esetén a tört csomópontok fel vannak kerekítve. Ha nincs megadva, az alapértelmezett érték 0. További információk, beleértve az ajánlott eljárásokat, lásd: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster

nodeSoakDurationInMinutes

integer (int32)

minimum: 0
maximum: 30

A csomópont áztatási időtartama
A csomópont kiürítése és újraimálása és a következő csomópontra való áttérés után várakozási idő (percek alatt). Ha nincs megadva, az alapértelmezett érték 0 perc.

undrainableNodeBehavior

UndrainableNodeBehavior

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

AgentPoolWindowsProfile

A Windows-ügynökkészlet konkrét profilja.

Name Típus Description
disableOutboundNat

boolean

Az OutboundNAT letiltása Windows-csomópontokban
Az alapértelmezett érték hamis. A kimenő NAT csak akkor tiltható le, ha a fürt kimenő típusa NAT-átjáró, és a Windows-ügynökkészletben nincs engedélyezve a csomópont nyilvános IP-címe.

CloudError

Hibaválasz a Container service-től.

Name Típus Description
error

CloudErrorBody

A hibával kapcsolatos részletek.

CloudErrorBody

Hibaválasz a Container service-től.

Name Típus Description
code

string

A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.

details

CloudErrorBody[]

A hiba további részleteinek listája.

message

string

A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.

target

string

Az adott hiba célja. Például a tulajdonság neve hibás.

code

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

Érték Description
Running

A fürt fut.

Stopped

A fürt leállt.

CreationData

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

Name Típus Description
sourceResourceId

string (arm-id)

Ez a célobjektum létrehozásához használandó forrásobjektum ARM-azonosítója.

GPUDriver

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

Érték Description
Install

Telepítse az illesztőprogramot.

None

Az illesztőprogram telepítésének kihagyása.

GPUInstanceProfile

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

Érték Description
MIG1g
MIG2g
MIG3g
MIG4g
MIG7g

GPUProfile

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

Name Típus Description
driver

GPUDriver

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

IPTag

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

Name Típus Description
ipTagType

string

Az IP-címke típusa. Példa: RoutingPreference.

tag

string

A nyilvános IP-címhez társított IP-címke értéke. Példa: Internet.

KubeletConfig

Az ügynökcsomópontok Kubelet-konfigurációi.

Name Típus Description
allowedUnsafeSysctls

string[]

A nem biztonságos sysctls- vagy nem biztonságos sysctl-minták engedélyezett listája (végződés: *).

containerLogMaxFiles

integer (int32)

minimum: 2

A tárolóhoz megjeleníthető tároló naplófájljainak maximális száma. A számnak 2 ≥ kell lennie.

containerLogMaxSizeMB

integer (int32)

A tároló naplófájljának maximális mérete (pl. 10Mi) forgatás előtt.

cpuCfsQuota

boolean

Ha a CPU CFS-kvóta kikényszerítése engedélyezve van a CPU-korlátokat meghatározó tárolók esetében.
Az alapértelmezett érték igaz.

cpuCfsQuotaPeriod

string

A CPU CFS kvótaidőszakának értéke.
Az alapértelmezett érték a "100 ms". Az érvényes értékek decimális számok sorozatai, amelyek nem kötelező törtrészt és egység utótagot tartalmaznak. Például: "300ms", "2h45m". A támogatott egységek a következők: "ns", "us", "ms", "s", "m", és "h".

cpuManagerPolicy

string

A használni kívánt CPU Manager-szabályzat.
Az alapértelmezett érték a "nincs". További információkért tekintse meg a Kubernetes CPU-kezelési szabályzatát . Az engedélyezett értékek "nincs" és "statikusak".

failSwapOn

boolean

Ha igaz értékre van állítva, a Kubelet nem indul el, ha a felcserélés engedélyezve van a csomóponton.

imageGcHighThreshold

integer (int32)

A lemezhasználat százalékos aránya, amely után a rendszerkép szemétgyűjtése mindig fut.
A kép szemétgyűjtésének letiltásához állítsa be a 100 értéket. Az alapértelmezett érték 85%

imageGcLowThreshold

integer (int32)

A lemezhasználat azon százaléka, amely előtt a rendszerkép szemétgyűjtése soha nem fut.
Ez nem állítható be magasabbra az imageGcHighThreshold értéknél. Az alapértelmezett érték 80%

podMaxPids

integer (int32)

A podonkénti folyamatok maximális száma.

topologyManagerPolicy

string

A használni kívánt Topology Manager-szabályzat.
További információ: Kubernetes Topology Manager. Az alapértelmezett érték a "nincs". Az engedélyezett értékek a következők: "none", "best-effort", "restricted" és "single-numa-node".

KubeletDiskType

Meghatározza az emptyDir-kötetek, a tároló futtatókörnyezeti adatgyökerének és a Kubelet rövid élettartamú tárolójának elhelyezését.

Érték Description
OS

A Kubelet az operációsrendszer-lemezt fogja használni az adataihoz.

Temporary

A Kubelet az ideiglenes lemezt fogja használni az adataihoz.

LinuxOSConfig

Linux-ügynökcsomópontok operációsrendszer-konfigurációi.

Name Típus Description
swapFileSizeMB

integer (int32)

Az egyes csomópontokon létrehozandó felcserélési fájl MB-ban megadott mérete.

sysctls

SysctlConfig

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

transparentHugePageDefrag

string

Azt jelzi, hogy a kernelnek agresszíven kell-e használnia a memóriatömörülést, hogy nagyobb méretű lapokat tegyen elérhetővé.
Az érvényes értékek a következők: "always", "halasztás", "halasztás+madvise", "madvise" és "never". Az alapértelmezett érték a "madvise". További információ: Transzparens hatalmas lapok.

transparentHugePageEnabled

string

Azt jelzi, hogy engedélyezve vannak-e a transzparens hatalmas lapok.
Az érvényes értékek a következők: "always", "madvise", és "never". Az alapértelmezett érték a "always". További információ: Transzparens hatalmas lapok.

ManualScaleProfile

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

Name Típus Description
count

integer (int32)

Csomópontok száma.

size

string

Az AKS által a létrehozáskor és skálázáskor használt virtuálisgép-méret, például "Standard_E4s_v3", "Standard_E16s_v3" vagy "Standard_D16s_v5".

OSDiskType

Az ügynökkészletben lévő gépekhez használandó operációsrendszer-lemez típusa.

Érték Description
Ephemeral

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

Managed

Az Azure replikálja egy virtuális gép operációsrendszer-lemezét az Azure Storage-ba az adatvesztés elkerülése érdekében, ha a virtuális gépet át kell helyezni egy másik gazdagépre. Mivel a tárolók nem úgy vannak kialakítva, hogy a helyi állapot megmaradjon, ez a viselkedés korlátozott értéket kínál, ugyanakkor hátrányokat is biztosít, beleértve a lassabb csomópontkiépítést és a nagyobb olvasási/írási késést.

OSSKU

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

Érték Description
AzureLinux

Használja az AzureLinuxot operációs rendszerként a csomópontrendszerképekhez. Az Azure Linux a Microsoft által készített tárolóoptimalizált Linux-disztribúció, további információért látogasson el https://aka.ms/azurelinux.

CBLMariner

Elavult OSSKU. A Microsoft azt javasolja, hogy az új üzemelő példányok inkább az "AzureLinux" lehetőséget válasszák.

Ubuntu

Csomópontképekhez használja az Ubuntu operációs rendszert.

Ubuntu2204

Használja az Ubuntu2204-et a csomópont-rendszerképek operációs rendszereként, azonban előfordulhat, hogy az Ubuntu 22.04 nem támogatott minden csomópontkészlethez. A korlátozásokat és a támogatott Kubernetes-verziókat lásd: https://aka.ms/aks/supported-ubuntu-versions

Windows2019

Használja a Windows2019-et operációs rendszerként csomópontlemezképekhez. A rendszercsomópont-készletek nem támogatottak. A Windows2019 csak a Windows2019-tárolókat támogatja; Nem futtathat Windows2022-tárolókat, és fordítva.

Windows2022

Használja a Windows2022 rendszert a csomópontlemezképek operációs rendszereként. A rendszercsomópont-készletek nem támogatottak. A Windows2022 csak a Windows2022-tárolókat támogatja; Nem futtathat Windows2019-tárolókat, és fordítva.

OSType

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

Érték Description
Linux

Linux használata.

Windows

Használja a Windowst.

PodIPAllocationMode

Pod IP-foglalási módja

Érték Description
DynamicIndividual

Minden csomópont a hüvelyekhez rendelhető IP-címek nem összefüggő listájával lesz lefoglalva. Ez jobb egy kis és közepes méretű /16 vagy kisebb alhálózat maximalizálásához. A dinamikus IP-címfoglalást tartalmazó Azure CNI-fürt alapértelmezés szerint erre a módra vonatkozik, ha az ügyfél nem ad meg explicit módon podIPAllocationMode-t

StaticBlock

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

PortRange

A porttartomány.

Name Típus Description
portEnd

integer (int32)

minimum: 1
maximum: 65535

A tartományhoz tartozó maximális port. 1 és 65535 között kell lennie, és nagyobbnak vagy egyenlőnek kell lennie a portStart értékénél.

portStart

integer (int32)

minimum: 1
maximum: 65535

A tartományba tartozó minimális port. A tartománynak 1 és 65535 között kell lennie, és kisebbnek vagy egyenlőnek kell lennie a portEnd értékénél.

protocol

Protocol

A port hálózati protokollja.

PowerState

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

Name Típus Description
code

code

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

Protocol

A port hálózati protokollja.

Érték Description
TCP

TCP protokoll.

UDP

UDP protokoll.

ScaleDownMode

A virtuális gépek ügynökkészletekhez való hozzáadásának vagy eltávolításának módját ismerteti. Lásd a számlázási állapotokat.

Érték Description
Deallocate

Megkísérli elindítani a felszabadított példányokat (ha léteznek) a vertikális felskálázás és a példányok felszabadítása során a leskálázás során.

Delete

Hozzon létre új példányokat a vertikális felskálázás során, és távolítsa el a példányokat a leskálázás során.

ScaleProfile

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

Name Típus Description
manual

ManualScaleProfile[]

A VirtualMachines-ügynökkészlet rögzített méretre történő skálázásának specifikációi.

ScaleSetEvictionPolicy

A virtuálisgép-méretezési csoport kizárási szabályzata.

Érték Description
Deallocate

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

Delete

A csomópontkészlet mögöttes méretezési csoportjában lévő csomópontok törlődnek, amikor kiürítik őket.

ScaleSetPriority

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

Érték Description
Regular

A rendszer normál virtuális gépeket használ.

Spot

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

SysctlConfig

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

Name Típus Description
fsAioMaxNr

integer (int32)

Sysctl-beállítás fs.aio-max-nr.

fsFileMax

integer (int32)

Sysctl-beállítás fs.file-max.

fsInotifyMaxUserWatches

integer (int32)

Sysctl-beállítás fs.inotify.max_user_watches.

fsNrOpen

integer (int32)

Sysctl-beállítás fs.nr_open.

kernelThreadsMax

integer (int32)

Sysctl beállítás kernel.threads-max.

netCoreNetdevMaxBacklog

integer (int32)

Sysctl-beállítás net.core.netdev_max_backlog.

netCoreOptmemMax

integer (int32)

Sysctl-beállítás net.core.optmem_max.

netCoreRmemDefault

integer (int32)

Sysctl-beállítás net.core.rmem_default.

netCoreRmemMax

integer (int32)

Sysctl-beállítás net.core.rmem_max.

netCoreSomaxconn

integer (int32)

Sysctl-beállítás net.core.somaxconn.

netCoreWmemDefault

integer (int32)

Sysctl-beállítás net.core.wmem_default.

netCoreWmemMax

integer (int32)

Sysctl-beállítás net.core.wmem_max.

netIpv4IpLocalPortRange

string

Sysctl-beállítás net.ipv4.ip_local_port_range.

netIpv4NeighDefaultGcThresh1

integer (int32)

Sysctl-beállítás net.ipv4.neigh.default.gc_thresh1.

netIpv4NeighDefaultGcThresh2

integer (int32)

Sysctl-beállítás net.ipv4.neigh.default.gc_thresh2.

netIpv4NeighDefaultGcThresh3

integer (int32)

Sysctl-beállítás net.ipv4.neigh.default.gc_thresh3.

netIpv4TcpFinTimeout

integer (int32)

Sysctl-beállítás net.ipv4.tcp_fin_timeout.

netIpv4TcpKeepaliveProbes

integer (int32)

Sysctl-beállítás net.ipv4.tcp_keepalive_probes.

netIpv4TcpKeepaliveTime

integer (int32)

Sysctl-beállítás net.ipv4.tcp_keepalive_time.

netIpv4TcpMaxSynBacklog

integer (int32)

Sysctl-beállítás net.ipv4.tcp_max_syn_backlog.

netIpv4TcpMaxTwBuckets

integer (int32)

Sysctl-beállítás net.ipv4.tcp_max_tw_buckets.

netIpv4TcpTwReuse

boolean

Sysctl-beállítás net.ipv4.tcp_tw_reuse.

netIpv4TcpkeepaliveIntvl

integer (int32)

minimum: 10
maximum: 90

Sysctl-beállítás net.ipv4.tcp_keepalive_intvl.

netNetfilterNfConntrackBuckets

integer (int32)

minimum: 65536
maximum: 524288

Sysctl-beállítás net.netfilter.nf_conntrack_buckets.

netNetfilterNfConntrackMax

integer (int32)

minimum: 131072
maximum: 2097152

Sysctl-beállítás net.netfilter.nf_conntrack_max.

vmMaxMapCount

integer (int32)

Sysctl-beállítás vm.max_map_count.

vmSwappiness

integer (int32)

Sysctl-beállítás vm.swappiness.

vmVfsCachePressure

integer (int32)

Sysctl-beállítás vm.vfs_cache_pressure.

UndrainableNodeBehavior

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

Érték Description
Cordon

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

Schedule

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

VirtualMachineNodes

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

Name Típus Description
count

integer (int32)

Csomópontok száma.

size

string

A csomópontcsoport üzemeltetéséhez használt ügynökök virtuálisgép-mérete.

VirtualMachinesProfile

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

Name Típus Description
scale

ScaleProfile

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

WorkloadRuntime

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

Érték Description
OCIContainer

A csomópontok a Kubelet használatával futtatják a standard OCI-tároló számítási feladatait.

WasmWasi

A csomópontok a Krustlet használatával futtatják a WASM-számítási feladatokat a WASI-szolgáltató (előzetes verzió) használatával.