Machines - Create Or Update

Služba:: AKS

Verze rozhraní API:: 2026-04-02-preview

Vytvoří nebo aktualizuje počítač v určeném fondu agentů.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/machines/{machineName}?api-version=2026-04-02-preview

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ů.
machineName	path	True	string pattern: ^[a-z][a-z0-9]{0,11}$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,39}$	Název hostitele počítače.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny zdrojů. 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.

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	MachineProperties	Vlastnosti počítače
zones	string[]	Zóna dostupnosti, ve které se počítač nachází.

Odpovědi

Name	Typ	Description
200 OK	Machine	Operace aktualizace zdroje "Machine" byla úspěšná
201 Created	Machine	Operace vytvoření zdroje 'Stroj' úspěšná Hlavičky Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Name

Typ

Description

200 OK

Machine

Operace aktualizace zdroje "Machine" byla úspěšná

201 Created

Machine

Operace vytvoření zdroje 'Stroj' úspěšná

Hlavičky

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 služby Azure Active Directory.

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

Rozsahy

Name	Description
user_impersonation	vydávat se za svůj uživatelský účet

Příklady

Create/Update Machine

Ukázkový požadavek

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1?api-version=2026-04-02-preview

{
  "properties": {
    "hardware": {
      "vmSize": "Standard_DS1_v2"
    },
    "kubernetes": {
      "kubeletDiskType": "OS",
      "maxPods": 110,
      "nodeLabels": {
        "key1": "val1"
      },
      "nodeTaints": [
        "Key1=Value1:NoSchedule"
      ],
      "orchestratorVersion": "1.30"
    },
    "mode": "User",
    "operatingSystem": {
      "enableFIPS": false,
      "osSKU": "Ubuntu",
      "osType": "Linux"
    },
    "priority": "Spot",
    "tags": {
      "name1": "val1"
    }
  }
}


