Machines - Create Or Update

Dienst:

AKS

API-Version:

2026-01-02-preview

Erstellt oder aktualisiert einen Computer im angegebenen Agent-Pool.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	Der Name des Agentpools.
machineName	path	True	string pattern: ^[a-z][a-z0-9]{0,11}$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,39}$	Hostname des Geräts.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
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]$	Der Name der verwalteten Clusterressource.
subscriptionId	path	True	string (uuid)	Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
if-match		string	Die Anforderung sollte nur fortgesetzt werden, wenn eine Entität mit dieser Zeichenfolge übereinstimmt.
if-none-match		string	Die Anforderung sollte nur fortgesetzt werden, wenn keine Entität mit dieser Zeichenfolge übereinstimmt.

Anforderungstext

Name	Typ	Beschreibung
properties	MachineProperties	Die Eigenschaften des Computers

Antworten

Name	Typ	Beschreibung
200 OK	Machine	Die Aktualisierung der Ressource 'Maschine' war erfolgreich
201 Created	Machine	Die Erstellungsoperation der Ressource 'Maschine' war erfolgreich Header Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Create/Update Machine

Beispielanforderung

HTTP

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-01-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"
    }
  }
}

Python

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

Go

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-01-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 pull 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

Beispiel für eine Antwort

Statuscode:

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"
  ]
}

Statuscode:

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"
  ]
}

Definitionen

Name	Beschreibung
AgentPoolArtifactStreamingProfile	Artefakt-Streaming-Profil für den Agentenpool.
AgentPoolMode	Der Modus eines Agentpools. Ein Cluster muss immer über mindestens einen 'System'-Agentpool verfügen. Weitere Informationen zu Agentpooleinschränkungen und bewährten Methoden finden Sie unter: https://docs.microsoft.com/azure/aks/use-system-pools
AgentPoolSSHAccess	SSH access Methode eines Agentenpools.
AgentPoolWindowsProfile	Das spezifische Profil des Windows-Agentpools.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DriftAction	Die Driftwirkung der Maschine. Gibt an, ob ein Computer aufgrund von Änderungen an den Eigenschaften des verwalteten Clusters vom erwarteten Zustand abgewichen ist und Korrekturmaßnahmen erforderlich sind.
DriverType	Geben Sie den Typ des GPU-Treibers an, der beim Erstellen von Windows-Agentpools installiert werden soll. Wenn nicht angegeben, wählt AKS den Treiber basierend auf der Systemkompatibilität aus. Dies kann nicht geändert werden, nachdem der AgentPool erstellt wurde. Dies kann nicht für Linux-AgentPools festgelegt werden. Für Linux-AgentPools wird der Treiber basierend auf der Systemkompatibilität ausgewählt.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
GPUDriver	Gibt an, ob GPU-Treiber installiert werden sollen. Wenn sie nicht angegeben ist, ist die Standardeinstellung "Installieren".
GPUInstanceProfile	GPUInstanceProfile, das zum Angeben des GPU-MIG-Instanzprofils für unterstützte GPU-VM-SKU verwendet werden soll.
GPUProfile	GPU-Einstellungen für den Agentpool.
IPFamily	So bestimmen Sie, ob die Adresse zur IPv4- oder IPv6-Familie gehört
IPTag	Enthält das dem Objekt zugeordnete IPTag.
KubeletConfig	Kubelet-Konfigurationen von Agentknoten. Weitere Informationen finden Sie unter konfiguration der benutzerdefinierten AKS-Knotenkonfiguration.
KubeletDiskType	Bestimmt die Platzierung der leeren Dir-Volumes, der Containerlaufzeit-Datenwurzel und der Kubelet-Ephemeral-storage.
LinuxOSConfig	Betriebssystemkonfigurationen von Linux-Agentknoten. Weitere Informationen finden Sie unter konfiguration der benutzerdefinierten AKS-Knotenkonfiguration.
LocalDNSForwardDestination	Zielserver für DNS-Abfragen, die von localDNS weitergeleitet werden sollen.
LocalDNSForwardPolicy	Forward-Richtlinie für die Auswahl des Upstream-DNS-Servers. Weitere Informationen finden Sie unter Forward-Plugin .
LocalDNSMode	Aktivierungsmodus für localDNS.
LocalDNSOverride	Außerkraftsetzungen für localDNS-Profil.
LocalDNSProfile	Konfiguriert das lokale DNS pro Knoten mit VnetDNS- und KubeDNS-Außerkraftsetzungen. LocalDNS trägt dazu bei, die Leistung und Zuverlässigkeit der DNS-Auflösung in einem AKS-Cluster zu verbessern. Weitere Informationen finden Sie unter aka.ms/aks/localdns.
LocalDNSProtocol	Erzwingen Sie TCP oder bevorzugen Sie das UDP-Protokoll für Verbindungen von localDNS zum Upstream-DNS-Server.
LocalDNSQueryLogging	Protokollebene für DNS-Abfragen in localDNS.
LocalDNSServeStale	Richtlinie für die Bereitstellung veralteter Daten. Weitere Informationen finden Sie unter Cache-Plugin .
LocalDNSState	Vom System generierter Zustand von localDNS.
Machine	Eine Maschine. Enthält Details zum zugrunde liegenden virtuellen Computer. Ein Computer ist hier möglicherweise sichtbar, aber nicht in kubectl get Knoten; wenn ja, liegt dies daran, dass der Computer noch nicht mit dem Kubernetes-API-Server registriert wurde.
MachineBillingProfile	Die Immobilien haben mit der Maschinenabrechnung zu tun.
MachineHardwareProfile	Die Hardware- und GPU-Einstellungen des Geräts.
MachineIpAddress	Die IP-Adressdetails des Computers.
MachineKubernetesProfile	Die Kubernetes-Konfigurationen, die von der Maschine verwendet werden.
MachineNetworkProperties	Netzwerkeigenschaften des Computers
MachineOSProfile	Das Betriebssystem und der Datenträger, die vom Gerät verwendet werden.
MachineOSProfileLinuxProfile	Das spezifische Profil des Linux-Computers.
MachineProperties	Die Eigenschaften des Computers
MachineSecurityProfile	Die Sicherheitseinstellungen des Geräts.
MachineStatus	Enthält schreibgeschützte Informationen über das Gerät.
ManagementMode	Das Managed-GPU-Erlebnis installiert zusätzliche Komponenten, wie zum Beispiel die Data Center GPU Manager (DCGM)-Metriken zur Überwachung, zusätzlich zum GPU-Treiber für dich. Für weitere Details zur Installation besuchen Sie aka.ms/aks/managed-gpu.
MigStrategy	Legt die MIG-Strategie (Multi-Instance GPU) fest, die für den Managed MIG-Support verwendet wird. Für weitere Informationen zu den verschiedenen Strategien besuchen Sie aka.ms/aks/managed-gpu. Wenn nicht angegeben, ist standardmäßig Keiner.
NvidiaGPUProfile	NVIDIA-spezifische GPU-Einstellungen
OSDiskType	Der Betriebssystemdatenträgertyp, der für Computer im Agentpool verwendet werden soll. Der Standardwert ist "Ephemeral", wenn die VM sie unterstützt und über einen Cachedatenträger verfügt, der größer als die angeforderte OSDiskSizeGB ist. Andernfalls wird standardmäßig "Verwaltet" verwendet. Kann nach der Erstellung nicht mehr geändert werden. Weitere Informationen finden Sie unter Ephemeral OS.
OSSKU	Gibt die vom Agentpool verwendete Betriebssystem-SKU an. Der Standardwert ist Ubuntu, wenn OSType Linux ist. Der Standardwert ist Windows2019, wenn Kubernetes <= 1.24 oder Windows2022, wenn Kubernetes >= 1.25 ist, wenn OSType Windows ist.
OSType	Der Betriebssystemtyp. Der Standardwert ist Linux.
ScaleSetEvictionPolicy	Die Richtlinie zum Entfernen von VM-Skalierungsgruppen. Die Räumungsrichtlinie legt fest, was mit der VM to do ist, wenn sie geräumt wird. Der Standardwert ist Löschen. Weitere Informationen zur Räumung finden Sie unter spot-VMs
ScaleSetPriority	Priorität des Skalierungssatzes für virtuelle Computer.
SeccompDefault	Gibt das standard seccomp-Profil an, das auf alle Workloads angewendet wird. Wenn nicht angegeben, wird "Nicht definiert" standardmäßig verwendet.
SysctlConfig	Sysctl-Einstellungen für Linux-Agentknoten.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
VmState	Status des virtuellen Computers. Gibt den aktuellen Status des zugrunde liegenden virtuellen Computers an.
WorkloadRuntime	Bestimmt den Typ der Workload, die ein Knoten ausführen kann.

