Machines - Create Or Update

Tjänst:: AKS

API-version:: 2026-01-02-preview

Skapar eller uppdaterar en dator i den angivna agentpoolen.

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

Name	I	Obligatorisk	Typ	Description
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	Namnet på agentpoolen.
machineName	path	True	string pattern: ^[a-z][a-z0-9]{0,11}$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,39}$	Värdnamn för datorn.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
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]$	Namnet på den hanterade klusterresursen.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandehuvud

Name	Obligatorisk	Typ	Description
if-match		string	Begäran bör endast fortsätta om en entitet matchar den här strängen.
if-none-match		string	Begäran bör endast fortsätta om ingen entitet matchar den här strängen.

Begärandetext

Name	Typ	Description
properties	MachineProperties	Egenskaperna för datorn

Svar

Name	Typ	Description
200 OK	Machine	Resursens 'Maskin'-uppdateringsoperation lyckades
201 Created	Machine	Resurs 'Maskin'-skapande operation lyckades Sidhuvuden Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Name

Typ

Description

200 OK

Machine

Resursens 'Maskin'-uppdateringsoperation lyckades

201 Created

Machine

Resurs 'Maskin'-skapande operation lyckades

Sidhuvuden

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Create/Update Machine

Exempelbegäran

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

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

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

Exempelsvar

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

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

Definitioner

Name	Description
AgentPoolArtifactStreamingProfile	Artefakt-streamingprofil för agentpoolen.
AgentPoolMode	Läget för en agentpool. Ett kluster måste ha minst en systemagentpool hela tiden. Mer information om begränsningar och metodtips för agentpooler finns i: https://docs.microsoft.com/azure/aks/use-system-pools
AgentPoolSSHAccess	SSH-access-metoden för en agentpool.
AgentPoolWindowsProfile	Windows-agentpoolens specifika profil.
createdByType	Den typ av identitet som skapade resursen.
DriftAction	Maskinens driftrörelse. Anger om en dator har avvikit från sitt förväntade tillstånd på grund av ändringar i egenskaperna för hanterade kluster, vilket kräver korrigerande åtgärder.
DriverType	Ange vilken typ av GPU-drivrutin som ska installeras när du skapar Windows-agentpooler. Om det inte anges väljer AKS drivrutinen baserat på systemets kompatibilitet. Detta kan inte ändras när AgentPool har skapats. Detta kan inte ställas in på Linux AgentPools. För Linux AgentPools väljs drivrutinen baserat på systemets kompatibilitet.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Detaljerna om felet.
ErrorResponse	Felsvar
GPUDriver	Om du vill installera GPU-drivrutiner. När den inte har angetts är standardinställningen Installera.
GPUInstanceProfile	GPUInstanceProfile som ska användas för att ange GPU MIG-instansprofil för GPU VM SKU som stöds.
GPUProfile	GPU-inställningar för agentpoolen.
IPFamily	Så här avgör du om adressen tillhör IPv4- eller IPv6-familjen
IPTag	Innehåller DEN IPTag som är associerad med objektet.
KubeletConfig	Kubelet-konfigurationer av agentnoder. Mer information finns i konfiguration av anpassade AKS-noder.
KubeletDiskType	Bestämmer placeringen av tomma Dir-volymer, containerruntime-data root och Kubelets ephemeral storage.
LinuxOSConfig	OS-konfigurationer av Linux-agentnoder. Mer information finns i konfiguration av anpassade AKS-noder.
LocalDNSForwardDestination	Målserver för DNS-frågor som ska vidarebefordras från localDNS.
LocalDNSForwardPolicy	Vidarebefordra princip för att välja överordnad DNS-server. Se vidarebefordra plugin för mer information.
LocalDNSMode	Aktiveringsläge för localDNS.
LocalDNSOverride	Åsidosättningar för localDNS-profil.
LocalDNSProfile	Konfigurerar den lokala DNS:en per nod med VnetDNS- och KubeDNS-åsidosättningar. LocalDNS hjälper till att förbättra prestanda och tillförlitlighet för DNS-matchning i ett AKS-kluster. Mer information finns i aka.ms/aks/localdns.
LocalDNSProtocol	Framtvinga TCP eller föredra UDP-protokoll för anslutningar från localDNS till överordnad DNS-server.
LocalDNSQueryLogging	Loggnivå för DNS-frågor i localDNS.
LocalDNSServeStale	Princip för att betjäna inaktuella data. Se cache-plugin för mer information.
LocalDNSState	Systemgenererat tillstånd för localDNS.
Machine	En maskin. Innehåller information om den underliggande virtuella datorn. En dator kan vara synlig här men inte i kubectl get-noder. Om så är fallet kan det bero på att datorn inte har registrerats med Kubernetes API Server ännu.
MachineBillingProfile	Fastigheterna har att göra med maskinfakturering.
MachineHardwareProfile	Maskinens maskinvaru- och GPU-inställningar.
MachineIpAddress	Information om datorns IP-adress.
MachineKubernetesProfile	De Kubernetes-konfigurationer som används av datorn.
MachineNetworkProperties	nätverksegenskaper för datorn
MachineOSProfile	Operativsystemet och disken som används av maskinen.
MachineOSProfileLinuxProfile	Linux-datorns specifika profil.
MachineProperties	Egenskaperna för datorn
MachineSecurityProfile	Maskinens säkerhetsinställningar.
MachineStatus	Innehåller skrivskyddad information om maskinen.
ManagementMode	Managed GPU-upplevelsen installerar ytterligare komponenter, såsom Data Center GPU Manager (DCGM)-mått för övervakning, ovanpå GPU-drivrutinen åt dig. För mer information om vad som är installerat, kolla in aka.ms/aks/managed-gpu.
MigStrategy	Sätter MIG-strategin (Multi-Instance GPU) som ska användas för hanterat MIG-stöd. För mer information om de olika strategierna, besök aka.ms/aks/managed-gpu. När det inte specificeras är standardvärdet Ingen.
NvidiaGPUProfile	NVIDIA-specifika GPU-inställningar
OSDiskType	Den operativsystemdisktyp som ska användas för datorer i agentpoolen. Standardvärdet är "Tillfällig" om den virtuella datorn stöder den och har en cachedisk som är större än den begärda OSDiskSizeGB. Annars är standardvärdet "Hanterad". Kan inte ändras när du har skapat. För mer information, se Ephemeral OS.
OSSKU	Anger os-SKU:n som används av agentpoolen. Standardvärdet är Ubuntu om OSType är Linux. Standardvärdet är Windows2019 när Kubernetes <= 1.24 eller Windows2022 när Kubernetes >= 1.25 om OSType är Windows.
OSType	Typ av operativsystem. Standardvärdet är Linux.
ScaleSetEvictionPolicy	Borttagningsprincipen för VM-skalningsuppsättningen. Vräkningspolicyn specificerar vad som to do med VM:n när den vräkas. Standardvärdet är Ta bort. För mer information om vräkning, se spot VMs
ScaleSetPriority	Prioritet för VM-skalningsuppsättning.
SeccompDefault	Anger standardprofilen för seccomp som tillämpas på alla arbetsbelastningar. Om det inte anges används "Odefinierad" som standard.
SysctlConfig	Sysctl-inställningar för Linux-agentnoder.
systemData	Metadata som rör skapande och senaste ändring av resursen.
VmState	Tillstånd för virtuell dator. Anger det aktuella tillståndet för den underliggande virtuella datorn.
WorkloadRuntime	Avgör vilken typ av arbetsbelastning en nod kan köra.

