Sdílet prostřednictvím

Agent Pools - Create Or Update

  • Reference
Služba:
AKS
Verze rozhraní API:
2024-09-01

Vytvoří nebo aktualizuje fond agentů v zadaném spravovaném clusteru.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
agentPoolName
 path True

string

Název fondu agentů.

Vzor regulárního výrazu: ^[a-z][a-z0-9]{0,11}$
resourceGroupName
 path True

string

Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
resourceName
 path True

string

Název prostředku spravovaného clusteru.

Vzor regulárního výrazu: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$
subscriptionId
 path True

string

uuid

ID cílového předplatného. Hodnota musí být UUID.
api-version
 query True

string

Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Name Vyžadováno Typ Description
If-Match

string

Požadavek by měl pokračovat pouze v případě, že entita odpovídá tomuto řetězci.
If-None-Match

string

Požadavek by měl pokračovat pouze v případě, že žádná entita neodpovídá tomuto řetězci.

Text požadavku

Name Typ Description
properties.availabilityZones

string[]

Seznam zón dostupnosti, které se mají použít pro uzly. Tuto vlastnost lze zadat pouze v případě, že vlastnost AgentPoolType je VirtualMachineScaleSets.
properties.capacityReservationGroupID

string

Plně kvalifikované ID prostředku skupiny rezervací kapacity pro poskytování virtuálních počítačů z rezervované skupiny virtuálních počítačů.
AKS přidruží zadaný fond agentů ke skupině rezervace kapacity.
properties.count

integer

Počet agentů (virtuálních počítačů) pro hostování kontejnerů Dockeru Povolené hodnoty musí být v rozsahu od 0 do 1 000 (včetně) pro fondy uživatelů a v rozsahu od 1 do 1 000 (včetně) pro systémové fondy. Výchozí hodnota je 1.
properties.creationData

CreationData

CreationData, která se použije k určení ID zdrojového snímku, pokud se fond uzlů vytvoří nebo upgraduje pomocí snímku.
properties.enableAutoScaling

boolean

Povolení automatického škálování
properties.enableEncryptionAtHost

boolean

Jestli chcete povolit šifrování operačního systému založeného na hostiteli a datové jednotky.
To se podporuje jenom u určitých velikostí virtuálních počítačů a v určitých oblastech Azure. Další informace najdete v tématu: https://docs.microsoft.com/azure/aks/enable-host-encryption
properties.enableFIPS

boolean

Určuje, jestli se má použít operační systém s podporou FIPS.
Další podrobnosti najdete v tématu Přidání fondu uzlů s podporou FIPS.
properties.enableNodePublicIP

boolean

Určuje, jestli je každému uzlu přidělena vlastní veřejná IP adresa.
Některé scénáře můžou vyžadovat, aby uzly ve fondu uzlů přijímaly vlastní vyhrazené veřejné IP adresy. Běžným scénářem jsou úlohy hraní her, kdy konzola potřebuje vytvořit přímé připojení ke cloudovému virtuálnímu počítači, aby se minimalizovaly segmenty směrování. Další informace najdete v tématu přiřazení veřejné IP adresy na uzel. Výchozí hodnota je false.
properties.enableUltraSSD

boolean

Zda povolit UltraSSD
properties.gpuInstanceProfile

GPUInstanceProfile

GPUInstanceProfile, který se má použít k určení profilu instance GPU MIG pro podporovanou skladovou položku virtuálního počítače GPU.
properties.hostGroupID

string

Plně kvalifikované ID prostředku vyhrazené skupiny hostitelů pro zřizování virtuálních počítačů, které se používají pouze ve scénáři vytváření, a ne povolené změny po nastavení.
Toto je formulář: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Další informace najdete v tématu vyhrazených hostitelů Azure.
properties.kubeletConfig

KubeletConfig

Konfigurace kubeletu uzlů agenta
Konfigurace Kubeletu na uzlech fondu agentů.
properties.kubeletDiskType

KubeletDiskType

Určuje umístění prázdných svazkůDir, kořen dat modulu runtime kontejneru a dočasné úložiště Kubelet.
properties.linuxOSConfig

LinuxOSConfig

Konfigurace operačního systému uzlů agenta Linuxu
Konfigurace operačního systému uzlů agenta Linuxu.
properties.maxCount

integer

Maximální počet uzlů pro automatické škálování
properties.maxPods

integer

Maximální počet podů, které se dají spustit na uzlu.
properties.minCount

integer

Minimální počet uzlů pro automatické škálování
properties.mode

AgentPoolMode

Režim fondu agentů.
Cluster musí mít vždy alespoň jeden fond agentů systému. Další informace o omezeních fondu agentů a osvědčených postupech najdete v tématu: https://docs.microsoft.com/azure/aks/use-system-pools
properties.networkProfile

AgentPoolNetworkProfile

Nastavení fondu agentů souvisejících se sítí
properties.nodeLabels

object

Popisky uzlů, které se mají uchovávat ve všech uzlech ve fondu agentů.
properties.nodePublicIPPrefixID

string

ID předpony veřejné IP adresy, ze kterých mají uzly virtuálních počítačů používat IP adresy.
Toto je formulář: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
properties.nodeTaints

string[]

Tainty přidané do nových uzlů během vytváření a škálování fondu uzlů Například key=value:NoSchedule.
properties.orchestratorVersion

string

Verze Kubernetes určená uživatelem
Podporují se obě verze opravy <major.minor.patch> (např. 1.20.13) a <major.minor> (např. 1.20). Při <major.minor> je zvolena nejnovější podporovaná verze opravy GA automaticky. Aktualizace clusteru se stejným <major.minor> po vytvoření (např. 1.14.x –> 1.14) neaktivuje upgrade, i když je k dispozici novější verze opravy. Osvědčeným postupem je upgradovat všechny fondy uzlů v clusteru AKS na stejnou verzi Kubernetes. Verze fondu uzlů musí mít stejnou hlavní verzi jako řídicí rovina. Podverze fondu uzlů musí být ve dvou podverzi verze řídicí roviny. Verze fondu uzlů nemůže být větší než verze řídicí roviny. Další informace najdete v tématu upgradu fondu uzlů.
properties.osDiskSizeGB

