Machines - Create Or Update

Servizio:

AKS

Versione API:

2026-01-02-preview

Crea o aggiorna un computer nel pool di agenti specificato.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	Nome del pool di agenti.
machineName	path	True	string pattern: ^[a-z][a-z0-9]{0,11}$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,39}$	Nome host del computer.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
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]$	Nome della risorsa cluster gestita.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
if-match		string	La richiesta deve continuare solo se un'entità corrisponde a questa stringa.
if-none-match		string	La richiesta deve continuare solo se nessuna entità corrisponde a questa stringa.

Corpo della richiesta

Nome	Tipo	Descrizione
properties	MachineProperties	Proprietà del computer

Risposte

Nome	Tipo	Descrizione
200 OK	Machine	Operazione di aggiornamento della risorsa 'Machine' riuscita
201 Created	Machine	Risorsa 'Machine' crea operazione con successo Intestazioni Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Create/Update Machine

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

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

Definizioni

Nome	Descrizione
AgentPoolArtifactStreamingProfile	Profilo streaming di artefatti per il pool di agenti.
AgentPoolMode	Modalità di un pool di agenti. Un cluster deve avere sempre almeno un pool di agenti "System". Per altre informazioni sulle restrizioni del pool di agenti e sulle procedure consigliate, vedere: https://docs.microsoft.com/azure/aks/use-system-pools
AgentPoolSSHAccess	Metodo di access SSH di un pool di agenti.
AgentPoolWindowsProfile	Profilo specifico del pool di agenti di Windows.
createdByType	Tipo di identità che ha creato la risorsa.
DriftAction	L'azione di deriva della macchina. Indica se un computer ha deviato dallo stato previsto a causa di modifiche nelle proprietà del cluster gestito, che richiedono un'azione correttiva.
DriverType	Specificare il tipo di driver GPU da installare durante la creazione di pool di agenti Windows. Se non specificato, il servizio Azure Kubernetes seleziona il driver in base alla compatibilità del sistema. Questa operazione non può essere modificata dopo la creazione di AgentPool. Non è possibile impostare questa impostazione in Linux AgentPools. Per Linux AgentPools, il driver viene selezionato in base alla compatibilità del sistema.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
GPUDriver	Indica se installare i driver GPU. Quando non è specificato, il valore predefinito è Install.
GPUInstanceProfile	GPUInstanceProfile da usare per specificare il profilo di istanza MIG della GPU per lo SKU di VM GPU supportato.
GPUProfile	Impostazioni GPU per il pool di agenti.
IPFamily	Per determinare se l'indirizzo appartiene alla famiglia IPv4 o IPv6
IPTag	Contiene l'IPTag associato all'oggetto .
KubeletConfig	Configurazioni kubelet dei nodi dell'agente. Per altre informazioni, vedere di configurazione del nodo personalizzato del servizio Azure Kubernetes.
KubeletDiskType	Determina la posizione dei volumi emptyDir, della radice dati in runtime del container e dello storage effimero Kubelet.
LinuxOSConfig	Configurazioni del sistema operativo dei nodi dell'agente Linux. Per altre informazioni, vedere di configurazione del nodo personalizzato del servizio Azure Kubernetes.
LocalDNSForwardDestination	Server di destinazione per le query DNS da inoltrare da localDNS.
LocalDNSForwardPolicy	Criterio di inoltro per la selezione del server DNS upstream. Per ulteriori informazioni, vedere il plug-in forward .
LocalDNSMode	Modalità di abilitazione per il DNS locale.
LocalDNSOverride	Sostituzioni per il profilo localDNS.
LocalDNSProfile	Configura il DNS locale per nodo, con override di VnetDNS e KubeDNS. LocalDNS consente di migliorare le prestazioni e l'affidabilità della risoluzione DNS in un cluster del servizio Azure Kubernetes. Per maggiori dettagli vedere aka.ms/aks/localdns.
LocalDNSProtocol	Applicare TCP o preferire il protocollo UDP per le connessioni da localDNS al server DNS upstream.
LocalDNSQueryLogging	Livello di log per le query DNS in localDNS.
LocalDNSServeStale	Criteri per la pubblicazione di dati non aggiornati. Per ulteriori informazioni, vedere il plug-in cache .
LocalDNSState	Stato generato dal sistema di localDNS.
Machine	Una macchina. Contiene informazioni dettagliate sulla macchina virtuale sottostante. Un computer può essere visibile qui ma non nei nodi kubectl get; in caso affermativo, potrebbe essere dovuto al fatto che il computer non è ancora stato registrato con il server API Kubernetes.
MachineBillingProfile	Le proprietà riguardano la fatturazione delle macchine.
MachineHardwareProfile	Le impostazioni hardware e GPU della macchina.
MachineIpAddress	Dettagli dell'indirizzo IP del computer.
MachineKubernetesProfile	Le configurazioni Kubernetes utilizzate dal computer.
MachineNetworkProperties	proprietà di rete del computer
MachineOSProfile	Il sistema operativo e il disco utilizzati dalla macchina.
MachineOSProfileLinuxProfile	Il profilo specifico del computer Linux.
MachineProperties	Proprietà del computer
MachineSecurityProfile	Le impostazioni di sicurezza della macchina.
MachineStatus	Contiene informazioni di sola lettura sulla macchina.
ManagementMode	L'esperienza GPU gestita installa componenti aggiuntivi, come le metriche Data Center GPU Manager (DCGM) per il monitoraggio, oltre al driver GPU per te. Per maggiori dettagli su cosa viene installato, dai un'occhiata a aka.ms/aks/managed-gpu.
MigStrategy	Stabilisce la strategia MIG (Multi-Instance GPU) che sarà utilizzata per il supporto MIG. Per maggiori informazioni sulle diverse strategie, visita aka.ms/aks/managed-gpu. Quando non specificato, il valore predefinito è Nessuno.
NvidiaGPUProfile	Impostazioni GPU specifiche NVIDIA
OSDiskType	Tipo di disco del sistema operativo da usare per i computer nel pool di agenti. Il valore predefinito è "Ephemeral" se la macchina virtuale lo supporta e ha un disco della cache maggiore di quello richiesto OSDiskSizeGB. In caso contrario, il valore predefinito è "Gestito". Non può essere modificato dopo la creazione. Per maggiori informazioni vedi Ephemeral OS.
OSSKU	Specifica lo SKU del sistema operativo usato dal pool di agenti. Il valore predefinito è Ubuntu se OSType è Linux. Il valore predefinito è Windows2019 quando Kubernetes <= 1.24 o Windows2022 quando Kubernetes >= 1.25 se OSType è Windows.
OSType	Tipo di sistema operativo. Il valore predefinito è Linux.
ScaleSetEvictionPolicy	Criteri di rimozione del set di scalabilità di macchine virtuali. La politica di sfratto specifica cosa fare do con la VM quando viene sfrattata. Il valore predefinito è Elimina. Per maggiori informazioni sullo sfratto vedi spot
ScaleSetPriority	Priorità del set di scalabilità di macchine virtuali.
SeccompDefault	Specifica il profilo seccomp predefinito applicato a tutti i carichi di lavoro. Se non specificato, per impostazione predefinita verrà usato 'Unconfined'.
SysctlConfig	Impostazioni sysctl per i nodi dell'agente Linux.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
VmState	Stato della macchina virtuale. Indica lo stato corrente della macchina virtuale sottostante.
WorkloadRuntime	Determina il tipo di carico di lavoro che un nodo può eseguire.