AgentPoolArtifactStreamingProfile

Objekt

Artefakt-Streaming-Profil für den Agentenpool.

Name	Typ	Beschreibung
enabled	boolean	Das Artefaktstreaming beschleunigt den Kaltstart von Containern auf einem Knoten durch Laden von On-Demand-Images. Um dieses Feature zu verwenden, müssen Containerimages auch das Artefaktstreaming auf ACR aktivieren. Wenn nicht angegeben, ist der Standardwert "false".

AgentPoolMode

Enumeration

Der Modus eines Agentpools. Ein Cluster muss immer über mindestens einen 'System'-Agentpool verfügen. Weitere Informationen zu Agentpooleinschränkungen und bewährten Methoden finden Sie unter: https://docs.microsoft.com/azure/aks/use-system-pools

Wert	Beschreibung
System	System-Agent-Pools dienen in erster Linie zum Hosten kritischer System-Pods wie CoreDNS und metrics-server. OsType für System-Agent-Pools muss Linux sein. Die VM-SKU für System-Agentpools muss mindestens 2vCPUs und 4 GB Arbeitsspeicher aufweisen.
User	Benutzer-Agent-Pools dienen in erster Linie zum Hosten Ihrer Anwendungspods.
Gateway	Gateway-Agent-Pools sind für die Bereitstellung statischer Ausgangs-IPs für Pods vorgesehen. Weitere Details finden Sie unter https://aka.ms/aks/static-egress-gateway.
ManagedSystem	ManagedSystem ist ein Systempool, der von AKS verwaltet wird. Der Pool wird dynamisch entsprechend der Clusternutzung skaliert und verfügt über zusätzliche automatisierte Überwachungs- und Reparaturfunktionen. Es kann nur einen ManagedSystem-Pool geben, und es wird empfohlen, alle anderen Systempools zu löschen, um eine optimale Erfahrung zu erzielen.
Machines	Maschinen-Agent-Pools sind für das Hosten von Maschinen dediziert. Nur eingeschränkte Vorgänge, wie z. B. Erstellen und Löschen, sind auf Poolebene zulässig. Bitte verwenden Sie die Maschinen-APIs, um den gesamten Maschinenlebenszyklus zu verwalten.

AgentPoolSSHAccess

Enumeration

SSH access Methode eines Agentenpools.

Wert	Beschreibung
LocalUser	Kann als lokaler Benutzer mithilfe eines privaten Schlüssels eine SSH-Verbindung zum Knoten herstellen.
Disabled	Der SSH-Dienst wird auf dem Knoten deaktiviert.
EntraId	SSH zum Knoten mit EntraId-Integration. Weitere Informationen finden Sie unter https://aka.ms/aks/ssh/aad

AgentPoolWindowsProfile

Objekt

Das spezifische Profil des Windows-Agentpools.

Name	Typ	Beschreibung
disableOutboundNat	boolean	Gibt an, ob OutboundNAT in Windows-Knoten deaktiviert werden soll. Der Standardwert ist "false". Ausgehende NAT kann nur deaktiviert werden, wenn der cluster outboundType NAT-Gateway ist und der Windows-Agentpool keine öffentliche IP-Knoten aktiviert hat.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

DriftAction

Enumeration

Die Driftwirkung der Maschine. Gibt an, ob ein Computer aufgrund von Änderungen an den Eigenschaften des verwalteten Clusters vom erwarteten Zustand abgewichen ist und Korrekturmaßnahmen erforderlich sind.

Wert	Beschreibung
Synced	Die Maschine ist auf dem neuesten Stand.
Recreate	Der Computer ist fehlerhaft und muss gelöscht und neu erstellt werden.

DriverType

Enumeration

Geben Sie den Typ des GPU-Treibers an, der beim Erstellen von Windows-Agentpools installiert werden soll. Wenn nicht angegeben, wählt AKS den Treiber basierend auf der Systemkompatibilität aus. Dies kann nicht geändert werden, nachdem der AgentPool erstellt wurde. Dies kann nicht für Linux-AgentPools festgelegt werden. Für Linux-AgentPools wird der Treiber basierend auf der Systemkompatibilität ausgewählt.

