Machines - Create Or Update

Service:

AKS

API-versie:

2026-01-02-preview

Hiermee maakt of werkt u een computer bij in de opgegeven agentengroep.

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

Name	In	Vereist	Type	Description
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	De naam van de agentgroep.
machineName	path	True	string pattern: ^[a-z][a-z0-9]{0,11}$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,39}$	Hostnaam van de machine.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
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]$	De naam van de beheerde clusterresource.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagkoptekst

Name	Vereist	Type	Description
if-match		string	De aanvraag mag alleen worden voortgezet als een entiteit overeenkomt met deze tekenreeks.
if-none-match		string	De aanvraag moet alleen worden voortgezet als er geen entiteit overeenkomt met deze tekenreeks.

Aanvraagbody

Name	Type	Description
properties	MachineProperties	De eigenschappen van de machine

Antwoorden

Name	Type	Description
200 OK	Machine	De updateoperatie van de bron 'Machine' is geslaagd
201 Created	Machine	De aanmaakoperatie 'Machine' van de bron is geslaagd Kopteksten Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Create/Update Machine

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name	Description
AgentPoolArtifactStreamingProfile	Artifact streamingprofiel voor de agentenpool.
AgentPoolMode	De modus van een agentpool. Een cluster moet te allen tijde ten minste één agentgroep van het systeem hebben. Zie voor meer informatie over beperkingen en aanbevolen procedures voor agentgroepen: https://docs.microsoft.com/azure/aks/use-system-pools
AgentPoolSSHAccess	SSH-access-methode van een agentpool.
AgentPoolWindowsProfile	Het specifieke profiel van de Windows-agentgroep.
createdByType	Het type identiteit waarmee de resource is gemaakt.
DriftAction	De driftactie van de machine. Geeft aan of een computer is afgeweken van de verwachte status als gevolg van wijzigingen in de eigenschappen van beheerde clusters, waarvoor corrigerende maatregelen nodig zijn.
DriverType	Geef het type GPU-stuurprogramma op dat moet worden geïnstalleerd bij het maken van Windows-agentpools. Indien niet opgegeven, selecteert AKS het stuurprogramma op basis van systeemcompatibiliteit. Dit kan niet worden gewijzigd nadat de AgentPool is gemaakt. Dit kan niet worden ingesteld op Linux AgentPools. Voor Linux AgentPools wordt het stuurprogramma geselecteerd op basis van systeemcompatibiliteit.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
GPUDriver	Of u GPU-stuurprogramma's wilt installeren. Als deze niet is opgegeven, is de standaardwaarde Installeren.
GPUInstanceProfile	GPUInstanceProfile dat moet worden gebruikt om het GPU MIG-exemplaarprofiel op te geven voor de ondersteunde GPU VM-SKU.
GPUProfile	GPU-instellingen voor de agentgroep.
IPFamily	Bepalen of het adres tot de IPv4- of IPv6-familie behoort
IPTag	Bevat de IPTag die aan het object is gekoppeld.
KubeletConfig	Kubelet-configuraties van agentknooppunten. Zie aangepaste AKS-knooppuntconfiguratie voor meer informatie.
KubeletDiskType	Bepaalt de plaatsing van lege Dir-volumes, container runtime data root en Kubelet ephemeral storage.
LinuxOSConfig	Besturingssysteemconfiguraties van Linux-agentknooppunten. Zie aangepaste AKS-knooppuntconfiguratie voor meer informatie.
LocalDNSForwardDestination	Doelserver voor DNS-query's die moeten worden doorgestuurd vanuit localDNS.
LocalDNSForwardPolicy	Beleid doorsturen voor het selecteren van upstream DNS-server. Zie forward plugin voor meer informatie.
LocalDNSMode	Wijze van inschakelen voor localDNS.
LocalDNSOverride	Overschrijvingen voor het localDNS-profiel.
LocalDNSProfile	Configureert de lokale DNS per knooppunt, met VnetDNS- en KubeDNS-overschrijvingen. LocalDNS helpt de prestaties en betrouwbaarheid van DNS-resolutie in een AKS-cluster te verbeteren. Voor meer details zie aka.ms/aks/localdns.
LocalDNSProtocol	Dwing TCP af of geef de voorkeur aan het UDP-protocol voor verbindingen van localDNS naar upstream DNS-server.
LocalDNSQueryLogging	Logboekniveau voor DNS-query's in localDNS.
LocalDNSServeStale	Beleid voor het leveren van verouderde gegevens. Zie cache-plug-in voor meer informatie.
LocalDNSState	Door het systeem gegenereerde status van localDNS.
Machine	Een machine. Bevat details over de onderliggende virtuele machine. Een machine is hier mogelijk zichtbaar, maar niet in kubectl get-knooppunten; Als dit het gevolg is, kan het zijn dat de machine nog niet is geregistreerd bij de Kubernetes-API-server.
MachineBillingProfile	De eigendommen hebben te maken met machinefacturering.
MachineHardwareProfile	De hardware- en GPU-instellingen van de machine.
MachineIpAddress	De gegevens van het IP-adres van de machine.
MachineKubernetesProfile	De Kubernetes-configuraties die door de machine worden gebruikt.
MachineNetworkProperties	netwerkeigenschappen van de machine
MachineOSProfile	Het besturingssysteem en de schijf die door de machine worden gebruikt.
MachineOSProfileLinuxProfile	Het specifieke profiel van de Linux-machine.
MachineProperties	De eigenschappen van de machine
MachineSecurityProfile	De beveiligingsinstellingen van de machine.
MachineStatus	Bevat alleen-lezen informatie over het apparaat.
ManagementMode	De Managed GPU-ervaring installeert extra componenten, zoals de Data Center GPU Manager (DCGM)-metrics voor monitoring, bovenop de GPU-driver voor jou. Voor meer details over wat er geïnstalleerd is, kijk eens op aka.ms/aks/managed-gpu.
MigStrategy	Bepaalt de MIG (Multi-Instance GPU) strategie die gebruikt zal worden voor managed MIG-ondersteuning. Voor meer informatie over de verschillende strategieën, bezoek aka.ms/aks/managed-gpu. Wanneer niet gespecificeerd, is de standaard Geen.
NvidiaGPUProfile	NVIDIA-specifieke GPU-instellingen
OSDiskType	Het type besturingssysteemschijf dat moet worden gebruikt voor machines in de agentgroep. De standaardwaarde is 'kortstondig' als de VIRTUELE machine deze ondersteunt en een cacheschijf heeft die groter is dan de aangevraagde OSDiskSizeGB. Anders wordt standaard 'Beheerd' gebruikt. Kan niet worden gewijzigd na het maken. Voor meer informatie, zie Ephemeral OS.
OSSKU	Hiermee geeft u de SKU van het besturingssysteem op die wordt gebruikt door de agentgroep. De standaardwaarde is Ubuntu als OSType Linux is. De standaardwaarde is Windows2019 wanneer Kubernetes <= 1.24 of Windows2022 wanneer Kubernetes >= 1.25 als OSType is Windows.
OSType	Het type besturingssysteem. De standaardwaarde is Linux.
ScaleSetEvictionPolicy	Het uitzettingsbeleid voor de schaal van de virtuele machine. Het uitzettingsbeleid specificeert wat er to do is met de VM wanneer deze wordt ontruimd. De standaardinstelling is Verwijderen. Voor meer informatie over uitzettingen, zie spot VMs
ScaleSetPriority	De prioriteit van de virtuele-machineschaalset.
SeccompDefault	Hiermee geeft u het standaard seccomp-profiel dat wordt toegepast op alle workloads. Als dit niet is opgegeven, wordt 'Niet-gedefinieerd' standaard gebruikt.
SysctlConfig	Sysctl-instellingen voor Linux-agentknooppunten.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
VmState	Status van virtuele machine. Geeft de huidige status van de onderliggende virtuele machine aan.
WorkloadRuntime	Bepaalt het type workload dat een knooppunt kan uitvoeren.