AgentPoolArtifactStreamingProfile

Objekt

Artefakt-streamingprofil för agentpoolen.

Name	Typ	Description
enabled	boolean	Artefaktströmning påskyndar kallstarten av containrar på en nod genom inläsning av avbildning på begäran. Om du vill använda den här funktionen måste containeravbildningar även aktivera artefaktströmning på ACR. Om det inte anges är standardvärdet falskt.

AgentPoolMode

Uppräkning

Läget för en agentpool. Ett kluster måste ha minst en systemagentpool hela tiden. Mer information om begränsningar och metodtips för agentpooler finns i: https://docs.microsoft.com/azure/aks/use-system-pools

Värde	Description
System	Systemagentpooler är främst avsedda som värd för kritiska systempoddar som CoreDNS och metrics-server. Systemagentpooler osType måste vara Linux. Systemagentpooler VM SKU måste ha minst 2vCPU:er och 4 GB minne.
User	Användaragentpooler är främst avsedda som värdar för dina programpoddar.
Gateway	Gateway-agentpooler är dedikerade för att tillhandahålla statiska utgående IP-adresser till poddar. Mer information finns i https://aka.ms/aks/static-egress-gateway.
ManagedSystem	ManagedSystem är en systempool som hanteras av AKS. Poolen skalas dynamiskt enligt klusteranvändning och har ytterligare funktioner för automatiserad övervakning och återställning. Det kan bara finnas en ManagedSystem-pool och vi rekommenderar att du tar bort alla andra systempooler för bästa möjliga upplevelse.
Machines	Datoragentpooler är dedikerade för att vara värdar för datorer. Endast begränsade åtgärder, till exempel skapande och borttagning, tillåts på poolnivå. Använd datorns API:er för att hantera hela datorns livscykel.

AgentPoolSSHAccess

Uppräkning

SSH-access-metoden för en agentpool.

Värde	Description
LocalUser	Kan SSH till noden som en lokal användare med hjälp av privat nyckel.
Disabled	SSH-tjänsten stängs av på noden.
EntraId	SSH till nod med EntraId-integrering. Mer information finns under https://aka.ms/aks/ssh/aad

AgentPoolWindowsProfile

Objekt

Windows-agentpoolens specifika profil.

Name	Typ	Description
disableOutboundNat	boolean	Om du vill inaktivera OutboundNAT i Windows-noder. Standardvärdet är falskt. Utgående NAT kan bara inaktiveras om klustret outboundType är NAT Gateway och Windows-agentpoolen inte har nodens offentliga IP-adress aktiverad.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

DriftAction

Uppräkning

Maskinens driftrörelse. Anger om en dator har avvikit från sitt förväntade tillstånd på grund av ändringar i egenskaperna för hanterade kluster, vilket kräver korrigerande åtgärder.

Värde	Description
Synced	Maskinen är uppdaterad.
Recreate	Datorn har avvikit och måste tas bort och återskapas.

DriverType

Uppräkning

Ange vilken typ av GPU-drivrutin som ska installeras när du skapar Windows-agentpooler. Om det inte anges väljer AKS drivrutinen baserat på systemets kompatibilitet. Detta kan inte ändras när AgentPool har skapats. Detta kan inte ställas in på Linux AgentPools. För Linux AgentPools väljs drivrutinen baserat på systemets kompatibilitet.

Värde	Description
GRID	Installera GRID-drivrutinen för GPU:n, lämplig för applikationer som kräver virtualiseringsstöd.
CUDA	Installera CUDA-drivrutinen för GPU:n, optimerad för beräkningsuppgifter i vetenskaplig databehandling och dataintensiva program.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Detaljerna om felet.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

