Microsoft.ContainerService managedClusters/agentPools 2025-03-02-preview

2025-06-10

Definizione di risorsa Bicep

Il tipo di risorsa managedClusters/agentPools può essere distribuito con operazioni destinate a:

gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.ContainerService/managedClusters/agentPools, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.ContainerService/managedClusters/agentPools@2025-03-02-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    artifactStreamingProfile: {
      enabled: bool
    }
    availabilityZones: [
      'string'
    ]
    capacityReservationGroupID: 'string'
    count: int
    creationData: {
      sourceResourceId: 'string'
    }
    enableAutoScaling: bool
    enableCustomCATrust: bool
    enableEncryptionAtHost: bool
    enableFIPS: bool
    enableNodePublicIP: bool
    enableUltraSSD: bool
    gatewayProfile: {
      publicIPPrefixSize: int
    }
    gpuInstanceProfile: 'string'
    gpuProfile: {
      driver: 'string'
      driverType: 'string'
    }
    hostGroupID: 'string'
    kubeletConfig: {
      allowedUnsafeSysctls: [
        'string'
      ]
      containerLogMaxFiles: int
      containerLogMaxSizeMB: int
      cpuCfsQuota: bool
      cpuCfsQuotaPeriod: 'string'
      cpuManagerPolicy: 'string'
      failSwapOn: bool
      imageGcHighThreshold: int
      imageGcLowThreshold: int
      podMaxPids: int
      seccompDefault: 'string'
      topologyManagerPolicy: 'string'
    }
    kubeletDiskType: 'string'
    linuxOSConfig: {
      swapFileSizeMB: int
      sysctls: {
        fsAioMaxNr: int
        fsFileMax: int
        fsInotifyMaxUserWatches: int
        fsNrOpen: int
        kernelThreadsMax: int
        netCoreNetdevMaxBacklog: int
        netCoreOptmemMax: int
        netCoreRmemDefault: int
        netCoreRmemMax: int
        netCoreSomaxconn: int
        netCoreWmemDefault: int
        netCoreWmemMax: int
        netIpv4IpLocalPortRange: 'string'
        netIpv4NeighDefaultGcThresh1: int
        netIpv4NeighDefaultGcThresh2: int
        netIpv4NeighDefaultGcThresh3: int
        netIpv4TcpFinTimeout: int
        netIpv4TcpkeepaliveIntvl: int
        netIpv4TcpKeepaliveProbes: int
        netIpv4TcpKeepaliveTime: int
        netIpv4TcpMaxSynBacklog: int
        netIpv4TcpMaxTwBuckets: int
        netIpv4TcpTwReuse: bool
        netNetfilterNfConntrackBuckets: int
        netNetfilterNfConntrackMax: int
        vmMaxMapCount: int
        vmSwappiness: int
        vmVfsCachePressure: int
      }
      transparentHugePageDefrag: 'string'
      transparentHugePageEnabled: 'string'
    }
    localDNSProfile: {
      kubeDNSOverrides: {
        cacheDurationInSeconds: int
        forwardDestination: 'string'
        forwardPolicy: 'string'
        maxConcurrent: int
        protocol: 'string'
        queryLogging: 'string'
        serveStale: 'string'
        serveStaleDurationInSeconds: int
      }
      mode: 'string'
      vnetDNSOverrides: {
        cacheDurationInSeconds: int
        forwardDestination: 'string'
        forwardPolicy: 'string'
        maxConcurrent: int
        protocol: 'string'
        queryLogging: 'string'
        serveStale: 'string'
        serveStaleDurationInSeconds: int
      }
    }
    maxCount: int
    maxPods: int
    messageOfTheDay: 'string'
    minCount: int
    mode: 'string'
    networkProfile: {
      allowedHostPorts: [
        {
          portEnd: int
          portStart: int
          protocol: 'string'
        }
      ]
      applicationSecurityGroups: [
        'string'
      ]
      nodePublicIPTags: [
        {
          ipTagType: 'string'
          tag: 'string'
        }
      ]
    }
    nodeInitializationTaints: [
      'string'
    ]
    nodeLabels: {
      {customized property}: 'string'
    }
    nodePublicIPPrefixID: 'string'
    nodeTaints: [
      'string'
    ]
    orchestratorVersion: 'string'
    osDiskSizeGB: int
    osDiskType: 'string'
    osSKU: 'string'
    osType: 'string'
    podIPAllocationMode: 'string'
    podSubnetID: 'string'
    powerState: {
      code: 'string'
    }
    proximityPlacementGroupID: 'string'
    scaleDownMode: 'string'
    scaleSetEvictionPolicy: 'string'
    scaleSetPriority: 'string'
    securityProfile: {
      enableSecureBoot: bool
      enableVTPM: bool
      sshAccess: 'string'
    }
    spotMaxPrice: int
    status: {}
    tags: {
      {customized property}: 'string'
    }
    type: 'string'
    upgradeSettings: {
      drainTimeoutInMinutes: int
      maxBlockedNodes: 'string'
      maxSurge: 'string'
      maxUnavailable: 'string'
      nodeSoakDurationInMinutes: int
      undrainableNodeBehavior: 'string'
    }
    virtualMachineNodesStatus: [
      {
        count: int
        size: 'string'
      }
    ]
    virtualMachinesProfile: {
      scale: {
        autoscale: any(...)
        manual: [
          {
            count: int
            size: 'string'
          }
        ]
      }
    }
    vmSize: 'string'
    vnetSubnetID: 'string'
    windowsProfile: {
      disableOutboundNat: bool
    }
    workloadRuntime: 'string'
  }
}

Valori delle proprietà

Microsoft.ContainerService/managedClusters/agentPools

Nome	Descrizione	Valore
nome	Nome della risorsa	corda Vincoli: Lunghezza minima = 1 Lunghezza massima = 12 Pattern = `^[a-z][a-z0-9]{0,11}$` (obbligatorio)
genitore	In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre. Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.	Nome simbolico per la risorsa di tipo: managedClusters
proprietà	Proprietà di un pool di agenti.	Proprietà gestite da ClusterAgentPoolProfileProperties

AgentPoolArtifactStreamingProfile

Nome	Descrizione	Valore
Abilitato	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.	Bool

AgentPoolGatewayProfile

Nome	Descrizione	Valore
publicIPPrefixSize	Il pool di agenti del gateway associa un prefisso IP pubblico per ogni gateway in uscita statico per fornire dati in uscita pubblici. Le dimensioni di Public IPPrefix devono essere selezionate dall'utente. A ogni nodo del pool di agenti viene assegnato un indirizzo IP dal prefisso IP. Le dimensioni di IPPrefix fungono quindi da limite per le dimensioni del pool di agenti del gateway. A causa della limitazione delle dimensioni di IPPrefix pubblico di Azure, l'intervallo di valori validi è [28, 31] (/31 = 2 nodi/IP, /30 = 4 nodi/INDIRIZZI IP, /29 = 8 nodi/IP, /28 = 16 nodi/INDIRIZZI IP). Il valore predefinito è 31.	Int Vincoli: Valore minimo = 28 Valore massimo = 31

AgentPoolNetworkProfile

Nome	Descrizione	Valore
allowedHostPorts	Intervalli di porte a cui è consentito l'accesso. Gli intervalli specificati possono sovrapporsi.	PortRange []
gruppi di sicurezza delle applicazioni	ID dei gruppi di sicurezza delle applicazioni che verranno associati al pool di agenti al momento della creazione.	stringa[]
nodePublicIPTags	IPTag degli INDIRIZZI IP pubblici a livello di istanza.	IPTag[]

AgentPoolSecurityProfile

Nome	Descrizione	Valore
enableSecureBoot	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.	Bool
abilita VTPM	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.	Bool
sshAccess	Metodo di accesso SSH di un pool di agenti.	'Disabilitato' 'Utente locale'

Stato del pool di agenti

Nome	Descrizione	Valore

AgentPoolUpgradeSettings

Nome	Descrizione	Valore
drainTimeoutInMinutes	Quantità di tempo (in minuti) di attesa per la rimozione dei pod e la terminazione normale per ogni nodo. Questo tempo di attesa di rimozione rispetta l'attesa dei budget di interruzione dei pod. Se questa volta viene superata, l'aggiornamento non riesce. Se non specificato, il valore predefinito è 30 minuti.	Int Vincoli: Valore minimo = 1 Valore massimo = 1440
maxBlockedNodes	Può essere impostato su un numero intero ,ad esempio '5', o su una percentuale (ad esempio , '50%'). Se viene specificata una percentuale, corrisponde alla percentuale delle dimensioni totali del pool di agenti al momento dell'aggiornamento. Per le percentuali, i nodi frazionari vengono arrotondati. Se non specificato, il valore predefinito è maxSurge. Deve essere sempre maggiore o uguale a maxSurge. Per altre informazioni, incluse le procedure consigliate, vedere: /azure/aks/upgrade-cluster	corda
MaxSurge	Può essere impostato su un numero intero ,ad esempio '5', o su una percentuale (ad esempio , '50%'). Se viene specificata una percentuale, corrisponde alla percentuale delle dimensioni totali del pool di agenti al momento dell'aggiornamento. Per le percentuali, i nodi frazionari vengono arrotondati. Se non specificato, il valore predefinito è 10%. Per altre informazioni, incluse le procedure consigliate, vedere: /azure/aks/upgrade-cluster	corda
maxNon disponibile	Può essere impostato su un numero intero ,ad esempio "1" o su una percentuale (ad esempio , '5%'). Se viene specificata una percentuale, corrisponde alla percentuale delle dimensioni totali del pool di agenti al momento dell'aggiornamento. Per le percentuali, i nodi frazionari vengono arrotondati. Se non specificato, il valore predefinito è 0. Per altre informazioni, incluse le procedure consigliate, vedere: /azure/aks/upgrade-cluster	corda
nodeSoakDurationInMinutes	Quantità di tempo (in minuti) di attesa dopo lo svuotamento di un nodo e prima di riimagarla e passare al nodo successivo. Se non specificato, il valore predefinito è 0 minuti.	Int Vincoli: Valore minimo = 0 Valore massimo = 30
undrainableNodeBehavior	Definisce il comportamento per i nodi non restrittivi durante l'aggiornamento. La causa più comune dei nodi non consentiti è i budget di interruzione dei pod (PDB), ma altri problemi, ad esempio il periodo di tolleranza di terminazione dei pod, superano il timeout di svuotamento rimanente per nodo o il pod è ancora in stato di esecuzione, può anche causare nodi non restrittivi.	'Cordone' 'Programma'