import com.azure.resourcemanager.containerservice.fluent.models.MachineInner;
import com.azure.resourcemanager.containerservice.models.AgentPoolMode;
import com.azure.resourcemanager.containerservice.models.KubeletDiskType;
import com.azure.resourcemanager.containerservice.models.MachineHardwareProfile;
import com.azure.resourcemanager.containerservice.models.MachineKubernetesProfile;
import com.azure.resourcemanager.containerservice.models.MachineOSProfile;
import com.azure.resourcemanager.containerservice.models.MachineProperties;
import com.azure.resourcemanager.containerservice.models.OSSku;
import com.azure.resourcemanager.containerservice.models.OSType;
import com.azure.resourcemanager.containerservice.models.ScaleSetPriority;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for Machines CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-04-02-preview/MachineCreate_Update.json
     */
    /**
     * Sample code: Create/Update Machine.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void createUpdateMachine(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getMachines().createOrUpdate("rg1", "clustername1", "agentpool1", "machine1",
            new MachineInner().withProperties(
                new MachineProperties().withHardware(new MachineHardwareProfile().withVmSize("Standard_DS1_v2"))
                    .withOperatingSystem(
                        new MachineOSProfile().withOsType(OSType.LINUX).withOsSku(OSSku.UBUNTU).withEnableFips(false))
                    .withKubernetes(new MachineKubernetesProfile().withNodeLabels(mapOf("key1", "fakeTokenPlaceholder"))
                        .withOrchestratorVersion("1.30").withKubeletDiskType(KubeletDiskType.OS)
                        .withNodeTaints(Arrays.asList("Key1=Value1:NoSchedule")).withMaxPods(110))
                    .withMode(AgentPoolMode.USER).withPriority(ScaleSetPriority.SPOT).withTags(mapOf("name1", "val1"))),
            null, null, com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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 machine_create_update.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="SUBSCRIPTION_ID",
    )

    response = client.machines.begin_create_or_update(
        resource_group_name="rg1",
        resource_name="clustername1",
        agent_pool_name="agentpool1",
        machine_name="machine1",
        parameters={
            "properties": {
                "hardware": {"vmSize": "Standard_DS1_v2"},
                "kubernetes": {
                    "kubeletDiskType": "OS",
                    "maxPods": 110,
                    "nodeLabels": {"key1": "val1"},
                    "nodeTaints": ["Key1=Value1:NoSchedule"],
                    "orchestratorVersion": "1.30",
                },
                "mode": "User",
                "operatingSystem": {"enableFIPS": False, "osSKU": "Ubuntu", "osType": "Linux"},
                "priority": "Spot",
                "tags": {"name1": "val1"},
            }
        },
    ).result()
    print(response)


# x-ms-original-file: 2026-04-02-preview/MachineCreate_Update.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/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/containerservice/armcontainerservice/v9"
)

// Generated from example definition: 2026-04-02-preview/MachineCreate_Update.json
func ExampleMachinesClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcontainerservice.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewMachinesClient().BeginCreateOrUpdate(ctx, "rg1", "clustername1", "agentpool1", "machine1", armcontainerservice.Machine{
		Properties: &armcontainerservice.MachineProperties{
			Hardware: &armcontainerservice.MachineHardwareProfile{
				VMSize: to.Ptr("Standard_DS1_v2"),
			},
			Kubernetes: &armcontainerservice.MachineKubernetesProfile{
				KubeletDiskType: to.Ptr(armcontainerservice.KubeletDiskTypeOS),
				MaxPods:         to.Ptr[int32](110),
				NodeLabels: map[string]*string{
					"key1": to.Ptr("val1"),
				},
				NodeTaints: []*string{
					to.Ptr("Key1=Value1:NoSchedule"),
				},
				OrchestratorVersion: to.Ptr("1.30"),
			},
			Mode: to.Ptr(armcontainerservice.AgentPoolModeUser),
			OperatingSystem: &armcontainerservice.MachineOSProfile{
				EnableFIPS: to.Ptr(false),
				OSSKU:      to.Ptr(armcontainerservice.OSSKUUbuntu),
				OSType:     to.Ptr(armcontainerservice.OSTypeLinux),
			},
			Priority: to.Ptr(armcontainerservice.ScaleSetPrioritySpot),
			Tags: map[string]*string{
				"name1": to.Ptr("val1"),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to poll the result: %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 = armcontainerservice.MachinesClientCreateOrUpdateResponse{
	// 	Machine: armcontainerservice.Machine{
	// 		Name: to.Ptr("machine1"),
	// 		Type: to.Ptr("Microsoft.ContainerService/managedClusters/agentPools/machines"),
	// 		ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1"),
	// 		Properties: &armcontainerservice.MachineProperties{
	// 			Hardware: &armcontainerservice.MachineHardwareProfile{
	// 				VMSize: to.Ptr("Standard_DS1_v2"),
	// 			},
	// 			Kubernetes: &armcontainerservice.MachineKubernetesProfile{
	// 				CurrentOrchestratorVersion: to.Ptr("1.30.6"),
	// 				KubeletDiskType: to.Ptr(armcontainerservice.KubeletDiskTypeOS),
	// 				MaxPods: to.Ptr[int32](110),
	// 				NodeLabels: map[string]*string{
	// 					"key1": to.Ptr("val1"),
	// 				},
	// 				NodeName: to.Ptr("aks-nodepool1-machine1-25481572-vm0"),
	// 				NodeTaints: []*string{
	// 					to.Ptr("Key1=Value1:NoSchedule"),
	// 				},
	// 				OrchestratorVersion: to.Ptr("1.30"),
	// 			},
	// 			Mode: to.Ptr(armcontainerservice.AgentPoolModeUser),
	// 			NodeImageVersion: to.Ptr("AKSUbuntu:1604:2023.03.11"),
	// 			OperatingSystem: &armcontainerservice.MachineOSProfile{
	// 				EnableFIPS: to.Ptr(false),
	// 				OSSKU: to.Ptr(armcontainerservice.OSSKUUbuntu),
	// 				OSType: to.Ptr(armcontainerservice.OSTypeLinux),
	// 			},
	// 			Priority: to.Ptr(armcontainerservice.ScaleSetPrioritySpot),
	// 			ProvisioningState: to.Ptr("Succeeded"),
	// 			Status: &armcontainerservice.MachineStatus{
	// 				CreationTimestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2025-04-02T12:00:00Z"); return t}()),
	// 				DriftAction: to.Ptr(armcontainerservice.DriftActionSynced),
	// 				VMState: to.Ptr(armcontainerservice.VMStateRunning),
	// 			},
	// 			Tags: map[string]*string{
	// 				"name1": to.Ptr("val1"),
	// 			},
	// 		},
	// 		Zones: []*string{
	// 			to.Ptr("1"),
	// 		},
	// 	},
	// }
}

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");

/**
 * This sample demonstrates how to creates or updates a machine in the specified agent pool.
 *
 * @summary creates or updates a machine in the specified agent pool.
 * x-ms-original-file: 2026-04-02-preview/MachineCreate_Update.json
 */
async function createOrUpdateMachine() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.machines.createOrUpdate(
    "rg1",
    "clustername1",
    "agentpool1",
    "machine1",
    {
      properties: {
        hardware: { vmSize: "Standard_DS1_v2" },
        kubernetes: {
          kubeletDiskType: "OS",
          maxPods: 110,
          nodeLabels: { key1: "val1" },
          nodeTaints: ["Key1=Value1:NoSchedule"],
          orchestratorVersion: "1.30",
        },
        mode: "User",
        operatingSystem: { enableFips: false, osSKU: "Ubuntu", osType: "Linux" },
        priority: "Spot",
        tags: { name1: "val1" },
      },
    },
  );
  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