GPUDriver

Uppräkning

Om du vill installera GPU-drivrutiner. När den inte har angetts är standardinställningen Installera.

Värde	Description
Install	Installera drivrutinen.
None	Hoppa över installationen av drivrutinen.

GPUInstanceProfile

Uppräkning

GPUInstanceProfile som ska användas för att ange GPU MIG-instansprofil för GPU VM SKU som stöds.

Värde	Description
MIG1g	MIG 1G GPU-instansprofil.
MIG2g	MIG 2G GPU-instansprofil.
MIG3g	MIG 3G GPU-instansprofil.
MIG4g	MIG 4G GPU-instansprofil.
MIG7g	MIG 7G GPU-instansprofil.

GPUProfile

Objekt

GPU-inställningar för agentpoolen.

Name	Typ	Description
driver	GPUDriver	Om du vill installera GPU-drivrutiner. När den inte har angetts är standardinställningen Installera.
driverType	DriverType	Ange vilken typ av GPU-drivrutin som ska installeras när du skapar Windows-agentpooler. Om det inte anges väljer AKS drivrutinen baserat på systemets kompatibilitet. Detta kan inte ändras när AgentPool har skapats. Detta kan inte ställas in på Linux AgentPools. För Linux AgentPools väljs drivrutinen baserat på systemets kompatibilitet.
nvidia	NvidiaGPUProfile	NVIDIA-specifika GPU-inställningar.

IPFamily

Uppräkning

Så här avgör du om adressen tillhör IPv4- eller IPv6-familjen

Värde	Description
IPv4	IPv4-familjen
IPv6	IPv6-familjen

IPTag

Objekt

Innehåller DEN IPTag som är associerad med objektet.

Name	Typ	Description
ipTagType	string	Typ av IP-tagg. Exempel: RoutingPreference.
tag	string	Värdet för IP-taggen som är associerad med den offentliga IP-adressen. Exempel: Internet.

KubeletConfig

Objekt

Kubelet-konfigurationer av agentnoder. Mer information finns i konfiguration av anpassade AKS-noder.

Name	Typ	Description
allowedUnsafeSysctls	string[]	Tillåten lista över osäkra sysctls eller osäkra sysctl-mönster (slutar i `*`).
containerLogMaxFiles	integer (int32) minimum: 2	Det maximala antalet containerloggfiler som kan finnas för en container. Talet måste vara ≥ 2.
containerLogMaxSizeMB	integer (int32)	Maximal storlek (t.ex. 10Mi) för containerloggfilen innan den roteras.
cpuCfsQuota	boolean	Om CPU CFS-kvottillämpning är aktiverat för containrar som anger CPU-gränser. Standardvärdet är sant.
cpuCfsQuotaPeriod	string	Värdet för CPU CFS-kvotperiod. Standardvärdet är "100 ms". Giltiga värden är en sekvens med decimaltal med ett valfritt bråk och ett enhetssuffix. Exempel: "300ms", "2h45m". Enheter som stöds är "ns", "us", "ms", "s", "m" och "h".
cpuManagerPolicy	string	Cpu Manager-principen som ska användas. Standardvärdet är "none". Mer information finns i Kubernetes CPU-hanteringsprinciper . Tillåtna värden är "none" och "static".
failSwapOn	boolean	Om värdet är sant kommer Kubelet inte att starta om växlingen är aktiverad på noden.
imageGcHighThreshold	integer (int32)	Den procent av diskanvändningen varefter skräpinsamling av avbildningar alltid körs. För att inaktivera skräpinsamling av bilder, ange värdet till 100. Standardvärdet är 85%
imageGcLowThreshold	integer (int32)	Den procentuella andelen av diskanvändning före vilket skräpinsamlingen för bilder aldrig körs. Detta kan inte anges högre än imageGcHighThreshold. Standardvärdet är 80%
podMaxPids	integer (int32)	Maximalt antal processer per podd.
seccompDefault	SeccompDefault	Anger standardprofilen för seccomp som tillämpas på alla arbetsbelastningar. Om det inte anges används "Odefinierad" som standard.
topologyManagerPolicy	string	Topologihanterarens princip som ska användas. Mer information finns i Kubernetes Toppology Manager. Standardvärdet är "none". Tillåtna värden är "none", "best-effort", "restricted" och "single-numa-node".

KubeletDiskType

Uppräkning

Bestämmer placeringen av tomma Dir-volymer, containerruntime-data root och Kubelets ephemeral storage.

Värde	Description
OS	Kubelet använder OS-disken för sina data.
Temporary	Kubelet använder den temporära disken för sina data.

LinuxOSConfig

Objekt

OS-konfigurationer av Linux-agentnoder. Mer information finns i konfiguration av anpassade AKS-noder.

Name	Typ	Description
swapFileSizeMB	integer (int32)	Storleken i MB för en växlingsfil som skapas på varje nod.
sysctls	SysctlConfig	Sysctl-inställningar för Linux-agentnoder.
transparentHugePageDefrag	string	Om kerneln ska använda minneskomprimering aggressivt för att göra fler stora sidor tillgängliga. Giltiga värden är "always", "defer", "defer+madvise", "madvise" och "never". Standardvärdet är "madvise". Mer information finns i Transparenta enorma sidor.
transparentHugePageEnabled	string	Om transparenta enorma sidor är aktiverade. Giltiga värden är "always", "madvise" och "never". Standardvärdet är "always". Mer information finns i Transparenta enorma sidor.