AgentePoolWindowsProfilo

Nome	Descrizione	Valore
disabilitaAccesso in uscitaNat	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.	Bool

CreationData

Nome	Descrizione	Valore
sourceResourceId	Si tratta dell'ID ARM dell'oggetto di origine da usare per creare l'oggetto di destinazione.	corda

GPUProfile

Nome	Descrizione	Valore
autista	Indica se installare i driver GPU. Quando non è specificato, il valore predefinito è Install.	'Installa' 'Nessuno'
Tipo di conducente	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.	'CUDA' 'GRIGLIA'

IPTag

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

KubeletConfig

Nome	Descrizione	Valore
allowedUnsafeSysctls	Elenco consentito di sysctls non sicuri o criteri sysctl non sicuri (che terminano in `*`).	stringa[]
containerLogMaxFiles	Numero massimo di file di log del contenitore che possono essere presenti per un contenitore. Il numero deve essere ≥ 2.	Int Vincoli: Valore minimo = 2
contenitoreLogMaxSizeMB	Dimensioni massime (ad esempio 10Mi) del file di log del contenitore prima della rotazione.	Int
cpuCfsQuota	Il valore predefinito è vero.	Bool
cpuCfsQuotaPeriod	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'.	corda
cpuManagerPolicy	Il valore predefinito è 'none'. Per altre informazioni, vedere Criteri di gestione della CPU Kubernetes . I valori consentiti sono 'none' e 'static'.	corda
failSwapOn	Se impostato su true, l'avvio di Kubelet avrà esito negativo se lo scambio è abilitato nel nodo.	Bool
imageGcHighThreshold	Per disabilitare l'operazione di Garbage Collection delle immagini, impostare su 100. Il valore predefinito è 85%	Int
imageGcLowThreshold	Non è possibile impostare un valore superiore a imageGcHighThreshold. Il valore predefinito è 80%	Int
podMaxPids	Numero massimo di processi per pod.	Int
seccompPredefinito	Specifica il profilo seccomp predefinito applicato a tutti i carichi di lavoro. Se non specificato, per impostazione predefinita verrà usato 'Unconfined'.	'RuntimeDefault' 'Senza confini'
topologyManagerPolicy	Per altre informazioni, vedere Gestione topologie Kubernetes. Il valore predefinito è 'none'. I valori consentiti sono "none", "best-effort", "restricted" e "single-numa-node".	corda

LinuxOSConfig

Nome	Descrizione	Valore
swapFileSizeMB	Dimensioni in MB di un file di scambio che verrà creato in ogni nodo.	Int
sysctls	Impostazioni sysctl per i nodi dell'agente Linux.	SysctlConfig
trasparenteHugePageDefrag	I valori validi sono 'always', 'defer', 'defer+madvise', 'madvise' e 'never'. Il valore predefinito è "madvise". Per altre informazioni, vedere Transparent Hugepages.	corda
transparentHugePageEnabled	I valori validi sono 'always', 'madvise' e 'never'. Il valore predefinito è 'always'. Per altre informazioni, vedere Transparent Hugepages.	corda

LocalDNSOverrides

Nome	Descrizione	Valore
cacheDurationInSeconds	Cache max TTL in secondi. Per ulteriori informazioni, vedere il plug-in cache .	Int
forwardDestination	Server di destinazione per le query DNS da inoltrare da localDNS.	'ClusterCoreDNS' 'VnetDNS'
forwardPolicy	Criterio di inoltro per la selezione del server DNS upstream. Per ulteriori informazioni, vedere il plug-in forward .	'Casuale' 'RoundRobin' 'Sequenziale'
maxConcurrent	Numero massimo di query simultanee. Per ulteriori informazioni, vedere il plug-in forward .	Int
protocollo	Applicare TCP o preferire il protocollo UDP per le connessioni da localDNS al server DNS upstream.	'ForceTCP' 'PreferisceUDP'
queryLogging	Livello di log per le query DNS in localDNS.	'Errore' 'Registro'
serveStale	Criteri per la pubblicazione di dati non aggiornati. Per ulteriori informazioni, vedere il plug-in cache .	'Disabilita' 'Immediato' 'Verificare'
serveStaleDurationInSeconds	Servi la durata obsoleta in secondi. Per ulteriori informazioni, vedere il plug-in cache .	Int

File LocalDNSProfile

Nome	Descrizione	Valore
kubeDNSOverrides	Le sostituzioni di KubeDNS si applicano al traffico DNS proveniente da pod con dnsPolicy:ClusterFirst (denominato traffico KubeDNS).	LocalDNSOverrides
modalità	Modalità di abilitazione per il DNS locale.	'Disabilitato' 'Preferito' 'Obbligatorio'
vnetDNSOverrides	Le sostituzioni di VnetDNS si applicano al traffico DNS proveniente da pod con dnsPolicy:default o kubelet (denominato traffico VnetDNS).	LocalDNSOverrides

Proprietà gestite da ClusterAgentPoolProfileProperties

Nome	Descrizione	Valore
artefattoStreamingProfile	Configurazione per l'uso dello streaming degli artefatti nel servizio Azure Kubernetes.	AgentPoolArtifactStreamingProfile
zone di disponibilità	Elenco delle zone di disponibilità da usare per i nodi. Questa opzione può essere specificata solo se la proprietà AgentPoolType è "VirtualMachineScaleSets".	stringa[]
capacityReservationGroupID	Il servizio Azure Kubernetes assocerà il pool di agenti specificato al gruppo di prenotazioni di capacità.	corda
contare	Numero di agenti (VM) per ospitare contenitori Docker. I valori consentiti devono essere compresi nell'intervallo compreso tra 0 e 1000 (inclusi) per i pool di utenti e nell'intervallo compreso tra 1 e 1000 (inclusi) per i pool di sistema. Il valore predefinito è 1.	Int
creationData	CreationData da usare per specificare l'ID snapshot di origine se il pool di nodi verrà creato/aggiornato usando uno snapshot.	CreationData
abilita AutoScaling	Se abilitare il ridimensionamento automatico	Bool
enableCustomCATrust	Se impostato su true, il servizio Azure Kubernetes aggiunge un'etichetta al nodo che indica che la funzionalità è abilitata e distribuisce un daemonset insieme ai servizi host per sincronizzare le autorità di certificazione personalizzate dall'elenco fornito dall'utente di certificati con codifica Base64 negli archivi attendibili dei nodi. Il valore predefinito è falso.	Bool
enableEncryptionAtHost	Questa opzione è supportata solo in determinate dimensioni di vm e in determinate aree di Azure. Per altre informazioni, vedere: /azure/aks/enable-host-encryption	Bool
abilita FIPS	Per altri dettagli, vedere Aggiungere un pool di nodi abilitato per FIPS .	Bool
enableNodePublicIP	Alcuni scenari possono richiedere che i nodi in un pool di nodi ricevano 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. Per altre informazioni, vedere Assegnazione di un indirizzo IP pubblico per nodo. Il valore predefinito è false.	Bool
abilitareUltraSSD	Se abilitare UltraSSD	Bool
gatewayProfile	Profilare specifici di un pool di agenti gestiti in modalità gateway. Questo campo non può essere impostato se la modalità pool di agenti non è Gateway.	AgentPoolGatewayProfile
gpuInstanceProfile	GPUInstanceProfile da usare per specificare il profilo di istanza MIG della GPU per lo SKU di VM GPU supportato.	'MIG1g' 'MIG2g' 'MIG3g' 'MIG4g' 'MIG7g'
gpuProfilo	Impostazioni GPU di un pool di agenti.	GPUProfile
hostGroupID	Questo è il formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Per altre informazioni, vedere Host dedicati di Azure.	corda
kubeletConfig	Configurazione di Kubelet nei nodi del pool di agenti.	KubeletConfig
kubeletDiskType	Determina la posizione dei volumi emptyDir, della radice dei dati di runtime del contenitore e dell'archiviazione temporanea di Kubelet.	'OS' 'Temporaneo'
linuxOSConfig	Configurazione del sistema operativo dei nodi dell'agente Linux.	LinuxOSConfig
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.	File LocalDNSProfile
Conteggio massimo	Numero massimo di nodi per il ridimensionamento automatico	Int
MaxPods	Numero massimo di pod che possono essere eseguiti in un nodo.	Int
messaggioDiL'Uomo	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).	corda
minCount	Numero minimo di nodi per il ridimensionamento automatico	Int
modalità	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: /azure/aks/use-system-pools	'Porta' 'Sistema' 'Utente'
Profilo di rete	Impostazioni correlate alla rete di un pool di agenti.	AgentPoolNetworkProfile
nodeInitializationTaints	Questi taints non verranno riconciliati dal servizio Azure Kubernetes e possono essere rimossi con una chiamata kubectl. Questo campo può essere modificato dopo la creazione del pool di nodi, ma i nodi non verranno ricreati con nuovi taints finché non viene eseguita un'altra operazione che richiede la ricreazione (ad esempio, l'aggiornamento dell'immagine del nodo). 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-`	stringa[]
nodeLabels	Etichette dei nodi da rendere persistenti in tutti i nodi nel pool di agenti.	ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID	Modulo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}	corda
nodeTaints	I contenitori aggiunti ai nuovi nodi durante la creazione e la scalabilità del pool di nodi. Ad esempio, key=value:NoSchedule.	stringa[]
orchestratorVersion	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. L'aggiornamento del pool di agenti con lo stesso <major.minor> dopo la creazione non attiverà un aggiornamento, anche se è disponibile una versione patch più recente. Come procedura consigliata, è consigliabile aggiornare tutti i pool di nodi in un cluster del servizio Azure Kubernetes alla stessa versione di Kubernetes. La versione del pool di nodi deve avere la stessa versione principale del piano di controllo. La versione secondaria del pool di nodi deve trovarsi all'interno di due versioni secondarie della versione del piano di controllo. La versione del pool di nodi non può essere maggiore della versione del piano di controllo. Per altre informazioni, vedere Aggiornamento di un pool di nodi.	corda
osDiskSizeGB	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.	Int Vincoli: Valore minimo = 0 Valore massimo = 2048
osDiskType	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 altre informazioni, vedere Sistema operativo temporaneo.	'Effimero' 'Gestito'
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.	'AzureLinux' 'CBLMariner' 'Marinaio' 'Ubuntu' 'Ubuntu2204' 'Ubuntu2404' 'Windows2019' 'Finestre 2022' 'WindowsAnnual'
osType	Tipo di sistema operativo. Il valore predefinito è Linux.	'Linux' 'Finestre'
podIPAllocationMode	Modalità di allocazione IP per i pod nel pool di agenti. Deve essere usato con podSubnetId. Il valore predefinito è "DynamicIndividual".	'Individuo dinamico' 'Blocco statico'
podSubnetID	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}	corda
powerState	Quando viene creato per la prima volta, un pool di agenti è in esecuzione inizialmente. Il pool di agenti può essere arrestato impostando questo campo su Arrestato. Un pool di agenti arrestato arresta tutte le macchine virtuali e non accumula addebiti per la fatturazione. Un pool di agenti può essere arrestato solo se è in esecuzione e lo stato di provisioning è Succeeded	Stato di alimentazione
proximityPlacementGroupID	ID del gruppo di posizionamento di prossimità.	corda
scaleDownMode	Questo influisce anche sul comportamento del ridimensionamento automatico del cluster. Se non specificato, il valore predefinito è Delete.	'Deallocare' 'Elimina'
policy di sfratto del set di scalabilità	Questa impostazione non può essere specificata a meno che scaleSetPriority non sia "Spot". Se non specificato, il valore predefinito è 'Delete'.	'Deallocare' 'Elimina'
prioritàImpostazioneScala	Priorità del set di scalabilità di macchine virtuali. Se non specificato, il valore predefinito è 'Regular'.	'Regolare' 'Macchia'
di sicurezzaProfilo	Impostazioni di sicurezza di un pool di agenti.	AgentPoolSecurityProfile
spotMaxPrezzo	I valori possibili sono qualsiasi valore decimale maggiore di zero o -1 che indica la disponibilità a pagare qualsiasi prezzo su richiesta. Per altre informazioni sui prezzi spot, vedere Prezzi delle macchine virtuali spot	Int
stato	Contiene informazioni di sola lettura sul pool di agenti.	Stato del pool di agenti
etichette	Tag da rendere persistenti nel set di scalabilità di macchine virtuali del pool di agenti.	ManagedClusterAgentPoolProfilePropertiesTags
tipo	Tipo di pool di agenti.	'Set di disponibilità' 'Macchine virtuali' 'VirtualMachineScaleSets'
aggiornamentoImpostazioni	Impostazioni per l'aggiornamento del pool di agenti	AgentPoolUpgradeSettings
virtualMachineNodesStatus	Stato dei nodi in un pool di agenti VirtualMachines.	VirtualMachineNodes[]
virtualMachinesProfile	Specifiche nel pool di agenti VirtualMachines.	VirtualMachinesProfile
vmSize	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: /azure/aks/quotas-skus-regions	corda
vnetSubnetID	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}	corda
windowsProfilo	Profilo specifico del pool di agenti di Windows.	AgentePoolWindowsProfilo
carico di lavoroRuntime	Determina il tipo di carico di lavoro che un nodo può eseguire.	'KataMshvVmIsolation' 'OCIContainer' 'WasmWasi'