integer

Velikost disku operačního systému v GB, která se má použít k určení velikosti disku pro každý počítač v hlavním fondu nebo fondu agentů. Pokud zadáte hodnotu 0, použije se výchozí velikost disku osDisk podle zadané hodnoty vmSize.
properties.osDiskType

OSDiskType

Typ disku s operačním systémem, který se má použít pro počítače ve fondu agentů.
Výchozí hodnota je dočasný, pokud virtuální počítač podporuje a má disk mezipaměti větší než požadovaný disk OSDiskSizeGB. V opačném případě se ve výchozím nastavení nastaví spravovaný. Po vytvoření se nemusí změnit. Další informace naleznete v tématu dočasný operační systém.
properties.osSKU

OSSKU

Určuje skladovou položku operačního systému používanou fondem agentů. Výchozí hodnota je Ubuntu, pokud je OSType Linux. Výchozí hodnota je Windows2019, když Kubernetes <= 1.24 nebo Windows2022, když Kubernetes >= 1.25, pokud je OSType Windows.
properties.osType

OSType

Typ operačního systému. Výchozí hodnota je Linux.
properties.podSubnetID

string

ID podsítě, ke které se pody připojí při spuštění.
Pokud tento parametr vynecháte, IP adresy podů se staticky přiřazují v podsíti uzlu (další podrobnosti najdete v tématu vnetSubnetID). Toto je formulář: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.powerState

PowerState

Bez ohledu na to, jestli je fond agentů spuštěný nebo zastavený.
Při prvním vytvoření fondu agentů je spuštěný. Fond agentů lze zastavit nastavením tohoto pole na Zastaveno. Zastavený fond agentů zastaví všechny své virtuální počítače a nenabíhá poplatky za fakturaci. Fond agentů lze zastavit pouze v případě, že je spuštěný a stav zřizování je úspěšný.
properties.proximityPlacementGroupID

string

ID skupiny umístění bezkontaktní komunikace.
properties.scaleDownMode

ScaleDownMode

Režim vertikálního snížení kapacity, který se použije při škálování fondu agentů.
To také ovlivňuje chování automatického škálování clusteru. Pokud není zadáno, ve výchozím nastavení se odstraní.
properties.scaleSetEvictionPolicy

ScaleSetEvictionPolicy

Zásady vyřazení škálovací sady virtuálních počítačů, které se mají použít.
Tuto hodnotu nelze zadat, pokud není scaleSetPriority spot. Pokud není zadáno, výchozí hodnota je Odstranit.
properties.scaleSetPriority

ScaleSetPriority

Priorita škálovací sady virtuálních počítačů Pokud není zadáno, výchozí hodnota je Normální.
properties.securityProfile

AgentPoolSecurityProfile

Nastavení zabezpečení fondu agentů.
properties.spotMaxPrice

number

Maximální cena (v amerických dolarech) jste ochotni zaplatit za spotové instance. Možné hodnoty jsou desetinná hodnota větší než nula nebo -1 označující výchozí cenu, která má být up-to na vyžádání.
Možné hodnoty jsou desetinná hodnota větší než nula nebo -1, což značí ochotu zaplatit jakoukoli cenu na vyžádání. Další podrobnosti o spotových cenách najdete v tématu cenových spotových virtuálních počítačů.
properties.tags

object

Značky, které se mají uchovávat ve škálovací sadě virtuálních počítačů fondu agentů.
properties.type

AgentPoolType

Typ fondu agentů.
properties.upgradeSettings

AgentPoolUpgradeSettings

Nastavení pro upgrade fondu agentů
properties.vmSize

string

Velikost virtuálních počítačů fondu agentů.
Dostupnost velikosti virtuálního počítače se liší podle oblasti. Pokud uzel obsahuje nedostatečné výpočetní prostředky (paměť, procesor atd.), nemusí se pody správně spustit. Další podrobnosti o omezených velikostech virtuálních počítačů najdete v tématu: https://docs.microsoft.com/azure/aks/quotas-skus-regions
properties.vnetSubnetID

string

ID podsítě, ke které se uzly fondu agentů a volitelně pody připojí při spuštění.
Pokud tento parametr nezadáte, vygeneruje a použije se virtuální síť a podsíť. Pokud není zadán žádný podSubnetID, platí to pro uzly a pody, jinak se vztahuje pouze na uzly. Toto je formulář: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.windowsProfile

AgentPoolWindowsProfile

Profil konkrétního fondu agentů Windows.
properties.workloadRuntime

WorkloadRuntime

Určuje typ úlohy, který může uzel spustit.

Odpovědi

Name Typ Description
200 OK

AgentPool

Existující fond agentů byl úspěšně aktualizován.
201 Created

AgentPool

Nový fond agentů byl úspěšně vytvořen.
Other Status Codes

CloudError

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

Create Agent Pool using an agent pool snapshot
Create Agent Pool with Capacity Reservation Group
Create Agent Pool with Dedicated Host Group
Create Agent Pool with EncryptionAtHost enabled
Create Agent Pool with Ephemeral OS Disk
Create Agent Pool with FIPS enabled OS
Create Agent Pool with GPUMIG
Create Agent Pool with Krustlet and the WASI runtime
Create Agent Pool with KubeletConfig and LinuxOSConfig
Create Agent Pool with OSSKU
Create Agent Pool with PPG
Create Agent Pool with UltraSSD enabled
Create Agent Pool with Windows OSSKU
Create Spot Agent Pool
Create Windows Agent Pool with disabling OutboundNAT
Create/Update Agent Pool
Start Agent Pool
Stop Agent Pool
Update Agent Pool

Create Agent Pool using an agent pool snapshot

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "enableFIPS": true,
    "creationData": {
      "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
    }
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.19.6",
    "currentOrchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableFIPS": true,
    "creationData": {
      "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
    }
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.19.6",
    "currentOrchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableFIPS": true,
    "creationData": {
      "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
    }
  }
}