AgentPoolArtifactStreamingProfile

Oggetto

Profilo streaming di artefatti per il pool di agenti.

Nome	Tipo	Descrizione
enabled	boolean	Lo streaming degli artefatti accelera l'avvio a freddo dei contenitori in un nodo tramite il caricamento di immagini su richiesta. Per usare questa funzionalità, le immagini del contenitore devono anche abilitare lo streaming degli artefatti nel Registro Azure Container. Se non specificato, il valore predefinito è false.

AgentPoolMode

Enumerazione

Modalità di un pool di agenti. Un cluster deve avere sempre almeno un pool di agenti "System". Per altre informazioni sulle restrizioni del pool di agenti e sulle procedure consigliate, vedere: https://docs.microsoft.com/azure/aks/use-system-pools

Valore	Descrizione
System	I pool di agenti di sistema sono principalmente per l'hosting di pod di sistema critici come CoreDNS e metrics-server. I pool di agenti di sistema osType devono essere Linux. Lo SKU della macchina virtuale dei pool di agenti di sistema deve avere almeno 2 vCPU e 4 GB di memoria.
User	I pool di agenti utente servono principalmente per ospitare i pod dell'applicazione.
Gateway	I pool di agenti gateway sono dedicati a fornire indirizzi IP di uscita statici ai pod. Per altri dettagli, vedere https://aka.ms/aks/static-egress-gateway.
ManagedSystem	ManagedSystem è un pool di sistemi gestito dal servizio Azure Kubernetes. Il pool viene ridimensionato dinamicamente in base all'utilizzo del cluster e dispone di funzionalità di monitoraggio e correzione automatizzate aggiuntive. Può essere presente un solo pool ManagedSystem ed è consigliabile eliminare tutti gli altri pool di sistemi per ottenere un'esperienza ottimale.
Machines	I pool di agenti dei computer sono dedicati ai computer host. A livello di pool sono consentite solo operazioni limitate, ad esempio la creazione e l'eliminazione. Utilizza le API della macchina per gestire l'intero ciclo di vita della macchina.

AgentPoolSSHAccess

Enumerazione

Metodo di access SSH di un pool di agenti.

Valore	Descrizione
LocalUser	Può eseguire SSH nel nodo come utente locale usando la chiave privata.
Disabled	Il servizio SSH verrà disattivato nel nodo.
EntraId	SSH al nodo con integrazione EntraId. Maggiori informazioni sono disponibili alla voce https://aka.ms/aks/ssh/aad

AgentPoolWindowsProfile

Oggetto

Profilo specifico del pool di agenti di Windows.

Nome	Tipo	Descrizione
disableOutboundNat	boolean	Indica se disabilitare OutboundNAT nei nodi Windows. Il valore predefinito è false. Nat in uscita può essere disabilitato solo se il cluster outboundType è gateway NAT e il pool di agenti Di Windows non dispone dell'indirizzo IP pubblico del nodo abilitato.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

DriftAction

Enumerazione

L'azione di deriva della macchina. Indica se un computer ha deviato dallo stato previsto a causa di modifiche nelle proprietà del cluster gestito, che richiedono un'azione correttiva.

Valore	Descrizione
Synced	La macchina è aggiornata.
Recreate	La macchina è andata alla deriva e deve essere eliminata e ricreata.

DriverType

Enumerazione

Specificare il tipo di driver GPU da installare durante la creazione di pool di agenti Windows. Se non specificato, il servizio Azure Kubernetes seleziona il driver in base alla compatibilità del sistema. Questa operazione non può essere modificata dopo la creazione di AgentPool. Non è possibile impostare questa impostazione in Linux AgentPools. Per Linux AgentPools, il driver viene selezionato in base alla compatibilità del sistema.