AgentPoolArtifactStreamingProfile

Object

Artifact streamingprofiel voor de agentenpool.

Name	Type	Description
enabled	boolean	Artefactstreaming versnelt het koude begin van containers op een knooppunt via het laden van installatiekopieën op aanvraag. Als u deze functie wilt gebruiken, moeten containerinstallatiekopieën ook artefactstreaming inschakelen op ACR. Als dit niet is opgegeven, is de standaardwaarde onwaar.

AgentPoolMode

Opsomming

De modus van een agentpool. Een cluster moet te allen tijde ten minste één agentgroep van het systeem hebben. Zie voor meer informatie over beperkingen en aanbevolen procedures voor agentgroepen: https://docs.microsoft.com/azure/aks/use-system-pools

Waarde	Description
System	Pools van systeemagenten zijn voornamelijk bedoeld voor het hosten van kritieke systeempods zoals CoreDNS en metrics-server. Systeemagentpools osType moet Linux zijn. Vm-SKU's voor systeemagentgroepen moeten ten minste 2vCPU's en 4 GB geheugen hebben.
User	Groepen van user-agents zijn voornamelijk bedoeld voor het hosten van uw applicatiepods.
Gateway	Gateway-agentpools zijn bedoeld voor het leveren van statische uitgaande IP's aan pods. Zie https://aka.ms/aks/static-egress-gateway voor meer informatie.
ManagedSystem	ManagedSystem is een systeempool die wordt beheerd door AKS. De pool wordt dynamisch geschaald op basis van het clustergebruik en heeft aanvullende geautomatiseerde bewakings- en herstelmogelijkheden. Er kan slechts één ManagedSystem-groep zijn en het wordt aanbevolen om alle andere systeemgroepen te verwijderen voor de beste ervaring.
Machines	Pools van machineagenten zijn gewijd aan het hosten van machines. Alleen beperkte bewerkingen, zoals maken en verwijderen, zijn toegestaan op groepsniveau. Gebruik de machine-API's om de volledige levenscyclus van de machine te beheren.

AgentPoolSSHAccess

Opsomming

SSH-access-methode van een agentpool.

Waarde	Description
LocalUser	Kan SSH op het knooppunt gebruiken als lokale gebruiker met behulp van een persoonlijke sleutel.
Disabled	De SSH-service wordt uitgeschakeld op het knooppunt.
EntraId	SSH naar node met EntraId-integratie. Meer informatie is te vinden onder https://aka.ms/aks/ssh/aad

AgentPoolWindowsProfile

Object

Het specifieke profiel van de Windows-agentgroep.

Name	Type	Description
disableOutboundNat	boolean	Of OutboundNAT in Windows-knooppunten moet worden uitgeschakeld. De standaardwaarde is onwaar. Uitgaande NAT kan alleen worden uitgeschakeld als het cluster uitgaandetype NAT Gateway is en de Windows-agentgroep geen openbaar IP-adres van het knooppunt heeft ingeschakeld.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

DriftAction

Opsomming

De driftactie van de machine. Geeft aan of een computer is afgeweken van de verwachte status als gevolg van wijzigingen in de eigenschappen van beheerde clusters, waarvoor corrigerende maatregelen nodig zijn.

Waarde	Description
Synced	De machine is up-to-date.
Recreate	De machine is op drift geraakt en moet worden verwijderd en opnieuw worden gemaakt.

DriverType

Opsomming

Geef het type GPU-stuurprogramma op dat moet worden geïnstalleerd bij het maken van Windows-agentpools. Indien niet opgegeven, selecteert AKS het stuurprogramma op basis van systeemcompatibiliteit. Dit kan niet worden gewijzigd nadat de AgentPool is gemaakt. Dit kan niet worden ingesteld op Linux AgentPools. Voor Linux AgentPools wordt het stuurprogramma geselecteerd op basis van systeemcompatibiliteit.