Ukázková odpověď

Stavový kód:: 200

{
  "name": "machine1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools/machines",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1",
  "properties": {
    "hardware": {
      "vmSize": "Standard_DS1_v2"
    },
    "kubernetes": {
      "currentOrchestratorVersion": "1.30.6",
      "kubeletDiskType": "OS",
      "maxPods": 110,
      "nodeLabels": {
        "key1": "val1"
      },
      "nodeName": "aks-nodepool1-machine1-25481572-vm0",
      "nodeTaints": [
        "Key1=Value1:NoSchedule"
      ],
      "orchestratorVersion": "1.30"
    },
    "mode": "User",
    "nodeImageVersion": "AKSUbuntu:1604:2023.03.11",
    "operatingSystem": {
      "enableFIPS": false,
      "osSKU": "Ubuntu",
      "osType": "Linux"
    },
    "priority": "Spot",
    "provisioningState": "Succeeded",
    "status": {
      "creationTimestamp": "2025-04-02T12:00:00Z",
      "driftAction": "Synced",
      "vmState": "Running"
    },
    "tags": {
      "name1": "val1"
    }
  },
  "zones": [
    "1"
  ]
}

Stavový kód:: 201

{
  "name": "machine1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools/machines",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1",
  "properties": {
    "hardware": {
      "vmSize": "Standard_DS1_v2"
    },
    "kubernetes": {
      "currentOrchestratorVersion": "1.30.6",
      "kubeletDiskType": "OS",
      "maxPods": 110,
      "nodeLabels": {
        "key1": "val1"
      },
      "nodeName": "aks-nodepool1-machine1-25481572-vm0",
      "nodeTaints": [
        "Key1=Value1:NoSchedule"
      ],
      "orchestratorVersion": "1.30"
    },
    "mode": "User",
    "nodeImageVersion": "AKSUbuntu:1604:2023.03.11",
    "operatingSystem": {
      "enableFIPS": false,
      "osSKU": "Ubuntu",
      "osType": "Linux"
    },
    "priority": "Spot",
    "provisioningState": "Creating",
    "status": {
      "creationTimestamp": "2025-04-02T12:00:00Z",
      "driftAction": "Synced",
      "vmState": "Running"
    },
    "tags": {
      "name1": "val1"
    }
  },
  "zones": [
    "1"
  ]
}

Definice

Name	Description
AgentPoolArtifactStreamingProfile	Profil streamování artefaktů pro agentní pool.
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
AgentPoolSSHAccess	Metoda přístupu SSH fondu agentů.
AgentPoolWindowsProfile	Profil konkrétního fondu agentů Windows.
createdByType	Typ identity, která prostředek vytvořila.
DriftAction	Driftová činnost stroje. Označuje, zda se počítač odchýlil od očekávaného stavu kvůli změnám ve vlastnostech spravovaného clusteru, které vyžadují nápravnou akci.
DriverType	Zadejte typ ovladače GPU, který se má nainstalovat při vytváření fondů agentů Windows. Pokud není k dispozici, AKS vybere ovladač na základě kompatibility systému. Po vytvoření fondu agentů nelze tuto možnost změnit. Toto nastavení nelze nastavit v fondech agentů Linuxu. U fondu agentů pro Linux je ovladač vybrán na základě kompatibility systému.
ErrorAdditionalInfo	Další informace o chybě při správě 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ů.
HardEvictionThreshold	Tvrdé prahy vyřazení pro Kubelet. Tyto prahy vyvolávají vyřazení podu, když zdroje uzlů klesnou pod stanovené hodnoty. Hodnoty musí být větší nebo rovny zdokumentovaným minimům pro každé návěstidle. Podporované formáty jsou Ki, Mi, Gi nebo procenta používající %.
IPFamily	Určení, zda adresa patří do rodiny IPv4 nebo IPv6
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.
KubeReserved	Hodnoty vyhrazené Kubelet. Pokud není nastavena hodnota, použije se systémově vypočítané výchozí nastavení založené na velikosti VM. Podrobnosti o vypočítaných výchozích hodnotách viz rezervace zdrojů AKS uzlů . Platí to pouze pro linuxové nodepooly.
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.
Machine	Stroj. Obsahuje podrobnosti o základním virtuálním počítači. Počítač může být zde viditelný, ale ne v kubectl get nodes; Pokud ano, může to být proto, že počítač ještě není zaregistrovaný na serveru rozhraní API Kubernetes.
MachineBillingProfile	Vlastnosti týkající se strojového fakturování.
MachineHardwareProfile	Nastavení hardwaru a GPU počítače.
MachineIpAddress	Podrobnosti IP adresy počítače.
MachineKubernetesProfile	Konfigurace Kubernetes používané počítačem.
MachineNetworkProperties	vlastnosti sítě počítače
MachineOSProfile	Operační systém a disk používaný zařízením.
MachineOSProfileLinuxProfile	Specifický profil počítače se systémem Linux.
MachineProperties	Vlastnosti počítače
MachineSecurityProfile	Nastavení zabezpečení zařízení.
MachineStatus	Obsahuje informace o zařízení, které jsou určeny pouze ke čtení.
ManagementMode	Managed GPU experience instaluje další komponenty, jako jsou metriky Data Center GPU Manager (DCGM) pro monitorování, navíc k ovladači GPU pro vás. Pro více informací o tom, co je instalováno, se podívejte na aka.ms/aks/managed-gpu.
MigStrategy	Nastavuje strategii MIG (Multi-Instance GPU), která bude použita pro podporu spravovaných MIGů. Pro více informací o různých strategiích navštivte aka.ms/aks/managed-gpu. Pokud není specifikováno, výchozí je Žádné.
NvidiaGPUProfile	Specifická nastavení GPU pro NVIDIA
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 při Kubernetes >= 1.25, pokud je OSType Windows.
OSType	Typ operačního systému. Výchozí hodnota je Linux.
ScaleSetEvictionPolicy	Zásady vyřazení škálovací sady virtuálních počítačů. Politika vystěhování specifikuje, co to do VM udělat při jeho vystěhování. Výchozí hodnota je Odstranit. Pro více informací o vyřazení viz spot VMs
ScaleSetPriority	Priorita škálovací sady virtuálních počítačů
SeccompDefault	Určuje výchozí profil seccomp použitý pro všechny úlohy. Pokud není zadáno, použije se ve výchozím nastavení hodnota Unconfined.
SysctlConfig	Nastavení sysctl pro uzly agenta Linuxu.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
VmState	Stav virtuálního počítače. Označuje aktuální stav základního virtuálního počítače.
WorkloadRuntime	Určuje typ úlohy, který může uzel spustit.