ManagedClusterAgentPoolProfilePropertiesNodeLabels

Nome	Descrizione	Valore

ManagedClusterAgentPoolProfilePropertiesTags

Nome	Descrizione	Valore

ManualeScaleProfile

Nome	Descrizione	Valore
contare	Numero di nodi.	Int
dimensione / taglia	Dimensioni delle macchine virtuali che verranno usate dal servizio Azure Kubernetes durante la creazione e il ridimensionamento, ad esempio "Standard_E4s_v3", "Standard_E16s_v3" o "Standard_D16s_v5".	corda

PortRange

Nome	Descrizione	Valore
presagire	Porta massima inclusa nell'intervallo. Deve essere compreso tra 1 e 65535 e deve essere maggiore o uguale a portStart.	Int Vincoli: Valore minimo = 1 Valore massimo = 65535
portaInizia	Porta minima inclusa nell'intervallo. Deve essere compreso tra 1 e 65535 e deve essere minore o uguale a portEnd.	Int Vincoli: Valore minimo = 1 Valore massimo = 65535
protocollo	Protocollo di rete della porta.	'TCP' 'UDP'

Stato di alimentazione

Nome	Descrizione	Valore
codice	Indica se il cluster è in esecuzione o arrestato	'Correre' 'Arrestato'

ScaleProfile

Nome	Descrizione	Valore
scalabilità automatica	Specifiche su come ridimensionare automaticamente il pool di agenti VirtualMachines all'interno di un intervallo di dimensioni predefinito.	qualunque
Manuale	Specifiche su come ridimensionare il pool di agenti VirtualMachines a dimensioni fisse.	ManualScaleProfile[]

SysctlConfig

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

VirtualMachineNodes

Nome	Descrizione	Valore
contare	Numero di nodi.	Int
dimensione / taglia	Dimensioni della macchina virtuale degli agenti usati per ospitare questo gruppo di nodi.	corda

VirtualMachinesProfile

Nome	Descrizione	Valore
scala	Specifiche su come ridimensionare un pool di agenti VirtualMachines.	ScaleProfile

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa managedClusters/agentPools può essere distribuito con operazioni destinate a:

gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.ContainerService/managedClusters/agentPools, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "apiVersion": "2025-03-02-preview",
  "name": "string",
  "properties": {
    "artifactStreamingProfile": {
      "enabled": "bool"
    },
    "availabilityZones": [ "string" ],
    "capacityReservationGroupID": "string",
    "count": "int",
    "creationData": {
      "sourceResourceId": "string"
    },
    "enableAutoScaling": "bool",
    "enableCustomCATrust": "bool",
    "enableEncryptionAtHost": "bool",
    "enableFIPS": "bool",
    "enableNodePublicIP": "bool",
    "enableUltraSSD": "bool",
    "gatewayProfile": {
      "publicIPPrefixSize": "int"
    },
    "gpuInstanceProfile": "string",
    "gpuProfile": {
      "driver": "string",
      "driverType": "string"
    },
    "hostGroupID": "string",
    "kubeletConfig": {
      "allowedUnsafeSysctls": [ "string" ],
      "containerLogMaxFiles": "int",
      "containerLogMaxSizeMB": "int",
      "cpuCfsQuota": "bool",
      "cpuCfsQuotaPeriod": "string",
      "cpuManagerPolicy": "string",
      "failSwapOn": "bool",
      "imageGcHighThreshold": "int",
      "imageGcLowThreshold": "int",
      "podMaxPids": "int",
      "seccompDefault": "string",
      "topologyManagerPolicy": "string"
    },
    "kubeletDiskType": "string",
    "linuxOSConfig": {
      "swapFileSizeMB": "int",
      "sysctls": {
        "fsAioMaxNr": "int",
        "fsFileMax": "int",
        "fsInotifyMaxUserWatches": "int",
        "fsNrOpen": "int",
        "kernelThreadsMax": "int",
        "netCoreNetdevMaxBacklog": "int",
        "netCoreOptmemMax": "int",
        "netCoreRmemDefault": "int",
        "netCoreRmemMax": "int",
        "netCoreSomaxconn": "int",
        "netCoreWmemDefault": "int",
        "netCoreWmemMax": "int",
        "netIpv4IpLocalPortRange": "string",
        "netIpv4NeighDefaultGcThresh1": "int",
        "netIpv4NeighDefaultGcThresh2": "int",
        "netIpv4NeighDefaultGcThresh3": "int",
        "netIpv4TcpFinTimeout": "int",
        "netIpv4TcpkeepaliveIntvl": "int",
        "netIpv4TcpKeepaliveProbes": "int",
        "netIpv4TcpKeepaliveTime": "int",
        "netIpv4TcpMaxSynBacklog": "int",
        "netIpv4TcpMaxTwBuckets": "int",
        "netIpv4TcpTwReuse": "bool",
        "netNetfilterNfConntrackBuckets": "int",
        "netNetfilterNfConntrackMax": "int",
        "vmMaxMapCount": "int",
        "vmSwappiness": "int",
        "vmVfsCachePressure": "int"
      },
      "transparentHugePageDefrag": "string",
      "transparentHugePageEnabled": "string"
    },
    "localDNSProfile": {
      "kubeDNSOverrides": {
        "cacheDurationInSeconds": "int",
        "forwardDestination": "string",
        "forwardPolicy": "string",
        "maxConcurrent": "int",
        "protocol": "string",
        "queryLogging": "string",
        "serveStale": "string",
        "serveStaleDurationInSeconds": "int"
      },
      "mode": "string",
      "vnetDNSOverrides": {
        "cacheDurationInSeconds": "int",
        "forwardDestination": "string",
        "forwardPolicy": "string",
        "maxConcurrent": "int",
        "protocol": "string",
        "queryLogging": "string",
        "serveStale": "string",
        "serveStaleDurationInSeconds": "int"
      }
    },
    "maxCount": "int",
    "maxPods": "int",
    "messageOfTheDay": "string",
    "minCount": "int",
    "mode": "string",
    "networkProfile": {
      "allowedHostPorts": [
        {
          "portEnd": "int",
          "portStart": "int",
          "protocol": "string"
        }
      ],
      "applicationSecurityGroups": [ "string" ],
      "nodePublicIPTags": [
        {
          "ipTagType": "string",
          "tag": "string"
        }
      ]
    },
    "nodeInitializationTaints": [ "string" ],
    "nodeLabels": {
      "{customized property}": "string"
    },
    "nodePublicIPPrefixID": "string",
    "nodeTaints": [ "string" ],
    "orchestratorVersion": "string",
    "osDiskSizeGB": "int",
    "osDiskType": "string",
    "osSKU": "string",
    "osType": "string",
    "podIPAllocationMode": "string",
    "podSubnetID": "string",
    "powerState": {
      "code": "string"
    },
    "proximityPlacementGroupID": "string",
    "scaleDownMode": "string",
    "scaleSetEvictionPolicy": "string",
    "scaleSetPriority": "string",
    "securityProfile": {
      "enableSecureBoot": "bool",
      "enableVTPM": "bool",
      "sshAccess": "string"
    },
    "spotMaxPrice": "int",
    "status": {
    },
    "tags": {
      "{customized property}": "string"
    },
    "type": "string",
    "upgradeSettings": {
      "drainTimeoutInMinutes": "int",
      "maxBlockedNodes": "string",
      "maxSurge": "string",
      "maxUnavailable": "string",
      "nodeSoakDurationInMinutes": "int",
      "undrainableNodeBehavior": "string"
    },
    "virtualMachineNodesStatus": [
      {
        "count": "int",
        "size": "string"
      }
    ],
    "virtualMachinesProfile": {
      "scale": {
        "autoscale": {},
        "manual": [
          {
            "count": "int",
            "size": "string"
          }
        ]
      }
    },
    "vmSize": "string",
    "vnetSubnetID": "string",
    "windowsProfile": {
      "disableOutboundNat": "bool"
    },
    "workloadRuntime": "string"
  }
}