Create Agent Pool with Capacity Reservation Group

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1"
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1"
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/CapacityReservationGroups/crg1"
  }
}

Create Agent Pool with Dedicated Host Group

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"
  }
}

Create Agent Pool with EncryptionAtHost enabled

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "enableEncryptionAtHost": true
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.13",
    "currentOrchestratorVersion": "1.17.13",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableEncryptionAtHost": true
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.13",
    "currentOrchestratorVersion": "1.17.13",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableEncryptionAtHost": true
  }
}

Create Agent Pool with Ephemeral OS Disk

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "osDiskType": "Ephemeral",
    "osDiskSizeGB": 64
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osDiskType": "Ephemeral",
    "osDiskSizeGB": 64
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osDiskType": "Ephemeral",
    "kubeletDiskType": "OS",
    "osDiskSizeGB": 64
  }
}

Create Agent Pool with FIPS enabled OS

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "enableFIPS": true
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.19.6",
    "currentOrchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableFIPS": true
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.19.6",
    "currentOrchestratorVersion": "1.19.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableFIPS": true
  }
}

Create Agent Pool with GPUMIG

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_ND96asr_v4",
    "osType": "Linux",
    "gpuInstanceProfile": "MIG2g",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_ND96asr_v4",
    "maxPods": 110,
    "osType": "Linux",
    "gpuInstanceProfile": "MIG2g",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_ND96asr_v4",
    "maxPods": 110,
    "osType": "Linux",
    "gpuInstanceProfile": "MIG2g",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false,
      "podMaxPids": 100
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 65536,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Create Agent Pool with Krustlet and the WASI runtime

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "osDiskSizeGB": 64,
    "mode": "User",
    "workloadRuntime": "WasmWasi"
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osDiskSizeGB": 64,
    "mode": "User",
    "workloadRuntime": "WasmWasi"
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osDiskSizeGB": 64,
    "mode": "User",
    "workloadRuntime": "WasmWasi"
  }
}

Create Agent Pool with KubeletConfig and LinuxOSConfig

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false,
      "podMaxPids": 100
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 65536,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Create Agent Pool with OSSKU

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "osSKU": "AzureLinux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osSKU": "AzureLinux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 12345,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.8",
    "currentOrchestratorVersion": "1.17.8",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "osSKU": "AzureLinux",
    "kubeletConfig": {
      "cpuManagerPolicy": "static",
      "cpuCfsQuota": true,
      "cpuCfsQuotaPeriod": "200ms",
      "imageGcHighThreshold": 90,
      "imageGcLowThreshold": 70,
      "topologyManagerPolicy": "best-effort",
      "allowedUnsafeSysctls": [
        "kernel.msg*",
        "net.core.somaxconn"
      ],
      "failSwapOn": false,
      "podMaxPids": 100
    },
    "linuxOSConfig": {
      "sysctls": {
        "netCoreWmemDefault": 65536,
        "netIpv4TcpTwReuse": true,
        "netIpv4IpLocalPortRange": "20000 60000",
        "kernelThreadsMax": 99999
      },
      "transparentHugePageEnabled": "always",
      "transparentHugePageDefrag": "madvise",
      "swapFileSizeMB": 1500
    }
  }
}

Create Agent Pool with PPG

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1"
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1"
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1"
  }
}

Create Agent Pool with UltraSSD enabled

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "osType": "Linux",
    "enableUltraSSD": true
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.17.13",
    "currentOrchestratorVersion": "1.17.13",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableUltraSSD": true
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.17.13",
    "currentOrchestratorVersion": "1.17.13",
    "count": 3,
    "vmSize": "Standard_DS2_v2",
    "maxPods": 110,
    "osType": "Linux",
    "enableUltraSSD": true
  }
}

Create Agent Pool with Windows OSSKU

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "1.23.3",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "osType": "Windows",
    "osSKU": "Windows2022"
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "wnp2",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.23.3",
    "currentOrchestratorVersion": "1.23.3",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "maxPods": 110,
    "osType": "Windows",
    "osSKU": "Windows2022"
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "wnp2",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.23.3",
    "currentOrchestratorVersion": "1.23.3",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "maxPods": 110,
    "osType": "Windows",
    "osSKU": "Windows2022"
  }
}

Create Spot Agent Pool

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete"
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete",
    "spotMaxPrice": -1
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete",
    "spotMaxPrice": -1
  }
}

Create Windows Agent Pool with disabling OutboundNAT

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "1.23.8",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "osType": "Windows",
    "osSKU": "Windows2022",
    "windowsProfile": {
      "disableOutboundNat": true
    }
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "wnp2",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.23.8",
    "currentOrchestratorVersion": "1.23.8",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "maxPods": 110,
    "osType": "Windows",
    "osSKU": "Windows2022",
    "windowsProfile": {
      "disableOutboundNat": true
    }
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/wnp2",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "wnp2",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.23.8",
    "currentOrchestratorVersion": "1.23.8",
    "count": 3,
    "vmSize": "Standard_D4s_v3",
    "maxPods": 110,
    "osType": "Windows",
    "osSKU": "Windows2022",
    "windowsProfile": {
      "disableOutboundNat": true
    }
  }
}

Create/Update Agent Pool

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete",
    "mode": "User"
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete",
    "mode": "User",
    "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Creating",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "tags": {
      "name1": "val1"
    },
    "nodeLabels": {
      "key1": "val1"
    },
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete",
    "mode": "User"
  }
}

Start Agent Pool

Ukázkový požadavek

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

{
  "properties": {
    "powerState": {
      "code": "Running"
    }
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Starting",
    "count": 50,
    "enableAutoScaling": true,
    "minCount": 3,
    "maxCount": 55,
    "powerState": {
      "code": "Running"
    }
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Starting",
    "count": 50,
    "enableAutoScaling": true,
    "minCount": 3,
    "maxCount": 55,
    "powerState": {
      "code": "Running"
    }
  }
}

Stop Agent Pool

Ukázkový požadavek

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