Waarde	Description
GRID	Installeer het GRID-stuurprogramma voor de GPU, geschikt voor toepassingen die virtualisatieondersteuning vereisen.
CUDA	Installeer het CUDA-stuurprogramma voor de GPU, geoptimaliseerd voor rekentaken in wetenschappelijke computers en gegevensintensieve toepassingen.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoelwit.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

GPUDriver

Opsomming

Of u GPU-stuurprogramma's wilt installeren. Als deze niet is opgegeven, is de standaardwaarde Installeren.

Waarde	Description
Install	Stuurprogramma installeren.
None	Sla de installatie van de driver over.

GPUInstanceProfile

Opsomming

GPUInstanceProfile dat moet worden gebruikt om het GPU MIG-exemplaarprofiel op te geven voor de ondersteunde GPU VM-SKU.

Waarde	Description
MIG1g	MIG 1G GPU-instantieprofiel.
MIG2g	MIG 2G GPU-instantieprofiel.
MIG3g	MIG 3G GPU-instantieprofiel.
MIG4g	MIG 4G GPU-instanceprofiel.
MIG7g	MIG 7G GPU-instantieprofiel.

GPUProfile

Object

GPU-instellingen voor de agentgroep.

Name	Type	Description
driver	GPUDriver	Of u GPU-stuurprogramma's wilt installeren. Als deze niet is opgegeven, is de standaardwaarde Installeren.
driverType	DriverType	Geef het type GPU-stuurprogramma op dat moet worden geïnstalleerd bij het maken van Windows-agentpools. Indien niet opgegeven, selecteert AKS het stuurprogramma op basis van systeemcompatibiliteit. Dit kan niet worden gewijzigd nadat de AgentPool is gemaakt. Dit kan niet worden ingesteld op Linux AgentPools. Voor Linux AgentPools wordt het stuurprogramma geselecteerd op basis van systeemcompatibiliteit.
nvidia	NvidiaGPUProfile	NVIDIA-specifieke GPU-instellingen.

IPFamily

Opsomming

Bepalen of het adres tot de IPv4- of IPv6-familie behoort

Waarde	Description
IPv4	IPv4-familie
IPv6	IPv6-familie

IPTag

Object

Bevat de IPTag die aan het object is gekoppeld.

Name	Type	Description
ipTagType	string	Het TYPE IP-tag. Voorbeeld: RoutingPreference.
tag	string	De waarde van de IP-tag die is gekoppeld aan het openbare IP-adres. Voorbeeld: Internet.

KubeletConfig

Object

Kubelet-configuraties van agentknooppunten. Zie aangepaste AKS-knooppuntconfiguratie voor meer informatie.

Name	Type	Description
allowedUnsafeSysctls	string[]	Toegestane lijst met onveilige sysctls of onveilige sysctl-patronen (eindigend op *).
containerLogMaxFiles	integer (int32) minimum: 2	Het maximum aantal containerlogboekbestanden dat aanwezig kan zijn voor een container. Het getal moet ≥ 2 zijn.
containerLogMaxSizeMB	integer (int32)	De maximale grootte (bijvoorbeeld 10Mi) van het containerlogboekbestand voordat het wordt gedraaid.
cpuCfsQuota	boolean	Als het afdwingen van CPU CFS-quota is ingeschakeld voor containers die CPU-limieten opgeven. De standaardwaarde is waar.
cpuCfsQuotaPeriod	string	De waarde van de CPU CFS-quotumperiode. De standaardwaarde is '100ms'. Geldige waarden zijn een reeks decimale getallen met een optionele breuk en een eenheidsachtervoegsel. Bijvoorbeeld: '300ms', '2h45m'. Ondersteunde eenheden zijn 'ns', 'us', 'ms', 's', 'm' en 'h'.
cpuManagerPolicy	string	Het CPU Manager-beleid dat moet worden gebruikt. De standaardwaarde is 'none'. Zie Het Beleid voor CPU-beheer van Kubernetes voor meer informatie. Toegestane waarden zijn 'none' en 'static'.
failSwapOn	boolean	Als deze optie is ingesteld op true, kan de Kubelet niet worden gestart als wisselen is ingeschakeld op het knooppunt.
imageGcHighThreshold	integer (int32)	Het percentage schijfgebruik waarna garbagecollection van installatiekopieën altijd wordt uitgevoerd. Als u de garbagecollection van de installatiekopieën wilt uitschakelen, stelt u in op 100. De standaardwaarde is 85%
imageGcLowThreshold	integer (int32)	Het percentage schijfgebruik voordat de garbagecollection van installatiekopieën nooit wordt uitgevoerd. Dit kan niet hoger worden ingesteld dan imageGcHighThreshold. De standaardwaarde is 80%
podMaxPids	integer (int32)	Het maximum aantal processen per pod.
seccompDefault	SeccompDefault	Hiermee geeft u het standaard seccomp-profiel dat wordt toegepast op alle workloads. Als dit niet is opgegeven, wordt 'Niet-gedefinieerd' standaard gebruikt.
topologyManagerPolicy	string	Het topologiebeheerbeleid dat moet worden gebruikt. Zie Kubernetes Topology Manager voor meer informatie. De standaardwaarde is 'none'. Toegestane waarden zijn 'none', 'best-effort', 'restricted' en 'single-numa-node'.

KubeletDiskType

Opsomming

Bepaalt de plaatsing van lege Dir-volumes, container runtime data root en Kubelet ephemeral storage.

Waarde	Description
OS	Kubelet gebruikt de OS-schijf voor zijn gegevens.
Temporary	Kubelet zal de tijdelijke schijf gebruiken voor zijn gegevens.

LinuxOSConfig

Object

Besturingssysteemconfiguraties van Linux-agentknooppunten. Zie aangepaste AKS-knooppuntconfiguratie voor meer informatie.