Valore	Descrizione
GRID	Installare il driver GRID per la GPU, adatto per le applicazioni che richiedono il supporto della virtualizzazione.
CUDA	Installa il driver CUDA per la GPU, ottimizzato per le attività di calcolo scientifico e le applicazioni ad alta intensità di dati.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

GPUDriver

Enumerazione

Indica se installare i driver GPU. Quando non è specificato, il valore predefinito è Install.

Valore	Descrizione
Install	Installa il driver.
None	Salta l'installazione del driver.

GPUInstanceProfile

Enumerazione

GPUInstanceProfile da usare per specificare il profilo di istanza MIG della GPU per lo SKU di VM GPU supportato.

Valore	Descrizione
MIG1g	Profilo di istanza GPU MIG 1g.
MIG2g	Profilo di istanza GPU MIG 2g.
MIG3g	Profilo di istanza GPU MIG 3g.
MIG4g	Profilo di istanza GPU MIG 4g.
MIG7g	Profilo di istanza GPU MIG 7g.

GPUProfile

Oggetto

Impostazioni GPU per il pool di agenti.

Nome	Tipo	Descrizione
driver	GPUDriver	Indica se installare i driver GPU. Quando non è specificato, il valore predefinito è Install.
driverType	DriverType	Specificare il tipo di driver GPU da installare durante la creazione di pool di agenti Windows. Se non specificato, il servizio Azure Kubernetes seleziona il driver in base alla compatibilità del sistema. Questa operazione non può essere modificata dopo la creazione di AgentPool. Non è possibile impostare questa impostazione in Linux AgentPools. Per Linux AgentPools, il driver viene selezionato in base alla compatibilità del sistema.
nvidia	NvidiaGPUProfile	Impostazioni GPU specifiche NVIDIA.

IPFamily

Enumerazione

Per determinare se l'indirizzo appartiene alla famiglia IPv4 o IPv6

Valore	Descrizione
IPv4	Famiglia IPv4
IPv6	Famiglia IPv6

IPTag

Oggetto

Contiene l'IPTag associato all'oggetto .

Nome	Tipo	Descrizione
ipTagType	string	Tipo di tag IP. Esempio: RoutingPreference.
tag	string	Valore del tag IP associato all'indirizzo IP pubblico. Esempio: Internet.

KubeletConfig

Oggetto

Configurazioni kubelet dei nodi dell'agente. Per altre informazioni, vedere di configurazione del nodo personalizzato del servizio Azure Kubernetes.

Nome	Tipo	Descrizione
allowedUnsafeSysctls	string[]	Elenco consentito di sysctls non sicuri o criteri sysctl non sicuri (che terminano in *).
containerLogMaxFiles	integer (int32) minimum: 2	Numero massimo di file di log del contenitore che possono essere presenti per un contenitore. Il numero deve essere ≥ 2.
containerLogMaxSizeMB	integer (int32)	Dimensioni massime (ad esempio 10Mi) del file di log del contenitore prima della rotazione.
cpuCfsQuota	boolean	Se l'imposizione della quota CFS della CPU è abilitata per i contenitori che specificano i limiti della CPU. Il valore predefinito è vero.
cpuCfsQuotaPeriod	string	Valore del periodo di quota DI CPU CFS. Il valore predefinito è '100ms'. I valori validi sono una sequenza di numeri decimali con una frazione facoltativa e un suffisso unità. Ad esempio: '300ms', '2h45m'. Le unità supportate sono 'ns', 'us', 'ms', 's', 'm' e 'h'.
cpuManagerPolicy	string	Criteri di Gestione CPU da usare. Il valore predefinito è 'none'. Per altre informazioni, vedere Criteri di gestione della CPU Kubernetes . I valori consentiti sono 'none' e 'static'.
failSwapOn	boolean	Se impostato su true, l'avvio di Kubelet avrà esito negativo se lo scambio è abilitato nel nodo.
imageGcHighThreshold	integer (int32)	Percentuale di utilizzo del disco dopo la quale viene sempre eseguita l'operazione di Garbage Collection dell'immagine. Per disabilitare l'operazione di Garbage Collection delle immagini, impostare su 100. Il valore predefinito è 85%
imageGcLowThreshold	integer (int32)	Percentuale di utilizzo del disco prima dell'esecuzione dell’operazione di Garbage Collection delle immagini. Non è possibile impostare un valore superiore a imageGcHighThreshold. Il valore predefinito è 80%
podMaxPids	integer (int32)	Numero massimo di processi per pod.
seccompDefault	SeccompDefault	Specifica il profilo seccomp predefinito applicato a tutti i carichi di lavoro. Se non specificato, per impostazione predefinita verrà usato 'Unconfined'.
topologyManagerPolicy	string	Criteri di Gestione topologia da usare. Per altre informazioni, vedere Gestione topologie Kubernetes. Il valore predefinito è 'none'. I valori consentiti sono "none", "best-effort", "restricted" e "single-numa-node".

KubeletDiskType

Enumerazione

Determina la posizione dei volumi emptyDir, della radice dati in runtime del container e dello storage effimero Kubelet.

Valore	Descrizione
OS	Kubelet utilizzerà il disco del sistema operativo per i suoi dati.
Temporary	Kubelet utilizzerà il disco temporaneo per i suoi dati.

LinuxOSConfig

Oggetto

Configurazioni del sistema operativo dei nodi dell'agente Linux. Per altre informazioni, vedere di configurazione del nodo personalizzato del servizio Azure Kubernetes.