{
  "properties": {
    "powerState": {
      "code": "Stopped"
    }
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Stopping",
    "count": 0,
    "enableAutoScaling": false,
    "minCount": null,
    "maxCount": null,
    "powerState": {
      "code": "Stopped"
    }
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Stopping",
    "count": 0,
    "enableAutoScaling": false,
    "minCount": null,
    "maxCount": null,
    "powerState": {
      "code": "Stopped"
    }
  }
}

Update Agent Pool

Ukázkový požadavek

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

{
  "properties": {
    "orchestratorVersion": "",
    "count": 3,
    "enableAutoScaling": true,
    "minCount": 2,
    "maxCount": 2,
    "vmSize": "Standard_DS1_v2",
    "osType": "Linux",
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete"
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "enableAutoScaling": true,
    "minCount": 2,
    "maxCount": 2,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete"
  }
}
Stavový kód:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Updating",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "count": 3,
    "enableAutoScaling": true,
    "minCount": 2,
    "maxCount": 2,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "nodeTaints": [
      "Key1=Value1:NoSchedule"
    ],
    "scaleSetPriority": "Spot",
    "scaleSetEvictionPolicy": "Delete"
  }
}

Definice

Name Description
AgentPool

Fond agentů.
AgentPoolMode

Režim fondu agentů.
AgentPoolNetworkProfile

Nastavení sítě fondu agentů
AgentPoolSecurityProfile

Nastavení zabezpečení fondu agentů.
AgentPoolType

Typ fondu agentů.
AgentPoolUpgradeSettings

Nastavení pro upgrade fondu agentů
AgentPoolWindowsProfile

Profil konkrétního fondu agentů Windows.
CloudError

Odpověď na chybu ze služby Container Service
CloudErrorBody

Odpověď na chybu ze služby Container Service
code

Určuje, jestli je cluster spuštěný nebo zastavený.
CreationData

Data používaná při vytváření cílového prostředku ze zdrojového prostředku
GPUInstanceProfile

GPUInstanceProfile, který se má použít k určení profilu instance GPU MIG pro podporovanou skladovou položku virtuálního počítače GPU.
IPTag

Obsahuje IPTag přidružený k objektu.
KubeletConfig

Konfigurace kubeletu uzlů agenta
KubeletDiskType

Určuje umístění prázdných svazkůDir, kořen dat modulu runtime kontejneru a dočasné úložiště Kubelet.
LinuxOSConfig

Konfigurace operačního systému uzlů agenta Linuxu
OSDiskType

Typ disku s operačním systémem, který se má použít pro počítače ve fondu agentů.
OSSKU

Určuje skladovou položku operačního systému používanou fondem agentů. Výchozí hodnota je Ubuntu, pokud je OSType Linux. Výchozí hodnota je Windows2019, když Kubernetes <= 1.24 nebo Windows2022, když Kubernetes >= 1.25, pokud je OSType Windows.
OSType

Typ operačního systému. Výchozí hodnota je Linux.
PortRange

Rozsah portů.
PowerState

Popisuje stav napájení clusteru.
Protocol

Síťový protokol portu.
ScaleDownMode

Popisuje, jak se virtuální počítače přidávají nebo odebírají z fondů agentů. Viz stavy fakturace.
ScaleSetEvictionPolicy

Zásady vyřazení škálovací sady virtuálních počítačů
ScaleSetPriority

Priorita škálovací sady virtuálních počítačů
SysctlConfig

Nastavení sysctl pro uzly agenta Linuxu.
WorkloadRuntime

Určuje typ úlohy, který může uzel spustit.

AgentPool

Fond agentů.

Name Typ Default value Description
id

string

ID prostředku.
name

string

Název prostředku, který je jedinečný v rámci skupiny prostředků. Tento název lze použít pro přístup k prostředku.
properties.availabilityZones

string[]

Seznam zón dostupnosti, které se mají použít pro uzly. Tuto vlastnost lze zadat pouze v případě, že vlastnost AgentPoolType je VirtualMachineScaleSets.
properties.capacityReservationGroupID

string

Plně kvalifikované ID prostředku skupiny rezervací kapacity pro poskytování virtuálních počítačů z rezervované skupiny virtuálních počítačů.
AKS přidruží zadaný fond agentů ke skupině rezervace kapacity.
properties.count

integer

Počet agentů (virtuálních počítačů) pro hostování kontejnerů Dockeru Povolené hodnoty musí být v rozsahu od 0 do 1 000 (včetně) pro fondy uživatelů a v rozsahu od 1 do 1 000 (včetně) pro systémové fondy. Výchozí hodnota je 1.
properties.creationData

CreationData

CreationData, která se použije k určení ID zdrojového snímku, pokud se fond uzlů vytvoří nebo upgraduje pomocí snímku.
properties.currentOrchestratorVersion

string

Verze Kubernetes, na které je fond agentů spuštěný.
Pokud je orchestratorVersion plně zadanou verzí <major.minor.patch>, bude toto pole přesně stejné. Pokud je orchestratorVersion <major.minor>, bude toto pole obsahovat úplnou verzi <major.minor.patch> verzi.
properties.eTag

string

Jedinečný řetězec jen pro čtení, který se používá k implementaci optimistické souběžnosti. Hodnota eTag se změní při aktualizaci prostředku. Zadejte hlavičku if-match nebo if-none-match s hodnotou eTag pro následný požadavek, aby se povolila optimistická souběžnost podle normální konvence značky etag.
properties.enableAutoScaling

boolean

Povolení automatického škálování
properties.enableEncryptionAtHost

boolean

Jestli chcete povolit šifrování operačního systému založeného na hostiteli a datové jednotky.
To se podporuje jenom u určitých velikostí virtuálních počítačů a v určitých oblastech Azure. Další informace najdete v tématu: https://docs.microsoft.com/azure/aks/enable-host-encryption
properties.enableFIPS

boolean

Určuje, jestli se má použít operační systém s podporou FIPS.
Další podrobnosti najdete v tématu Přidání fondu uzlů s podporou FIPS.
properties.enableNodePublicIP

boolean