Name	Type	Description
swapFileSizeMB	integer (int32)	De grootte in MB van een wisselbestand dat op elk knooppunt wordt gemaakt.
sysctls	SysctlConfig	Sysctl-instellingen voor Linux-agentknooppunten.
transparentHugePageDefrag	string	Of de kernel agressief gebruik moet maken van geheugencompressie om meer enorme pagina's beschikbaar te maken. Geldige waarden zijn 'altijd', 'uitstellen', 'uitstellen+madvise', 'madvise' en 'nooit'. De standaardwaarde is 'madvise'. Zie Transparent Hugepagesvoor meer informatie.
transparentHugePageEnabled	string	Of transparante enorme pagina's zijn ingeschakeld. Geldige waarden zijn 'altijd', 'madvise' en 'nooit'. De standaardwaarde is altijd. Zie Transparent Hugepagesvoor meer informatie.

LocalDNSForwardDestination

Opsomming

Doelserver voor DNS-query's die moeten worden doorgestuurd vanuit localDNS.

Waarde	Description
ClusterCoreDNS	Stuur DNS-query's door van localDNS naar cluster CoreDNS.
VnetDNS	Stuur DNS-query's door van localDNS naar de DNS-server die is geconfigureerd in het VNET. Een VNET kan meerdere DNS-servers hebben geconfigureerd.

LocalDNSForwardPolicy

Opsomming

Beleid doorsturen voor het selecteren van upstream DNS-server. Zie forward plugin voor meer informatie.

Waarde	Description
Sequential	Implementeert sequentiële upstream DNS-serverselectie. Zie forward plugin voor meer informatie.
RoundRobin	Implementeert round robin upstream DNS-serverselectie. Zie forward plugin voor meer informatie.
Random	Implementeert willekeurige upstream DNS-serverselectie. Zie forward plugin voor meer informatie.

LocalDNSMode

Opsomming

Wijze van inschakelen voor localDNS.

Waarde	Description
Preferred	Als de huidige orchestratorversie deze functie ondersteunt, geef er dan de voorkeur aan localDNS in te schakelen.
Required	Schakel localDNS in.
Disabled	Schakel localDNS uit.

LocalDNSOverride

Object

Overschrijvingen voor het localDNS-profiel.

Name	Type	Default value	Description
cacheDurationInSeconds	integer (int32)	3600	Cache max TTL in seconden. Zie cache-plug-in voor meer informatie.
forwardDestination	LocalDNSForwardDestination	ClusterCoreDNS	Doelserver voor DNS-query's die moeten worden doorgestuurd vanuit localDNS.
forwardPolicy	LocalDNSForwardPolicy	Sequential	Beleid doorsturen voor het selecteren van upstream DNS-server. Zie forward plugin voor meer informatie.
maxConcurrent	integer (int32)	1000	Maximaal aantal gelijktijdige query's. Zie forward plugin voor meer informatie.
protocol	LocalDNSProtocol	PreferUDP	Dwing TCP af of geef de voorkeur aan het UDP-protocol voor verbindingen van localDNS naar upstream DNS-server.
queryLogging	LocalDNSQueryLogging	Error	Logboekniveau voor DNS-query's in localDNS.
serveStale	LocalDNSServeStale	Immediate	Beleid voor het leveren van verouderde gegevens. Zie cache-plug-in voor meer informatie.
serveStaleDurationInSeconds	integer (int32)	3600	Serveer oud in seconden. Zie cache-plug-in voor meer informatie.

LocalDNSProfile

Object

Configureert de lokale DNS per knooppunt, met VnetDNS- en KubeDNS-overschrijvingen. LocalDNS helpt de prestaties en betrouwbaarheid van DNS-resolutie in een AKS-cluster te verbeteren. Voor meer details zie aka.ms/aks/localdns.

Name	Type	Default value	Description
kubeDNSOverrides	<string,  LocalDNSOverride>		KubeDNS-overschrijvingen zijn van toepassing op DNS-verkeer van pods met dnsPolicy:ClusterFirst (ook wel KubeDNS-verkeer genoemd).
mode	LocalDNSMode	Preferred	Wijze van inschakelen voor localDNS.
state	LocalDNSState		Door het systeem gegenereerde status van localDNS.
vnetDNSOverrides	<string,  LocalDNSOverride>		VnetDNS-overschrijvingen zijn van toepassing op DNS-verkeer van pods met dnsPolicy:default of kubelet (ook wel VnetDNS-verkeer genoemd).

LocalDNSProtocol

Opsomming

Dwing TCP af of geef de voorkeur aan het UDP-protocol voor verbindingen van localDNS naar upstream DNS-server.

Waarde	Description
PreferUDP	Geef de voorkeur aan het UDP-protocol voor verbindingen van localDNS naar de upstream DNS-server.
ForceTCP	Dwing het TCP-protocol af voor verbindingen van localDNS naar de upstream DNS-server.

LocalDNSQueryLogging

Opsomming

Logboekniveau voor DNS-query's in localDNS.

Waarde	Description
Error	Maakt foutregistratie in localDNS mogelijk. Zie fouten plugin voor meer informatie.
Log	Maakt het vastleggen van query's in localDNS mogelijk. Zie log plugin voor meer informatie.

LocalDNSServeStale

Opsomming

Beleid voor het leveren van verouderde gegevens. Zie cache-plug-in voor meer informatie.

Waarde	Description
Verify	Lever verouderde gegevens met verificatie. Controleer eerst of een vermelding nog steeds niet beschikbaar is bij de bron voordat u de verlopen vermelding naar de client verzendt. Zie cache-plug-in voor meer informatie.
Immediate	Serveer verouderde gegevens onmiddellijk. Stuur de verlopen invoer naar de klant voordat u controleert of de invoer beschikbaar is bij de bron. Zie cache-plug-in voor meer informatie.
Disable	Schakel de weergave van verlopen gegevens uit.

LocalDNSState

Opsomming

Door het systeem gegenereerde status van localDNS.