Nome	Tipo	Descrizione
swapFileSizeMB	integer (int32)	Dimensioni in MB di un file di scambio che verrà creato in ogni nodo.
sysctls	SysctlConfig	Impostazioni sysctl per i nodi dell'agente Linux.
transparentHugePageDefrag	string	Indica se il kernel deve fare uso aggressivo della compattazione della memoria per rendere disponibili più enormi pagine. I valori validi sono 'always', 'defer', 'defer+madvise', 'madvise' e 'never'. Il valore predefinito è "madvise". Per altre informazioni, vedere Transparent Hugepages.
transparentHugePageEnabled	string	Indica se le enormi pagine trasparenti sono abilitate. I valori validi sono 'always', 'madvise' e 'never'. Il valore predefinito è 'always'. Per altre informazioni, vedere Transparent Hugepages.

LocalDNSForwardDestination

Enumerazione

Server di destinazione per le query DNS da inoltrare da localDNS.

Valore	Descrizione
ClusterCoreDNS	Inoltra le query DNS da localDNS al cluster CoreDNS.
VnetDNS	Inoltrare le query DNS da localDNS al server DNS configurato nella rete virtuale. Una rete virtuale può avere più server DNS configurati.

LocalDNSForwardPolicy

Enumerazione

Criterio di inoltro per la selezione del server DNS upstream. Per ulteriori informazioni, vedere il plug-in forward .

Valore	Descrizione
Sequential	Implementa la selezione sequenziale del server DNS a monte. Per ulteriori informazioni, vedere il plug-in forward .
RoundRobin	Implementa la selezione del server DNS upstream round robin. Per ulteriori informazioni, vedere il plug-in forward .
Random	Implementa la selezione casuale del server DNS a monte. Per ulteriori informazioni, vedere il plug-in forward .

LocalDNSMode

Enumerazione

Modalità di abilitazione per il DNS locale.

Valore	Descrizione
Preferred	Se la versione corrente dell'agente di orchestrazione supporta questa funzionalità, preferire l'abilitazione di localDNS.
Required	Abilita localDNS.
Disabled	Disabilita il DNS locale.

LocalDNSOverride

Oggetto

Sostituzioni per il profilo localDNS.

Nome	Tipo	Valore predefinito	Descrizione
cacheDurationInSeconds	integer (int32)	3600	Cache max TTL in secondi. Per ulteriori informazioni, vedere il plug-in cache .
forwardDestination	LocalDNSForwardDestination	ClusterCoreDNS	Server di destinazione per le query DNS da inoltrare da localDNS.
forwardPolicy	LocalDNSForwardPolicy	Sequential	Criterio di inoltro per la selezione del server DNS upstream. Per ulteriori informazioni, vedere il plug-in forward .
maxConcurrent	integer (int32)	1000	Numero massimo di query simultanee. Per ulteriori informazioni, vedere il plug-in forward .
protocol	LocalDNSProtocol	PreferUDP	Applicare TCP o preferire il protocollo UDP per le connessioni da localDNS al server DNS upstream.
queryLogging	LocalDNSQueryLogging	Error	Livello di log per le query DNS in localDNS.
serveStale	LocalDNSServeStale	Immediate	Criteri per la pubblicazione di dati non aggiornati. Per ulteriori informazioni, vedere il plug-in cache .
serveStaleDurationInSeconds	integer (int32)	3600	Servi la durata obsoleta in secondi. Per ulteriori informazioni, vedere il plug-in cache .

LocalDNSProfile

Oggetto

Configura il DNS locale per nodo, con override di VnetDNS e KubeDNS. LocalDNS consente di migliorare le prestazioni e l'affidabilità della risoluzione DNS in un cluster del servizio Azure Kubernetes. Per maggiori dettagli vedere aka.ms/aks/localdns.

Nome	Tipo	Valore predefinito	Descrizione
kubeDNSOverrides	<string,  LocalDNSOverride>		Le sostituzioni di KubeDNS si applicano al traffico DNS proveniente da pod con dnsPolicy:ClusterFirst (denominato traffico KubeDNS).
mode	LocalDNSMode	Preferred	Modalità di abilitazione per il DNS locale.
state	LocalDNSState		Stato generato dal sistema di localDNS.
vnetDNSOverrides	<string,  LocalDNSOverride>		Le sostituzioni di VnetDNS si applicano al traffico DNS proveniente da pod con dnsPolicy:default o kubelet (denominato traffico VnetDNS).

LocalDNSProtocol

Enumerazione

Applicare TCP o preferire il protocollo UDP per le connessioni da localDNS al server DNS upstream.

Valore	Descrizione
PreferUDP	Preferisci il protocollo UDP per le connessioni da localDNS al server DNS upstream.
ForceTCP	Applicare il protocollo TCP per le connessioni da localDNS al server DNS upstream.

LocalDNSQueryLogging

Enumerazione

Livello di log per le query DNS in localDNS.

Valore	Descrizione
Error	Abilita la registrazione degli errori in localDNS. Per ulteriori informazioni, vedere il plug-in errors .
Log	Abilita la registrazione delle query in localDNS. Per ulteriori informazioni, vedere il plug-in di registro .

LocalDNSServeStale

Enumerazione

Criteri per la pubblicazione di dati non aggiornati. Per ulteriori informazioni, vedere il plug-in cache .

Valore	Descrizione
Verify	Distribuisci dati obsoleti con la verifica. Verificare innanzitutto che una voce non sia ancora disponibile dall'origine prima di inviare la voce scaduta al client. Per ulteriori informazioni, vedere il plug-in cache .
Immediate	Distribuisci immediatamente i dati obsoleti. Inviare la voce scaduta al client prima di verificare se la voce è disponibile dall'origine. Per ulteriori informazioni, vedere il plug-in cache .
Disable	Disabilitare la gestione dei dati non aggiornati.

LocalDNSState

Enumerazione