LocalDNSForwardDestination

Uppräkning

Målserver för DNS-frågor som ska vidarebefordras från localDNS.

Värde	Description
ClusterCoreDNS	Vidarebefordra DNS-frågor från localDNS till klustrets CoreDNS.
VnetDNS	Vidarebefordra DNS-frågor från localDNS till DNS-servern som konfigurerats i det virtuella nätverket. Ett virtuellt nätverk kan ha flera DNS-servrar konfigurerade.

LocalDNSForwardPolicy

Uppräkning

Vidarebefordra princip för att välja överordnad DNS-server. Se vidarebefordra plugin för mer information.

Värde	Description
Sequential	Implementerar sekventiellt val av DNS-server uppströms. Se vidarebefordra plugin för mer information.
RoundRobin	Implementerar val av resursallokering av överordnad DNS-server. Se vidarebefordra plugin för mer information.
Random	Implementerar slumpmässigt val av DNS-server uppströms. Se vidarebefordra plugin för mer information.

LocalDNSMode

Uppräkning

Aktiveringsläge för localDNS.

Värde	Description
Preferred	Om den aktuella orkestreringsversionen stöder den här funktionen föredrar du att aktivera localDNS.
Required	Aktivera localDNS.
Disabled	Inaktivera localDNS.

LocalDNSOverride

Objekt

Åsidosättningar för localDNS-profil.

Name	Typ	Standardvärde	Description
cacheDurationInSeconds	integer (int32)	3600	Cachelagring av maximalt TTL-värde i sekunder. Se cache-plugin för mer information.
forwardDestination	LocalDNSForwardDestination	ClusterCoreDNS	Målserver för DNS-frågor som ska vidarebefordras från localDNS.
forwardPolicy	LocalDNSForwardPolicy	Sequential	Vidarebefordra princip för att välja överordnad DNS-server. Se vidarebefordra plugin för mer information.
maxConcurrent	integer (int32)	1000	Maximalt antal samtidiga frågor. Se vidarebefordra plugin för mer information.
protocol	LocalDNSProtocol	PreferUDP	Framtvinga TCP eller föredra UDP-protokoll för anslutningar från localDNS till överordnad DNS-server.
queryLogging	LocalDNSQueryLogging	Error	Loggnivå för DNS-frågor i localDNS.
serveStale	LocalDNSServeStale	Immediate	Princip för att betjäna inaktuella data. Se cache-plugin för mer information.
serveStaleDurationInSeconds	integer (int32)	3600	Servera inaktuell varaktighet i sekunder. Se cache-plugin för mer information.

LocalDNSProfile

Objekt

Konfigurerar den lokala DNS:en per nod med VnetDNS- och KubeDNS-åsidosättningar. LocalDNS hjälper till att förbättra prestanda och tillförlitlighet för DNS-matchning i ett AKS-kluster. Mer information finns i aka.ms/aks/localdns.

Name	Typ	Standardvärde	Description
kubeDNSOverrides	<string, LocalDNSOverride>		KubeDNS-åsidosättningar gäller för DNS-trafik från poddar med dnsPolicy:ClusterFirst (kallas KubeDNS-trafik).
mode	LocalDNSMode	Preferred	Aktiveringsläge för localDNS.
state	LocalDNSState		Systemgenererat tillstånd för localDNS.
vnetDNSOverrides	<string, LocalDNSOverride>		VnetDNS-åsidosättningar gäller för DNS-trafik från poddar med dnsPolicy:default eller kubelet (kallas VnetDNS-trafik).

LocalDNSProtocol

Uppräkning

Framtvinga TCP eller föredra UDP-protokoll för anslutningar från localDNS till överordnad DNS-server.

Värde	Description
PreferUDP	Föredra UDP-protokoll för anslutningar från localDNS till den överordnade DNS-servern.
ForceTCP	Framtvinga TCP-protokoll för anslutningar från localDNS till överordnad DNS-server.

LocalDNSQueryLogging

Uppräkning

Loggnivå för DNS-frågor i localDNS.

Värde	Description
Error	Aktiverar felloggning i localDNS. Se plugin-programmet errors för mer information.
Log	Aktiverar frågeloggning i localDNS. Se logg-plugin för mer information.

LocalDNSServeStale

Uppräkning

Princip för att betjäna inaktuella data. Se cache-plugin för mer information.

Värde	Description
Verify	Hantera inaktuella data med verifiering. Kontrollera först att en post fortfarande inte är tillgänglig från källan innan du skickar den utgångna posten till klienten. Se cache-plugin för mer information.
Immediate	Servera inaktuella data omedelbart. Skicka den utgångna posten till klienten innan du kontrollerar om posten är tillgänglig från källan. Se cache-plugin för mer information.
Disable	Inaktivera servering av inaktuella data.

LocalDNSState

Uppräkning

Systemgenererat tillstånd för localDNS.

Värde	Description
Enabled	localDNS är aktiverat.
Disabled	localDNS är inaktiverat.

Machine

Objekt

En maskin. Innehåller information om den underliggande virtuella datorn. En dator kan vara synlig här men inte i kubectl get-noder. Om så är fallet kan det bero på att datorn inte har registrerats med Kubernetes API Server ännu.

Name	Typ	Description
id	string (arm-id)	Fullständigt kvalificerat resurs-ID för resursen. T.ex. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Namnet på resursen
properties	MachineProperties	Egenskaperna för datorn
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"
zones	string[]	Tillgänglighetszonen där datorn finns.