AgentPoolArtifactStreamingProfile

Objekt

Profil streamování artefaktů pro agentní pool.

Name	Typ	Description
enabled	boolean	Streamování artefaktů zrychluje studený start kontejnerů na uzlu prostřednictvím načítání imagí na vyžádání. Aby bylo možné tuto funkci použít, musí image kontejnerů také povolit streamování artefaktů v ACR. Pokud není zadáno, výchozí hodnota je false.

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č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	Fondy uživatelských agentů jsou primárně určené pro hostování podů aplikací.
Gateway	Fondy agentů brány jsou vyhrazené pro poskytování statických IP adres pro odchozí přenos dat podům. Další podrobnosti najdete tady: https://aka.ms/aks/static-egress-gateway.
ManagedSystem	ManagedSystem je systémový fond spravovaný službou AKS. Fond se dynamicky škáluje podle využití clusteru a má další možnosti automatického monitorování a léčení. Fond ManagedSystem může být pouze jeden a pro dosažení nejlepších výsledků doporučujeme odstranit všechny ostatní systémové fondy.
Machines	Fondy agentů počítačů jsou vyhrazené pro hostování počítačů. Na úrovni fondu jsou povoleny pouze omezené operace, jako je vytváření a odstraňování. Ke správě celého životního cyklu stroje používejte rozhraní API počítače.

AgentPoolSSHAccess

Výčet

Metoda přístupu SSH fondu agentů.

Hodnota	Description
LocalUser	Může se k uzlu připojit přes SSH jako místní uživatel pomocí privátního klíče.
Disabled	Služba SSH bude v uzlu vypnuta.
EntraId	SSH na uzel s integrací EntraId. Více informací naleznete v části https://aka.ms/aks/ssh/aad

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.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

DriftAction

Výčet

Driftová činnost stroje. Označuje, zda se počítač odchýlil od očekávaného stavu kvůli změnám ve vlastnostech spravovaného clusteru, které vyžadují nápravnou akci.

Hodnota	Description
Synced	Stroj je aktuální.
Recreate	Počítač se zatoulal a je třeba jej odstranit a znovu vytvořit.

DriverType

Výčet

Zadejte typ ovladače GPU, který se má nainstalovat při vytváření fondů agentů Windows. Pokud není k dispozici, AKS vybere ovladač na základě kompatibility systému. Po vytvoření fondu agentů nelze tuto možnost změnit. Toto nastavení nelze nastavit v fondech agentů Linuxu. U fondu agentů pro Linux je ovladač vybrán na základě kompatibility systému.