Stato generato dal sistema di localDNS.

Valore	Descrizione
Enabled	localDNS è abilitato.
Disabled	localDNS è disabilitato.

Machine

Oggetto

Una macchina. Contiene informazioni dettagliate sulla macchina virtuale sottostante. Un computer può essere visibile qui ma non nei nodi kubectl get; in caso affermativo, potrebbe essere dovuto al fatto che il computer non è ancora stato registrato con il server API Kubernetes.

Nome	Tipo	Descrizione
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nome della risorsa
properties	MachineProperties	Proprietà del computer
systemData	systemData	Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"
zones	string[]	La zona di disponibilità in cui si trova il computer.

MachineBillingProfile

Oggetto

Le proprietà riguardano la fatturazione delle macchine.

Nome	Tipo	Valore predefinito	Descrizione
spotMaxPrice	number (float)	-1	Il prezzo massimo (in dollari statunitensi) che si è disposti a pagare per le istanze spot. I valori possibili sono qualsiasi valore decimale maggiore di zero o -1 che indica il prezzo predefinito da up-to su richiesta. Per maggiori dettagli sui prezzi spot, vedi VM spot c0

MachineHardwareProfile

Oggetto

Le impostazioni hardware e GPU della macchina.

Nome	Tipo	Descrizione
gpuInstanceProfile	GPUInstanceProfile	GPUInstanceProfile da usare per specificare il profilo di istanza MIG della GPU per lo SKU di VM GPU supportato.
gpuProfile	GPUProfile	Le impostazioni GPU della macchina.
ultraSsdEnabled	boolean	Se abilitare UltraSSD
vmSize	string	Dimensioni della macchina virtuale. La disponibilità delle dimensioni della macchina virtuale varia in base all'area. Se un nodo contiene risorse di calcolo insufficienti (memoria, CPU e così via) i pod potrebbero non essere eseguiti correttamente. Per altre informazioni sulle dimensioni delle macchine virtuali con restrizioni, vedere: https://docs.microsoft.com/azure/aks/quotas-skus-regions

MachineIpAddress

Oggetto

Dettagli dell'indirizzo IP del computer.

Nome	Tipo	Descrizione
family	IPFamily	Per determinare se l'indirizzo appartiene alla famiglia IPv4 o IPv6
ip	string	Indirizzo IPv4 o IPv6 della macchina

MachineKubernetesProfile

Oggetto

Le configurazioni Kubernetes utilizzate dal computer.

Nome	Tipo	Descrizione
artifactStreamingProfile	AgentPoolArtifactStreamingProfile	Configurazione per l'uso dello streaming degli artefatti nel servizio Azure Kubernetes.
currentOrchestratorVersion	string	La versione di Kubernetes in esecuzione nel computer. Se orchestratorVersion era una versione <completamente specificata major.minor.patch>, questo campo sarà esattamente uguale a esso. Se orchestratorVersion è <major.minor>, questo campo conterrà la versione principale.secondaria.patch< completa >usata.
kubeletConfig	KubeletConfig	La configurazione Kubelet sulla macchina.
kubeletDiskType	KubeletDiskType	Determina la posizione dei volumi emptyDir, della radice dati in runtime del container e dello storage effimero Kubelet.
maxPods	integer (int32)	Numero massimo di pod che possono essere eseguiti in un nodo.
nodeInitializationTaints	string[]	Contaminazioni aggiunte al nodo durante la creazione che non verranno riconciliate dal servizio Azure Kubernetes. Questi taints non verranno riconciliati dal servizio Azure Kubernetes e possono essere rimossi con una chiamata kubectl. Questi taints consentono l'esecuzione della configurazione necessaria prima che il nodo sia pronto ad accettare carichi di lavoro, ad esempio 'key1=value1:NoSchedule' che può essere rimosso con kubectl taint nodes node1 key1=value1:NoSchedule-
nodeLabels	object	Le etichette dei nodi sulla macchina.
nodeName	string	Il nome del nodo nel cluster Kubernetes.
nodeTaints	string[]	Le contaminazioni aggiunte al nuovo nodo durante la creazione del computer. Ad esempio, key=value:NoSchedule.
orchestratorVersion	string	Versione di Kubernetes specificata dall'utente. Sono supportate entrambe le versioni <patch major.minor.patch> e <major.minor> . Quando <si specifica major.minor> , viene scelta automaticamente la versione della patch supportata più recente.
workloadRuntime	WorkloadRuntime	Determina il tipo di carico di lavoro che un nodo può eseguire.

MachineNetworkProperties

Oggetto

proprietà di rete del computer

Nome	Tipo	Descrizione
enableNodePublicIP	boolean	Se al computer è allocato il proprio indirizzo IP pubblico. Alcuni scenari possono richiedere che il computer riceva i propri indirizzi IP pubblici dedicati. Uno scenario comune riguarda i carichi di lavoro di gioco, in cui una console deve stabilire una connessione diretta a una macchina virtuale cloud per ridurre al minimo gli hop. Il valore predefinito è false.
ipAddresses	MachineIpAddress[]	Indirizzi IPv4, IPv6 della macchina
nodePublicIPPrefixID	string (arm-id)	ID del prefisso IP pubblico da cui il nodo della macchina virtuale deve usare gli indirizzi IP. Modulo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
nodePublicIPTags	IPTag[]	IPTag degli INDIRIZZI IP pubblici a livello di istanza.
podSubnetID	string (arm-id)	ID della subnet a cui verranno aggiunti i pod al momento dell'avvio. Se omesso, gli indirizzi IP dei pod vengono assegnati in modo statico nella subnet del nodo (vedere vnetSubnetID per altri dettagli). Questo è il formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
vnetSubnetID	string (arm-id)	L'ID della subnet a cui si uniranno i pod e, facoltativamente, all'avvio. Se non viene specificato, verrà generata e usata una rete virtuale e una subnet. Se non viene specificato alcun podSubnetID, questo vale per nodi e pod, altrimenti si applica solo ai nodi. Questo è il formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