Wert	Beschreibung
GRID	Installieren Sie den GRID-Treiber für die GPU, der für Anwendungen geeignet ist, die Virtualisierungsunterstützung erfordern.
CUDA	Installieren Sie den CUDA-Treiber für die GPU, der für Rechenaufgaben im wissenschaftlichen Rechnen und in datenintensiven Anwendungen optimiert ist.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

GPUDriver

Enumeration

Gibt an, ob GPU-Treiber installiert werden sollen. Wenn sie nicht angegeben ist, ist die Standardeinstellung "Installieren".

Wert	Beschreibung
Install	Installieren Sie den Treiber.
None	Überspringen Sie die Treiberinstallation.

GPUInstanceProfile

Enumeration

GPUInstanceProfile, das zum Angeben des GPU-MIG-Instanzprofils für unterstützte GPU-VM-SKU verwendet werden soll.

Wert	Beschreibung
MIG1g	MIG 1g GPU-Instanzprofil.
MIG2g	MIG 2G-GPU-Instanzprofil.
MIG3g	MIG 3G GPU-Instanzprofil.
MIG4g	MIG 4G GPU-Instanzprofil.
MIG7g	MIG 7G GPU-Instanzprofil.

GPUProfile

Objekt

GPU-Einstellungen für den Agentpool.

Name	Typ	Beschreibung
driver	GPUDriver	Gibt an, ob GPU-Treiber installiert werden sollen. Wenn sie nicht angegeben ist, ist die Standardeinstellung "Installieren".
driverType	DriverType	Geben Sie den Typ des GPU-Treibers an, der beim Erstellen von Windows-Agentpools installiert werden soll. Wenn nicht angegeben, wählt AKS den Treiber basierend auf der Systemkompatibilität aus. Dies kann nicht geändert werden, nachdem der AgentPool erstellt wurde. Dies kann nicht für Linux-AgentPools festgelegt werden. Für Linux-AgentPools wird der Treiber basierend auf der Systemkompatibilität ausgewählt.
nvidia	NvidiaGPUProfile	NVIDIA-spezifische GPU-Einstellungen.

IPFamily

Enumeration

So bestimmen Sie, ob die Adresse zur IPv4- oder IPv6-Familie gehört

Wert	Beschreibung
IPv4	IPv4-Familie
IPv6	IPv6-Familie

IPTag

Objekt

Enthält das dem Objekt zugeordnete IPTag.

Name	Typ	Beschreibung
ipTagType	string	Der IP-Tagtyp. Beispiel: RoutingPreference.
tag	string	Der Wert des IP-Tags, das der öffentlichen IP zugeordnet ist. Beispiel: Internet.

KubeletConfig

Objekt

Kubelet-Konfigurationen von Agentknoten. Weitere Informationen finden Sie unter konfiguration der benutzerdefinierten AKS-Knotenkonfiguration.

Name	Typ	Beschreibung
allowedUnsafeSysctls	string[]	Liste zulässiger unsicherer Sysctls oder unsicherer Sysctl-Muster (endend in *).
containerLogMaxFiles	integer (int32) minimum: 2	Die maximale Anzahl von Containerprotokolldateien, die für einen Container vorhanden sein können. Die Zahl muss ≥ 2 sein.
containerLogMaxSizeMB	integer (int32)	Die maximale Größe (z. B. 10Mi) der Containerprotokolldatei, bevor sie gedreht wird.
cpuCfsQuota	boolean	Wenn die Erzwingung von CPU-CFS-Kontingenten für Container aktiviert ist, die CPU-Grenzwerte angeben. Der Standardwert ist „true“.
cpuCfsQuotaPeriod	string	Der CPU CFS-Kontingentzeitraumswert. Der Standardwert ist "100 ms". Gültige Werte sind eine Sequenz von Dezimalzahlen mit einem optionalen Bruch und einem Einheitensuffix. Beispiel: '300 ms', '2h45m'. Unterstützte Einheiten sind 'ns', 'us', 'ms', 's', 'm' und 'h'.
cpuManagerPolicy	string	Die zu verwendende CPU-Manager-Richtlinie. Der Standardwert ist "none". Weitere Informationen finden Sie unter Kubernetes CPU-Verwaltungsrichtlinien . Zulässige Werte sind "none" und "static".
failSwapOn	boolean	Wenn dieser Wert auf "true" festgelegt ist, schlägt das Kubelet fehl, wenn der Tausch auf dem Knoten aktiviert ist.
imageGcHighThreshold	integer (int32)	Der Prozentsatz der Datenträgerauslastung, nach der die Garbage Collection des Images immer ausgeführt wird. Um die Garbage Collection von Bildern zu deaktivieren, legen Sie diesen auf 100 fest. Der Standardwert ist 85%
imageGcLowThreshold	integer (int32)	Der Prozentsatz der Datenträgerauslastung, vor der die Garbage Collection von Bildern nie ausgeführt wird. Dies kann nicht höher als imageGcHighThreshold festgelegt werden. Der Standardwert ist 80%
podMaxPids	integer (int32)	Die maximale Anzahl von Prozessen pro Pod.
seccompDefault	SeccompDefault	Gibt das standard seccomp-Profil an, das auf alle Workloads angewendet wird. Wenn nicht angegeben, wird "Nicht definiert" standardmäßig verwendet.
topologyManagerPolicy	string	Die zu verwendende Topologie-Manager-Richtlinie. Weitere Informationen finden Sie unter Kubernetes Topology Manager. Der Standardwert ist "none". Zulässige Werte sind "none", "best-effort", "restricted" und "single-numa-node".

KubeletDiskType

Enumeration

Bestimmt die Platzierung der leeren Dir-Volumes, der Containerlaufzeit-Datenwurzel und der Kubelet-Ephemeral-storage.

Wert	Beschreibung
OS	Kubelet verwendet den Betriebssystemdatenträger für seine Daten.
Temporary	Kubelet verwendet die temporäre Festplatte für seine Daten.

LinuxOSConfig

Objekt

Betriebssystemkonfigurationen von Linux-Agentknoten. Weitere Informationen finden Sie unter konfiguration der benutzerdefinierten AKS-Knotenkonfiguration.