Waarde	Description
Enabled	localDNS is ingeschakeld.
Disabled	localDNS is uitgeschakeld.

Machine

Object

Een machine. Bevat details over de onderliggende virtuele machine. Een machine is hier mogelijk zichtbaar, maar niet in kubectl get-knooppunten; Als dit het gevolg is, kan het zijn dat de machine nog niet is geregistreerd bij de Kubernetes-API-server.

Name	Type	Description
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
name	string	De naam van de resource
properties	MachineProperties	De eigenschappen van de machine
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'
zones	string[]	De beschikbaarheidszone waarin de machine zich bevindt.

MachineBillingProfile

Object

De eigendommen hebben te maken met machinefacturering.

Name	Type	Default value	Description
spotMaxPrice	number (float)	-1	De maximale prijs (in Amerikaanse dollars) die u bereid bent te betalen voor spot-instanties. Mogelijke waarden zijn een decimale waarde die groter is dan nul of -1 die aangeeft dat de standaardprijs moet worden up-to op aanvraag. Voor meer details over spotprijzen, zie spot VMs prijsstelling

MachineHardwareProfile

Object

De hardware- en GPU-instellingen van de machine.

Name	Type	Description
gpuInstanceProfile	GPUInstanceProfile	GPUInstanceProfile dat moet worden gebruikt om het GPU MIG-exemplaarprofiel op te geven voor de ondersteunde GPU VM-SKU.
gpuProfile	GPUProfile	De GPU-instellingen van de machine.
ultraSsdEnabled	boolean	Of UltraSSD moet worden ingeschakeld
vmSize	string	De grootte van de virtuele machine. Beschikbaarheid van VM-grootte verschilt per regio. Als een knooppunt onvoldoende rekenresources (geheugen, cpu, enzovoort) bevat, kunnen pods mogelijk niet correct worden uitgevoerd. Zie voor meer informatie over beperkte VM-grootten: https://docs.microsoft.com/azure/aks/quotas-skus-regions

MachineIpAddress

Object

De gegevens van het IP-adres van de machine.

Name	Type	Description
family	IPFamily	Bepalen of het adres tot de IPv4- of IPv6-familie behoort
ip	string	IPv4- of IPv6-adres van de machine

MachineKubernetesProfile

Object

De Kubernetes-configuraties die door de machine worden gebruikt.

Name	Type	Description
artifactStreamingProfile	AgentPoolArtifactStreamingProfile	Configuratie voor het gebruik van artefactstreaming op AKS.
currentOrchestratorVersion	string	De versie van Kubernetes die op de machine draait. Als orchestratorVersion een volledig opgegeven versie <major.minor.patch> was, is dit veld precies gelijk aan het veld. Als orchestratorVersion major.minor< was>, bevat dit veld de volledige <versie major.minor.patch> die wordt gebruikt.
kubeletConfig	KubeletConfig	De Kubelet-configuratie op de machine.
kubeletDiskType	KubeletDiskType	Bepaalt de plaatsing van lege Dir-volumes, container runtime data root en Kubelet ephemeral storage.
maxPods	integer (int32)	Het maximum aantal pods dat op een knooppunt kan worden uitgevoerd.
nodeInitializationTaints	string[]	Smetten die tijdens het maken op de knoop worden toegevoegd en die niet door AKS worden verzoend. Deze taints worden niet afgestemd door AKS en kunnen worden verwijderd met een kubectl-aanroep. Met deze taints kan de vereiste configuratie worden uitgevoerd voordat het knooppunt klaar is om workloads te accepteren, bijvoorbeeld 'key1=value1:NoSchedule' die vervolgens kunnen worden verwijderd met kubectl taint nodes node1 key1=value1:NoSchedule-
nodeLabels	object	De knooppuntlabels op de machine.
nodeName	string	De naam van het knooppunt in het Kubernetes-cluster.
nodeTaints	string[]	De smetten die tijdens het maken van de machine aan een nieuw knooppunt worden toegevoegd. Bijvoorbeeld key=value:NoSchedule.
orchestratorVersion	string	De versie van Kubernetes die door de gebruiker is opgegeven. Zowel patchversie <major.minor.patch> als <major.minor> worden ondersteund. Wanneer <major.minor> is opgegeven, wordt automatisch de meest recente ondersteunde patchversie gekozen.
workloadRuntime	WorkloadRuntime	Bepaalt het type workload dat een knooppunt kan uitvoeren.

MachineNetworkProperties

Object

netwerkeigenschappen van de machine

Name	Type	Description
enableNodePublicIP	boolean	Of de machine een eigen publiek IP-adres krijgt toegewezen. In sommige scenario's moet de computer mogelijk zijn eigen toegewezen openbare IP-adressen ontvangen. Een veelvoorkomend scenario is voor gamingworkloads, waarbij een console een directe verbinding moet maken met een virtuele cloudmachine om hops te minimaliseren. De standaardwaarde is onwaar.
ipAddresses	MachineIpAddress[]	IPv4, IPv6-adressen van de machine
nodePublicIPPrefixID	string (arm-id)	De openbare IP-voorvoegsel-id waarvan VM-knooppunt IP's moet gebruiken. Dit is van de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
nodePublicIPTags	IPTag[]	IPTags van openbare IP-adressen op exemplaarniveau.
podSubnetID	string (arm-id)	De id van het subnet waaraan pods worden samengevoegd wanneer deze worden gestart. Als u dit weglaat, worden pod-IP's statisch toegewezen aan het knooppuntsubnet (zie vnetSubnetID voor meer informatie). Dit is van het formulier: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
vnetSubnetID	string (arm-id)	De ID van het subnet waar het knooppunt en eventueel de pods zich bij het opstarten bij aansluiten. Als dit niet is opgegeven, worden er een VNET en subnet gegenereerd en gebruikt. Als er geen podSubnetID is opgegeven, is dit van toepassing op knooppunten en pods, anders geldt dit voor alleen knooppunten. Dit is van het formulier: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