Určuje, jestli je každému uzlu přidělena vlastní veřejná IP adresa.
Některé scénáře můžou vyžadovat, aby uzly ve fondu uzlů přijímaly vlastní vyhrazené veřejné IP adresy. Běžným scénářem jsou úlohy hraní her, kdy konzola potřebuje vytvořit přímé připojení ke cloudovému virtuálnímu počítači, aby se minimalizovaly segmenty směrování. Další informace najdete v tématu přiřazení veřejné IP adresy na uzel. Výchozí hodnota je false.
properties.enableUltraSSD

boolean

Zda povolit UltraSSD
properties.gpuInstanceProfile

GPUInstanceProfile

GPUInstanceProfile, který se má použít k určení profilu instance GPU MIG pro podporovanou skladovou položku virtuálního počítače GPU.
properties.hostGroupID

string

Plně kvalifikované ID prostředku vyhrazené skupiny hostitelů pro zřizování virtuálních počítačů, které se používají pouze ve scénáři vytváření, a ne povolené změny po nastavení.
Toto je formulář: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Další informace najdete v tématu vyhrazených hostitelů Azure.
properties.kubeletConfig

KubeletConfig

Konfigurace kubeletu uzlů agenta
Konfigurace Kubeletu na uzlech fondu agentů.
properties.kubeletDiskType

KubeletDiskType

Určuje umístění prázdných svazkůDir, kořen dat modulu runtime kontejneru a dočasné úložiště Kubelet.
properties.linuxOSConfig

LinuxOSConfig

Konfigurace operačního systému uzlů agenta Linuxu
Konfigurace operačního systému uzlů agenta Linuxu.
properties.maxCount

integer

Maximální počet uzlů pro automatické škálování
properties.maxPods

integer

Maximální počet podů, které se dají spustit na uzlu.
properties.minCount

integer

Minimální počet uzlů pro automatické škálování
properties.mode

AgentPoolMode

Režim fondu agentů.
Cluster musí mít vždy alespoň jeden fond agentů systému. Další informace o omezeních fondu agentů a osvědčených postupech najdete v tématu: https://docs.microsoft.com/azure/aks/use-system-pools
properties.networkProfile

AgentPoolNetworkProfile

Nastavení fondu agentů souvisejících se sítí
properties.nodeImageVersion

string

Verze image uzlu
properties.nodeLabels

object

Popisky uzlů, které se mají uchovávat ve všech uzlech ve fondu agentů.
properties.nodePublicIPPrefixID

string

ID předpony veřejné IP adresy, ze kterých mají uzly virtuálních počítačů používat IP adresy.
Toto je formulář: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
properties.nodeTaints

string[]

Tainty přidané do nových uzlů během vytváření a škálování fondu uzlů Například key=value:NoSchedule.
properties.orchestratorVersion

string

Verze Kubernetes určená uživatelem
Podporují se obě verze opravy <major.minor.patch> (např. 1.20.13) a <major.minor> (např. 1.20). Při <major.minor> je zvolena nejnovější podporovaná verze opravy GA automaticky. Aktualizace clusteru se stejným <major.minor> po vytvoření (např. 1.14.x –> 1.14) neaktivuje upgrade, i když je k dispozici novější verze opravy. Osvědčeným postupem je upgradovat všechny fondy uzlů v clusteru AKS na stejnou verzi Kubernetes. Verze fondu uzlů musí mít stejnou hlavní verzi jako řídicí rovina. Podverze fondu uzlů musí být ve dvou podverzi verze řídicí roviny. Verze fondu uzlů nemůže být větší než verze řídicí roviny. Další informace najdete v tématu upgradu fondu uzlů.
properties.osDiskSizeGB

integer

Velikost disku operačního systému v GB, která se má použít k určení velikosti disku pro každý počítač v hlavním fondu nebo fondu agentů. Pokud zadáte hodnotu 0, použije se výchozí velikost disku osDisk podle zadané hodnoty vmSize.
properties.osDiskType

OSDiskType

Typ disku s operačním systémem, který se má použít pro počítače ve fondu agentů.
Výchozí hodnota je dočasný, pokud virtuální počítač podporuje a má disk mezipaměti větší než požadovaný disk OSDiskSizeGB. V opačném případě se ve výchozím nastavení nastaví spravovaný. Po vytvoření se nemusí změnit. Další informace naleznete v tématu dočasný operační systém.
properties.osSKU

OSSKU

Určuje skladovou položku operačního systému používanou fondem agentů. Výchozí hodnota je Ubuntu, pokud je OSType Linux. Výchozí hodnota je Windows2019, když Kubernetes <= 1.24 nebo Windows2022, když Kubernetes >= 1.25, pokud je OSType Windows.
properties.osType

OSType

Linux

Typ operačního systému. Výchozí hodnota je Linux.
properties.podSubnetID

string

ID podsítě, ke které se pody připojí při spuštění.
Pokud tento parametr vynecháte, IP adresy podů se staticky přiřazují v podsíti uzlu (další podrobnosti najdete v tématu vnetSubnetID). Toto je formulář: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.powerState

PowerState

Bez ohledu na to, jestli je fond agentů spuštěný nebo zastavený.
Při prvním vytvoření fondu agentů je spuštěný. Fond agentů lze zastavit nastavením tohoto pole na Zastaveno. Zastavený fond agentů zastaví všechny své virtuální počítače a nenabíhá poplatky za fakturaci. Fond agentů lze zastavit pouze v případě, že je spuštěný a stav zřizování je úspěšný.
properties.provisioningState

string

Aktuální stav nasazení nebo zřizování.
properties.proximityPlacementGroupID

string

ID skupiny umístění bezkontaktní komunikace.
properties.scaleDownMode

ScaleDownMode

Režim vertikálního snížení kapacity, který se použije při škálování fondu agentů.
To také ovlivňuje chování automatického škálování clusteru. Pokud není zadáno, ve výchozím nastavení se odstraní.
properties.scaleSetEvictionPolicy

ScaleSetEvictionPolicy

Delete