Name	Typ	Beschreibung
swapFileSizeMB	integer (int32)	Die Größe in MB einer Swapdatei, die auf jedem Knoten erstellt wird.
sysctls	SysctlConfig	Sysctl-Einstellungen für Linux-Agentknoten.
transparentHugePageDefrag	string	Gibt an, ob der Kernel aggressive Speicherkomprimierung nutzen soll, um mehr Hugepages zur Verfügung zu stellen. Gültige Werte sind "always", "defer", "defer+madvise", "madvise" und "never". Der Standardwert ist "madvise". Weitere Informationen finden Sie unter Transparent Hugepages.
transparentHugePageEnabled	string	Gibt an, ob transparente Hugepages aktiviert sind. Gültige Werte sind "always", "madvise" und "never". Der Standardwert ist "always". Weitere Informationen finden Sie unter Transparent Hugepages.

LocalDNSForwardDestination

Enumeration

Zielserver für DNS-Abfragen, die von localDNS weitergeleitet werden sollen.

Wert	Beschreibung
ClusterCoreDNS	Leiten Sie DNS-Abfragen von localDNS an den CoreDNS-Cluster weiter.
VnetDNS	Leiten Sie DNS-Abfragen von localDNS an den im VNET konfigurierten DNS-Server weiter. Für ein VNET können mehrere DNS-Server konfiguriert sein.

LocalDNSForwardPolicy

Enumeration

Forward-Richtlinie für die Auswahl des Upstream-DNS-Servers. Weitere Informationen finden Sie unter Forward-Plugin .

Wert	Beschreibung
Sequential	Implementiert die sequenzielle Auswahl von Upstream-DNS-Servern. Weitere Informationen finden Sie unter Forward-Plugin .
RoundRobin	Implementiert die Roundrobin-Auswahl von Upstream-DNS-Servern. Weitere Informationen finden Sie unter Forward-Plugin .
Random	Implementiert die zufällige Auswahl von Upstream-DNS-Servern. Weitere Informationen finden Sie unter Forward-Plugin .

LocalDNSMode

Enumeration

Aktivierungsmodus für localDNS.

Wert	Beschreibung
Preferred	Wenn die aktuelle Orchestrator-Version dieses Feature unterstützt, sollten Sie localDNS aktivieren.
Required	Aktivieren Sie localDNS.
Disabled	Deaktivieren Sie localDNS.

LocalDNSOverride

Objekt

Außerkraftsetzungen für localDNS-Profil.

Name	Typ	Standardwert	Beschreibung
cacheDurationInSeconds	integer (int32)	3600	Maximale Cache-TTL in Sekunden. Weitere Informationen finden Sie unter Cache-Plugin .
forwardDestination	LocalDNSForwardDestination	ClusterCoreDNS	Zielserver für DNS-Abfragen, die von localDNS weitergeleitet werden sollen.
forwardPolicy	LocalDNSForwardPolicy	Sequential	Forward-Richtlinie für die Auswahl des Upstream-DNS-Servers. Weitere Informationen finden Sie unter Forward-Plugin .
maxConcurrent	integer (int32)	1000	Maximale Anzahl gleichzeitiger Abfragen. Weitere Informationen finden Sie unter Forward-Plugin .
protocol	LocalDNSProtocol	PreferUDP	Erzwingen Sie TCP oder bevorzugen Sie das UDP-Protokoll für Verbindungen von localDNS zum Upstream-DNS-Server.
queryLogging	LocalDNSQueryLogging	Error	Protokollebene für DNS-Abfragen in localDNS.
serveStale	LocalDNSServeStale	Immediate	Richtlinie für die Bereitstellung veralteter Daten. Weitere Informationen finden Sie unter Cache-Plugin .
serveStaleDurationInSeconds	integer (int32)	3600	Veraltete Dauer in Sekunden bereitstellen. Weitere Informationen finden Sie unter Cache-Plugin .

LocalDNSProfile

Objekt

Konfiguriert das lokale DNS pro Knoten mit VnetDNS- und KubeDNS-Außerkraftsetzungen. LocalDNS trägt dazu bei, die Leistung und Zuverlässigkeit der DNS-Auflösung in einem AKS-Cluster zu verbessern. Weitere Informationen finden Sie unter aka.ms/aks/localdns.

Name	Typ	Standardwert	Beschreibung
kubeDNSOverrides	<string,  LocalDNSOverride>		KubeDNS-Außerkraftsetzungen gelten für DNS-Datenverkehr von Pods mit dnsPolicy:ClusterFirst (als KubeDNS-Datenverkehr bezeichnet).
mode	LocalDNSMode	Preferred	Aktivierungsmodus für localDNS.
state	LocalDNSState		Vom System generierter Zustand von localDNS.
vnetDNSOverrides	<string,  LocalDNSOverride>		VnetDNS-Außerkraftsetzungen gelten für DNS-Datenverkehr von Pods mit dnsPolicy:default oder Kubelet (als VnetDNS-Datenverkehr bezeichnet).

LocalDNSProtocol

Enumeration

Erzwingen Sie TCP oder bevorzugen Sie das UDP-Protokoll für Verbindungen von localDNS zum Upstream-DNS-Server.

Wert	Beschreibung
PreferUDP	Bevorzugen Sie das UDP-Protokoll für Verbindungen von localDNS zu einem Upstream-DNS-Server.
ForceTCP	Erzwingen Sie das TCP-Protokoll für Verbindungen von localDNS zu einem Upstream-DNS-Server.

LocalDNSQueryLogging

Enumeration

Protokollebene für DNS-Abfragen in localDNS.

Wert	Beschreibung
Error	Aktiviert die Fehlerprotokollierung in localDNS. Weitere Informationen finden Sie unter Fehler-Plugin .
Log	Aktiviert die Abfrageprotokollierung in localDNS. Weitere Informationen finden Sie unter Log-Plugin .

LocalDNSServeStale

Enumeration

Richtlinie für die Bereitstellung veralteter Daten. Weitere Informationen finden Sie unter Cache-Plugin .

Wert	Beschreibung
Verify	Bereitstellen veralteter Daten mit Verifizierung. Stellen Sie zunächst sicher, dass ein Eintrag in der Quelle immer noch nicht verfügbar ist, bevor Sie den abgelaufenen Eintrag an den Client senden. Weitere Informationen finden Sie unter Cache-Plugin .
Immediate	Bereitstellen veralteter Daten sofort. Senden Sie den abgelaufenen Eintrag an den Client, bevor Sie überprüfen, ob der Eintrag von der Quelle verfügbar ist. Weitere Informationen finden Sie unter Cache-Plugin .
Disable	Deaktivieren Sie die Bereitstellung veralteter Daten.