MachineBillingProfile

Objekt

Fastigheterna har att göra med maskinfakturering.

Name	Typ	Standardvärde	Description
spotMaxPrice	number (float)	-1	Det högsta priset (i us-dollar) som du är villig att betala för spot-instanser. Möjliga värden är ett decimalvärde som är större än noll eller -1 vilket anger att standardpriset är up-to på begäran. För mer information om spotprissättning, se spot VMs prissättning

MachineHardwareProfile

Objekt

Maskinens maskinvaru- och GPU-inställningar.

Name	Typ	Description
gpuInstanceProfile	GPUInstanceProfile	GPUInstanceProfile som ska användas för att ange GPU MIG-instansprofil för GPU VM SKU som stöds.
gpuProfile	GPUProfile	Datorns GPU-inställningar.
ultraSsdEnabled	boolean	Om du vill aktivera UltraSSD
vmSize	string	Storleken på den virtuella datorn. Tillgängligheten för VM-storlek varierar beroende på region. Om en nod innehåller otillräckliga beräkningsresurser (minne, processor osv.) kan poddar inte köras korrekt. Mer information om begränsade VM-storlekar finns i: https://docs.microsoft.com/azure/aks/quotas-skus-regions

MachineIpAddress

Objekt

Information om datorns IP-adress.

Name	Typ	Description
family	IPFamily	Så här avgör du om adressen tillhör IPv4- eller IPv6-familjen
ip	string	Maskinens IPv4- eller IPv6-adress

MachineKubernetesProfile

Objekt

De Kubernetes-konfigurationer som används av datorn.

Name	Typ	Description
artifactStreamingProfile	AgentPoolArtifactStreamingProfile	Konfiguration för användning av artefaktströmning i AKS.
currentOrchestratorVersion	string	Den version av Kubernetes som körs på datorn. Om orchestratorVersion var en fullständigt angiven version <major.minor.patch> är det här fältet exakt lika med det. Om orchestratorVersion var <major.minor> innehåller det här fältet den fullständiga <major.minor.patch-versionen> som används.
kubeletConfig	KubeletConfig	Kubelet-konfigurationen på datorn.
kubeletDiskType	KubeletDiskType	Bestämmer placeringen av tomma Dir-volymer, containerruntime-data root och Kubelets ephemeral storage.
maxPods	integer (int32)	Det maximala antalet poddar som kan köras på en nod.
nodeInitializationTaints	string[]	Taints som läggs till på noden när den skapas och som inte kommer att stämmas av AKS. Dessa taints kommer inte att stämmas av av AKS och kan tas bort med ett kubectl-anrop. Dessa taints tillåter att nödvändig konfiguration körs innan noden är redo att acceptera arbetsbelastningar, till exempel "key1=value1:NoSchedule" som sedan kan tas bort med `kubectl taint nodes node1 key1=value1:NoSchedule-`
nodeLabels	object	Noden etiketter på datorn.
nodeName	string	Nodnamnet i Kubernetes-klustret.
nodeTaints	string[]	Taints läggs till i den nya noden när datorn skapas. Till exempel key=value:NoSchedule.
orchestratorVersion	string	Den version av Kubernetes som angetts av användaren. Både korrigeringsversionen <major.minor.patch> och <major.minor> stöds. När <major.minor> har angetts väljs den senaste uppdateringsversionen som stöds automatiskt.
workloadRuntime	WorkloadRuntime	Avgör vilken typ av arbetsbelastning en nod kan köra.

MachineNetworkProperties

Objekt

nätverksegenskaper för datorn

Name	Typ	Description
enableNodePublicIP	boolean	Om datorn tilldelas en egen offentlig IP-adress. Vissa scenarier kan kräva att datorn tar emot sina egna dedikerade offentliga IP-adresser. Ett vanligt scenario är för spelarbetsbelastningar, där en konsol måste upprätta en direktanslutning till en virtuell molndator för att minimera hopp. Standardvärdet är falskt.
ipAddresses	MachineIpAddress[]	IPv4, IPv6-adresser till maskinen
nodePublicIPPrefixID	string (arm-id)	Det offentliga IP-prefix-ID som VM-noden ska använda IP-adresser från. Det här är formuläret: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
nodePublicIPTags	IPTag[]	IPTags för offentliga IP-adresser på instansnivå.
podSubnetID	string (arm-id)	ID för det undernät som poddar ansluter till när de startas. Om detta utelämnas tilldelas podd-IP-adresser statiskt i nodundernätet (mer information finns i vnetSubnetID). Detta är i formuläret : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
vnetSubnetID	string (arm-id)	ID:t för det undernät som noden och eventuellt poddar ska ansluta till vid start. Om detta inte anges genereras och används ett VNET och undernät. Om inget podSubnetID har angetts gäller detta för noder och poddar, annars gäller det bara för noder. Detta är i formuläret : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

MachineOSProfile

Objekt

Operativsystemet och disken som används av maskinen.