Valori delle proprietà

Microsoft.ContainerService/managedClusters/agentPools

Nome	Descrizione	Valore
versione dell'API	Versione dell'API	'Anteprima 2025-03-02'
nome	Nome della risorsa	corda Vincoli: Lunghezza minima = 1 Lunghezza massima = 12 Pattern = `^[a-z][a-z0-9]{0,11}$` (obbligatorio)
proprietà	Proprietà di un pool di agenti.	Proprietà gestite da ClusterAgentPoolProfileProperties
tipo	Tipo di risorsa	'Microsoft.ContainerService/managedClusters/agentPools'

AgentPoolArtifactStreamingProfile

Nome	Descrizione	Valore
Abilitato	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.	Bool

AgentPoolGatewayProfile

Nome	Descrizione	Valore
publicIPPrefixSize	Il pool di agenti del gateway associa un prefisso IP pubblico per ogni gateway in uscita statico per fornire dati in uscita pubblici. Le dimensioni di Public IPPrefix devono essere selezionate dall'utente. A ogni nodo del pool di agenti viene assegnato un indirizzo IP dal prefisso IP. Le dimensioni di IPPrefix fungono quindi da limite per le dimensioni del pool di agenti del gateway. A causa della limitazione delle dimensioni di IPPrefix pubblico di Azure, l'intervallo di valori validi è [28, 31] (/31 = 2 nodi/IP, /30 = 4 nodi/INDIRIZZI IP, /29 = 8 nodi/IP, /28 = 16 nodi/INDIRIZZI IP). Il valore predefinito è 31.	Int Vincoli: Valore minimo = 28 Valore massimo = 31

AgentPoolNetworkProfile

Nome	Descrizione	Valore
allowedHostPorts	Intervalli di porte a cui è consentito l'accesso. Gli intervalli specificati possono sovrapporsi.	PortRange []
gruppi di sicurezza delle applicazioni	ID dei gruppi di sicurezza delle applicazioni che verranno associati al pool di agenti al momento della creazione.	stringa[]
nodePublicIPTags	IPTag degli INDIRIZZI IP pubblici a livello di istanza.	IPTag[]

AgentPoolSecurityProfile

Nome	Descrizione	Valore
enableSecureBoot	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.	Bool
abilita VTPM	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.	Bool
sshAccess	Metodo di accesso SSH di un pool di agenti.	'Disabilitato' 'Utente locale'

Stato del pool di agenti

Nome	Descrizione	Valore

AgentPoolUpgradeSettings

Nome	Descrizione	Valore
drainTimeoutInMinutes	Quantità di tempo (in minuti) di attesa per la rimozione dei pod e la terminazione normale per ogni nodo. Questo tempo di attesa di rimozione rispetta l'attesa dei budget di interruzione dei pod. Se questa volta viene superata, l'aggiornamento non riesce. Se non specificato, il valore predefinito è 30 minuti.	Int Vincoli: Valore minimo = 1 Valore massimo = 1440
maxBlockedNodes	Può essere impostato su un numero intero ,ad esempio '5', o su una percentuale (ad esempio , '50%'). Se viene specificata una percentuale, corrisponde alla percentuale delle dimensioni totali del pool di agenti al momento dell'aggiornamento. Per le percentuali, i nodi frazionari vengono arrotondati. Se non specificato, il valore predefinito è maxSurge. Deve essere sempre maggiore o uguale a maxSurge. Per altre informazioni, incluse le procedure consigliate, vedere: /azure/aks/upgrade-cluster	corda
MaxSurge	Può essere impostato su un numero intero ,ad esempio '5', o su una percentuale (ad esempio , '50%'). Se viene specificata una percentuale, corrisponde alla percentuale delle dimensioni totali del pool di agenti al momento dell'aggiornamento. Per le percentuali, i nodi frazionari vengono arrotondati. Se non specificato, il valore predefinito è 10%. Per altre informazioni, incluse le procedure consigliate, vedere: /azure/aks/upgrade-cluster	corda
maxNon disponibile	Può essere impostato su un numero intero ,ad esempio "1" o su una percentuale (ad esempio , '5%'). Se viene specificata una percentuale, corrisponde alla percentuale delle dimensioni totali del pool di agenti al momento dell'aggiornamento. Per le percentuali, i nodi frazionari vengono arrotondati. Se non specificato, il valore predefinito è 0. Per altre informazioni, incluse le procedure consigliate, vedere: /azure/aks/upgrade-cluster	corda
nodeSoakDurationInMinutes	Quantità di tempo (in minuti) di attesa dopo lo svuotamento di un nodo e prima di riimagarla e passare al nodo successivo. Se non specificato, il valore predefinito è 0 minuti.	Int Vincoli: Valore minimo = 0 Valore massimo = 30
undrainableNodeBehavior	Definisce il comportamento per i nodi non restrittivi durante l'aggiornamento. La causa più comune dei nodi non consentiti è i budget di interruzione dei pod (PDB), ma altri problemi, ad esempio il periodo di tolleranza di terminazione dei pod, superano il timeout di svuotamento rimanente per nodo o il pod è ancora in stato di esecuzione, può anche causare nodi non restrittivi.	'Cordone' 'Programma'

AgentePoolWindowsProfilo

Nome	Descrizione	Valore
disabilitaAccesso in uscitaNat	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.	Bool

CreationData

Nome	Descrizione	Valore
sourceResourceId	Si tratta dell'ID ARM dell'oggetto di origine da usare per creare l'oggetto di destinazione.	corda

GPUProfile

Nome	Descrizione	Valore
autista	Indica se installare i driver GPU. Quando non è specificato, il valore predefinito è Install.	'Installa' 'Nessuno'
Tipo di conducente	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.	'CUDA' 'GRIGLIA'

IPTag

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

KubeletConfig

Nome	Descrizione	Valore
allowedUnsafeSysctls	Elenco consentito di sysctls non sicuri o criteri sysctl non sicuri (che terminano in `*`).	stringa[]
containerLogMaxFiles	Numero massimo di file di log del contenitore che possono essere presenti per un contenitore. Il numero deve essere ≥ 2.	Int Vincoli: Valore minimo = 2
contenitoreLogMaxSizeMB	Dimensioni massime (ad esempio 10Mi) del file di log del contenitore prima della rotazione.	Int
cpuCfsQuota	Il valore predefinito è vero.	Bool
cpuCfsQuotaPeriod	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'.	corda
cpuManagerPolicy	Il valore predefinito è 'none'. Per altre informazioni, vedere Criteri di gestione della CPU Kubernetes . I valori consentiti sono 'none' e 'static'.	corda
failSwapOn	Se impostato su true, l'avvio di Kubelet avrà esito negativo se lo scambio è abilitato nel nodo.	Bool
imageGcHighThreshold	Per disabilitare l'operazione di Garbage Collection delle immagini, impostare su 100. Il valore predefinito è 85%	Int
imageGcLowThreshold	Non è possibile impostare un valore superiore a imageGcHighThreshold. Il valore predefinito è 80%	Int
podMaxPids	Numero massimo di processi per pod.	Int
seccompPredefinito	Specifica il profilo seccomp predefinito applicato a tutti i carichi di lavoro. Se non specificato, per impostazione predefinita verrà usato 'Unconfined'.	'RuntimeDefault' 'Senza confini'
topologyManagerPolicy	Per altre informazioni, vedere Gestione topologie Kubernetes. Il valore predefinito è 'none'. I valori consentiti sono "none", "best-effort", "restricted" e "single-numa-node".	corda

LinuxOSConfig

Nome	Descrizione	Valore
swapFileSizeMB	Dimensioni in MB di un file di scambio che verrà creato in ogni nodo.	Int
sysctls	Impostazioni sysctl per i nodi dell'agente Linux.	SysctlConfig
trasparenteHugePageDefrag	I valori validi sono 'always', 'defer', 'defer+madvise', 'madvise' e 'never'. Il valore predefinito è "madvise". Per altre informazioni, vedere Transparent Hugepages.	corda
transparentHugePageEnabled	I valori validi sono 'always', 'madvise' e 'never'. Il valore predefinito è 'always'. Per altre informazioni, vedere Transparent Hugepages.	corda

LocalDNSOverrides