LocalDNSState

Enumeration

Vom System generierter Zustand von localDNS.

Wert	Beschreibung
Enabled	localDNS ist aktiviert.
Disabled	localDNS ist deaktiviert.

Machine

Objekt

Eine Maschine. Enthält Details zum zugrunde liegenden virtuellen Computer. Ein Computer ist hier möglicherweise sichtbar, aber nicht in kubectl get Knoten; wenn ja, liegt dies daran, dass der Computer noch nicht mit dem Kubernetes-API-Server registriert wurde.

Name	Typ	Beschreibung
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Der Name der Ressource
properties	MachineProperties	Die Eigenschaften des Computers
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"
zones	string[]	Die Verfügbarkeitszone, in der sich die Maschine befindet.

MachineBillingProfile

Objekt

Die Immobilien haben mit der Maschinenabrechnung zu tun.

Name	Typ	Standardwert	Beschreibung
spotMaxPrice	number (float)	-1	Der Höchstpreis (in US-Dollar), den Sie für Spotinstanzen bezahlen möchten. Mögliche Werte sind ein beliebiger Dezimalwert größer als Null oder -1, der angibt, dass der Standardpreis bei Bedarf up-to wird. Weitere Details zur Spot-Preisgestaltung finden Sie unter spot VMs Preis

MachineHardwareProfile

Objekt

Die Hardware- und GPU-Einstellungen des Geräts.

Name	Typ	Beschreibung
gpuInstanceProfile	GPUInstanceProfile	GPUInstanceProfile, das zum Angeben des GPU-MIG-Instanzprofils für unterstützte GPU-VM-SKU verwendet werden soll.
gpuProfile	GPUProfile	Die GPU-Einstellungen des Geräts.
ultraSsdEnabled	boolean	Gibt an, ob UltraSSD aktiviert werden soll
vmSize	string	Die Größe des virtuellen Computers. Die Verfügbarkeit der VM variiert je nach Region. Wenn ein Knoten unzureichende Computeressourcen (Arbeitsspeicher, CPU usw.) enthält, können Pods möglicherweise nicht ordnungsgemäß ausgeführt werden. Weitere Informationen zu eingeschränkten VM-Größen finden Sie unter: https://docs.microsoft.com/azure/aks/quotas-skus-regions

MachineIpAddress

Objekt

Die IP-Adressdetails des Computers.

Name	Typ	Beschreibung
family	IPFamily	So bestimmen Sie, ob die Adresse zur IPv4- oder IPv6-Familie gehört
ip	string	IPv4- oder IPv6-Adresse des Geräts

MachineKubernetesProfile

Objekt

Die Kubernetes-Konfigurationen, die von der Maschine verwendet werden.

Name	Typ	Beschreibung
artifactStreamingProfile	AgentPoolArtifactStreamingProfile	Konfiguration für die Verwendung des Artefaktstreamings auf AKS.
currentOrchestratorVersion	string	Die Version von Kubernetes, die auf dem Computer ausgeführt wird. Wenn OrchestratorVersion eine vollständig angegebene Version <major.minor.patch> war, ist dieses Feld genau gleich. Wenn OrchestratorVersion "major.minor<" war>, enthält dieses Feld die vollständige <version "major.minor.patch">, die verwendet wird.
kubeletConfig	KubeletConfig	Die Kubelet-Konfiguration auf dem Computer.
kubeletDiskType	KubeletDiskType	Bestimmt die Platzierung der leeren Dir-Volumes, der Containerlaufzeit-Datenwurzel und der Kubelet-Ephemeral-storage.
maxPods	integer (int32)	Die maximale Anzahl von Pods, die auf einem Knoten ausgeführt werden können.
nodeInitializationTaints	string[]	Taints, die dem Knoten während der Erstellung hinzugefügt wurden und nicht von AKS abgeglichen werden. DieseTaints werden nicht von AKS in Einklang gebracht und können mit einem Kubectl-Aufruf entfernt werden. Diese Taints ermöglichen die Ausführung der erforderlichen Konfiguration, bevor der Knoten arbeitsauslastungen akzeptiert, z. B. "key1=value1:NoSchedule", die dann entfernt werden können. kubectl taint nodes node1 key1=value1:NoSchedule-
nodeLabels	object	Die Knotenbeschriftungen auf dem Computer.
nodeName	string	Der Knotenname im Kubernetes-Cluster.
nodeTaints	string[]	Die Taints, die dem neuen Knoten während der Maschinenerstellung hinzugefügt wurden. Beispiel: key=value:NoSchedule.
orchestratorVersion	string	Die vom Benutzer angegebene Version von Kubernetes. Sowohl Patchversion <major.minor.patch> als <auch major.minor> werden unterstützt. Wenn <"major.minor"> angegeben wird, wird automatisch die neueste unterstützte Patchversion ausgewählt.
workloadRuntime	WorkloadRuntime	Bestimmt den Typ der Workload, die ein Knoten ausführen kann.

MachineNetworkProperties

Objekt

Netzwerkeigenschaften des Computers

Name	Typ	Beschreibung
enableNodePublicIP	boolean	Gibt an, ob dem Computer eine eigene öffentliche IP-Adresse zugewiesen wurde. In einigen Szenarien kann es erforderlich sein, dass der Computer seine eigenen dedizierten öffentlichen IP-Adressen erhält. Ein häufiges Szenario ist für Gaming-Workloads, bei denen eine Konsole eine direkte Verbindung mit einem virtuellen Cloudcomputer herstellen muss, um Hops zu minimieren. Die Standardeinstellung ist „false“.
ipAddresses	MachineIpAddress[]	IPv4, IPv6-Adressen des Geräts
nodePublicIPPrefixID	string (arm-id)	Die Präfix-ID der öffentlichen IP-Adresse, von der aus der VM-Knoten IP-Adressen verwenden soll. Dies ist das Formular: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
nodePublicIPTags	IPTag[]	IPTags von öffentlichen IP-Adressen auf Instanzebene.
podSubnetID	string (arm-id)	Die ID des Subnetzes, dem pods beim Starten beitreten. Wenn diese Angabe weggelassen wird, werden Pod-IPs im Knotensubnetz statisch zugewiesen (weitere Details finden Sie unter vnetSubnetID). Dies ist das Formular: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
vnetSubnetID	string (arm-id)	Die ID des Subnetzes, dem der Knoten und optional die Pods beim Start beitreten sollen. Wenn dies nicht angegeben ist, wird ein VNET und ein Subnetz generiert und verwendet. Wenn keine podSubnetID angegeben ist, gilt dies für Knoten und Pods, andernfalls gilt sie nur für Knoten. Dies ist das Formular: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