MachineOSProfile

Object

Het besturingssysteem en de schijf die door de machine worden gebruikt.

Name	Type	Default value	Description
enableFIPS	boolean		Of u een besturingssysteem met FIPS wilt gebruiken.
linuxProfile	MachineOSProfileLinuxProfile		Het specifieke profiel van de Linux-machine.
osDiskSizeGB	integer (int32) minimum: 0 maximum: 2048		Grootte van besturingssysteemschijf in GB die moet worden gebruikt om de schijfgrootte op te geven voor elke computer in de hoofd-/agentgroep. Als u 0 opgeeft, wordt de standaard osDisk-grootte toegepast op basis van de opgegeven vmSize.
osDiskType	OSDiskType		Het type besturingssysteemschijf dat moet worden gebruikt voor machines in de agentgroep. De standaardwaarde is 'kortstondig' als de VIRTUELE machine deze ondersteunt en een cacheschijf heeft die groter is dan de aangevraagde OSDiskSizeGB. Anders wordt standaard 'Beheerd' gebruikt. Kan niet worden gewijzigd na het maken. Voor meer informatie, zie Ephemeral OS.
osSKU	OSSKU		Hiermee geeft u de SKU van het besturingssysteem op die wordt gebruikt door de agentgroep. Als dit niet is opgegeven, is de standaardinstelling Ubuntu als OSType=Linux of Windows2019 als OSType=Windows. En de standaard Windows OSSKU wordt gewijzigd in Windows2022 nadat Windows2019 is afgeschaft.
osType	OSType	Linux	Het type besturingssysteem. De standaardwaarde is Linux.
windowsProfile	AgentPoolWindowsProfile		Het specifieke profiel van de Windows-machine.

MachineOSProfileLinuxProfile

Object

Het specifieke profiel van de Linux-machine.

Name	Type	Description
linuxOSConfig	LinuxOSConfig	De OS-configuratie van de Linux-machine.
messageOfTheDay	string	Bericht van de dag voor Linux-knooppunten, met base64 gecodeerd. Een met base64 gecodeerde tekenreeks die na het decoderen naar /etc/motd wordt geschreven. Hiermee kunt u het bericht van de dag aanpassen voor Linux-knooppunten. Deze mag niet worden opgegeven voor Windows knooppunten. Het moet een statische tekenreeks zijn (dat wil bijvoorbeeld onbewerkt worden afgedrukt en niet worden uitgevoerd als een script).

MachineProperties

Object

De eigenschappen van de machine

Name	Type	Default value	Description
billing	MachineBillingProfile		De eigendommen hebben te maken met machinefacturering.
eTag	string		Unieke alleen-lezen tekenreeks die wordt gebruikt voor het implementeren van optimistische gelijktijdigheid. De eTag-waarde wordt gewijzigd wanneer de resource wordt bijgewerkt. Geef een if-match of if-none-match header op met de eTag-waarde voor een volgende aanvraag om optimistische gelijktijdigheid mogelijk te maken volgens de normale eTag-conventie.
evictionPolicy	ScaleSetEvictionPolicy	Delete	Het uitzettingsbeleid voor machine. Dit kan niet worden gespecificeerd tenzij de prioriteit 'Spot' is. Als dit niet is opgegeven, is de standaardwaarde Verwijderen.
hardware	MachineHardwareProfile		De hardware- en GPU-instellingen van de machine.
kubernetes	MachineKubernetesProfile		De Kubernetes-configuraties die door de machine worden gebruikt.
localDNSProfile	LocalDNSProfile		Configureert de lokale DNS per knooppunt, met VnetDNS- en KubeDNS-overschrijvingen. LocalDNS helpt de prestaties en betrouwbaarheid van DNS-resolutie in een AKS-cluster te verbeteren. Voor meer details zie aka.ms/aks/localdns.
mode	AgentPoolMode		De machine staat alleen de modi 'Systeem' en 'Gebruiker' toe.
network	MachineNetworkProperties		netwerkeigenschappen van de machine
nodeImageVersion	string		De versie van de knooppuntinstallatiekopieën.
operatingSystem	MachineOSProfile		Het besturingssysteem en de schijf die door de machine worden gebruikt.
priority	ScaleSetPriority	Regular	De prioriteit voor de machine. Als dit niet is opgegeven, is de standaardwaarde 'Normaal'.
provisioningState	string		De huidige implementatie- of inrichtingsstatus.
resourceId	string (arm-id)		Azure-resource-id van de machine. Het kan worden gebruikt om onderliggende VM-instantie te KRIJGEN
security	MachineSecurityProfile		De beveiligingsinstellingen van de machine.
status	MachineStatus		Bevat alleen-lezen informatie over het apparaat.
tags	object		De tags die op de machine moeten worden persistent.

MachineSecurityProfile

Object

De beveiligingsinstellingen van de machine.

Name	Type	Description
enableEncryptionAtHost	boolean	Hiermee wordt aangegeven of hostgebaseerde besturingssysteem- en gegevensstationsversleuteling moeten worden ingeschakeld. Dit wordt alleen ondersteund op bepaalde VM-groottes en in bepaalde Azure-regio's. Zie voor meer informatie: https://docs.microsoft.com/azure/aks/enable-host-encryption
enableSecureBoot	boolean	Beveiligd opstarten is een functie van Vertrouwde start die ervoor zorgt dat alleen ondertekende besturingssystemen en stuurprogramma's kunnen worden opgestart. Zie aka.ms/aks/trustedlaunch voor meer informatie. Als dit niet is opgegeven, is de standaardwaarde onwaar.
enableVTPM	boolean	vTPM is een vertrouwde startfunctie voor het configureren van een toegewezen beveiligde kluis voor sleutels en metingen die lokaal op het knooppunt worden bewaard. Zie aka.ms/aks/trustedlaunch voor meer informatie. Als dit niet is opgegeven, is de standaardwaarde onwaar.
sshAccess	AgentPoolSSHAccess	SSH-access-methode van een agentpool.