Nome	Descrizione	Valore
cacheDurationInSeconds	Cache max TTL in secondi. Per ulteriori informazioni, vedere il plug-in cache .	Int
forwardDestination	Server di destinazione per le query DNS da inoltrare da localDNS.	'ClusterCoreDNS' 'VnetDNS'
forwardPolicy	Criterio di inoltro per la selezione del server DNS upstream. Per ulteriori informazioni, vedere il plug-in forward .	'Casuale' 'RoundRobin' 'Sequenziale'
maxConcurrent	Numero massimo di query simultanee. Per ulteriori informazioni, vedere il plug-in forward .	Int
protocollo	Applicare TCP o preferire il protocollo UDP per le connessioni da localDNS al server DNS upstream.	'ForceTCP' 'PreferisceUDP'
queryLogging	Livello di log per le query DNS in localDNS.	'Errore' 'Registro'
serveStale	Criteri per la pubblicazione di dati non aggiornati. Per ulteriori informazioni, vedere il plug-in cache .	'Disabilita' 'Immediato' 'Verificare'
serveStaleDurationInSeconds	Servi la durata obsoleta in secondi. Per ulteriori informazioni, vedere il plug-in cache .	Int

File LocalDNSProfile

Nome	Descrizione	Valore
kubeDNSOverrides	Le sostituzioni di KubeDNS si applicano al traffico DNS proveniente da pod con dnsPolicy:ClusterFirst (denominato traffico KubeDNS).	LocalDNSOverrides
modalità	Modalità di abilitazione per il DNS locale.	'Disabilitato' 'Preferito' 'Obbligatorio'
vnetDNSOverrides	Le sostituzioni di VnetDNS si applicano al traffico DNS proveniente da pod con dnsPolicy:default o kubelet (denominato traffico VnetDNS).	LocalDNSOverrides

Proprietà gestite da ClusterAgentPoolProfileProperties

Nome	Descrizione	Valore
artefattoStreamingProfile	Configurazione per l'uso dello streaming degli artefatti nel servizio Azure Kubernetes.	AgentPoolArtifactStreamingProfile
zone di disponibilità	Elenco delle zone di disponibilità da usare per i nodi. Questa opzione può essere specificata solo se la proprietà AgentPoolType è "VirtualMachineScaleSets".	stringa[]
capacityReservationGroupID	Il servizio Azure Kubernetes assocerà il pool di agenti specificato al gruppo di prenotazioni di capacità.	corda
contare	Numero di agenti (VM) per ospitare contenitori Docker. I valori consentiti devono essere compresi nell'intervallo compreso tra 0 e 1000 (inclusi) per i pool di utenti e nell'intervallo compreso tra 1 e 1000 (inclusi) per i pool di sistema. Il valore predefinito è 1.	Int
creationData	CreationData da usare per specificare l'ID snapshot di origine se il pool di nodi verrà creato/aggiornato usando uno snapshot.	CreationData
abilita AutoScaling	Se abilitare il ridimensionamento automatico	Bool
enableCustomCATrust	Se impostato su true, il servizio Azure Kubernetes aggiunge un'etichetta al nodo che indica che la funzionalità è abilitata e distribuisce un daemonset insieme ai servizi host per sincronizzare le autorità di certificazione personalizzate dall'elenco fornito dall'utente di certificati con codifica Base64 negli archivi attendibili dei nodi. Il valore predefinito è falso.	Bool
enableEncryptionAtHost	Questa opzione è supportata solo in determinate dimensioni di vm e in determinate aree di Azure. Per altre informazioni, vedere: /azure/aks/enable-host-encryption	Bool
abilita FIPS	Per altri dettagli, vedere Aggiungere un pool di nodi abilitato per FIPS .	Bool
enableNodePublicIP	Alcuni scenari possono richiedere che i nodi in un pool di nodi ricevano 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. Per altre informazioni, vedere Assegnazione di un indirizzo IP pubblico per nodo. Il valore predefinito è false.	Bool
abilitareUltraSSD	Se abilitare UltraSSD	Bool
gatewayProfile	Profilare specifici di un pool di agenti gestiti in modalità gateway. Questo campo non può essere impostato se la modalità pool di agenti non è Gateway.	AgentPoolGatewayProfile
gpuInstanceProfile	GPUInstanceProfile da usare per specificare il profilo di istanza MIG della GPU per lo SKU di VM GPU supportato.	'MIG1g' 'MIG2g' 'MIG3g' 'MIG4g' 'MIG7g'
gpuProfilo	Impostazioni GPU di un pool di agenti.	GPUProfile
hostGroupID	Questo è il formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Per altre informazioni, vedere Host dedicati di Azure.	corda
kubeletConfig	Configurazione di Kubelet nei nodi del pool di agenti.	KubeletConfig
kubeletDiskType	Determina la posizione dei volumi emptyDir, della radice dei dati di runtime del contenitore e dell'archiviazione temporanea di Kubelet.	'OS' 'Temporaneo'
linuxOSConfig	Configurazione del sistema operativo dei nodi dell'agente Linux.	LinuxOSConfig
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.	File LocalDNSProfile
Conteggio massimo	Numero massimo di nodi per il ridimensionamento automatico	Int
MaxPods	Numero massimo di pod che possono essere eseguiti in un nodo.	Int
messaggioDiL'Uomo	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).	corda
minCount	Numero minimo di nodi per il ridimensionamento automatico	Int
modalità	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: /azure/aks/use-system-pools	'Porta' 'Sistema' 'Utente'
Profilo di rete	Impostazioni correlate alla rete di un pool di agenti.	AgentPoolNetworkProfile
nodeInitializationTaints	Questi taints non verranno riconciliati dal servizio Azure Kubernetes e possono essere rimossi con una chiamata kubectl. Questo campo può essere modificato dopo la creazione del pool di nodi, ma i nodi non verranno ricreati con nuovi taints finché non viene eseguita un'altra operazione che richiede la ricreazione (ad esempio, l'aggiornamento dell'immagine del nodo). 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-`	stringa[]
nodeLabels	Etichette dei nodi da rendere persistenti in tutti i nodi nel pool di agenti.	ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID	Modulo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}	corda
nodeTaints	I contenitori aggiunti ai nuovi nodi durante la creazione e la scalabilità del pool di nodi. Ad esempio, key=value:NoSchedule.	stringa[]
orchestratorVersion	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. L'aggiornamento del pool di agenti con lo stesso <major.minor> dopo la creazione non attiverà un aggiornamento, anche se è disponibile una versione patch più recente. Come procedura consigliata, è consigliabile aggiornare tutti i pool di nodi in un cluster del servizio Azure Kubernetes alla stessa versione di Kubernetes. La versione del pool di nodi deve avere la stessa versione principale del piano di controllo. La versione secondaria del pool di nodi deve trovarsi all'interno di due versioni secondarie della versione del piano di controllo. La versione del pool di nodi non può essere maggiore della versione del piano di controllo. Per altre informazioni, vedere Aggiornamento di un pool di nodi.	corda
osDiskSizeGB	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.	Int Vincoli: Valore minimo = 0 Valore massimo = 2048
osDiskType	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 altre informazioni, vedere Sistema operativo temporaneo.	'Effimero' 'Gestito'
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.	'AzureLinux' 'CBLMariner' 'Marinaio' 'Ubuntu' 'Ubuntu2204' 'Ubuntu2404' 'Windows2019' 'Finestre 2022' 'WindowsAnnual'
osType	Tipo di sistema operativo. Il valore predefinito è Linux.	'Linux' 'Finestre'
podIPAllocationMode	Modalità di allocazione IP per i pod nel pool di agenti. Deve essere usato con podSubnetId. Il valore predefinito è "DynamicIndividual".	'Individuo dinamico' 'Blocco statico'
podSubnetID	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}	corda
powerState	Quando viene creato per la prima volta, un pool di agenti è in esecuzione inizialmente. Il pool di agenti può essere arrestato impostando questo campo su Arrestato. Un pool di agenti arrestato arresta tutte le macchine virtuali e non accumula addebiti per la fatturazione. Un pool di agenti può essere arrestato solo se è in esecuzione e lo stato di provisioning è Succeeded	Stato di alimentazione
proximityPlacementGroupID	ID del gruppo di posizionamento di prossimità.	corda
scaleDownMode	Questo influisce anche sul comportamento del ridimensionamento automatico del cluster. Se non specificato, il valore predefinito è Delete.	'Deallocare' 'Elimina'
policy di sfratto del set di scalabilità	Questa impostazione non può essere specificata a meno che scaleSetPriority non sia "Spot". Se non specificato, il valore predefinito è 'Delete'.	'Deallocare' 'Elimina'
prioritàImpostazioneScala	Priorità del set di scalabilità di macchine virtuali. Se non specificato, il valore predefinito è 'Regular'.	'Regolare' 'Macchia'
di sicurezzaProfilo	Impostazioni di sicurezza di un pool di agenti.	AgentPoolSecurityProfile
spotMaxPrezzo	I valori possibili sono qualsiasi valore decimale maggiore di zero o -1 che indica la disponibilità a pagare qualsiasi prezzo su richiesta. Per altre informazioni sui prezzi spot, vedere Prezzi delle macchine virtuali spot	Int
stato	Contiene informazioni di sola lettura sul pool di agenti.	Stato del pool di agenti
etichette	Tag da rendere persistenti nel set di scalabilità di macchine virtuali del pool di agenti.	ManagedClusterAgentPoolProfilePropertiesTags
tipo	Tipo di pool di agenti.	'Set di disponibilità' 'Macchine virtuali' 'VirtualMachineScaleSets'
aggiornamentoImpostazioni	Impostazioni per l'aggiornamento del pool di agenti	AgentPoolUpgradeSettings
virtualMachineNodesStatus	Stato dei nodi in un pool di agenti VirtualMachines.	VirtualMachineNodes[]
virtualMachinesProfile	Specifiche nel pool di agenti VirtualMachines.	VirtualMachinesProfile
vmSize	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: /azure/aks/quotas-skus-regions	corda
vnetSubnetID	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}	corda
windowsProfilo	Profilo specifico del pool di agenti di Windows.	AgentePoolWindowsProfilo
carico di lavoroRuntime	Determina il tipo di carico di lavoro che un nodo può eseguire.	'KataMshvVmIsolation' 'OCIContainer' 'WasmWasi'

ManagedClusterAgentPoolProfilePropertiesNodeLabels

Nome	Descrizione	Valore

ManagedClusterAgentPoolProfilePropertiesTags

Nome	Descrizione	Valore

ManualeScaleProfile