Hodnota	Description
GRID	Nainstalujte ovladač GRID pro GPU, který je vhodný pro aplikace vyžadující podporu virtualizace.
CUDA	Nainstalujte ovladač CUDA pro GPU optimalizovaný pro výpočetní úlohy ve vědeckých výpočetních aplikacích a aplikacích náročných na data.

ErrorAdditionalInfo

Objekt

Další informace o chybě při správě 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	Profil instance MIG 1g GPU.
MIG2g	Profil instance MIG 2g GPU.
MIG3g	Profil instance MIG 3G GPU.
MIG4g	Profil instance MIG 4G GPU.
MIG7g	Profil instance GPU MIG 7g.

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.
driverType	DriverType	Zadejte typ ovladače GPU, který se má nainstalovat při vytváření fondů agentů Windows. Pokud není k dispozici, AKS vybere ovladač na základě kompatibility systému. Po vytvoření fondu agentů nelze tuto možnost změnit. Toto nastavení nelze nastavit v fondech agentů Linuxu. U fondu agentů pro Linux je ovladač vybrán na základě kompatibility systému.
nvidia	NvidiaGPUProfile	Nastavení GPU specifická pro NVIDIA.

HardEvictionThreshold

Objekt

Tvrdé prahy vyřazení pro Kubelet. Tyto prahy vyvolávají vyřazení podu, když zdroje uzlů klesnou pod stanovené hodnoty. Hodnoty musí být větší nebo rovny zdokumentovaným minimům pro každé návěstidle. Podporované formáty jsou Ki, Mi, Gi nebo procenta používající %.

Name	Typ	Description
memoryAvailable	string	Práh dostupné paměti, pod kterým je vyřazení podu spuštěno. Přijímá absolutní hodnoty (např. '500 mil') nebo procentuální hodnoty (např. '5%'). Absolutní hodnoty musí být větší nebo rovny 100 mil. Procentuální hodnoty musí být větší nebo rovny 2%.
nodeFsAvailable	string	Práh dostupného prostoru souborového systému uzlů, pod kterým je spuštěna eportace podu. Přijímá absolutní hodnoty (např. '1Gi') nebo procentuální hodnoty (např. '10%'). Musí být větší nebo rovna výchozímu systému 10%.
nodeFsInodesFree	string	Práh pro dostupné inody na souborovém systému uzlu, pod kterým je spuštěno vyřazení podu. Přijímá absolutní počty inodů (např. '100000') nebo procentuální hodnoty (např. '5%'). Procentuální hodnoty musí být vyšší nebo rovny výchozímu systému 5%.

IPFamily

Výčet

Určení, zda adresa patří do rodiny IPv4 nebo IPv6

Hodnota	Description
IPv4	Řada IPv4
IPv6	Řada IPv6

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í.
hardEvictionThreshold	HardEvictionThreshold	Tvrdé prahy vyřazení pro Kubelet. Pokud není nastaven práh, použije se výchozí nastavení systému. Podrobnosti o vypočítaných výchozích hodnotách viz rezervace zdrojů AKS uzlů . Platí to pouze pro linuxové nodepooly.
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%
kubeReserved	KubeReserved	Hodnoty vyhrazené Kubelet. Pokud není nastavena hodnota, použije se systémově vypočítané výchozí nastavení založené na velikosti VM. Podrobnosti o vypočítaných výchozích hodnotách viz rezervace zdrojů AKS uzlů . Platí to pouze pro linuxové nodepooly.
podMaxPids	integer (int32)	Maximální počet procesů na pod.
seccompDefault	SeccompDefault	Určuje výchozí profil seccomp použitý pro všechny úlohy. Pokud není zadáno, použije se ve výchozím nastavení hodnota Unconfined.
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 použije disk s operačním systémem pro svá data.
Temporary	Kubelet použije dočasný disk pro svá data.

KubeReserved

Objekt

Hodnoty vyhrazené Kubelet. Pokud není nastavena hodnota, použije se systémově vypočítané výchozí nastavení založené na velikosti VM. Podrobnosti o vypočítaných výchozích hodnotách viz rezervace zdrojů AKS uzlů . Platí to pouze pro linuxové nodepooly.

Name	Typ	Description
cpuMillicores	integer (int32)	Množství CPU vyhrazeného pro démony systému Kubernetes, v milikorech. Musí být větší nebo rovna 140. Například hodnota 200 znamená 200m (0,2 jader CPU).
memoryMB	integer (int32)	Množství paměti vyhrazené pro démony systému Kubernetes v MiB. Musí být větší nebo rovna 750.

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.

Machine

Objekt

Stroj. Obsahuje podrobnosti o základním virtuálním počítači. Počítač může být zde viditelný, ale ne v kubectl get nodes; Pokud ano, může to být proto, že počítač ještě není zaregistrovaný na serveru rozhraní API Kubernetes.