MachineOSProfile

Oggetto

Il sistema operativo e il disco utilizzati dalla macchina.

Nome	Tipo	Valore predefinito	Descrizione
enableFIPS	boolean		Indica se usare un sistema operativo abilitato per FIPS.
linuxProfile	MachineOSProfileLinuxProfile		Il profilo specifico del computer Linux.
osDiskSizeGB	integer (int32) minimum: 0 maximum: 2048		Dimensioni disco del sistema operativo in GB da usare per specificare le dimensioni del disco per ogni computer nel pool master/agente. Se si specifica 0, verrà applicata la dimensione osDisk predefinita in base all'opzione vmSize specificata.
osDiskType	OSDiskType		Tipo di disco del sistema operativo da usare per i computer nel pool di agenti. Il valore predefinito è "Ephemeral" se la macchina virtuale lo supporta e ha un disco della cache maggiore di quello richiesto OSDiskSizeGB. In caso contrario, il valore predefinito è "Gestito". Non può essere modificato dopo la creazione. Per maggiori informazioni vedi Ephemeral OS.
osSKU	OSSKU		Specifica lo SKU del sistema operativo usato dal pool di agenti. Se non specificato, il valore predefinito è Ubuntu se OSType=Linux o Windows2019 se OSType=Windows. E il sistema operativo Windows predefinito verrà modificato in Windows2022 dopo che Windows2019 è deprecato.
osType	OSType	Linux	Tipo di sistema operativo. Il valore predefinito è Linux.
windowsProfile	AgentPoolWindowsProfile		Profilo specifico del computer Windows.

MachineOSProfileLinuxProfile

Oggetto

Il profilo specifico del computer Linux.

Nome	Tipo	Descrizione
linuxOSConfig	LinuxOSConfig	La configurazione del sistema operativo della macchina Linux.
messageOfTheDay	string	Messaggio del giorno per i nodi Linux, con codifica Base64. Stringa con codifica base64 che verrà scritta in /etc/motd dopo la decodifica. In questo modo è possibile personalizzare il messaggio del giorno per i nodi Linux. Non deve essere specificato per i nodi Windows. Deve essere una stringa statica (ad esempio, verrà stampato non elaborato e non verrà eseguito come script).

MachineProperties

Oggetto

Proprietà del computer

Nome	Tipo	Valore predefinito	Descrizione
billing	MachineBillingProfile		Le proprietà riguardano la fatturazione delle macchine.
eTag	string		Stringa di sola lettura univoca usata per implementare la concorrenza ottimistica. Il valore eTag cambierà quando la risorsa viene aggiornata. Specificare un'intestazione if-match o if-none-match con il valore eTag per una richiesta successiva per abilitare la concorrenza ottimistica in base alla normale convenzione eTag.
evictionPolicy	ScaleSetEvictionPolicy	Delete	La politica di sfratto per la macchina. Questo non può essere specificato a meno che la priorità non sia 'Spot'. Se non specificato, il valore predefinito è 'Delete'.
hardware	MachineHardwareProfile		Le impostazioni hardware e GPU della macchina.
kubernetes	MachineKubernetesProfile		Le configurazioni Kubernetes utilizzate dal computer.
localDNSProfile	LocalDNSProfile		Configura il DNS locale per nodo, con override di VnetDNS e KubeDNS. LocalDNS consente di migliorare le prestazioni e l'affidabilità della risoluzione DNS in un cluster del servizio Azure Kubernetes. Per maggiori dettagli vedere aka.ms/aks/localdns.
mode	AgentPoolMode		La macchina consente solo le modalità 'Sistema' e 'Utente'.
network	MachineNetworkProperties		proprietà di rete del computer
nodeImageVersion	string		Versione dell'immagine del nodo.
operatingSystem	MachineOSProfile		Il sistema operativo e il disco utilizzati dalla macchina.
priority	ScaleSetPriority	Regular	La priorità per la macchina. Se non specificato, il valore predefinito è 'Regular'.
provisioningState	string		Stato di distribuzione o provisioning corrente.
resourceId	string (arm-id)		ID risorsa Azure del computer. Può essere utilizzato per OTTENERE l'istanza VM sottostante
security	MachineSecurityProfile		Le impostazioni di sicurezza della macchina.
status	MachineStatus		Contiene informazioni di sola lettura sulla macchina.
tags	object		I tag da rendere persistenti nel computer.

MachineSecurityProfile

Oggetto

Le impostazioni di sicurezza della macchina.

Nome	Tipo	Descrizione
enableEncryptionAtHost	boolean	Indica se abilitare la crittografia del sistema operativo e dell'unità dati basata su host. Questo è supportato solo su determinate dimensioni di VM e in determinate regioni Azure. Per altre informazioni, vedere: https://docs.microsoft.com/azure/aks/enable-host-encryption
enableSecureBoot	boolean	L'avvio protetto è una funzionalità di avvio attendibile che garantisce l'avvio solo dei sistemi operativi e dei driver firmati. Per altri dettagli, vedere aka.ms/aks/trustedlaunch. Se non specificato, il valore predefinito è false.
enableVTPM	boolean	vTPM è una funzionalità di avvio attendibile per la configurazione di un insieme di credenziali sicuro dedicato per chiavi e misurazioni mantenute localmente nel nodo. Per altri dettagli, vedere aka.ms/aks/trustedlaunch. Se non specificato, il valore predefinito è false.
sshAccess	AgentPoolSSHAccess	Metodo di access SSH di un pool di agenti.