Nome	Descrizione	Valore
contare	Numero di nodi.	Int
dimensione / taglia	Dimensioni delle macchine virtuali che verranno usate dal servizio Azure Kubernetes durante la creazione e il ridimensionamento, ad esempio "Standard_E4s_v3", "Standard_E16s_v3" o "Standard_D16s_v5".	corda

PortRange

Nome	Descrizione	Valore
presagire	Porta massima inclusa nell'intervallo. Deve essere compreso tra 1 e 65535 e deve essere maggiore o uguale a portStart.	Int Vincoli: Valore minimo = 1 Valore massimo = 65535
portaInizia	Porta minima inclusa nell'intervallo. Deve essere compreso tra 1 e 65535 e deve essere minore o uguale a portEnd.	Int Vincoli: Valore minimo = 1 Valore massimo = 65535
protocollo	Protocollo di rete della porta.	'TCP' 'UDP'

Stato di alimentazione

Nome	Descrizione	Valore
codice	Indica se il cluster è in esecuzione o arrestato	'Correre' 'Arrestato'

ScaleProfile

Nome	Descrizione	Valore
scalabilità automatica	Specifiche su come ridimensionare automaticamente il pool di agenti VirtualMachines all'interno di un intervallo di dimensioni predefinito.	qualunque
Manuale	Specifiche su come ridimensionare il pool di agenti VirtualMachines a dimensioni fisse.	ManualScaleProfile[]

SysctlConfig

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

VirtualMachineNodes

Nome	Descrizione	Valore
contare	Numero di nodi.	Int
dimensione / taglia	Dimensioni della macchina virtuale degli agenti usati per ospitare questo gruppo di nodi.	corda

VirtualMachinesProfile

Nome	Descrizione	Valore
scala	Specifiche su come ridimensionare un pool di agenti VirtualMachines.	ScaleProfile

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Modello	Descrizione
Distribuire un cluster del servizio Azure Kubernetes per Azure ML	Questo modello consente di distribuire un cluster del servizio Azure Kubernetes conforme all'entreprise che può essere collegato ad Azure ML

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa managedClusters/agentPools può essere distribuito con operazioni destinate a:

gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.ContainerService/managedClusters/agentPools, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/managedClusters/agentPools@2025-03-02-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      artifactStreamingProfile = {
        enabled = bool
      }
      availabilityZones = [
        "string"
      ]
      capacityReservationGroupID = "string"
      count = int
      creationData = {
        sourceResourceId = "string"
      }
      enableAutoScaling = bool
      enableCustomCATrust = bool
      enableEncryptionAtHost = bool
      enableFIPS = bool
      enableNodePublicIP = bool
      enableUltraSSD = bool
      gatewayProfile = {
        publicIPPrefixSize = int
      }
      gpuInstanceProfile = "string"
      gpuProfile = {
        driver = "string"
        driverType = "string"
      }
      hostGroupID = "string"
      kubeletConfig = {
        allowedUnsafeSysctls = [
          "string"
        ]
        containerLogMaxFiles = int
        containerLogMaxSizeMB = int
        cpuCfsQuota = bool
        cpuCfsQuotaPeriod = "string"
        cpuManagerPolicy = "string"
        failSwapOn = bool
        imageGcHighThreshold = int
        imageGcLowThreshold = int
        podMaxPids = int
        seccompDefault = "string"
        topologyManagerPolicy = "string"
      }
      kubeletDiskType = "string"
      linuxOSConfig = {
        swapFileSizeMB = int
        sysctls = {
          fsAioMaxNr = int
          fsFileMax = int
          fsInotifyMaxUserWatches = int
          fsNrOpen = int
          kernelThreadsMax = int
          netCoreNetdevMaxBacklog = int
          netCoreOptmemMax = int
          netCoreRmemDefault = int
          netCoreRmemMax = int
          netCoreSomaxconn = int
          netCoreWmemDefault = int
          netCoreWmemMax = int
          netIpv4IpLocalPortRange = "string"
          netIpv4NeighDefaultGcThresh1 = int
          netIpv4NeighDefaultGcThresh2 = int
          netIpv4NeighDefaultGcThresh3 = int
          netIpv4TcpFinTimeout = int
          netIpv4TcpkeepaliveIntvl = int
          netIpv4TcpKeepaliveProbes = int
          netIpv4TcpKeepaliveTime = int
          netIpv4TcpMaxSynBacklog = int
          netIpv4TcpMaxTwBuckets = int
          netIpv4TcpTwReuse = bool
          netNetfilterNfConntrackBuckets = int
          netNetfilterNfConntrackMax = int
          vmMaxMapCount = int
          vmSwappiness = int
          vmVfsCachePressure = int
        }
        transparentHugePageDefrag = "string"
        transparentHugePageEnabled = "string"
      }
      localDNSProfile = {
        kubeDNSOverrides = {
          cacheDurationInSeconds = int
          forwardDestination = "string"
          forwardPolicy = "string"
          maxConcurrent = int
          protocol = "string"
          queryLogging = "string"
          serveStale = "string"
          serveStaleDurationInSeconds = int
        }
        mode = "string"
        vnetDNSOverrides = {
          cacheDurationInSeconds = int
          forwardDestination = "string"
          forwardPolicy = "string"
          maxConcurrent = int
          protocol = "string"
          queryLogging = "string"
          serveStale = "string"
          serveStaleDurationInSeconds = int
        }
      }
      maxCount = int
      maxPods = int
      messageOfTheDay = "string"
      minCount = int
      mode = "string"
      networkProfile = {
        allowedHostPorts = [
          {
            portEnd = int
            portStart = int
            protocol = "string"
          }
        ]
        applicationSecurityGroups = [
          "string"
        ]
        nodePublicIPTags = [
          {
            ipTagType = "string"
            tag = "string"
          }
        ]
      }
      nodeInitializationTaints = [
        "string"
      ]
      nodeLabels = {
        {customized property} = "string"
      }
      nodePublicIPPrefixID = "string"
      nodeTaints = [
        "string"
      ]
      orchestratorVersion = "string"
      osDiskSizeGB = int
      osDiskType = "string"
      osSKU = "string"
      osType = "string"
      podIPAllocationMode = "string"
      podSubnetID = "string"
      powerState = {
        code = "string"
      }
      proximityPlacementGroupID = "string"
      scaleDownMode = "string"
      scaleSetEvictionPolicy = "string"
      scaleSetPriority = "string"
      securityProfile = {
        enableSecureBoot = bool
        enableVTPM = bool
        sshAccess = "string"
      }
      spotMaxPrice = int
      status = {
      }
      tags = {
        {customized property} = "string"
      }
      type = "string"
      upgradeSettings = {
        drainTimeoutInMinutes = int
        maxBlockedNodes = "string"
        maxSurge = "string"
        maxUnavailable = "string"
        nodeSoakDurationInMinutes = int
        undrainableNodeBehavior = "string"
      }
      virtualMachineNodesStatus = [
        {
          count = int
          size = "string"
        }
      ]
      virtualMachinesProfile = {
        scale = {
          autoscale = ?
          manual = [
            {
              count = int
              size = "string"
            }
          ]
        }
      }
      vmSize = "string"
      vnetSubnetID = "string"
      windowsProfile = {
        disableOutboundNat = bool
      }
      workloadRuntime = "string"
    }
  }
}

Valori delle proprietà

Microsoft.ContainerService/managedClusters/agentPools

Nome	Descrizione	Valore
nome	Nome della risorsa	corda Vincoli: Lunghezza minima = 1 Lunghezza massima = 12 Pattern = `^[a-z][a-z0-9]{0,11}$` (obbligatorio)
parent_id	ID della risorsa padre per questa risorsa.	ID per la risorsa di tipo: managedClusters
proprietà	Proprietà di un pool di agenti.	Proprietà gestite da ClusterAgentPoolProfileProperties
tipo	Tipo di risorsa	"Microsoft.ContainerService/managedClusters/agentPools@2025-03-02-preview"

AgentPoolArtifactStreamingProfile

Nome	Descrizione	Valore
Abilitato	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.	Bool

AgentPoolGatewayProfile

Nome	Descrizione	Valore
publicIPPrefixSize	Il pool di agenti del gateway associa un prefisso IP pubblico per ogni gateway in uscita statico per fornire dati in uscita pubblici. Le dimensioni di Public IPPrefix devono essere selezionate dall'utente. A ogni nodo del pool di agenti viene assegnato un indirizzo IP dal prefisso IP. Le dimensioni di IPPrefix fungono quindi da limite per le dimensioni del pool di agenti del gateway. A causa della limitazione delle dimensioni di IPPrefix pubblico di Azure, l'intervallo di valori validi è [28, 31] (/31 = 2 nodi/IP, /30 = 4 nodi/INDIRIZZI IP, /29 = 8 nodi/IP, /28 = 16 nodi/INDIRIZZI IP). Il valore predefinito è 31.	Int Vincoli: Valore minimo = 28 Valore massimo = 31

AgentPoolNetworkProfile

Nome	Descrizione	Valore
allowedHostPorts	Intervalli di porte a cui è consentito l'accesso. Gli intervalli specificati possono sovrapporsi.	PortRange []
gruppi di sicurezza delle applicazioni	ID dei gruppi di sicurezza delle applicazioni che verranno associati al pool di agenti al momento della creazione.	stringa[]
nodePublicIPTags	IPTag degli INDIRIZZI IP pubblici a livello di istanza.	IPTag[]

AgentPoolSecurityProfile

Nome	Descrizione	Valore
enableSecureBoot	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.	Bool
abilita VTPM	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.	Bool
sshAccess	Metodo di accesso SSH di un pool di agenti.	'Disabilitato' 'Utente locale'

Stato del pool di agenti

Nome	Descrizione	Valore

AgentPoolUpgradeSettings