Name	Typ	Description
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Název prostředku
properties	MachineProperties	Vlastnosti počítače
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts
zones	string[]	Zóna dostupnosti, ve které se počítač nachází.

MachineBillingProfile

Objekt

Vlastnosti týkající se strojového fakturování.

Name	Typ	Default value	Description
spotMaxPrice	number (float)	-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í. Další podrobnosti o spotových cenách najdete v tématu s cenami spotových virtuálních počítačů.

MachineHardwareProfile

Objekt

Nastavení hardwaru a GPU počítače.

Name	Typ	Description
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.
gpuProfile	GPUProfile	Nastavení GPU počítače.
ultraSsdEnabled	boolean	Zda povolit UltraSSD
vmSize	string	Velikost virtuálního počítače. 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

MachineIpAddress

Objekt

Podrobnosti IP adresy počítače.

Name	Typ	Description
family	IPFamily	Určení, zda adresa patří do rodiny IPv4 nebo IPv6
ip	string	IPv4 nebo IPv6 adresa zařízení

MachineKubernetesProfile

Objekt

Konfigurace Kubernetes používané počítačem.

Name	Typ	Description
artifactStreamingProfile	AgentPoolArtifactStreamingProfile	Konfigurace pro použití streamování artefaktů v AKS
currentOrchestratorVersion	string	Verze Kubernetes spuštěná na počítači. Pokud byla orchestratorVersion plně zadaná verze <major.minor.patch>, bude toto pole přesně stejné. Pokud byl <orchestratorVersion hlavní.podverze>, bude toto pole obsahovat celou <použitou verzi major.minor.patch> .
kubeletConfig	KubeletConfig	Konfigurace Kubelet v počítači.
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.
maxPods	integer (int32)	Maximální počet podů, které se dají spustit na uzlu.
nodeInitializationTaints	string[]	Tainty přidané do uzlu během vytváření, které AKS neodsouhlasí. Tyto tainty nebudou odsouhlaseny službou AKS a je možné je odebrat voláním kubectl. Tyto tainty umožňují, aby se požadovaná konfigurace spustila před tím, než je uzel připravený přijímat úlohy, například key1=value1:NoSchedule, které se pak dají odebrat. `kubectl taint nodes node1 key1=value1:NoSchedule-`
nodeLabels	object	Štítky uzlů na počítači.
nodeName	string	Název uzlu v clusteru Kubernetes.
nodeTaints	string[]	Tainty přidané do nového uzlu během vytváření počítače. Například key=value:NoSchedule.
orchestratorVersion	string	Verze Kubernetes určená uživatelem Podporují se obě verze <opravy major.minor.patch> i <major.minor> . Při <zadání hlavní.podverze> se automaticky vybere nejnovější podporovaná verze opravy.
workloadRuntime	WorkloadRuntime	Určuje typ úlohy, který může uzel spustit.

MachineNetworkProperties

Objekt

vlastnosti sítě počítače

Name	Typ	Description
enableNodePublicIP	boolean	Určuje, jestli má počítač přidělenou vlastní veřejnou IP adresu. Některé scénáře mohou vyžadovat, aby počítač přijímal 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í. Výchozí hodnota je false.
ipAddresses	MachineIpAddress[]	IPv4, IPv6 adresy stroje
nodePublicIPPrefixID	string (arm-id)	ID předpony veřejné IP adresy, ze které má uzel virtuálního počítače používat IP adresy. Toto je formulář: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
nodePublicIPTags	IPTag[]	IPTagy veřejných IP adres na úrovni instance
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}
vnetSubnetID	string (arm-id)	ID podsítě, ke které se uzel 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}

MachineOSProfile

Objekt

Operační systém a disk používaný zařízením.

Name	Typ	Default value	Description
enableFIPS	boolean		Určuje, jestli se má použít operační systém s podporou FIPS.
linuxProfile	MachineOSProfileLinuxProfile		Specifický profil počítače se systémem Linux.
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.
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.
osSKU	OSSKU		Určuje skladovou položku operačního systému používanou fondem agentů. Pokud není zadáno, výchozí je Ubuntu, pokud OSType=Linux nebo Windows2019 if OSType=Windows. Výchozí systém Windows OSSKU se po vyřazení Windows2019 změní na Windows2022.
osType	OSType	Linux	Typ operačního systému. Výchozí hodnota je Linux.
windowsProfile	AgentPoolWindowsProfile		Specifický profil počítače se systémem Windows.

MachineOSProfileLinuxProfile

Objekt

Specifický profil počítače se systémem Linux.

Name	Typ	Description
linuxOSConfig	LinuxOSConfig	Konfigurace operačního systému počítače se systémem Linux.
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).