MachineStatus

Oggetto

Contiene informazioni di sola lettura sulla macchina.

Nome	Tipo	Descrizione
creationTimestamp	string (date-time)	Specifica l'ora in cui il computer è stato creato.
driftAction	DriftAction	L'azione di deriva della macchina. Indica se un computer ha deviato dallo stato previsto a causa di modifiche nelle proprietà del cluster gestito, che richiedono un'azione correttiva.
driftReason	string	Motivo della deriva della macchina. Fornisce informazioni dettagliate sul motivo per cui la macchina è andata alla deriva. Questo campo viene omesso se la macchina è aggiornata.
provisioningError	ErrorDetail	L'errore dettaglia le informazioni della macchina. Conserva le informazioni dettagliate dell'errore. Se non si è verificato alcun errore, questo campo viene omesso.
vmState	VmState	Stato della macchina virtuale. Indica lo stato corrente della macchina virtuale sottostante.

ManagementMode

Enumerazione

L'esperienza GPU gestita installa componenti aggiuntivi, come le metriche Data Center GPU Manager (DCGM) per il monitoraggio, oltre al driver GPU per te. Per maggiori dettagli su cosa viene installato, dai un'occhiata a aka.ms/aks/managed-gpu.

Valore	Descrizione
Unmanaged	L'esperienza GPU gestita è disabilitata per le GPU NVIDIA.
Managed	L'esperienza GPU gestita è abilitata per le GPU NVIDIA.

MigStrategy

Enumerazione

Stabilisce la strategia MIG (Multi-Instance GPU) che sarà utilizzata per il supporto MIG. Per maggiori informazioni sulle diverse strategie, visita aka.ms/aks/managed-gpu. Quando non specificato, il valore predefinito è Nessuno.

Valore	Descrizione
None	Non impostare una strategia MIG. Se ne avevi già una impostata, questa la sovrascriverà e la set rimuoverà la strategia MIG impostata.
Single	Imposta la strategia MIG per il MIG gestito come singola.
Mixed	Imposta la strategia MIG per il MIG gestito come mista.

NvidiaGPUProfile

Oggetto

Impostazioni GPU specifiche NVIDIA

Nome	Tipo	Descrizione
managementMode	ManagementMode	L'esperienza GPU gestita installa componenti aggiuntivi, come le metriche Data Center GPU Manager (DCGM) per il monitoraggio, oltre al driver GPU per te. Per maggiori dettagli su cosa viene installato, dai un'occhiata a aka.ms/aks/managed-gpu.
migStrategy	MigStrategy	Stabilisce la strategia MIG (Multi-Instance GPU) che sarà utilizzata per il supporto MIG. Per maggiori informazioni sulle diverse strategie, visita aka.ms/aks/managed-gpu. Quando non specificato, il valore predefinito è Nessuno.

OSDiskType

Enumerazione

Tipo di disco del sistema operativo da usare per i computer nel pool di agenti. Il valore predefinito è "Ephemeral" se la macchina virtuale lo supporta e ha un disco della cache maggiore di quello richiesto OSDiskSizeGB. In caso contrario, il valore predefinito è "Gestito". Non può essere modificato dopo la creazione. Per maggiori informazioni vedi Ephemeral OS.

Valore	Descrizione
Managed	Azure replica il disco del sistema operativo per una macchina virtuale in Archiviazione di Azure per evitare la perdita di dati nel caso in cui la macchina virtuale debba essere riposizionata in un altro host. Poiché i contenitori non sono progettati per rendere persistente lo stato locale, questo comportamento offre un valore limitato, fornendo alcuni svantaggi, tra cui il provisioning dei nodi più lento e una latenza di lettura/scrittura superiore.
Ephemeral	I dischi temporanei del sistema operativo vengono archiviati solo nel computer host, proprio come un disco temporaneo. Ciò garantisce una latenza di lettura/scrittura inferiore, oltre a un ridimensionamento più rapido dei nodi e agli aggiornamenti del cluster.

OSSKU

Enumerazione

Specifica lo SKU del sistema operativo usato dal pool di agenti. Il valore predefinito è Ubuntu se OSType è Linux. Il valore predefinito è Windows2019 quando Kubernetes <= 1.24 o Windows2022 quando Kubernetes >= 1.25 se OSType è Windows.