Nome	Descrizione	Valore
drainTimeoutInMinutes	Quantità di tempo (in minuti) di attesa per la rimozione dei pod e la terminazione normale per ogni nodo. Questo tempo di attesa di rimozione rispetta l'attesa dei budget di interruzione dei pod. Se questa volta viene superata, l'aggiornamento non riesce. Se non specificato, il valore predefinito è 30 minuti.	Int Vincoli: Valore minimo = 1 Valore massimo = 1440
maxBlockedNodes	Può essere impostato su un numero intero ,ad esempio '5', o su una percentuale (ad esempio , '50%'). Se viene specificata una percentuale, corrisponde alla percentuale delle dimensioni totali del pool di agenti al momento dell'aggiornamento. Per le percentuali, i nodi frazionari vengono arrotondati. Se non specificato, il valore predefinito è maxSurge. Deve essere sempre maggiore o uguale a maxSurge. Per altre informazioni, incluse le procedure consigliate, vedere: /azure/aks/upgrade-cluster	corda
MaxSurge	Può essere impostato su un numero intero ,ad esempio '5', o su una percentuale (ad esempio , '50%'). Se viene specificata una percentuale, corrisponde alla percentuale delle dimensioni totali del pool di agenti al momento dell'aggiornamento. Per le percentuali, i nodi frazionari vengono arrotondati. Se non specificato, il valore predefinito è 10%. Per altre informazioni, incluse le procedure consigliate, vedere: /azure/aks/upgrade-cluster	corda
maxNon disponibile	Può essere impostato su un numero intero ,ad esempio "1" o su una percentuale (ad esempio , '5%'). Se viene specificata una percentuale, corrisponde alla percentuale delle dimensioni totali del pool di agenti al momento dell'aggiornamento. Per le percentuali, i nodi frazionari vengono arrotondati. Se non specificato, il valore predefinito è 0. Per altre informazioni, incluse le procedure consigliate, vedere: /azure/aks/upgrade-cluster	corda
nodeSoakDurationInMinutes	Quantità di tempo (in minuti) di attesa dopo lo svuotamento di un nodo e prima di riimagarla e passare al nodo successivo. Se non specificato, il valore predefinito è 0 minuti.	Int Vincoli: Valore minimo = 0 Valore massimo = 30
undrainableNodeBehavior	Definisce il comportamento per i nodi non restrittivi durante l'aggiornamento. La causa più comune dei nodi non consentiti è i budget di interruzione dei pod (PDB), ma altri problemi, ad esempio il periodo di tolleranza di terminazione dei pod, superano il timeout di svuotamento rimanente per nodo o il pod è ancora in stato di esecuzione, può anche causare nodi non restrittivi.	'Cordone' 'Programma'

AgentePoolWindowsProfilo

Nome	Descrizione	Valore
disabilitaAccesso in uscitaNat	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.	Bool

CreationData

Nome	Descrizione	Valore
sourceResourceId	Si tratta dell'ID ARM dell'oggetto di origine da usare per creare l'oggetto di destinazione.	corda

GPUProfile

Nome	Descrizione	Valore
autista	Indica se installare i driver GPU. Quando non è specificato, il valore predefinito è Install.	'Installa' 'Nessuno'
Tipo di conducente	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.	'CUDA' 'GRIGLIA'

IPTag

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

KubeletConfig

Nome	Descrizione	Valore
allowedUnsafeSysctls	Elenco consentito di sysctls non sicuri o criteri sysctl non sicuri (che terminano in `*`).	stringa[]
containerLogMaxFiles	Numero massimo di file di log del contenitore che possono essere presenti per un contenitore. Il numero deve essere ≥ 2.	Int Vincoli: Valore minimo = 2
contenitoreLogMaxSizeMB	Dimensioni massime (ad esempio 10Mi) del file di log del contenitore prima della rotazione.	Int
cpuCfsQuota	Il valore predefinito è vero.	Bool
cpuCfsQuotaPeriod	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'.	corda
cpuManagerPolicy	Il valore predefinito è 'none'. Per altre informazioni, vedere Criteri di gestione della CPU Kubernetes . I valori consentiti sono 'none' e 'static'.	corda
failSwapOn	Se impostato su true, l'avvio di Kubelet avrà esito negativo se lo scambio è abilitato nel nodo.	Bool
imageGcHighThreshold	Per disabilitare l'operazione di Garbage Collection delle immagini, impostare su 100. Il valore predefinito è 85%	Int
imageGcLowThreshold	Non è possibile impostare un valore superiore a imageGcHighThreshold. Il valore predefinito è 80%	Int
podMaxPids	Numero massimo di processi per pod.	Int
seccompPredefinito	Specifica il profilo seccomp predefinito applicato a tutti i carichi di lavoro. Se non specificato, per impostazione predefinita verrà usato 'Unconfined'.	'RuntimeDefault' 'Senza confini'
topologyManagerPolicy	Per altre informazioni, vedere Gestione topologie Kubernetes. Il valore predefinito è 'none'. I valori consentiti sono "none", "best-effort", "restricted" e "single-numa-node".	corda

LinuxOSConfig

Nome	Descrizione	Valore
swapFileSizeMB	Dimensioni in MB di un file di scambio che verrà creato in ogni nodo.	Int
sysctls	Impostazioni sysctl per i nodi dell'agente Linux.	SysctlConfig
trasparenteHugePageDefrag	I valori validi sono 'always', 'defer', 'defer+madvise', 'madvise' e 'never'. Il valore predefinito è "madvise". Per altre informazioni, vedere Transparent Hugepages.	corda
transparentHugePageEnabled	I valori validi sono 'always', 'madvise' e 'never'. Il valore predefinito è 'always'. Per altre informazioni, vedere Transparent Hugepages.	corda

LocalDNSOverrides

Nome	Descrizione	Valore
cacheDurationInSeconds	Cache max TTL in secondi. Per ulteriori informazioni, vedere il plug-in cache .	Int
forwardDestination	Server di destinazione per le query DNS da inoltrare da localDNS.	'ClusterCoreDNS' 'VnetDNS'
forwardPolicy	Criterio di inoltro per la selezione del server DNS upstream. Per ulteriori informazioni, vedere il plug-in forward .	'Casuale' 'RoundRobin' 'Sequenziale'
maxConcurrent	Numero massimo di query simultanee. Per ulteriori informazioni, vedere il plug-in forward .	Int
protocollo	Applicare TCP o preferire il protocollo UDP per le connessioni da localDNS al server DNS upstream.	'ForceTCP' 'PreferisceUDP'
queryLogging	Livello di log per le query DNS in localDNS.	'Errore' 'Registro'
serveStale	Criteri per la pubblicazione di dati non aggiornati. Per ulteriori informazioni, vedere il plug-in cache .	'Disabilita' 'Immediato' 'Verificare'
serveStaleDurationInSeconds	Servi la durata obsoleta in secondi. Per ulteriori informazioni, vedere il plug-in cache .	Int

File LocalDNSProfile

Nome	Descrizione	Valore
kubeDNSOverrides	Le sostituzioni di KubeDNS si applicano al traffico DNS proveniente da pod con dnsPolicy:ClusterFirst (denominato traffico KubeDNS).	LocalDNSOverrides
modalità	Modalità di abilitazione per il DNS locale.	'Disabilitato' 'Preferito' 'Obbligatorio'
vnetDNSOverrides	Le sostituzioni di VnetDNS si applicano al traffico DNS proveniente da pod con dnsPolicy:default o kubelet (denominato traffico VnetDNS).	LocalDNSOverrides

Proprietà gestite da ClusterAgentPoolProfileProperties