MachineProperties

Objekt

Vlastnosti počítače

Name	Typ	Default value	Description
billing	MachineBillingProfile		Vlastnosti týkající se strojového fakturování.
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.
evictionPolicy	ScaleSetEvictionPolicy	Delete	Politika vystěhování pro stroj. To nelze specifikovat, pokud priorita není 'Spot'. Pokud není zadáno, výchozí hodnota je Odstranit.
hardware	MachineHardwareProfile		Nastavení hardwaru a GPU počítače.
kubernetes	MachineKubernetesProfile		Konfigurace Kubernetes používané počítačem.
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.
mode	AgentPoolMode		Stroj umožňuje pouze režimy "Systém" a "Uživatel".
network	MachineNetworkProperties		vlastnosti sítě počítače
nodeImageVersion	string		Verze image uzlu.
operatingSystem	MachineOSProfile		Operační systém a disk používaný zařízením.
priority	ScaleSetPriority	Regular	Priorita pro stroj. Pokud není zadáno, výchozí hodnota je Normální.
provisioningState	string		Aktuální stav nasazení nebo zřizování.
resourceId	string (arm-id)		ID prostředku Azure počítače. Dá se použít k ZÍSKÁNÍ základní instance VM
security	MachineSecurityProfile		Nastavení zabezpečení zařízení.
status	MachineStatus		Obsahuje informace o zařízení, které jsou určeny pouze ke čtení.
tags	object		Značky, které mají být v počítači zachovány.

MachineSecurityProfile

Objekt

Nastavení zabezpečení zařízení.

Name	Typ	Description
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 tady: https://docs.microsoft.com/azure/aks/enable-host-encryption.
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ů.

MachineStatus

Objekt

Obsahuje informace o zařízení, které jsou určeny pouze ke čtení.

Name	Typ	Description
creationTimestamp	string (date-time)	Určuje čas, kdy byl počítač vytvořen.
driftAction	DriftAction	Driftová činnost stroje. Označuje, zda se počítač odchýlil od očekávaného stavu kvůli změnám ve vlastnostech spravovaného clusteru, které vyžadují nápravnou akci.
driftReason	string	Důvod pro posun stroje. Poskytuje podrobné informace o tom, proč se stroj posunul. Toto pole je vynecháno, pokud je počítač aktuální.
provisioningError	ErrorDetail	Informace o chybě podrobně o zařízení. Zachovává podrobné informace o selhání. Pokud nedošlo k chybě, toto pole se vynechá.
vmState	VmState	Stav virtuálního počítače. Označuje aktuální stav základního virtuálního počítače.

ManagementMode

Výčet

Managed GPU experience instaluje další komponenty, jako jsou metriky Data Center GPU Manager (DCGM) pro monitorování, navíc k ovladači GPU pro vás. Pro více informací o tom, co je instalováno, se podívejte na aka.ms/aks/managed-gpu.

Hodnota	Description
Unmanaged	Spravované GPU je u NVIDIA GPU zakázáno.
Managed	Spravované GPU je povoleno i pro NVIDIA GPU.

MigStrategy

Výčet

Nastavuje strategii MIG (Multi-Instance GPU), která bude použita pro podporu spravovaných MIGů. Pro více informací o různých strategiích navštivte aka.ms/aks/managed-gpu. Pokud není specifikováno, výchozí je Žádné.

Hodnota	Description
None	Nenastavujte strategii MIG. Pokud jste dříve měli jednu sadu, tato strategie ji přepíše a odstraní strategii MIG setu.
Single	Nastavte strategii MIG pro spravovaný MIG jako single.
Mixed	Nastavte strategii MIG pro spravovaný MIG jako smíšenou.

NvidiaGPUProfile

Objekt

Specifická nastavení GPU pro NVIDIA

Name	Typ	Description
managementMode	ManagementMode	Managed GPU experience instaluje další komponenty, jako jsou metriky Data Center GPU Manager (DCGM) pro monitorování, navíc k ovladači GPU pro vás. Pro více informací o tom, co je instalováno, se podívejte na aka.ms/aks/managed-gpu.
migStrategy	MigStrategy	Nastavuje strategii MIG (Multi-Instance GPU), která bude použita pro podporu spravovaných MIGů. Pro více informací o různých strategiích navštivte aka.ms/aks/managed-gpu. Pokud není specifikováno, výchozí je Žádné.

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

Hodnota

Description

Managed

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.

Ephemeral

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.

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 při Kubernetes >= 1.25, pokud je OSType Windows.