Zásady vyřazení škálovací sady virtuálních počítačů, které se mají použít.
Tuto hodnotu nelze zadat, pokud není scaleSetPriority spot. Pokud není zadáno, výchozí hodnota je Odstranit.
properties.scaleSetPriority

ScaleSetPriority

Regular

Priorita škálovací sady virtuálních počítačů Pokud není zadáno, výchozí hodnota je Normální.
properties.securityProfile

AgentPoolSecurityProfile

Nastavení zabezpečení fondu agentů.
properties.spotMaxPrice

number

-1

Maximální cena (v amerických dolarech) jste ochotni zaplatit za spotové instance. Možné hodnoty jsou desetinná hodnota větší než nula nebo -1 označující výchozí cenu, která má být up-to na vyžádání.
Možné hodnoty jsou desetinná hodnota větší než nula nebo -1, což značí ochotu zaplatit jakoukoli cenu na vyžádání. Další podrobnosti o spotových cenách najdete v tématu cenových spotových virtuálních počítačů.
properties.tags

object

Značky, které se mají uchovávat ve škálovací sadě virtuálních počítačů fondu agentů.
properties.type

AgentPoolType

Typ fondu agentů.
properties.upgradeSettings

AgentPoolUpgradeSettings

Nastavení pro upgrade fondu agentů
properties.vmSize

string

Velikost virtuálních počítačů fondu agentů.
Dostupnost velikosti virtuálního počítače se liší podle oblasti. Pokud uzel obsahuje nedostatečné výpočetní prostředky (paměť, procesor atd.), nemusí se pody správně spustit. Další podrobnosti o omezených velikostech virtuálních počítačů najdete v tématu: https://docs.microsoft.com/azure/aks/quotas-skus-regions
properties.vnetSubnetID

string

ID podsítě, ke které se uzly fondu agentů a volitelně pody připojí při spuštění.
Pokud tento parametr nezadáte, vygeneruje a použije se virtuální síť a podsíť. Pokud není zadán žádný podSubnetID, platí to pro uzly a pody, jinak se vztahuje pouze na uzly. Toto je formulář: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.windowsProfile

AgentPoolWindowsProfile

Profil konkrétního fondu agentů Windows.
properties.workloadRuntime

WorkloadRuntime

Určuje typ úlohy, který může uzel spustit.
type

string

Typ prostředku

AgentPoolMode

Režim fondu agentů.

Name Typ Description
System

string

Fondy systémových agentů jsou primárně určené pro hostování důležitých podů systému, jako jsou CoreDNS a server metrik. Systémové fondy agentů osType musí být Linux. Skladová položka virtuálního počítače s fondy systémových agentů musí mít alespoň 2vCPU a 4 GB paměti.
User

string

Fondy uživatelských agentů jsou primárně určené pro hostování podů aplikací.

AgentPoolNetworkProfile

Nastavení sítě fondu agentů

Name Typ Description
allowedHostPorts

PortRange[]

Rozsahy portů, ke kterým má povolený přístup. Zadané oblasti se mohou překrývat.
applicationSecurityGroups

string[]

ID skupin zabezpečení aplikace, které fond agentů přidruží při vytváření.
nodePublicIPTags

IPTag[]

IPTagy veřejných IP adres na úrovni instance

AgentPoolSecurityProfile

Nastavení zabezpečení fondu agentů.

Name Typ Description
enableSecureBoot

boolean

Zabezpečené spouštění je funkce důvěryhodného spuštění, která zajišťuje, že se můžou spouštět jenom podepsané operační systémy a ovladače. Další podrobnosti najdete v tématu aka.ms/aks/trustedlaunch. Pokud není zadáno, výchozí hodnota je false.
enableVTPM

boolean

vTPM je funkce Trusted Launch pro konfiguraci vyhrazeného zabezpečeného trezoru pro klíče a měření uložená místně na uzlu. Další podrobnosti najdete v tématu aka.ms/aks/trustedlaunch. Pokud není zadáno, výchozí hodnota je false.

AgentPoolType

Typ fondu agentů.

Name Typ Description
AvailabilitySet

string

Toto použití se důrazně nedoporučuje.
VirtualMachineScaleSets

string

Vytvořte fond agentů zálohovaný škálovací sadou virtuálních počítačů.

AgentPoolUpgradeSettings

Nastavení pro upgrade fondu agentů

Name Typ Description
drainTimeoutInMinutes

integer

Časový limit vyprázdnění uzlu
Doba (v minutách) čekání na vyřazení podů a řádné ukončení na uzel. Tato doba čekání na vyřazení respektuje čekání na rozpočty přerušení podů. Pokud dojde k překročení této doby, upgrade se nezdaří. Pokud není zadáno, výchozí hodnota je 30 minut.
maxSurge

string

Maximální početneboch
Můžete ho nastavit buď na celé číslo (např. 5), nebo procento (např. 50%). Pokud je zadáno procento, jedná se o procento celkové velikosti fondu agentů v době upgradu. V procentech se desetinné uzly zaokrouhlují nahoru. Pokud není zadáno, výchozí hodnota je 1. Další informace, včetně osvědčených postupů, najdete v tématu: https://docs.microsoft.com/azure/aks/upgrade-cluster#customize-node-surge-upgrade
nodeSoakDurationInMinutes

integer

Doba trvání namočení uzlu
Doba (v minutách) čekání po vyprázdnění uzlu a před opětovným obnovením a přechodem na další uzel. Pokud není zadáno, výchozí hodnota je 0 minut.

AgentPoolWindowsProfile

Profil konkrétního fondu agentů Windows.

Name Typ Description
disableOutboundNat

boolean

Určuje, jestli se má v uzlech Windows zakázat odchozí připojeníNAT.
Výchozí hodnota je false. Odchozí překlad adres (NAT) je možné zakázat pouze v případě, že odchozí typ clusteru je NAT Gateway a fond agentů Windows nemá povolenou veřejnou IP adresu uzlu.

CloudError

Odpověď na chybu ze služby Container Service

Name Typ Description
error

CloudErrorBody

Podrobnosti o chybě

CloudErrorBody

Odpověď na chybu ze služby Container Service

Name Typ Description
code