Name	Typ	Standardvärde	Description
enableFIPS	boolean		Om du vill använda ett FIPS-aktiverat operativsystem.
linuxProfile	MachineOSProfileLinuxProfile		Linux-datorns specifika profil.
osDiskSizeGB	integer (int32) minimum: 0 maximum: 2048		Operativsystemets diskstorlek i GB som ska användas för att ange diskstorleken för varje dator i huvud-/agentpoolen. Om du anger 0 tillämpas standardstorleken för osDisk enligt den angivna vmSize-storleken.
osDiskType	OSDiskType		Den operativsystemdisktyp som ska användas för datorer i agentpoolen. Standardvärdet är "Tillfällig" om den virtuella datorn stöder den och har en cachedisk som är större än den begärda OSDiskSizeGB. Annars är standardvärdet "Hanterad". Kan inte ändras när du har skapat. För mer information, se Ephemeral OS.
osSKU	OSSKU		Anger os-SKU:n som används av agentpoolen. Om det inte anges är standardvärdet Ubuntu om OSType=Linux eller Windows2019 om OSType=Windows. Och standardvärdet för Windows OSSKU ändras till Windows2022 när Windows2019 är inaktuellt.
osType	OSType	Linux	Typ av operativsystem. Standardvärdet är Linux.
windowsProfile	AgentPoolWindowsProfile		Windows-datorns specifika profil.

MachineOSProfileLinuxProfile

Objekt

Linux-datorns specifika profil.

Name	Typ	Description
linuxOSConfig	LinuxOSConfig	OS-konfigurationen för Linux-datorn.
messageOfTheDay	string	Dagens meddelande för Linux-noder, base64-kodat. En base64-kodad sträng som skrivs till /etc/motd efter avkodning. Detta möjliggör anpassning av dagens meddelande för Linux-noder. Den får inte anges för Windows noder. Det måste vara en statisk sträng (d.v.s. skrivs ut rå och körs inte som ett skript).

MachineProperties

Objekt

Egenskaperna för datorn

Name	Typ	Standardvärde	Description
billing	MachineBillingProfile		Fastigheterna har att göra med maskinfakturering.
eTag	string		Unik skrivskyddad sträng som används för att implementera optimistisk samtidighet. ETag-värdet ändras när resursen uppdateras. Ange ett if-match- eller if-none-match-huvud med eTag-värdet för en efterföljande begäran för att aktivera optimistisk samtidighet enligt den normala eTag-konventionen.
evictionPolicy	ScaleSetEvictionPolicy	Delete	Vräkningspolicyn för maskin. Detta kan inte specificeras om inte prioriteten är 'Spot'. Om det inte anges är standardvärdet "Ta bort".
hardware	MachineHardwareProfile		Maskinens maskinvaru- och GPU-inställningar.
kubernetes	MachineKubernetesProfile		De Kubernetes-konfigurationer som används av datorn.
localDNSProfile	LocalDNSProfile		Konfigurerar den lokala DNS:en per nod med VnetDNS- och KubeDNS-åsidosättningar. LocalDNS hjälper till att förbättra prestanda och tillförlitlighet för DNS-matchning i ett AKS-kluster. Mer information finns i aka.ms/aks/localdns.
mode	AgentPoolMode		Maskinen tillåter endast "System" och "Användare"-lägen.
network	MachineNetworkProperties		nätverksegenskaper för datorn
nodeImageVersion	string		Versionen av nodbilden.
operatingSystem	MachineOSProfile		Operativsystemet och disken som används av maskinen.
priority	ScaleSetPriority	Regular	Prioriteten för maskinen. Om det inte anges är standardvärdet "Vanlig".
provisioningState	string		Det aktuella distributions- eller etableringstillståndet.
resourceId	string (arm-id)		Azure-resurs-ID för datorn. Den kan användas för att hämta underliggande VM-instans
security	MachineSecurityProfile		Maskinens säkerhetsinställningar.
status	MachineStatus		Innehåller skrivskyddad information om maskinen.
tags	object		Taggarna som ska sparas på datorn.

MachineSecurityProfile

Objekt

Maskinens säkerhetsinställningar.

Name	Typ	Description
enableEncryptionAtHost	boolean	Om värdbaserad os- och dataenhetskryptering ska aktiveras. Detta stöds endast på vissa VM-storlekar och i vissa Azure-regioner. Mer information finns i: https://docs.microsoft.com/azure/aks/enable-host-encryption
enableSecureBoot	boolean	Säker start är en funktion i Trusted Launch som säkerställer att endast signerade operativsystem och drivrutiner kan starta. Mer information finns i aka.ms/aks/trustedlaunch. Om det inte anges är standardvärdet falskt.
enableVTPM	boolean	vTPM är en betrodd startfunktion för att konfigurera ett dedikerat säkert valv för nycklar och mått som lagras lokalt på noden. Mer information finns i aka.ms/aks/trustedlaunch. Om det inte anges är standardvärdet falskt.
sshAccess	AgentPoolSSHAccess	SSH-access-metoden för en agentpool.

MachineStatus

Objekt

Innehåller skrivskyddad information om maskinen.

Name	Typ	Description
creationTimestamp	string (date-time)	Anger den tidpunkt då datorn skapades.
driftAction	DriftAction	Maskinens driftrörelse. Anger om en dator har avvikit från sitt förväntade tillstånd på grund av ändringar i egenskaperna för hanterade kluster, vilket kräver korrigerande åtgärder.
driftReason	string	Orsak till maskindrift. Ger detaljerad information om varför maskinen har drivit. Det här fältet utelämnas om maskinen är uppdaterad.
provisioningError	ErrorDetail	Felinformationen för maskinen är detaljerad. Bevarar detaljerad information om felet. Om det inte fanns något fel utelämnas det här fältet.
vmState	VmState	Tillstånd för virtuell dator. Anger det aktuella tillståndet för den underliggande virtuella datorn.

ManagementMode

Uppräkning

Managed GPU-upplevelsen installerar ytterligare komponenter, såsom Data Center GPU Manager (DCGM)-mått för övervakning, ovanpå GPU-drivrutinen åt dig. För mer information om vad som är installerat, kolla in aka.ms/aks/managed-gpu.