Valore	Descrizione
Ubuntu	Usare Ubuntu come sistema operativo per le immagini del nodo.
AzureLinux	Usare AzureLinux come sistema operativo per le immagini dei nodi. Linux di Azure è una distribuzione Linux ottimizzata per i contenitori creata da Microsoft. Per altre informazioni, visitare https://aka.ms/azurelinux.
AzureLinux3	Usare AzureLinux3 come sistema operativo per le immagini dei nodi. Linux di Azure è una distribuzione Linux ottimizzata per i contenitori creata da Microsoft. Per altre informazioni, visitare https://aka.ms/azurelinux. Per le limitazioni, visitare il sito https://aka.ms/aks/node-images. Per indicazioni sulla migrazione del sistema operativo, vedere https://aka.ms/aks/upgrade-os-version.
Mariner	OSSKU deprecato. Microsoft consiglia di scegliere invece "AzureLinux" per le nuove distribuzioni.
Flatcar	Usa Flatcar Container Linux come sistema operativo per le immagini dei nodi. Flatcar è un sistema operativo Linux ottimizzato per i container e incentrato sulla sicurezza, con un filesystem immutabile e parte della Cloud Native Computing Foundation (CNCF). Per altre informazioni su Flatcar Container Linux per il servizio Azure Kubernetes, vedere aka.ms/aks/flatcar-container-linux-for-aks
CBLMariner	OSSKU deprecato. Microsoft consiglia di scegliere invece "AzureLinux" per le nuove distribuzioni.
Windows2019	Usare Windows2019 come sistema operativo per le immagini del nodo. Non supportato per i pool di nodi di sistema. Windows2019 supporta solo i contenitori Windows2019; non può eseguire contenitori Windows2022 e viceversa.
Windows2022	Usare Windows2022 come sistema operativo per le immagini del nodo. Non supportato per i pool di nodi di sistema. Windows2022 supporta solo contenitori Windows2022; non può eseguire contenitori Windows2019 e viceversa.
Ubuntu2204	Utilizzare Ubuntu2204 come sistema operativo per le immagini dei nodi, tuttavia, Ubuntu 22.04 potrebbe non essere supportato per tutti i pool di nodi. Per le limitazioni e le versioni di Kubernetes supportate, vedere https://aka.ms/aks/supported-ubuntu-versions
Windows2025	Utilizzare Windows2025 come sistema operativo per le immagini dei nodi. Non supportato per i pool di nodi di sistema. Windows2025 supporta i contenitori Windows2022 e Windows 2025; non può eseguire contenitori Windows2019 e viceversa.
WindowsAnnual	Usa la versione del canale annuale di Windows come sistema operativo per le immagini del nodo. Non supportato per i pool di nodi di sistema. I dettagli sulle immagini del contenitore supportate e sulle versioni kubernetes in diverse versioni del canale annuale del servizio Azure Kubernetes possono essere visualizzate in https://aka.ms/aks/windows-annual-channel-details.
Ubuntu2404	Utilizzare Ubuntu2404 come sistema operativo per le immagini dei nodi, tuttavia, Ubuntu 24.04 potrebbe non essere supportato per tutti i pool di nodi. Per le limitazioni e le versioni di kubernetes supportate, vedere https://aka.ms/aks/supported-ubuntu-versions

OSType

Enumerazione

Tipo di sistema operativo. Il valore predefinito è Linux.

Valore	Descrizione
Linux	Usa Linux.
Windows	Usa Windows.

ScaleSetEvictionPolicy

Enumerazione

Criteri di rimozione del set di scalabilità di macchine virtuali. La politica di sfratto specifica cosa fare do con la VM quando viene sfrattata. Il valore predefinito è Elimina. Per maggiori informazioni sullo sfratto vedi spot

Valore	Descrizione
Delete	I nodi nel set di scalabilità sottostante del pool di nodi vengono eliminati quando vengono rimossi.
Deallocate	I nodi nel set di scalabilità sottostante del pool di nodi vengono impostati sullo stato arrestato-deallocato al momento della rimozione. I nodi nel conteggio dello stato di deallocazione arrestata rispetto alla quota di calcolo e possono causare problemi con il ridimensionamento o l'aggiornamento del cluster.

ScaleSetPriority

Enumerazione

Priorità del set di scalabilità di macchine virtuali.

Valore	Descrizione
Spot	Verranno usate macchine virtuali con priorità spot. Non esiste alcun contratto di servizio per i nodi spot. Per altre informazioni, vedere spot sul del servizio Azure Kubernetes.
Regular	Verranno usate macchine virtuali normali.

SeccompDefault

Enumerazione

Specifica il profilo seccomp predefinito applicato a tutti i carichi di lavoro. Se non specificato, per impostazione predefinita verrà usato 'Unconfined'.

Valore	Descrizione
Unconfined	Non viene applicato alcun profilo seccomp, consentendo tutte le chiamate di sistema.
RuntimeDefault	Viene applicato il profilo seccomp predefinito per il runtime del contenitore, che limita determinate chiamate di sistema per una maggiore sicurezza.

SysctlConfig

Oggetto

Impostazioni sysctl per i nodi dell'agente Linux.

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

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

VmState

Enumerazione

Stato della macchina virtuale. Indica lo stato corrente della macchina virtuale sottostante.

Valore	Descrizione
Running	La macchina virtuale è attualmente in esecuzione.
Deleted	La macchina virtuale è stata eliminata dall'utente o a causa di una rimozione spot.

WorkloadRuntime

Enumerazione

Determina il tipo di carico di lavoro che un nodo può eseguire.

Valore	Descrizione
OCIContainer	I nodi useranno Kubelet per eseguire carichi di lavoro di contenitori OCI standard.
WasmWasi	I nodi useranno Krustlet per eseguire carichi di lavoro WASM usando il provider WASI (anteprima).
KataMshvVmIsolation	I nodi possono usare (Kata + Cloud Hypervisor + Hyper-V) per abilitare i pod basati su vm annidati (anteprima). A causa dell'uso di Hyper-V, il sistema operativo del nodo del servizio Azure Kubernetes è una macchina virtuale nidificata (il sistema operativo radice) di Hyper-V. Può quindi essere usata solo con serie di macchine virtuali che supportano la virtualizzazione annidata, ad esempio la serie Dv3. Questa convenzione di denominazione verrà deprecata nelle versioni future a favore di KataVmIsolation.
KataVmIsolation	I nodi possono utilizzare (Kata + Cloud Hypervisor + Hyper-V) per abilitare i pod nidificati basati su VM. A causa dell'uso di Hyper-V, il sistema operativo del nodo del servizio Azure Kubernetes è una macchina virtuale nidificata (il sistema operativo radice) di Hyper-V. Può quindi essere usata solo con serie di macchine virtuali che supportano la virtualizzazione annidata, ad esempio la serie Dv3.