MachineOSProfile

Objekt

Das Betriebssystem und der Datenträger, die vom Gerät verwendet werden.

Name	Typ	Standardwert	Beschreibung
enableFIPS	boolean		Gibt an, ob ein FIPS-fähiges Betriebssystem verwendet werden soll.
linuxProfile	MachineOSProfileLinuxProfile		Das spezifische Profil des Linux-Computers.
osDiskSizeGB	integer (int32) minimum: 0 maximum: 2048		Betriebssystemdatenträgergröße in GB, die verwendet werden soll, um die Datenträgergröße für jeden Computer im Master-/Agent-Pool anzugeben. Wenn Sie "0" angeben, wird die Standardmäßige osDisk-Größe entsprechend der angegebenen vmSize angewendet.
osDiskType	OSDiskType		Der Betriebssystemdatenträgertyp, der für Computer im Agentpool verwendet werden soll. Der Standardwert ist "Ephemeral", wenn die VM sie unterstützt und über einen Cachedatenträger verfügt, der größer als die angeforderte OSDiskSizeGB ist. Andernfalls wird standardmäßig "Verwaltet" verwendet. Kann nach der Erstellung nicht mehr geändert werden. Weitere Informationen finden Sie unter Ephemeral OS.
osSKU	OSSKU		Gibt die vom Agentpool verwendete Betriebssystem-SKU an. Wenn nicht angegeben, ist die Standardeinstellung Ubuntu, wenn OSType=Linux oder Windows2019, wenn OSType=Windows. Und die Standardmäßige Windows OSSKU wird in Windows2022 geändert, nachdem Windows2019 veraltet ist.
osType	OSType	Linux	Der Betriebssystemtyp. Der Standardwert ist Linux.
windowsProfile	AgentPoolWindowsProfile		Das spezifische Profil des Windows-Computers.

MachineOSProfileLinuxProfile

Objekt

Das spezifische Profil des Linux-Computers.

Name	Typ	Beschreibung
linuxOSConfig	LinuxOSConfig	Die Betriebssystemkonfiguration des Linux-Computers.
messageOfTheDay	string	Nachricht des Tages für Linux-Knoten, base64-codiert. Eine base64-codierte Zeichenfolge, die nach der Decodierung in /etc/motd geschrieben wird. Dies ermöglicht die Anpassung der Nachricht des Tages für Linux-Knoten. Es darf nicht für Windows-Knoten angegeben werden. Es muss sich um eine statische Zeichenfolge (d. h. wird unformatierte Zeichenfolge gedruckt und nicht als Skript ausgeführt).

MachineProperties

Objekt

Die Eigenschaften des Computers

Name	Typ	Standardwert	Beschreibung
billing	MachineBillingProfile		Die Immobilien haben mit der Maschinenabrechnung zu tun.
eTag	string		Eindeutige schreibgeschützte Zeichenfolge, die verwendet wird, um optimistische Parallelität zu implementieren. Der eTag-Wert ändert sich, wenn die Ressource aktualisiert wird. Geben Sie einen if-match- oder if-none-match-Header mit dem eTag-Wert für eine nachfolgende Anforderung an, um die optimistische Parallelität gemäß der normalen eTag-Konvention zu aktivieren.
evictionPolicy	ScaleSetEvictionPolicy	Delete	Die Räumungspolitik für die Maschine. Dies kann nicht angegeben werden, es sei denn, die Priorität ist 'Spot'. Wenn nicht angegeben, lautet der Standardwert "Delete".
hardware	MachineHardwareProfile		Die Hardware- und GPU-Einstellungen des Geräts.
kubernetes	MachineKubernetesProfile		Die Kubernetes-Konfigurationen, die von der Maschine verwendet werden.
localDNSProfile	LocalDNSProfile		Konfiguriert das lokale DNS pro Knoten mit VnetDNS- und KubeDNS-Außerkraftsetzungen. LocalDNS trägt dazu bei, die Leistung und Zuverlässigkeit der DNS-Auflösung in einem AKS-Cluster zu verbessern. Weitere Informationen finden Sie unter aka.ms/aks/localdns.
mode	AgentPoolMode		Der Computer erlaubt nur die Modi "System" und "Benutzer".
network	MachineNetworkProperties		Netzwerkeigenschaften des Computers
nodeImageVersion	string		Die Version des Knotenimages.
operatingSystem	MachineOSProfile		Das Betriebssystem und der Datenträger, die vom Gerät verwendet werden.
priority	ScaleSetPriority	Regular	Die Priorität für die Maschine. Wenn nicht angegeben, lautet der Standardwert "Normal".
provisioningState	string		Der aktuelle Bereitstellungs- oder Bereitstellungsstatus.
resourceId	string (arm-id)		Azure-Ressourcen-ID des Computers. Es kann verwendet werden, um die zugrunde liegende VM-Instanz abzurufen
security	MachineSecurityProfile		Die Sicherheitseinstellungen des Geräts.
status	MachineStatus		Enthält schreibgeschützte Informationen über das Gerät.
tags	object		Die Tags, die auf dem Computer beibehalten werden sollen.

MachineSecurityProfile

Objekt

Die Sicherheitseinstellungen des Geräts.

Name	Typ	Beschreibung
enableEncryptionAtHost	boolean	Gibt an, ob hostbasierte Betriebssystem- und Datenlaufwerkverschlüsselung aktiviert werden sollen. Dies wird nur bei bestimmten VM-Größen und in bestimmten Azure-Regionen unterstützt. Weitere Informationen finden Sie unter: https://docs.microsoft.com/azure/aks/enable-host-encryption
enableSecureBoot	boolean	Sicherer Start ist ein Feature des vertrauenswürdigen Starts, das sicherstellt, dass nur signierte Betriebssysteme und Treiber starten können. Weitere Informationen finden Sie unter aka.ms/aks/trustedlaunch. Wenn nicht angegeben, ist der Standardwert "false".
enableVTPM	boolean	vTPM ist ein vertrauenswürdiges Startfeature zum Konfigurieren eines dedizierten sicheren Tresors für Schlüssel und Messungen, die lokal auf dem Knoten gespeichert sind. Weitere Informationen finden Sie unter aka.ms/aks/trustedlaunch. Wenn nicht angegeben, ist der Standardwert "false".
sshAccess	AgentPoolSSHAccess	SSH access Methode eines Agentenpools.