Värde	Description
Unmanaged	Managed GPU-upplevelsen är inaktiverad för NVIDIA GPU:er.
Managed	Managed GPU-upplevelsen är aktiverad för NVIDIA GPU:er.

MigStrategy

Uppräkning

Sätter MIG-strategin (Multi-Instance GPU) som ska användas för hanterat MIG-stöd. För mer information om de olika strategierna, besök aka.ms/aks/managed-gpu. När det inte specificeras är standardvärdet Ingen.

Värde	Description
None	Sätt inte upp en MIG-strategi. Om du tidigare hade en uppsättning kommer detta att åsidosätta den och sätta bort MIG-strategin.
Single	Ställ in MIG-strategin för managed MIG som enkel.
Mixed	Sätt MIG-strategin för managed MIG som blandad.

NvidiaGPUProfile

Objekt

NVIDIA-specifika GPU-inställningar

Name	Typ	Description
managementMode	ManagementMode	Managed GPU-upplevelsen installerar ytterligare komponenter, såsom Data Center GPU Manager (DCGM)-mått för övervakning, ovanpå GPU-drivrutinen åt dig. För mer information om vad som är installerat, kolla in aka.ms/aks/managed-gpu.
migStrategy	MigStrategy	Sätter MIG-strategin (Multi-Instance GPU) som ska användas för hanterat MIG-stöd. För mer information om de olika strategierna, besök aka.ms/aks/managed-gpu. När det inte specificeras är standardvärdet Ingen.

OSDiskType

Uppräkning

Den operativsystemdisktyp som ska användas för datorer i agentpoolen. Standardvärdet är "Tillfällig" om den virtuella datorn stöder den och har en cachedisk som är större än den begärda OSDiskSizeGB. Annars är standardvärdet "Hanterad". Kan inte ändras när du har skapat. För mer information, se Ephemeral OS.

Värde	Description
Managed	Azure replikerar operativsystemdisken för en virtuell dator till Azure Storage för att undvika dataförlust om den virtuella datorn behöver flyttas till en annan värd. Eftersom containrar inte är utformade för att ha kvar lokalt tillstånd ger det här beteendet ett begränsat värde samtidigt som vissa nackdelar, inklusive långsammare nodetablering och högre svarstid för läsning/skrivning.
Ephemeral	Tillfälliga OS-diskar lagras endast på värddatorn, precis som en tillfällig disk. Detta ger lägre svarstid för läsning/skrivning, tillsammans med snabbare nodskalning och klusteruppgraderingar.

Värde

Description

Managed

Azure replikerar operativsystemdisken för en virtuell dator till Azure Storage för att undvika dataförlust om den virtuella datorn behöver flyttas till en annan värd. Eftersom containrar inte är utformade för att ha kvar lokalt tillstånd ger det här beteendet ett begränsat värde samtidigt som vissa nackdelar, inklusive långsammare nodetablering och högre svarstid för läsning/skrivning.

Ephemeral

Tillfälliga OS-diskar lagras endast på värddatorn, precis som en tillfällig disk. Detta ger lägre svarstid för läsning/skrivning, tillsammans med snabbare nodskalning och klusteruppgraderingar.

OSSKU

Uppräkning

Anger os-SKU:n som används av agentpoolen. Standardvärdet är Ubuntu om OSType är Linux. Standardvärdet är Windows2019 när Kubernetes <= 1.24 eller Windows2022 när Kubernetes >= 1.25 om OSType är Windows.

Värde	Description
Ubuntu	Använd Ubuntu som operativsystem för nodavbildningar.
AzureLinux	Använd AzureLinux som operativsystem för nodavbildningar. Azure Linux är en containeroptimerad Linux-distribution som skapats av Microsoft, besök https://aka.ms/azurelinux för mer information.
AzureLinux3	Använd AzureLinux3 som operativsystem för nodavbildningar. Azure Linux är en containeroptimerad Linux-distribution som skapats av Microsoft, besök https://aka.ms/azurelinux för mer information. Om du vill begränsa antalet besök kan du besöka https://aka.ms/aks/node-images. Vägledning för OS-migrering finns i https://aka.ms/aks/upgrade-os-version.
Mariner	Inaktuell OSSKU. Microsoft rekommenderar att nya distributioner väljer "AzureLinux" i stället.
Flatcar	Använd Flatcar Container Linux som operativsystem för nodavbildningar. Flatcar är ett containeroptimerat, säkerhetsfokuserat Linux-operativsystem med ett oföränderligt filsystem och en del av Cloud Native Computing Foundation (CNCF). Mer information om Flatcar Container Linux för AKS finns i aka.ms/aks/flatcar-container-linux-for-aks
CBLMariner	Inaktuell OSSKU. Microsoft rekommenderar att nya distributioner väljer "AzureLinux" i stället.
Windows2019	Använd Windows2019 som operativsystem för nodavbildningar. Stöds inte för systemnodpooler. Windows2019 stöder endast Windows2019-containrar. Det går inte att köra Windows2022-containrar och vice versa.
Windows2022	Använd Windows2022 som operativsystem för nodavbildningar. Stöds inte för systemnodpooler. Windows2022 stöder endast Windows2022-containrar. Det går inte att köra Windows2019-containrar och vice versa.
Ubuntu2204	Använd Ubuntu2204 som operativsystem för nodavbildningar, men Ubuntu 22.04 kanske inte stöds för alla nodpooler. Begränsningar och kubernetes-versioner som stöds finns i https://aka.ms/aks/supported-ubuntu-versions
Windows2025	Använd Windows2025 som operativsystem för nodavbildningar. Stöds inte för systemnodpooler. Windows2025 stöder Windows2022- och Windows 2025-containrar; den kan inte köra Windows2019-containrar och vice versa.
WindowsAnnual	Använd Windows Annual Channel-version som operativsystem för nodavbildningar. Stöds inte för systemnodpooler. Information om containeravbildningar som stöds och kubernetes-versioner under olika AKS Annual Channel-versioner kan visas i https://aka.ms/aks/windows-annual-channel-details.
Ubuntu2404	Använd Ubuntu2404 som operativsystem för nodavbildningar, men Ubuntu 24.04 kanske inte stöds för alla nodpooler. Begränsningar och kubernetes-versioner som stöds finns i se https://aka.ms/aks/supported-ubuntu-versions

