Agent Pools - Get

Služba:: AKS

Verze rozhraní API:: 2025-10-01

Získá zadaný fond agentů spravovaného clusteru.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	Název fondu agentů.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
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]$	Název spravovaného prostředku clusteru.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	AgentPool	OK
Other Status Codes	ErrorResponse	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

Get Agent Pool

Ukázkový požadavek

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


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

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.containerservice import ContainerServiceClient

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

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


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

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


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

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

package armcontainerservice_test

import (
	"context"
	"log"

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

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/9cc7633f842575274f715cc02e37c5769ac2742d/specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-10-01/examples/AgentPoolsGet.json
func ExampleAgentPoolsClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcontainerservice.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewAgentPoolsClient().Get(ctx, "rg1", "clustername1", "agentpool1", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.AgentPool = armcontainerservice.AgentPool{
	// 	Name: to.Ptr("agentpool1"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1"),
	// 	Properties: &armcontainerservice.ManagedClusterAgentPoolProfileProperties{
	// 		Count: to.Ptr[int32](3),
	// 		CurrentOrchestratorVersion: to.Ptr("1.9.6"),
	// 		ETag: to.Ptr("ebwiyfneowv"),
	// 		MaxPods: to.Ptr[int32](110),
	// 		NodeImageVersion: to.Ptr("AKSUbuntu:1604:2020.03.11"),
	// 		OrchestratorVersion: to.Ptr("1.9.6"),
	// 		OSType: to.Ptr(armcontainerservice.OSTypeLinux),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		UpgradeSettings: &armcontainerservice.AgentPoolUpgradeSettings{
	// 			MaxSurge: to.Ptr("33%"),
	// 		},
	// 		VMSize: to.Ptr("Standard_DS1_v2"),
	// 	},
	// }
}

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

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

/**
 * This sample demonstrates how to Gets the specified managed cluster agent pool.
 *
 * @summary Gets the specified managed cluster agent pool.
 * x-ms-original-file: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-10-01/examples/AgentPoolsGet.json
 */
async function getAgentPool() {
  const subscriptionId =
    process.env["CONTAINERSERVICE_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["CONTAINERSERVICE_RESOURCE_GROUP"] || "rg1";
  const resourceName = "clustername1";
  const agentPoolName = "agentpool1";
  const credential = new DefaultAzureCredential();
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.agentPools.get(resourceGroupName, resourceName, agentPoolName);
  console.log(result);
}

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.ContainerService.Models;
using Azure.ResourceManager.ContainerService;

// Generated from example definition: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-10-01/examples/AgentPoolsGet.json
// this example is just showing the usage of "AgentPools_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ContainerServiceAgentPoolResource created on azure
// for more information of creating ContainerServiceAgentPoolResource, please refer to the document of ContainerServiceAgentPoolResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "rg1";
string resourceName = "clustername1";
string agentPoolName = "agentpool1";
ResourceIdentifier containerServiceAgentPoolResourceId = ContainerServiceAgentPoolResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, resourceName, agentPoolName);
ContainerServiceAgentPoolResource containerServiceAgentPool = client.GetContainerServiceAgentPoolResource(containerServiceAgentPoolResourceId);

// invoke the operation
ContainerServiceAgentPoolResource result = await containerServiceAgentPool.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ContainerServiceAgentPoolData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Ukázková odpověď

Stavový kód:: 200

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

Definice

Name	Description
AgentPool	Fond agentů.
AgentPoolGatewayProfile	Profil fondu agentů spravované brány clusteru
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
AgentPoolNetworkProfile	Nastavení sítě fondu agentů
AgentPoolSecurityProfile	Nastavení zabezpečení fondu agentů.
AgentPoolSSHAccess	Metoda přístupu SSH fondu agentů.
AgentPoolStatus	Obsahuje informace o fondu agentů jen pro čtení.
AgentPoolType	Typ fondu agentů.
AgentPoolUpgradeSettings	Nastavení pro upgrade fondu agentů
AgentPoolWindowsProfile	Profil konkrétního fondu agentů Windows.
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
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
GPUDriver	Zda se mají nainstalovat ovladače GPU. Pokud není zadaný, výchozí hodnota je Nainstalovat.
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.
GPUProfile	Nastavení GPU pro fond agentů.
IPTag	Obsahuje IPTag přidružený k objektu.
KubeletConfig	Konfigurace kubeletu uzlů agenta Další podrobnosti najdete v tématu konfigurace vlastních uzlů AKS.
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 Další podrobnosti najdete v tématu konfigurace vlastních uzlů AKS.
LocalDNSForwardDestination	Cílový server pro předávání dotazů DNS z localDNS.
LocalDNSForwardPolicy	Předávací politika pro výběr nadřazeného serveru DNS. Další informace naleznete v části forward plugin .
LocalDNSMode	Režim povolení pro localDNS.
LocalDNSOverride	Přepsání pro localDNS profil.
LocalDNSProfile	Konfiguruje místní DNS pro jednotlivé uzly s přepsáním VnetDNS a KubeDNS. LocalDNS pomáhá zlepšit výkon a spolehlivost překladu DNS v clusteru AKS. Více podrobností naleznete v aka.ms/aks/localdns.
LocalDNSProtocol	Vynucujte protokol TCP nebo upřednostněte protokol UDP pro připojení z localDNS k nadřazenému serveru DNS.
LocalDNSQueryLogging	Úroveň protokolu pro dotazy DNS v localDNS.
LocalDNSServeStale	Zásady pro poskytování zastaralých dat. Další informace naleznete v části zásuvný modul mezipaměti .
LocalDNSState	Systémem generovaný stav localDNS.
ManualScaleProfile	Specifikace počtu počítačů.
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.
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.
PodIPAllocationMode	Režim přidělování IP podů. Režim přidělování IP adres pro pody ve fondu agentů. Musí se používat s podSubnetId. Výchozí hodnota je DynamicIndividual.
PortRange	Rozsah portů.
PowerState	Popisuje stav napájení clusteru.
Protocol	Síťový protokol portu.
ScaleDownMode	Popisuje, jak jsou virtuální počítače přidávány do fondů agentů nebo z nich odebírány. Viz stavy fakturace.
ScaleProfile	Specifikace, jak škálovat fond agentů VirtualMachines
ScaleSetEvictionPolicy	Zásady vyřazení škálovací sady virtuálních počítačů. Zásady vyřazení určují, co se má s virtuálním počítačem dělat při jeho vyloučení. Výchozí hodnota je Odstranit. Další informace o vyřazení naleznete v tématu spotové virtuální počítače.
ScaleSetPriority	Priorita škálovací sady virtuálních počítačů
SysctlConfig	Nastavení sysctl pro uzly agenta Linuxu.
UndrainableNodeBehavior	Definuje chování neschůdných uzlů během upgradu. Nejčastější příčinou nepovolitelného uzlu jsou rozpočty přerušení podů (PDB), ale jiné problémy, jako je období odkladu ukončení podu, překračuje zbývající časový limit pro vyprázdnění uzlu nebo pod je stále ve spuštěném stavu, můžou také způsobit nedržitelné uzly.
VirtualMachineNodes	Aktuální stav ve skupině uzlů se stejnou velikostí virtuálního počítače
VirtualMachinesProfile	Specifikace fondu agentů VirtualMachines
WorkloadRuntime	Určuje typ úlohy, který může uzel spustit.

AgentPool

Objekt

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 (arm-id)		AKS přidruží zadaný fond agentů ke skupině rezervace kapacity.
properties.count	integer (int32)		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, abyste povolili optimistickou souběžnost podle normální konvence 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.gatewayProfile	AgentPoolGatewayProfile		Profilování specifické pro fond spravovaných agentů v režimu brány Toto pole nelze nastavit, pokud režim fondu agentů není brána.
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.gpuProfile	GPUProfile		Nastavení GPU pro fond agentů.
properties.hostGroupID	string (arm-id)		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 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.
properties.localDNSProfile	LocalDNSProfile		Konfiguruje místní DNS pro jednotlivé uzly s přepsáním VnetDNS a KubeDNS. LocalDNS pomáhá zlepšit výkon a spolehlivost překladu DNS v clusteru AKS. Více podrobností naleznete v aka.ms/aks/localdns.
properties.maxCount	integer (int32)		Maximální počet uzlů pro automatické škálování
properties.maxPods	integer (int32)		Maximální počet podů, které se dají spustit na uzlu.
properties.messageOfTheDay	string		Zpráva dne pro uzly s Linuxem, kódovaná base64. Řetězec s kódováním base64, který se zapíše do /etc/motd po dekódování. To umožňuje přizpůsobení zprávy dne pro uzly s Linuxem. Nesmí být určen pro uzly Windows. Musí se jednat o statický řetězec (tj. bude vytištěn nezpracovaný a nebude proveden jako skript).
properties.minCount	integer (int32)		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 (arm-id)		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 (int32) minimum: 0 maximum: 2048		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.podIPAllocationMode	PodIPAllocationMode		Režim přidělování IP podů. Režim přidělování IP adres pro pody ve fondu agentů. Musí se používat s podSubnetId. Výchozí hodnota je DynamicIndividual.
properties.podSubnetID	string (arm-id)		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 (arm-id)		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.status	AgentPoolStatus		Obsahuje informace o fondu agentů jen pro čtení.
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.virtualMachineNodesStatus	VirtualMachineNodes[]		Stav uzlů ve fondu agentů VirtualMachines.
properties.virtualMachinesProfile	VirtualMachinesProfile		Specifikace fondu agentů VirtualMachines
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 (arm-id)		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 zdroje

AgentPoolGatewayProfile

Objekt

Profil fondu agentů spravované brány clusteru

Name	Typ	Default value	Description
publicIPPrefixSize	integer (int32) minimum: 28 maximum: 31	31	Fond agentů brány přidruží jednu veřejnou IPPrefix pro každou statickou bránu výchozího přenosu dat k zajištění veřejného výchozího přenosu dat. Uživatel by měl vybrat velikost veřejné IPPrefixu. Každému uzlu ve fondu agentů je přiřazena jedna IP adresa z IPPrefixu. Velikost IPPrefixu tedy slouží jako limit velikosti fondu agentů brány. Kvůli omezení velikosti veřejné IPPrefixu Azure je platný rozsah hodnot [28, 31] (/31 = 2 uzly/IP adresy, /30 = 4 uzly/IP adresy, /29 = 8 uzlů/IP adres, /28 = 16 uzlů/IP adres). Výchozí hodnota je 31.

AgentPoolMode

Výčet

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

Hodnota	Description
System	Fondy systémových agentů jsou primárně určeny k hostování kritických systémových podů, jako jsou CoreDNS a metrics-server. 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	Fondy uživatelských agentů jsou primárně určeny k hostování podů aplikací.
Gateway	Fondy agentů brány jsou vyhrazené pro poskytování statických výstupních IP adres do podů. Další podrobnosti najdete tady: https://aka.ms/aks/static-egress-gateway.

AgentPoolNetworkProfile

Objekt

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[] (arm-id)	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

Objekt

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.
sshAccess	AgentPoolSSHAccess	Metoda přístupu SSH fondu agentů.

AgentPoolSSHAccess

Výčet

Metoda přístupu SSH fondu agentů.

Hodnota	Description
LocalUser	Může se připojit k uzlu jako místní uživatel pomocí privátního klíče.
Disabled	Služba SSH bude na uzlu vypnutá.

AgentPoolStatus

Objekt

Obsahuje informace o fondu agentů jen pro čtení.

Name	Typ	Description
provisioningError	ErrorDetail	Podrobné informace o chybě fondu agentů. Uchovává podrobné informace o selhání. Pokud nedošlo k žádné chybě, bude toto pole vynecháno.

AgentPoolType

Výčet

Typ fondu agentů.

Hodnota	Description
VirtualMachineScaleSets	Vytvořte fond agentů zálohovaný škálovací sadou virtuálních počítačů.
AvailabilitySet	Použití tohoto nástroje se důrazně nedoporučuje.
VirtualMachines	Vytvořte fond agentů zálohovaný režimem orchestrace virtuálních počítačů s jednou instancí.

AgentPoolUpgradeSettings

Objekt

Nastavení pro upgrade fondu agentů

Name	Typ	Description
drainTimeoutInMinutes	integer (int32) minimum: 1 maximum: 1440	Časový limit vyčerpání pro uzel. 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 10%. Další informace, včetně osvědčených postupů, naleznete v tématu: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster
maxUnavailable	string	Maximální počet nebo procento uzlů, které mohou být během upgradu současně nedostupné. Můžete ho nastavit buď na celé číslo (např. 1), nebo procento (např. 5%). 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 0. Další informace, včetně osvědčených postupů, naleznete v tématu: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster
nodeSoakDurationInMinutes	integer (int32) minimum: 0 maximum: 30	Doba namáč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.
undrainableNodeBehavior	UndrainableNodeBehavior	Definuje chování neschůdných uzlů během upgradu. Nejčastější příčinou nepovolitelného uzlu jsou rozpočty přerušení podů (PDB), ale jiné problémy, jako je období odkladu ukončení podu, překračuje zbývající časový limit pro vyprázdnění uzlu nebo pod je stále ve spuštěném stavu, můžou také způsobit nedržitelné uzly.

AgentPoolWindowsProfile

Objekt

Profil konkrétního fondu agentů Windows.

Name	Typ	Description
disableOutboundNat	boolean	Zda zakázat OutboundNAT v uzlech Windows. 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.

code

Výčet

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

Hodnota	Description
Running	Cluster je spuštěný.
Stopped	Cluster je zastaven.

CreationData

Objekt

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

Name	Typ	Description
sourceResourceId	string (arm-id)	Toto je ID ARM zdrojového objektu, které se má použít k vytvoření cílového objektu.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

GPUDriver

Výčet

Zda se mají nainstalovat ovladače GPU. Pokud není zadaný, výchozí hodnota je Nainstalovat.

Hodnota	Description
Install	Nainstalujte ovladač.
None	Přeskočte instalaci ovladače.

GPUInstanceProfile

Výčet

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.

Hodnota	Description
MIG1g
MIG2g
MIG3g
MIG4g
MIG7g

GPUProfile

Objekt

Nastavení GPU pro fond agentů.

Name	Typ	Description
driver	GPUDriver	Zda se mají nainstalovat ovladače GPU. Pokud není zadaný, výchozí hodnota je Nainstalovat.

IPTag

Objekt

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

Objekt

Konfigurace kubeletu uzlů agenta Další podrobnosti najdete v tématu konfigurace vlastních uzlů AKS.

Name	Typ	Description
allowedUnsafeSysctls	string[]	Povolený seznam nebezpečných vzorů sysctl nebo nebezpečných vzorů sysctl (končících ).`*`
containerLogMaxFiles	integer (int32) minimum: 2	Maximální počet souborů protokolu kontejneru, které mohou být přítomné pro kontejner. Číslo musí být ≥ 2.
containerLogMaxSizeMB	integer (int32)	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ásady 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 (int32)	Procento využití disku, po kterém se vždy spustí uvolňování nevyužívaných obrazů. Pokud chcete zakázat uvolňování paměti obrázků, nastavte hodnotu na 100. Výchozí hodnota je 85%
imageGcLowThreshold	integer (int32)	Procento využití disku, při kterém nikdy nedojde ke spuštění uvolnění nepoužívaných obrazů. Nelze nastavit vyšší než imageGcHighThreshold. Výchozí hodnota je 80%
podMaxPids	integer (int32)	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

Výčet

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

Hodnota	Description
OS	Kubelet bude pro svá data používat disk s operačním systémem.
Temporary	Kubelet použije pro svá data dočasný disk.

LinuxOSConfig

Objekt

Konfigurace operačního systému uzlů agenta Linuxu Další podrobnosti najdete v tématu konfigurace vlastních uzlů AKS.

Name	Typ	Description
swapFileSizeMB	integer (int32)	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.

LocalDNSForwardDestination

Výčet

Cílový server pro předávání dotazů DNS z localDNS.

Hodnota	Description
ClusterCoreDNS	Přesměrujte dotazy DNS z localDNS do clusteru CoreDNS.
VnetDNS	Předávejte dotazy DNS z localDNS na server DNS nakonfigurovaný ve virtuální síti. Virtuální síť může mít nakonfigurovaných více serverů DNS.

LocalDNSForwardPolicy

Výčet

Předávací politika pro výběr nadřazeného serveru DNS. Další informace naleznete v části forward plugin .

Hodnota	Description
Sequential	Implementuje sekvenční výběr serveru DNS proti proudu. Další informace naleznete v části forward plugin .
RoundRobin	Implementuje kruhové dotazování pro výběr nadřazeného DNS serveru. Další informace naleznete v části forward plugin .
Random	Implementuje náhodný výběr serveru DNS proti proudu. Další informace naleznete v části forward plugin .

LocalDNSMode

Výčet

Režim povolení pro localDNS.

Hodnota	Description
Preferred	Pokud aktuální verze nástroje Orchestrator tuto funkci podporuje, upřednostněte povolení localDNS.
Required	Povolte localDNS.
Disabled	Zakažte localDNS.

LocalDNSOverride

Objekt

Přepsání pro localDNS profil.

Name	Typ	Default value	Description
cacheDurationInSeconds	integer (int32)	3600	Uložit maximální hodnotu TTL do mezipaměti v sekundách. Další informace naleznete v části zásuvný modul mezipaměti .
forwardDestination	LocalDNSForwardDestination	ClusterCoreDNS	Cílový server pro předávání dotazů DNS z localDNS.
forwardPolicy	LocalDNSForwardPolicy	Sequential	Předávací politika pro výběr nadřazeného serveru DNS. Další informace naleznete v části forward plugin .
maxConcurrent	integer (int32)	1000	Maximální počet souběžných dotazů. Další informace naleznete v části forward plugin .
protocol	LocalDNSProtocol	PreferUDP	Vynucujte protokol TCP nebo upřednostněte protokol UDP pro připojení z localDNS k nadřazenému serveru DNS.
queryLogging	LocalDNSQueryLogging	Error	Úroveň protokolu pro dotazy DNS v localDNS.
serveStale	LocalDNSServeStale	Immediate	Zásady pro poskytování zastaralých dat. Další informace naleznete v části zásuvný modul mezipaměti .
serveStaleDurationInSeconds	integer (int32)	3600	Poskytujte zastaralou dobu trvání během několika sekund. Další informace naleznete v části zásuvný modul mezipaměti .

LocalDNSProfile

Objekt

Konfiguruje místní DNS pro jednotlivé uzly s přepsáním VnetDNS a KubeDNS. LocalDNS pomáhá zlepšit výkon a spolehlivost překladu DNS v clusteru AKS. Více podrobností naleznete v aka.ms/aks/localdns.

Name	Typ	Default value	Description
kubeDNSOverrides	<string, LocalDNSOverride>		Přepsání KubeDNS se vztahují na provoz DNS z podů s dnsPolicy:ClusterFirst (označované jako provoz KubeDNS).
mode	LocalDNSMode	Preferred	Režim povolení pro localDNS.
state	LocalDNSState		Systémem generovaný stav localDNS.
vnetDNSOverrides	<string, LocalDNSOverride>		Přepsání VnetDNS se vztahují na provoz DNS z podů s dnsPolicy:default nebo kubelet (označované jako provoz VnetDNS).

LocalDNSProtocol

Výčet

Vynucujte protokol TCP nebo upřednostněte protokol UDP pro připojení z localDNS k nadřazenému serveru DNS.

Hodnota	Description
PreferUDP	Preferovat UDP protokol pro připojení z localDNS k upstream DNS serveru.
ForceTCP	Vynucuje protokol TCP pro připojení z localDNS k nadřazenému serveru DNS.

LocalDNSQueryLogging

Výčet

Úroveň protokolu pro dotazy DNS v localDNS.

Hodnota	Description
Error	Povolí protokolování chyb v localDNS. Pro více informací se podívejte na plugin errors .
Log	Povolí protokolování dotazů v localDNS. Další informace naleznete v tématu log plugin .

LocalDNSServeStale

Výčet

Zásady pro poskytování zastaralých dat. Další informace naleznete v části zásuvný modul mezipaměti .

Hodnota	Description
Verify	Poskytujte zastaralá data s ověřením. Před odesláním položky s vypršenou platností klientovi nejprve ověřte, zda je položka stále nedostupná ze zdroje. Další informace naleznete v části zásuvný modul mezipaměti .
Immediate	Zastaralá data poskytujte okamžitě. Odešlete položku s vypršenou platností klientovi před kontrolou, zda je položka dostupná ze zdroje. Další informace naleznete v části zásuvný modul mezipaměti .
Disable	Zakažte poskytování zastaralých dat.

LocalDNSState

Výčet

Systémem generovaný stav localDNS.

Hodnota	Description
Enabled	localDNS je povolen.
Disabled	localDNS je zakázáno.

ManualScaleProfile

Objekt

Specifikace počtu počítačů.

Name	Typ	Description
count	integer (int32)	Počet uzlů
size	string	Velikost virtuálního počítače, kterou AKS použije při vytváření a škálování, například "Standard_E4s_v3", "Standard_E16s_v3" nebo "Standard_D16s_v5".

OSDiskType

Výčet

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.

Hodnota

Description

Managed

Azure replikuje disk operačního systému pro virtuální počítač do úložiště Azure, aby nedocházelo ke ztrátě dat v případě, že by bylo nutné 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.

Ephemeral

Dočasné disky s operačním systémem jsou uloženy pouze 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.

OSSKU

Výčet

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.

Hodnota	Description
AzureLinux	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.
AzureLinux3	Jako operační systém pro image uzlů použijte AzureLinux3. Azure Linux je distribuce Linuxu optimalizovaná pro kontejnery vytvořená Microsoftem. Další informace najdete v https://aka.ms/azurelinux. Informace o omezeních naleznete na adrese https://aka.ms/aks/node-images. Pokyny k migraci operačního systému naleznete v tématu https://aka.ms/aks/upgrade-os-version.
CBLMariner	Zastaralá jednotka OSSKU. Microsoft doporučuje, aby nová nasazení zvolila místo toho AzureLinux.
Ubuntu	Jako operační systém použijte Ubuntu pro image uzlů.
Ubuntu2204	Jako operační systém pro image uzlů použijte Ubuntu2204, ale Ubuntu 22.04 nemusí být podporováno pro všechny fondy uzlů. Omezení a podporované verze Kubernetes najdete v tématu https://aka.ms/aks/supported-ubuntu-versions
Ubuntu2404	Jako operační systém pro image uzlů použijte Ubuntu2404, ale Ubuntu 24.04 nemusí být podporováno pro všechny fondy uzlů. Omezení a podporované verze Kubernetes najdete v tématu https://aka.ms/aks/supported-ubuntu-versions
Windows2019	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	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

Výčet

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

Hodnota	Description
Linux	Použijte Linux.
Windows	Použijte systém Windows.

PodIPAllocationMode

Výčet

Režim přidělování IP podů. Režim přidělování IP adres pro pody ve fondu agentů. Musí se používat s podSubnetId. Výchozí hodnota je DynamicIndividual.

Hodnota

Description

DynamicIndividual

Každému uzlu se přidělí nesouvislý seznam IP adres, které lze přiřadit podům. To je lepší pro maximalizaci malé až střední podsítě velikosti /16 nebo menší. Cluster Azure CNI s dynamickým přidělováním IP adres se ve výchozím nastavení přepne do tohoto režimu, pokud zákazník explicitně nezadá podIPAllocationMode

StaticBlock

Každému uzlu jsou staticky přiděleny bloky CIDR o velikosti /28 = 16 IP adres na blok, aby byly splněny maxPody na uzel. Počet bloků CIDR >= (maxPods / 16). Blok místo jedné IP adresy se počítá s limitem privátní IP adresy virtuální sítě Azure 65 tisíc. Proto je režim bloku vhodný pro spouštění větších úloh s větším než aktuálním limitem 65 tisíc podů v clusteru. Tento režim je vhodnější pro škálování s většími podsítěmi /15 nebo většími.

PortRange

Objekt

Rozsah portů.

Name	Typ	Description
portEnd	integer (int32) minimum: 1 maximum: 65535	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 (int32) minimum: 1 maximum: 65535	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

Objekt

Popisuje stav napájení clusteru.

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

Protocol

Výčet

Síťový protokol portu.

Hodnota	Description
TCP	Protokol TCP.
UDP	Protokol UDP.

ScaleDownMode

Výčet

Popisuje, jak jsou virtuální počítače přidávány do fondů agentů nebo z nich odebírány. Viz stavy fakturace.

Hodnota	Description
Delete	Vytvářejte nové instance během vertikálního navýšení kapacity a odeberte instance během horizontálního navýšení kapacity.
Deallocate	Pokuste se spustit zrušené instance (pokud existují) během vertikálního navýšení kapacity a uvolněte instance během horizontálního navýšení kapacity.

ScaleProfile

Objekt

Specifikace, jak škálovat fond agentů VirtualMachines

Name	Typ	Description
manual	ManualScaleProfile[]	Specifikace, jak škálovat fond agentů VirtualMachines na pevnou velikost.

ScaleSetEvictionPolicy

Výčet

Zásady vyřazení škálovací sady virtuálních počítačů. Zásady vyřazení určují, co se má s virtuálním počítačem dělat při jeho vyloučení. Výchozí hodnota je Odstranit. Další informace o vyřazení naleznete v tématu spotové virtuální počítače.

Hodnota	Description
Delete	Uzly v podkladové škálovací sadě fondu uzlů se při vyřazení odstraní.
Deallocate	Uzly v podkladové škálovací sadě fondu uzlů se při vyřazení nastaví do stavu zastaveno a zrušeno. 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.

ScaleSetPriority

Výčet

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

Hodnota	Description
Spot	Budou použity virtuální počítače s prioritou spotů. Pro spotové uzly neexistuje žádná smlouva SLA. Další informace najdete na místě na AKS.
Regular	Budou použity běžné virtuální počítače.

SysctlConfig

Objekt

Nastavení sysctl pro uzly agenta Linuxu.

Name	Typ	Description
fsAioMaxNr	integer (int32)	Nastavení sysctl fs.aio-max-nr.
fsFileMax	integer (int32)	Nastavení sysctl fs.file-max.
fsInotifyMaxUserWatches	integer (int32)	Nastavení sysctl fs.inotify.max_user_watches.
fsNrOpen	integer (int32)	Nastavení sysctl fs.nr_open.
kernelThreadsMax	integer (int32)	Sysctl nastavení kernel.threads-max.
netCoreNetdevMaxBacklog	integer (int32)	Nastavení sysctl net.core.netdev_max_backlog.
netCoreOptmemMax	integer (int32)	Nastavení sysctl net.core.optmem_max.
netCoreRmemDefault	integer (int32)	Nastavení sysctl net.core.rmem_default.
netCoreRmemMax	integer (int32)	Nastavení sysctl net.core.rmem_max.
netCoreSomaxconn	integer (int32)	Nastavení sysctl net.core.somaxconn.
netCoreWmemDefault	integer (int32)	Nastavení sysctl net.core.wmem_default.
netCoreWmemMax	integer (int32)	Nastavení sysctl net.core.wmem_max.
netIpv4IpLocalPortRange	string	Nastavení sysctl net.ipv4.ip_local_port_range.
netIpv4NeighDefaultGcThresh1	integer (int32)	Nastavení sysctl net.ipv4.neigh.default.gc_thresh1.
netIpv4NeighDefaultGcThresh2	integer (int32)	Nastavení sysctl net.ipv4.neigh.default.gc_thresh2.
netIpv4NeighDefaultGcThresh3	integer (int32)	Nastavení sysctl net.ipv4.neigh.default.gc_thresh3.
netIpv4TcpFinTimeout	integer (int32)	Nastavení sysctl net.ipv4.tcp_fin_timeout.
netIpv4TcpKeepaliveProbes	integer (int32)	Nastavení sysctl net.ipv4.tcp_keepalive_probes.
netIpv4TcpKeepaliveTime	integer (int32)	Nastavení sysctl net.ipv4.tcp_keepalive_time.
netIpv4TcpMaxSynBacklog	integer (int32)	Nastavení sysctl net.ipv4.tcp_max_syn_backlog.
netIpv4TcpMaxTwBuckets	integer (int32)	Nastavení sysctl net.ipv4.tcp_max_tw_buckets.
netIpv4TcpTwReuse	boolean	Nastavení sysctl net.ipv4.tcp_tw_reuse.
netIpv4TcpkeepaliveIntvl	integer (int32) minimum: 10 maximum: 90	Nastavení sysctl net.ipv4.tcp_keepalive_intvl.
netNetfilterNfConntrackBuckets	integer (int32) minimum: 65536 maximum: 524288	Nastavení sysctl net.netfilter.nf_conntrack_buckets.
netNetfilterNfConntrackMax	integer (int32) minimum: 131072 maximum: 2097152	Nastavení sysctl net.netfilter.nf_conntrack_max.
vmMaxMapCount	integer (int32)	Nastavení sysctl vm.max_map_count.
vmSwappiness	integer (int32)	Nastavení sysctl vm.swappiness.
vmVfsCachePressure	integer (int32)	Nastavení sysctl vm.vfs_cache_pressure.

UndrainableNodeBehavior

Výčet

Definuje chování neschůdných uzlů během upgradu. Nejčastější příčinou nepovolitelného uzlu jsou rozpočty přerušení podů (PDB), ale jiné problémy, jako je období odkladu ukončení podu, překračuje zbývající časový limit pro vyprázdnění uzlu nebo pod je stále ve spuštěném stavu, můžou také způsobit nedržitelné uzly.

Hodnota

Description

Schedule

AKS označí blokované uzly jako plánovatelné, ale blokované uzly se neupgradují. Bude proveden pokus o odstranění všech přepětí uzlů. Operace upgradu a spravovaný cluster budou ve stavu selhání, pokud existují nějaké blokované uzly.

Cordon

AKS blokované uzly během upgradu nahradí přepěťovými uzly. Blokované uzly budou zřetěděny a nahrazeny přepětím uzlů. Blokované uzly budou mít popisek kubernetes.azure.com/upgrade-status:Quarantined. Pro každý blokovaný uzel se zachová přepětí. Bude proveden pokus o odstranění všech ostatních přepětí uzlů. Pokud je k nahrazení blokovaných uzlů dostatek uzlů, operace upgradu a spravovaný cluster bude ve stavu selhání. Jinak se operace upgradu a spravovaný cluster zruší.

VirtualMachineNodes

Objekt

Aktuální stav ve skupině uzlů se stejnou velikostí virtuálního počítače

Name	Typ	Description
count	integer (int32)	Počet uzlů
size	string	Velikost virtuálního počítače agentů používaných k hostování této skupiny uzlů

VirtualMachinesProfile

Objekt

Specifikace fondu agentů VirtualMachines

Name	Typ	Description
scale	ScaleProfile	Specifikace, jak škálovat fond agentů VirtualMachines

WorkloadRuntime

Výčet

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

Hodnota	Description
OCIContainer	Uzly budou používat Kubelet ke spouštění standardních úloh kontejneru OCI.
WasmWasi	Uzly budou používat Krustlet ke spouštění úloh WASM pomocí poskytovatele WASI (Preview).
KataVmIsolation	Uzly mohou pomocí (Kata + Cloud Hypervisor + Hyper-V) povolit vnořené pody založené na virtuálních počítačích. Vzhledem k použití technologie Hyper-V je samotný operační systém uzlu AKS vnořeným virtuálním počítačem (kořenovým operačním systémem) technologie Hyper-V. Dá se tedy použít pouze u řad virtuálních počítačů, které podporují vnořenou virtualizaci, jako je řada Dv3.