MachineStatus

Objekt

Enthält schreibgeschützte Informationen über das Gerät.

Name	Typ	Beschreibung
creationTimestamp	string (date-time)	Gibt den Zeitpunkt an, zu dem die Maschine erstellt wurde.
driftAction	DriftAction	Die Driftwirkung der Maschine. Gibt an, ob ein Computer aufgrund von Änderungen an den Eigenschaften des verwalteten Clusters vom erwarteten Zustand abgewichen ist und Korrekturmaßnahmen erforderlich sind.
driftReason	string	Grund für die Abdrift der Maschine. Bietet detaillierte Informationen darüber, warum die Maschine abdriftet ist. Dieses Feld wird weggelassen, wenn die Maschine auf dem neuesten Stand ist.
provisioningError	ErrorDetail	Die Fehlerdetails des Geräts. Behält die detaillierten Informationen zum Fehler bei. Wenn kein Fehler aufgetreten ist, wird dieses Feld weggelassen.
vmState	VmState	Status des virtuellen Computers. Gibt den aktuellen Status des zugrunde liegenden virtuellen Computers an.

ManagementMode

Enumeration

Das Managed-GPU-Erlebnis installiert zusätzliche Komponenten, wie zum Beispiel die Data Center GPU Manager (DCGM)-Metriken zur Überwachung, zusätzlich zum GPU-Treiber für dich. Für weitere Details zur Installation besuchen Sie aka.ms/aks/managed-gpu.

Wert	Beschreibung
Unmanaged	Die Managed GPU Experience ist für NVIDIA-GPUs deaktiviert.
Managed	Das Managed-GPU-Erlebnis ist für NVIDIA-GPUs aktiviert.

MigStrategy

Enumeration

Legt die MIG-Strategie (Multi-Instance GPU) fest, die für den Managed MIG-Support verwendet wird. Für weitere Informationen zu den verschiedenen Strategien besuchen Sie aka.ms/aks/managed-gpu. Wenn nicht angegeben, ist standardmäßig Keiner.

Wert	Beschreibung
None	Setze keine MIG-Strategie. Wenn du vorher eine festgelegt hattest, wird diese überschrieben und die Set MIG-Strategie entfernt.
Single	Setze die MIG-Strategie für Managed MIG als Einzelperson ein.
Mixed	Stellen Sie die MIG-Strategie für das verwaltete MIG als gemischt fest.

NvidiaGPUProfile

Objekt

NVIDIA-spezifische GPU-Einstellungen

Name	Typ	Beschreibung
managementMode	ManagementMode	Das Managed-GPU-Erlebnis installiert zusätzliche Komponenten, wie zum Beispiel die Data Center GPU Manager (DCGM)-Metriken zur Überwachung, zusätzlich zum GPU-Treiber für dich. Für weitere Details zur Installation besuchen Sie aka.ms/aks/managed-gpu.
migStrategy	MigStrategy	Legt die MIG-Strategie (Multi-Instance GPU) fest, die für den Managed MIG-Support verwendet wird. Für weitere Informationen zu den verschiedenen Strategien besuchen Sie aka.ms/aks/managed-gpu. Wenn nicht angegeben, ist standardmäßig Keiner.

OSDiskType

Enumeration

Der Betriebssystemdatenträgertyp, der für Computer im Agentpool verwendet werden soll. Der Standardwert ist "Ephemeral", wenn die VM sie unterstützt und über einen Cachedatenträger verfügt, der größer als die angeforderte OSDiskSizeGB ist. Andernfalls wird standardmäßig "Verwaltet" verwendet. Kann nach der Erstellung nicht mehr geändert werden. Weitere Informationen finden Sie unter Ephemeral OS.

Wert	Beschreibung
Managed	Azure repliziert den Betriebssystemdatenträger für einen virtuellen Computer in Azure Storage, um Datenverluste zu vermeiden, falls die VM auf einen anderen Host verschoben werden muss. Da Container nicht so konzipiert sind, dass der lokale Zustand beibehalten wird, bietet dieses Verhalten einen begrenzten Wert, während einige Nachteile bereitgestellt werden, einschließlich langsamerer Knotenbereitstellung und höherer Lese-/Schreiblatenz.
Ephemeral	Kurzlebige Betriebssystemdatenträger werden nur auf dem Hostcomputer gespeichert, genau wie ein temporärer Datenträger. Dies bietet geringere Lese-/Schreiblatenz sowie schnellere Knotenskalierung und Clusterupgrades.

OSSKU

Enumeration

Gibt die vom Agentpool verwendete Betriebssystem-SKU an. Der Standardwert ist Ubuntu, wenn OSType Linux ist. Der Standardwert ist Windows2019, wenn Kubernetes <= 1.24 oder Windows2022, wenn Kubernetes >= 1.25 ist, wenn OSType Windows ist.