MachineStatus

Object

Bevat alleen-lezen informatie over het apparaat.

Name	Type	Description
creationTimestamp	string (date-time)	Hiermee geeft u het tijdstip op waarop de machine is gemaakt.
driftAction	DriftAction	De driftactie van de machine. Geeft aan of een computer is afgeweken van de verwachte status als gevolg van wijzigingen in de eigenschappen van beheerde clusters, waarvoor corrigerende maatregelen nodig zijn.
driftReason	string	Reden voor machinedrift. Biedt gedetailleerde informatie over de reden waarom de machine is afgedreven. Dit veld wordt weggelaten als de machine up-to-date is.
provisioningError	ErrorDetail	De fout geeft informatie over de machine. Behoudt de gedetailleerde informatie over storingen. Als er geen fout is opgetreden, wordt dit veld weggelaten.
vmState	VmState	Status van virtuele machine. Geeft de huidige status van de onderliggende virtuele machine aan.

ManagementMode

Opsomming

De Managed GPU-ervaring installeert extra componenten, zoals de Data Center GPU Manager (DCGM)-metrics voor monitoring, bovenop de GPU-driver voor jou. Voor meer details over wat er geïnstalleerd is, kijk eens op aka.ms/aks/managed-gpu.

Waarde	Description
Unmanaged	De beheerde GPU-ervaring is uitgeschakeld voor NVIDIA GPU's.
Managed	Managed GPU Experience is ingeschakeld voor NVIDIA GPU's.

MigStrategy

Opsomming

Bepaalt de MIG (Multi-Instance GPU) strategie die gebruikt zal worden voor managed MIG-ondersteuning. Voor meer informatie over de verschillende strategieën, bezoek aka.ms/aks/managed-gpu. Wanneer niet gespecificeerd, is de standaard Geen.

Waarde	Description
None	Stel geen MIG-strategie vast. Als je eerder één set had, overschrijft dit deze en verwijdert de set MIG-strategie.
Single	Stel de MIG-strategie voor managed MIG in als single.
Mixed	Stel de MIG-strategie voor managed MIG in als gemengd.

NvidiaGPUProfile

Object

NVIDIA-specifieke GPU-instellingen

Name	Type	Description
managementMode	ManagementMode	De Managed GPU-ervaring installeert extra componenten, zoals de Data Center GPU Manager (DCGM)-metrics voor monitoring, bovenop de GPU-driver voor jou. Voor meer details over wat er geïnstalleerd is, kijk eens op aka.ms/aks/managed-gpu.
migStrategy	MigStrategy	Bepaalt de MIG (Multi-Instance GPU) strategie die gebruikt zal worden voor managed MIG-ondersteuning. Voor meer informatie over de verschillende strategieën, bezoek aka.ms/aks/managed-gpu. Wanneer niet gespecificeerd, is de standaard Geen.

OSDiskType

Opsomming

Het type besturingssysteemschijf dat moet worden gebruikt voor machines in de agentgroep. De standaardwaarde is 'kortstondig' als de VIRTUELE machine deze ondersteunt en een cacheschijf heeft die groter is dan de aangevraagde OSDiskSizeGB. Anders wordt standaard 'Beheerd' gebruikt. Kan niet worden gewijzigd na het maken. Voor meer informatie, zie Ephemeral OS.

Waarde	Description
Managed	Azure repliceert de schijf van het besturingssysteem voor een virtuele machine naar Azure-opslag om gegevensverlies te voorkomen als de VM naar een andere host moet worden verplaatst. Omdat containers niet zijn ontworpen om de lokale status persistent te maken, biedt dit gedrag een beperkte waarde en biedt dit enkele nadelen, waaronder tragere inrichting van knooppunten en een hogere lees-/schrijflatentie.
Ephemeral	Kortstondige besturingssysteemschijven worden alleen op de hostcomputer opgeslagen, net als een tijdelijke schijf. Dit biedt een lagere latentie voor lezen/schrijven, samen met snellere schaalaanpassing van knooppunten en clusterupgrades.

OSSKU

Opsomming

Hiermee geeft u de SKU van het besturingssysteem op die wordt gebruikt door de agentgroep. De standaardwaarde is Ubuntu als OSType Linux is. De standaardwaarde is Windows2019 wanneer Kubernetes <= 1.24 of Windows2022 wanneer Kubernetes >= 1.25 als OSType is Windows.