string

Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.
details

CloudErrorBody[]

Seznam dalších podrobností o chybě
message

string

Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.
target

string

Cíl konkrétní chyby. Například název vlastnosti v chybě.

code

Určuje, jestli je cluster spuštěný nebo zastavený.

Name Typ Description
Running

string

Cluster je spuštěný.
Stopped

string

Cluster je zastavený.

CreationData

Data používaná při vytváření cílového prostředku ze zdrojového prostředku

Name Typ Description
sourceResourceId

string

Toto je ID ARM zdrojového objektu, které se má použít k vytvoření cílového objektu.

GPUInstanceProfile

GPUInstanceProfile, který se má použít k určení profilu instance GPU MIG pro podporovanou skladovou položku virtuálního počítače GPU.

Name Typ Description
MIG1g

string

MIG2g

string

MIG3g

string

MIG4g

string

MIG7g

string

IPTag

Obsahuje IPTag přidružený k objektu.

Name Typ Description
ipTagType

string

Typ značky IP. Příklad: RoutingPreference.
tag

string

Hodnota značky IP přidružené k veřejné IP adrese. Příklad: Internet.

KubeletConfig

Konfigurace kubeletu uzlů agenta

Name Typ Description
allowedUnsafeSysctls

string[]

Povolený seznam nebezpečných vzorů sysctl nebo nebezpečných vzorů sysctl (končících na *).
containerLogMaxFiles

integer

Maximální počet souborů protokolu kontejneru, které mohou být přítomné pro kontejner. Číslo musí být ≥ 2.
containerLogMaxSizeMB

integer

Maximální velikost souboru protokolu kontejneru (např. 10Mi) před otočením.
cpuCfsQuota

boolean

Pokud je pro kontejnery, které určují limity procesoru, povolená kvóta CFS procesoru.
Výchozí hodnota je true.
cpuCfsQuotaPeriod

string

Hodnota období kvóty CPU CFS.
Výchozí hodnota je 100 ms. Platné hodnoty jsou posloupnost desetinných čísel s volitelným zlomkem a příponou jednotky. Příklad: 300ms, 2h45m. Podporované jednotky jsou ns, us, ms, s, m a h.
cpuManagerPolicy

string

Zásady správce procesoru, které se mají použít.
Výchozí hodnota je žádná. Další informace najdete v tématu zásad správy procesoru Kubernetes. Povolené hodnoty jsou none a static.
failSwapOn

boolean

Pokud je nastavená hodnota true, kubelet se nepodaří spustit, pokud je na uzlu povoleno prohození.
imageGcHighThreshold

integer

Procento využití disku, po kterém se vždy spustí uvolňování paměti image.
Pokud chcete zakázat uvolňování paměti image, nastavte hodnotu 100. Výchozí hodnota je 85%
imageGcLowThreshold

integer

Procento využití disku, před kterým se nikdy nespustí uvolňování paměti image.
Nelze nastavit vyšší než imageGcHighThreshold. Výchozí hodnota je 80%
podMaxPids

integer

Maximální počet procesů na pod.
topologyManagerPolicy

string

Zásady Správce topologie, které se mají použít.
Další informace naleznete v tématu Správce topologie Kubernetes. Výchozí hodnota je žádná. Povolené hodnoty jsou none, best-effort, restricted a single-numa-node.

KubeletDiskType

Určuje umístění prázdných svazkůDir, kořen dat modulu runtime kontejneru a dočasné úložiště Kubelet.

Name Typ Description
OS

string

Kubelet použije disk s operačním systémem pro svá data.
Temporary

string

Kubelet použije dočasný disk pro svá data.

LinuxOSConfig

Konfigurace operačního systému uzlů agenta Linuxu

Name Typ Description
swapFileSizeMB

integer

Velikost v MB prohození souboru, který se vytvoří na každém uzlu.
sysctls

SysctlConfig

Nastavení sysctl pro uzly agenta Linuxu.
transparentHugePageDefrag

string

Zda by jádro mělo agresivně využívat komprimace paměti, aby bylo k dispozici více obrovských stránek.
Platné hodnoty jsou 'always', 'defer', 'defer+madvise', 'madvise' a 'never'. Výchozí hodnota je madvise. Další informace naleznete v tématu Transparent Hugepages.
transparentHugePageEnabled

string

Jestli jsou povolené průhledné obrovské stránky.
Platné hodnoty jsou 'always', 'madvise' a 'never'. Výchozí hodnota je vždy. Další informace naleznete v tématu Transparent Hugepages.

OSDiskType

Typ disku s operačním systémem, který se má použít pro počítače ve fondu agentů.

Name Typ Description
Ephemeral

string

Dočasné disky s operačním systémem se ukládají jenom na hostitelském počítači, stejně jako dočasný disk. To poskytuje nižší latenci čtení a zápisu spolu s rychlejším škálováním uzlů a upgrady clusteru.
Managed

string

Azure replikuje disk operačního systému pro virtuální počítač do úložiště Azure, aby se zabránilo ztrátě dat, pokud je potřeba virtuální počítač přemístit na jiného hostitele. Vzhledem k tomu, že kontejnery nejsou navržené tak, aby měly trvalý místní stav, nabízí toto chování omezenou hodnotu a zároveň poskytuje určité nevýhody, včetně pomalejšího zřizování uzlů a vyšší latence čtení a zápisu.

OSSKU

Určuje skladovou položku operačního systému používanou fondem agentů. Výchozí hodnota je Ubuntu, pokud je OSType Linux. Výchozí hodnota je Windows2019, když Kubernetes <= 1.24 nebo Windows2022, když Kubernetes >= 1.25, pokud je OSType Windows.

Name Typ Description
AzureLinux

string

Jako operační systém pro image uzlů použijte AzureLinux. Azure Linux je distribuce Linuxu optimalizovaná pro kontejnery vytvořená Microsoftem. Další informace najdete v https://aka.ms/azurelinux.
CBLMariner

string

Zastaralá jednotka OSSKU. Microsoft doporučuje, aby nová nasazení zvolila místo toho AzureLinux.
Ubuntu