Wert	Beschreibung
Ubuntu	Verwenden Sie Ubuntu als Betriebssystem für Knotenimages.
AzureLinux	Verwenden Sie AzureLinux als Betriebssystem für Knotenimages. Azure Linux ist eine containeroptimierte Linux-Distribution, die von Microsoft erstellt wurde, besuchen Sie https://aka.ms/azurelinux, um weitere Informationen zu finden.
AzureLinux3	Verwenden Sie AzureLinux3 als Betriebssystem für Knotenimages. Azure Linux ist eine containeroptimierte Linux-Distribution, die von Microsoft erstellt wurde, besuchen Sie https://aka.ms/azurelinux, um weitere Informationen zu finden. Informationen zu Einschränkungen finden Sie unter https://aka.ms/aks/node-images. Eine Anleitung zur Betriebssystemmigration finden Sie unter https://aka.ms/aks/upgrade-os-version.
Mariner	Veraltete OSSKU. Microsoft empfiehlt, stattdessen neue Bereitstellungen "AzureLinux" auszuwählen.
Flatcar	Verwenden Sie Flatcar Container Linux als Betriebssystem für Node-Images. Flatcar ist ein containeroptimiertes, sicherheitsorientiertes Linux-Betriebssystem mit einem unveränderlichen Dateisystem und Teil der Cloud Native Computing Foundation (CNCF). Weitere Informationen zu Flatcar Container Linux für AKS finden Sie unter aka.ms/aks/flatcar-container-linux-for-aks
CBLMariner	Veraltete OSSKU. Microsoft empfiehlt, stattdessen neue Bereitstellungen "AzureLinux" auszuwählen.
Windows2019	Verwenden Sie Windows2019 als Betriebssystem für Knotenimages. Nicht unterstützt für Systemknotenpools. Windows2019 unterstützt nur Windows2019-Container; Sie kann Keine Windows2022-Container ausführen und umgekehrt.
Windows2022	Verwenden Sie Windows2022 als Betriebssystem für Knotenimages. Nicht unterstützt für Systemknotenpools. Windows2022 unterstützt nur Windows2022-Container; Sie kann Keine Windows2019-Container ausführen und umgekehrt.
Ubuntu2204	Verwenden Sie Ubuntu2204 als Betriebssystem für Knotenimages, Ubuntu 22.04 wird jedoch möglicherweise nicht für alle Knotenpools unterstützt. Informationen zu Einschränkungen und unterstützten Kubernetes-Versionen finden Sie unter https://aka.ms/aks/supported-ubuntu-versions
Windows2025	Verwenden Sie Windows2025 als Betriebssystem für Knotenimages. Nicht unterstützt für Systemknotenpools. Windows2025 unterstützt Windows2022- und Windows 2025-Container. Es können keine Windows2019-Container ausgeführt werden und umgekehrt.
WindowsAnnual	Verwenden Sie die Windows Annual Channel-Version als Betriebssystem für Knotenimages. Nicht unterstützt für Systemknotenpools. Details zu unterstützten Containerimages und Kubernetes-Versionen unter verschiedenen AKS Annual Channel-Versionen finden Sie in https://aka.ms/aks/windows-annual-channel-details.
Ubuntu2404	Verwenden Sie Ubuntu2404 als Betriebssystem für Knotenimages, Ubuntu 24.04 wird jedoch möglicherweise nicht für alle Knotenpools unterstützt. Informationen zu Einschränkungen und unterstützten Kubernetes-Versionen finden Sie unter https://aka.ms/aks/supported-ubuntu-versions

OSType

Enumeration

Der Betriebssystemtyp. Der Standardwert ist Linux.

Wert	Beschreibung
Linux	Verwenden Sie Linux.
Windows	Verwenden Sie Windows.

ScaleSetEvictionPolicy

Enumeration

Die Richtlinie zum Entfernen von VM-Skalierungsgruppen. Die Räumungsrichtlinie legt fest, was mit der VM to do ist, wenn sie geräumt wird. Der Standardwert ist Löschen. Weitere Informationen zur Räumung finden Sie unter spot-VMs

Wert	Beschreibung
Delete	Knoten in der zugrunde liegenden Skalierungsgruppe des Knotenpools werden gelöscht, wenn sie entfernt werden.
Deallocate	Knoten in der zugrunde liegenden Skalierungsgruppe des Knotenpools werden bei der Entfernung auf den Status "Beendet/Zuordnung aufgehoben" festgelegt. Knoten im Zustand "Beendete Zuordnung" zählen zu Ihrem Computekontingent und können Probleme mit der Clusterskalierung oder einem Upgrade verursachen.

ScaleSetPriority

Enumeration

Priorität des Skalierungssatzes für virtuelle Computer.

Wert	Beschreibung
Spot	Es werden VMs mit Spot-Priorität verwendet. Für Spotknoten ist kein SLA vorhanden. Weitere Informationen finden Sie unter Spot auf AKS.
Regular	Es werden reguläre VMs verwendet.

SeccompDefault

Enumeration

Gibt das standard seccomp-Profil an, das auf alle Workloads angewendet wird. Wenn nicht angegeben, wird "Nicht definiert" standardmäßig verwendet.

Wert	Beschreibung
Unconfined	Es wird kein seccomp-Profil angewendet, sodass alle Systemaufrufe zulässig sind.
RuntimeDefault	Das standardmäßige seccomp-Profil für die Containerlaufzeit wird angewendet, wodurch bestimmte Systemaufrufe für eine erhöhte Sicherheit eingeschränkt werden.

SysctlConfig

Objekt

Sysctl-Einstellungen für Linux-Agentknoten.

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

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

VmState

Enumeration

Status des virtuellen Computers. Gibt den aktuellen Status des zugrunde liegenden virtuellen Computers an.

Wert	Beschreibung
Running	Der virtuelle Computer wird derzeit ausgeführt.
Deleted	Die virtuelle Maschine wurde vom Benutzer gelöscht oder aufgrund einer punktuellen Entfernung.

WorkloadRuntime

Enumeration

Bestimmt den Typ der Workload, die ein Knoten ausführen kann.

Wert	Beschreibung
OCIContainer	Knoten verwenden Kubelet zum Ausführen standardmäßiger OCI-Containerarbeitslasten.
WasmWasi	Knoten verwenden Krustlet zum Ausführen von WASM-Workloads mithilfe des WASI-Anbieters (Vorschau).
KataMshvVmIsolation	Knoten können (Kata + Cloud Hypervisor + Hyper-V) verwenden, um geschachtelte VM-basierte Pods (Vorschau) zu aktivieren. Aufgrund der Verwendung von Hyper-V ist das AKS-Knotenbetriebssystem selbst eine geschachtelte VM (das Stammbetriebssystem) von Hyper-V. Daher kann es nur mit VM-Reihen verwendet werden, die geschachtelte Virtualisierung wie dv3-Serie unterstützen. Diese Namenskonvention wird in zukünftigen Versionen zugunsten von KataVmIsolation veraltet sein.
KataVmIsolation	Knoten können (Kata + Cloud Hypervisor + Hyper-V) verwenden, um geschachtelte VM-basierte Pods zu aktivieren. Aufgrund der Verwendung von Hyper-V ist das AKS-Knotenbetriebssystem selbst eine geschachtelte VM (das Stammbetriebssystem) von Hyper-V. Daher kann es nur mit VM-Reihen verwendet werden, die geschachtelte Virtualisierung wie dv3-Serie unterstützen.