Waarde	Description
Ubuntu	Gebruik Ubuntu als het besturingssysteem voor knooppuntinstallatiekopieën.
AzureLinux	Gebruik AzureLinux als het besturingssysteem voor knooppuntinstallatiekopieën. Azure Linux is een door containers geoptimaliseerde Linux-distributie die is gebouwd door Microsoft. Ga naar https://aka.ms/azurelinux voor meer informatie.
AzureLinux3	Gebruik AzureLinux3 als besturingssysteem voor knooppuntafbeeldingen. Azure Linux is een door containers geoptimaliseerde Linux-distributie die is gebouwd door Microsoft. Ga naar https://aka.ms/azurelinux voor meer informatie. Ga voor beperkingen naar https://aka.ms/aks/node-images. Zie voor richtlijnen voor het migreren van het besturingssysteem.https://aka.ms/aks/upgrade-os-version
Mariner	Afgeschafte OSSKU. Microsoft raadt aan dat nieuwe implementaties in plaats daarvan 'AzureLinux' kiezen.
Flatcar	Gebruik Flatcar Container Linux als besturingssysteem voor knooppuntafbeeldingen. Flatcar is een voor containers geoptimaliseerd, op beveiliging gericht Linux-besturingssysteem, met een onveranderlijk bestandssysteem en onderdeel van de Cloud Native Computing Foundation (CNCF). Voor meer informatie over Flatcar Container Linux voor AKS, zie aka.ms/aks/flatcar-container-linux-for-aks
CBLMariner	Afgeschafte OSSKU. Microsoft raadt aan dat nieuwe implementaties in plaats daarvan 'AzureLinux' kiezen.
Windows2019	Gebruik Windows2019 als het besturingssysteem voor knooppuntinstallatiekopieën. Niet ondersteund voor systeemknooppuntgroepen. Windows2019 ondersteunt alleen Windows2019-containers; Windows2022-containers kunnen niet worden uitgevoerd en omgekeerd.
Windows2022	Gebruik Windows2022 als het besturingssysteem voor knooppuntinstallatiekopieën. Niet ondersteund voor systeemknooppuntgroepen. Windows2022 ondersteunt alleen Windows2022-containers; Windows2019-containers kunnen niet worden uitgevoerd en omgekeerd.
Ubuntu2204	Gebruik Ubuntu2204 als besturingssysteem voor knooppuntafbeeldingen, maar Ubuntu 22.04 wordt mogelijk niet voor alle knooppuntpools ondersteund. Zie voor beperkingen en ondersteunde Kubernetes-versies https://aka.ms/aks/supported-ubuntu-versions
Windows2025	Gebruik Windows2025 als besturingssysteem voor knooppuntafbeeldingen. Niet ondersteund voor systeemknooppuntgroepen. Windows2025 ondersteunt Windows2022 en Windows 2025 containers; het kan geen Windows2019-containers uitvoeren en vice versa.
WindowsAnnual	Gebruik windows Annual-kanaalversie als het besturingssysteem voor knooppuntinstallatiekopieën. Niet ondersteund voor systeemknooppuntgroepen. Details over ondersteunde containerinstallatiekopieën en kubernetes-versies onder verschillende AKS Annual-kanaalversies zijn te zien in https://aka.ms/aks/windows-annual-channel-details.
Ubuntu2404	Gebruik Ubuntu2404 als besturingssysteem voor knooppuntafbeeldingen, maar Ubuntu 24.04 wordt mogelijk niet voor alle knooppuntpools ondersteund. Zie voor beperkingen en ondersteunde Kubernetes-versies https://aka.ms/aks/supported-ubuntu-versions

OSType

Opsomming

Het type besturingssysteem. De standaardwaarde is Linux.

Waarde	Description
Linux	Gebruik Linux.
Windows	Gebruik Windows.

ScaleSetEvictionPolicy

Opsomming

Het uitzettingsbeleid voor de schaal van de virtuele machine. Het uitzettingsbeleid specificeert wat er to do is met de VM wanneer deze wordt ontruimd. De standaardinstelling is Verwijderen. Voor meer informatie over uitzettingen, zie spot VMs

Waarde	Description
Delete	Knooppunten in de onderliggende schaalset van de knooppuntenpool worden verwijderd wanneer ze worden verwijderd.
Deallocate	Knooppunten in de onderliggende schaalset van de knooppuntgroep worden bij uitzetting ingesteld op de status gestopt-niet-toegewezen. Knooppunten met het aantal gestopte toewijzingsstatussen ten opzichte van uw rekenquotum en kunnen problemen veroorzaken met het schalen of upgraden van clusters.

ScaleSetPriority

Opsomming

De prioriteit van de virtuele-machineschaalset.

Waarde	Description
Spot	Er worden VM's met spotprioriteit gebruikt. Er is geen SLA voor spot-knooppunten. Zie plek op AKS- voor meer informatie.
Regular	Er worden gewone VM's gebruikt.

SeccompDefault

Opsomming

Hiermee geeft u het standaard seccomp-profiel dat wordt toegepast op alle workloads. Als dit niet is opgegeven, wordt 'Niet-gedefinieerd' standaard gebruikt.

Waarde	Description
Unconfined	Er wordt geen seccomp-profiel toegepast, waardoor alle systeemaanroepen mogelijk zijn.
RuntimeDefault	Het standaard seccomp-profiel voor containerruntime wordt toegepast, waardoor bepaalde systeemaanroepen worden beperkt voor verbeterde beveiliging.

SysctlConfig

Object

Sysctl-instellingen voor Linux-agentknooppunten.

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

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

VmState

Opsomming

Status van virtuele machine. Geeft de huidige status van de onderliggende virtuele machine aan.

Waarde	Description
Running	De virtuele machine is momenteel actief.
Deleted	De virtuele machine is verwijderd door de gebruiker of vanwege spotverwijdering.

WorkloadRuntime

Opsomming

Bepaalt het type workload dat een knooppunt kan uitvoeren.

Waarde	Description
OCIContainer	Knooppunten gebruiken Kubelet om standaard-OCI-containerworkloads uit te voeren.
WasmWasi	Knooppunten gebruiken Krustlet om WASM-workloads uit te voeren met behulp van de WASI-provider (preview).
KataMshvVmIsolation	Knooppunten kunnen (Kata + Cloud Hypervisor + Hyper-V) gebruiken om geneste VM-pods (preview) in te schakelen. Vanwege het gebruik van Hyper-V is het AKS-knooppuntbesturingssysteem zelf een geneste VM (het hoofdbesturingssysteem) van Hyper-V. Het kan dus alleen worden gebruikt met VM-serie die ondersteuning biedt voor geneste virtualisatie, zoals Dv3-serie. Deze naamgevingsconventie zal in toekomstige releases worden afgeschaft ten gunste van KataVmIsolation.
KataVmIsolation	Knooppunten kunnen worden gebruikt (Kata + Cloud Hypervisor + Hyper-V) om geneste VM-gebaseerde pods in te schakelen. Vanwege het gebruik van Hyper-V is het AKS-knooppuntbesturingssysteem zelf een geneste VM (het hoofdbesturingssysteem) van Hyper-V. Het kan dus alleen worden gebruikt met VM-serie die ondersteuning biedt voor geneste virtualisatie, zoals Dv3-serie.