Nome	Descrizione	Valore
artefattoStreamingProfile	Configurazione per l'uso dello streaming degli artefatti nel servizio Azure Kubernetes.	AgentPoolArtifactStreamingProfile
zone di disponibilità	Elenco delle zone di disponibilità da usare per i nodi. Questa opzione può essere specificata solo se la proprietà AgentPoolType è "VirtualMachineScaleSets".	stringa[]
capacityReservationGroupID	Il servizio Azure Kubernetes assocerà il pool di agenti specificato al gruppo di prenotazioni di capacità.	corda
contare	Numero di agenti (VM) per ospitare contenitori Docker. I valori consentiti devono essere compresi nell'intervallo compreso tra 0 e 1000 (inclusi) per i pool di utenti e nell'intervallo compreso tra 1 e 1000 (inclusi) per i pool di sistema. Il valore predefinito è 1.	Int
creationData	CreationData da usare per specificare l'ID snapshot di origine se il pool di nodi verrà creato/aggiornato usando uno snapshot.	CreationData
abilita AutoScaling	Se abilitare il ridimensionamento automatico	Bool
enableCustomCATrust	Se impostato su true, il servizio Azure Kubernetes aggiunge un'etichetta al nodo che indica che la funzionalità è abilitata e distribuisce un daemonset insieme ai servizi host per sincronizzare le autorità di certificazione personalizzate dall'elenco fornito dall'utente di certificati con codifica Base64 negli archivi attendibili dei nodi. Il valore predefinito è falso.	Bool
enableEncryptionAtHost	Questa opzione è supportata solo in determinate dimensioni di vm e in determinate aree di Azure. Per altre informazioni, vedere: /azure/aks/enable-host-encryption	Bool
abilita FIPS	Per altri dettagli, vedere Aggiungere un pool di nodi abilitato per FIPS .	Bool
enableNodePublicIP	Alcuni scenari possono richiedere che i nodi in un pool di nodi ricevano 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. Per altre informazioni, vedere Assegnazione di un indirizzo IP pubblico per nodo. Il valore predefinito è false.	Bool
abilitareUltraSSD	Se abilitare UltraSSD	Bool
gatewayProfile	Profilare specifici di un pool di agenti gestiti in modalità gateway. Questo campo non può essere impostato se la modalità pool di agenti non è Gateway.	AgentPoolGatewayProfile
gpuInstanceProfile	GPUInstanceProfile da usare per specificare il profilo di istanza MIG della GPU per lo SKU di VM GPU supportato.	'MIG1g' 'MIG2g' 'MIG3g' 'MIG4g' 'MIG7g'
gpuProfilo	Impostazioni GPU di un pool di agenti.	GPUProfile
hostGroupID	Questo è il formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Per altre informazioni, vedere Host dedicati di Azure.	corda
kubeletConfig	Configurazione di Kubelet nei nodi del pool di agenti.	KubeletConfig
kubeletDiskType	Determina la posizione dei volumi emptyDir, della radice dei dati di runtime del contenitore e dell'archiviazione temporanea di Kubelet.	'OS' 'Temporaneo'
linuxOSConfig	Configurazione del sistema operativo dei nodi dell'agente Linux.	LinuxOSConfig
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.	File LocalDNSProfile
Conteggio massimo	Numero massimo di nodi per il ridimensionamento automatico	Int
MaxPods	Numero massimo di pod che possono essere eseguiti in un nodo.	Int
messaggioDiL'Uomo	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).	corda
minCount	Numero minimo di nodi per il ridimensionamento automatico	Int
modalità	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: /azure/aks/use-system-pools	'Porta' 'Sistema' 'Utente'
Profilo di rete	Impostazioni correlate alla rete di un pool di agenti.	AgentPoolNetworkProfile
nodeInitializationTaints	Questi taints non verranno riconciliati dal servizio Azure Kubernetes e possono essere rimossi con una chiamata kubectl. Questo campo può essere modificato dopo la creazione del pool di nodi, ma i nodi non verranno ricreati con nuovi taints finché non viene eseguita un'altra operazione che richiede la ricreazione (ad esempio, l'aggiornamento dell'immagine del nodo). 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-`	stringa[]
nodeLabels	Etichette dei nodi da rendere persistenti in tutti i nodi nel pool di agenti.	ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID	Modulo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}	corda
nodeTaints	I contenitori aggiunti ai nuovi nodi durante la creazione e la scalabilità del pool di nodi. Ad esempio, key=value:NoSchedule.	stringa[]
orchestratorVersion	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. L'aggiornamento del pool di agenti con lo stesso <major.minor> dopo la creazione non attiverà un aggiornamento, anche se è disponibile una versione patch più recente. Come procedura consigliata, è consigliabile aggiornare tutti i pool di nodi in un cluster del servizio Azure Kubernetes alla stessa versione di Kubernetes. La versione del pool di nodi deve avere la stessa versione principale del piano di controllo. La versione secondaria del pool di nodi deve trovarsi all'interno di due versioni secondarie della versione del piano di controllo. La versione del pool di nodi non può essere maggiore della versione del piano di controllo. Per altre informazioni, vedere Aggiornamento di un pool di nodi.	corda
osDiskSizeGB	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.	Int Vincoli: Valore minimo = 0 Valore massimo = 2048
osDiskType	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 altre informazioni, vedere Sistema operativo temporaneo.	'Effimero' 'Gestito'
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.	'AzureLinux' 'CBLMariner' 'Marinaio' 'Ubuntu' 'Ubuntu2204' 'Ubuntu2404' 'Windows2019' 'Finestre 2022' 'WindowsAnnual'
osType	Tipo di sistema operativo. Il valore predefinito è Linux.	'Linux' 'Finestre'
podIPAllocationMode	Modalità di allocazione IP per i pod nel pool di agenti. Deve essere usato con podSubnetId. Il valore predefinito è "DynamicIndividual".	'Individuo dinamico' 'Blocco statico'
podSubnetID	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}	corda
powerState	Quando viene creato per la prima volta, un pool di agenti è in esecuzione inizialmente. Il pool di agenti può essere arrestato impostando questo campo su Arrestato. Un pool di agenti arrestato arresta tutte le macchine virtuali e non accumula addebiti per la fatturazione. Un pool di agenti può essere arrestato solo se è in esecuzione e lo stato di provisioning è Succeeded	Stato di alimentazione
proximityPlacementGroupID	ID del gruppo di posizionamento di prossimità.	corda
scaleDownMode	Questo influisce anche sul comportamento del ridimensionamento automatico del cluster. Se non specificato, il valore predefinito è Delete.	'Deallocare' 'Elimina'
policy di sfratto del set di scalabilità	Questa impostazione non può essere specificata a meno che scaleSetPriority non sia "Spot". Se non specificato, il valore predefinito è 'Delete'.	'Deallocare' 'Elimina'
prioritàImpostazioneScala	Priorità del set di scalabilità di macchine virtuali. Se non specificato, il valore predefinito è 'Regular'.	'Regolare' 'Macchia'
di sicurezzaProfilo	Impostazioni di sicurezza di un pool di agenti.	AgentPoolSecurityProfile
spotMaxPrezzo	I valori possibili sono qualsiasi valore decimale maggiore di zero o -1 che indica la disponibilità a pagare qualsiasi prezzo su richiesta. Per altre informazioni sui prezzi spot, vedere Prezzi delle macchine virtuali spot	Int
stato	Contiene informazioni di sola lettura sul pool di agenti.	Stato del pool di agenti
etichette	Tag da rendere persistenti nel set di scalabilità di macchine virtuali del pool di agenti.	ManagedClusterAgentPoolProfilePropertiesTags
tipo	Tipo di pool di agenti.	'Set di disponibilità' 'Macchine virtuali' 'VirtualMachineScaleSets'
aggiornamentoImpostazioni	Impostazioni per l'aggiornamento del pool di agenti	AgentPoolUpgradeSettings
virtualMachineNodesStatus	Stato dei nodi in un pool di agenti VirtualMachines.	VirtualMachineNodes[]
virtualMachinesProfile	Specifiche nel pool di agenti VirtualMachines.	VirtualMachinesProfile
vmSize	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: /azure/aks/quotas-skus-regions	corda
vnetSubnetID	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}	corda
windowsProfilo	Profilo specifico del pool di agenti di Windows.	AgentePoolWindowsProfilo
carico di lavoroRuntime	Determina il tipo di carico di lavoro che un nodo può eseguire.	'KataMshvVmIsolation' 'OCIContainer' 'WasmWasi'

ManagedClusterAgentPoolProfilePropertiesNodeLabels

Nome	Descrizione	Valore

ManagedClusterAgentPoolProfilePropertiesTags

Nome	Descrizione	Valore

ManualeScaleProfile

Nome	Descrizione	Valore
contare	Numero di nodi.	Int
dimensione / taglia	Dimensioni delle macchine virtuali che verranno usate dal servizio Azure Kubernetes durante la creazione e il ridimensionamento, ad esempio "Standard_E4s_v3", "Standard_E16s_v3" o "Standard_D16s_v5".	corda

PortRange

Nome	Descrizione	Valore
presagire	Porta massima inclusa nell'intervallo. Deve essere compreso tra 1 e 65535 e deve essere maggiore o uguale a portStart.	Int Vincoli: Valore minimo = 1 Valore massimo = 65535
portaInizia	Porta minima inclusa nell'intervallo. Deve essere compreso tra 1 e 65535 e deve essere minore o uguale a portEnd.	Int Vincoli: Valore minimo = 1 Valore massimo = 65535
protocollo	Protocollo di rete della porta.	'TCP' 'UDP'

Stato di alimentazione

Nome	Descrizione	Valore
codice	Indica se il cluster è in esecuzione o arrestato	'Correre' 'Arrestato'

ScaleProfile

Nome	Descrizione	Valore
scalabilità automatica	Specifiche su come ridimensionare automaticamente il pool di agenti VirtualMachines all'interno di un intervallo di dimensioni predefinito.	qualunque
Manuale	Specifiche su come ridimensionare il pool di agenti VirtualMachines a dimensioni fisse.	ManualScaleProfile[]

SysctlConfig

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

VirtualMachineNodes

Nome	Descrizione	Valore
contare	Numero di nodi.	Int
dimensione / taglia	Dimensioni della macchina virtuale degli agenti usati per ospitare questo gruppo di nodi.	corda

VirtualMachinesProfile

Nome	Descrizione	Valore
scala	Specifiche su come ridimensionare un pool di agenti VirtualMachines.	ScaleProfile

Condividi tramite

Microsoft.ContainerService managedClusters/agentPools 2025-03-02-preview

Definizione di risorsa Bicep

Formato risorsa

Valori delle proprietà

Microsoft.ContainerService/managedClusters/agentPools

AgentPoolArtifactStreamingProfile

AgentPoolGatewayProfile

AgentPoolNetworkProfile

AgentPoolSecurityProfile

Stato del pool di agenti

AgentPoolUpgradeSettings

AgentePoolWindowsProfilo

CreationData

GPUProfile

IPTag

KubeletConfig

LinuxOSConfig

LocalDNSOverrides

File LocalDNSProfile

Proprietà gestite da ClusterAgentPoolProfileProperties

ManagedClusterAgentPoolProfilePropertiesNodeLabels

ManagedClusterAgentPoolProfilePropertiesTags

ManualeScaleProfile

PortRange

Stato di alimentazione

ScaleProfile

SysctlConfig

VirtualMachineNodes

VirtualMachinesProfile

Definizione di risorsa del modello di Resource Manager

Formato risorsa

Valori delle proprietà

Microsoft.ContainerService/managedClusters/agentPools

AgentPoolArtifactStreamingProfile

AgentPoolGatewayProfile

AgentPoolNetworkProfile

AgentPoolSecurityProfile

Stato del pool di agenti

AgentPoolUpgradeSettings

AgentePoolWindowsProfilo

CreationData

GPUProfile

IPTag

KubeletConfig

LinuxOSConfig

LocalDNSOverrides

File LocalDNSProfile

Proprietà gestite da ClusterAgentPoolProfileProperties

ManagedClusterAgentPoolProfilePropertiesNodeLabels

ManagedClusterAgentPoolProfilePropertiesTags

ManualeScaleProfile

PortRange

Stato di alimentazione

ScaleProfile

SysctlConfig

VirtualMachineNodes

VirtualMachinesProfile

Esempi di utilizzo

Modelli di avvio rapido di Azure

Definizione di risorsa Terraform (provider AzAPI)

Formato risorsa

Valori delle proprietà

Microsoft.ContainerService/managedClusters/agentPools

AgentPoolArtifactStreamingProfile

AgentPoolGatewayProfile

AgentPoolNetworkProfile

AgentPoolSecurityProfile

Stato del pool di agenti

AgentPoolUpgradeSettings

AgentePoolWindowsProfilo

CreationData

GPUProfile

IPTag

KubeletConfig

LinuxOSConfig

LocalDNSOverrides

File LocalDNSProfile

Proprietà gestite da ClusterAgentPoolProfileProperties

ManagedClusterAgentPoolProfilePropertiesNodeLabels