Hodnota	Description
Ubuntu	Jako operační systém použijte Ubuntu pro image uzlů.
AzureLinux	Jako operační systém pro image uzlů použijte AzureLinux. Azure Linux je linuxová distribuce optimalizovaná pro kontejnery a vybudovaná Microsoft, pro více informací navštivte https://aka.ms/azurelinux.
AzureLinux3	Jako operační systém pro image uzlů použijte AzureLinux3. Azure Linux je linuxová distribuce optimalizovaná pro kontejnery a vybudovaná Microsoft, pro více informací navštivte 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.
Mariner	Zastaralá jednotka OSSKU. Microsoft doporučuje, aby nové nasazení zvolily místo toho 'AzureLinux'.
Flatcar	Jako operační systém pro obrazy uzlů použijte Flatcar Container Linux. Flatcar je linuxový operační systém optimalizovaný pro kontejnery a zaměřený na bezpečnost, s neměnným souborovým systémem a součástí Cloud Native Computing Foundation (CNCF). Další informace o kontejnerovém Linuxu Flatcar pro AKS najdete v tématu aka.ms/aks/flatcar-container-linux-for-aks
CBLMariner	Zastaralá jednotka OSSKU. Microsoft doporučuje, aby nové nasazení zvolily místo toho 'AzureLinux'.
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.
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
Windows2025	Jako operační systém pro obrazy uzlů použijte Windows2025. Nepodporované fondy systémových uzlů. Windows2025 podporuje kontejnery Windows2022 a Windows 2025; nemůže spouštět kontejnery Windows2019 a naopak.
WindowsAnnual	Použijte verzi Windows Annual Channel jako operační systém pro obrazy uzlů. Nepodporované fondy systémových uzlů. Podrobnosti o podporovaných imagích kontejnerů a verzích Kubernetes v různých verzích AKS Annual Channel se dají zobrazit v https://aka.ms/aks/windows-annual-channel-details.
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
AzureContainerLinux	Použijte Azure Container Linux jako operační systém pro obrazy uzlů. Azure Container Linux je linuxový operační systém optimalizovaný pro kontejnery a bezpečnost zaměřený na bezpečnost postavený na Azure Linuxu s neměnným souborovým systémem. ACL vychází z projektu Flatcar Container Linux, navazuje na osvědčený design Flatcaru zaměřený na kontejnery a neměnné řešení, přičemž přidává balíčky pro Azure Linux, servis a hlubokou integraci s cykly Azure a AKS. Další informace najdete v tématu https://aka.ms/azurecontainerlinux

OSType

Výčet

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

Hodnota	Description
Linux	Použijte Linux.
Windows	Používejte Windows.

ScaleSetEvictionPolicy

Výčet

Zásady vyřazení škálovací sady virtuálních počítačů. Politika vystěhování specifikuje, co to do VM udělat při jeho vystěhování. Výchozí hodnota je Odstranit. Pro více informací o vyřazení viz spot VMs

Hodnota	Description
Delete	Uzly v podkladové škálovací sadě fondu uzlů se odstraní, když se vyřadí.
Deallocate	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.

ScaleSetPriority

Výčet

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

Hodnota	Description
Spot	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.
Regular	Použijí se běžné virtuální počítače.

SeccompDefault

Výčet

Určuje výchozí profil seccomp použitý pro všechny úlohy. Pokud není zadáno, použije se ve výchozím nastavení hodnota Unconfined.

Hodnota	Description
Unconfined	Není použit žádný profil seccomp, což umožňuje všechna systémová volání.
RuntimeDefault	Použije se výchozí profil seccomp pro modul runtime kontejneru, který omezuje určitá systémová volání pro rozšířené zabezpečení.

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.

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

VmState

Výčet

Stav virtuálního počítače. Označuje aktuální stav základního virtuálního počítače.

Hodnota	Description
Running	Virtuální počítač je aktuálně spuštěn.
Deleted	Virtuální počítač byl odstraněn uživatelem nebo z důvodu okamžitého vyřazení.

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).
KataMshvVmIsolation	Uzly mohou použít (Kata + Cloud Hypervisor + Hyper-V) k povolení vnořených VM podů (Preview). Díky použití Hyper-V je operační systém uzlu AKS samotný vnořený VM (kořenový OS) Hyper-V. Dá se tedy použít pouze u řad virtuálních počítačů, které podporují vnořenou virtualizaci, jako je řada Dv3. Tato konvence pojmenování bude v budoucích verzích zastaralá ve prospěch KataVmIsolation.
KataVmIsolation	Uzly mohou pomocí (Kata + Cloud Hypervisor + Hyper-V) povolit vnořené pody založené na virtuálních počítačích. Díky použití Hyper-V je operační systém uzlu AKS samotný vnořený VM (kořenový OS) Hyper-V. Dá se tedy použít pouze u řad virtuálních počítačů, které podporují vnořenou virtualizaci, jako je řada Dv3.