string

Jako operační systém použijte Ubuntu pro image uzlů.
Windows2019

string

Jako operační systém pro image uzlů použijte Windows2019. Nepodporované fondy systémových uzlů. Windows2019 podporuje pouze kontejnery Windows2019; Nemůže spouštět kontejnery Windows2022 a naopak.
Windows2022

string

Jako operační systém pro image uzlů použijte Windows2022. Nepodporované fondy systémových uzlů. Windows2022 podporuje pouze kontejnery Windows2022; Nemůže spouštět kontejnery Windows2019 a naopak.

OSType

Typ operačního systému. Výchozí hodnota je Linux.

Name Typ Description
Linux

string

Použijte Linux.
Windows

string

Používejte Windows.

PortRange

Rozsah portů.

Name Typ Description
portEnd

integer

Maximální port, který je součástí rozsahu. Měla by být v rozsahu od 1 do 65535 a měla by být větší nebo rovna portuStart.
portStart

integer

Minimální port, který je součástí rozsahu. Měla by být v rozsahu od 1 do 65535 a měla by být menší nebo rovna portuEnd.
protocol

Protocol

Síťový protokol portu.

PowerState

Popisuje stav napájení clusteru.

Name Typ Description
code

code

Určuje, jestli je cluster spuštěný nebo zastavený.

Protocol

Síťový protokol portu.

Name Typ Description
TCP

string

Protokol TCP.
UDP

string

Protokol UDP.

ScaleDownMode

Popisuje, jak se virtuální počítače přidávají nebo odebírají z fondů agentů. Viz stavy fakturace.

Name Typ Description
Deallocate

string

Pokus o spuštění uvolněných instancí (pokud existují) během vertikálního navýšení kapacity a zrušení přidělení instancí během vertikálního snížení kapacity.
Delete

string

Během vertikálního navýšení kapacity můžete vytvářet nové instance a během vertikálního snížení kapacity odebírat instance.

ScaleSetEvictionPolicy

Zásady vyřazení škálovací sady virtuálních počítačů

Name Typ Description
Deallocate

string

Uzly v podkladové škálovací sadě fondu uzlů se při vyřazení nastaví na zastavený uvolněný stav. Uzly v zastaveném uvolněném stavu se započítávají do kvóty výpočetních prostředků a můžou způsobovat problémy se škálováním nebo upgradem clusteru.
Delete

string

Uzly v podkladové škálovací sadě fondu uzlů se odstraní, když se vyřadí.

ScaleSetPriority

Priorita škálovací sady virtuálních počítačů

Name Typ Description
Regular

string

Použijí se běžné virtuální počítače.
Spot

string

Použijí se spotové virtuální počítače s prioritou. Pro spotové uzly neexistuje žádná smlouva SLA. Další informace najdete na místě na AKS.

SysctlConfig

Nastavení sysctl pro uzly agenta Linuxu.

Name Typ Description
fsAioMaxNr

integer

Sysctl setting fs.aio-max-nr.
fsFileMax

integer

Sysctl setting fs.file-max.
fsInotifyMaxUserWatches

integer

Nastavení sysctl fs.inotify.max_user_watches.
fsNrOpen

integer

Nastavení sysctl fs.nr_open.
kernelThreadsMax

integer

Sysctl setting kernel.threads-max.
netCoreNetdevMaxBacklog

integer

Nastavení sysctl net.core.netdev_max_backlog.
netCoreOptmemMax

integer

Nastavení sysctl net.core.optmem_max.
netCoreRmemDefault

integer

Nastavení sysctl net.core.rmem_default.
netCoreRmemMax

integer

Nastavení sysctl net.core.rmem_max.
netCoreSomaxconn

integer

Nastavení sysctl net.core.somaxconn.
netCoreWmemDefault

integer

Nastavení sysctl net.core.wmem_default.
netCoreWmemMax

integer

Nastavení sysctl net.core.wmem_max.
netIpv4IpLocalPortRange

string

Nastavení sysctl net.ipv4.ip_local_port_range.
netIpv4NeighDefaultGcThresh1

integer

Nastavení sysctl net.ipv4.neigh.default.gc_thresh1.
netIpv4NeighDefaultGcThresh2

integer

Nastavení sysctl net.ipv4.neigh.default.gc_thresh2.
netIpv4NeighDefaultGcThresh3

integer

Nastavení sysctl net.ipv4.neigh.default.gc_thresh3.
netIpv4TcpFinTimeout

integer

Nastavení sysctl net.ipv4.tcp_fin_timeout.
netIpv4TcpKeepaliveProbes

integer

Nastavení sysctl net.ipv4.tcp_keepalive_probes.
netIpv4TcpKeepaliveTime

integer

Nastavení sysctl net.ipv4.tcp_keepalive_time.
netIpv4TcpMaxSynBacklog

integer

Nastavení sysctl net.ipv4.tcp_max_syn_backlog.
netIpv4TcpMaxTwBuckets

integer

Nastavení sysctl net.ipv4.tcp_max_tw_buckets.
netIpv4TcpTwReuse

boolean

Nastavení sysctl net.ipv4.tcp_tw_reuse.
netIpv4TcpkeepaliveIntvl

integer

Nastavení sysctl net.ipv4.tcp_keepalive_intvl.
netNetfilterNfConntrackBuckets

integer

Nastavení sysctl net.netfilter.nf_conntrack_buckets.
netNetfilterNfConntrackMax

integer

Nastavení sysctl net.netfilter.nf_conntrack_max.
vmMaxMapCount

integer

Nastavení sysctl vm.max_map_count.
vmSwappiness

integer

Nastavení sysctl vm.swappiness.
vmVfsCachePressure

integer

Nastavení sysctl vm.vfs_cache_pressure.

WorkloadRuntime

Určuje typ úlohy, který může uzel spustit.

Name Typ Description
OCIContainer

string

Uzly budou používat Kubelet ke spouštění standardních úloh kontejneru OCI.
WasmWasi

string

Uzly budou používat Krustlet ke spouštění úloh WASM pomocí poskytovatele WASI (Preview).