OSType

Uppräkning

Typ av operativsystem. Standardvärdet är Linux.

Värde	Description
Linux	Använd Linux.
Windows	Använd Windows.

ScaleSetEvictionPolicy

Uppräkning

Borttagningsprincipen för VM-skalningsuppsättningen. Vräkningspolicyn specificerar vad som to do med VM:n när den vräkas. Standardvärdet är Ta bort. För mer information om vräkning, se spot VMs

Värde	Description
Delete	Noder i den underliggande skalningsuppsättningen för nodpoolen tas bort när de avlägsnas.
Deallocate	Noder i den underliggande skalningsuppsättningen för nodpoolen är inställda på tillståndet stoppad-frigjord vid borttagning. Noder i det stoppade frigjorda tillståndet räknas mot din beräkningskvot och kan orsaka problem med klusterskalning eller uppgradering.

ScaleSetPriority

Uppräkning

Prioritet för VM-skalningsuppsättning.

Värde	Description
Spot	Virtuella datorer med punktprioritet kommer att användas. Det finns inget serviceavtal för skalningsnoder för oanvänd kapacitet. Mer information finns i plats på AKS-.
Regular	Vanliga virtuella datorer kommer att användas.

SeccompDefault

Uppräkning

Anger standardprofilen för seccomp som tillämpas på alla arbetsbelastningar. Om det inte anges används "Odefinierad" som standard.

Värde	Description
Unconfined	Ingen seccomp-profil tillämpas, vilket tillåter alla systemanrop.
RuntimeDefault	Standardprofilen seccomp för containerkörning tillämpas, vilket begränsar vissa systemanrop för förbättrad säkerhet.

SysctlConfig

Objekt

Sysctl-inställningar för Linux-agentnoder.

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

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

VmState

Uppräkning

Tillstånd för virtuell dator. Anger det aktuella tillståndet för den underliggande virtuella datorn.

Värde	Description
Running	Den virtuella datorn körs för närvarande.
Deleted	Den virtuella datorn har tagits bort av användaren eller på grund av punktavlägsning.

WorkloadRuntime

Uppräkning

Avgör vilken typ av arbetsbelastning en nod kan köra.

Värde	Description
OCIContainer	Noder använder Kubelet för att köra standardarbetsbelastningar för OCI-container.
WasmWasi	Noder använder Krustlet för att köra WASM-arbetsbelastningar med WASI-providern (förhandsversion).
KataMshvVmIsolation	Noder kan använda (Kata + Cloud Hypervisor + Hyper-V) för att aktivera kapslade VM-baserade poddar (förhandsversion). På grund av användningen av Hyper-V är SJÄLVA AKS-nodoperativsystemet en kapslad virtuell dator (rotoperativsystemet) i Hyper-V. Därför kan den bara användas med VM-serier som stöder kapslad virtualisering, till exempel Dv3-serien. Den här namngivningskonventionen kommer att bli inaktuell i framtida versioner till förmån för KataVmIsolation.
KataVmIsolation	Noder kan använda (Kata + Cloud Hypervisor + Hyper-V) för att aktivera kapslade VM-baserade poddar. På grund av användningen av Hyper-V är SJÄLVA AKS-nodoperativsystemet en kapslad virtuell dator (rotoperativsystemet) i Hyper-V. Därför kan den bara användas med VM-serier som stöder kapslad virtualisering, till exempel Dv3-serien.

Dela via

Machines - Create Or Update

URI-parametrar

Begärandehuvud

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

Create/Update Machine

Exempelbegäran

Exempelsvar

Definitioner

AgentPoolArtifactStreamingProfile

AgentPoolMode

AgentPoolSSHAccess

AgentPoolWindowsProfile

createdByType

DriftAction

DriverType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GPUDriver

GPUInstanceProfile

GPUProfile

IPFamily

IPTag

KubeletConfig

KubeletDiskType

LinuxOSConfig

LocalDNSForwardDestination

LocalDNSForwardPolicy

LocalDNSMode

LocalDNSOverride

LocalDNSProfile

LocalDNSProtocol

LocalDNSQueryLogging

LocalDNSServeStale

LocalDNSState

Machine

MachineBillingProfile

MachineHardwareProfile

MachineIpAddress

MachineKubernetesProfile

MachineNetworkProperties

MachineOSProfile

MachineOSProfileLinuxProfile

MachineProperties

MachineSecurityProfile

MachineStatus

ManagementMode

MigStrategy

NvidiaGPUProfile

OSDiskType

OSSKU

OSType

ScaleSetEvictionPolicy

ScaleSetPriority

SeccompDefault

SysctlConfig

systemData

VmState

WorkloadRuntime