Agent Pools - Get

Servizio:: AKS

Versione API:: 2025-09-01

Ottiene il pool di agenti del cluster gestito specificato.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}?api-version=2025-09-01

Parametri dell'URI

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

Risposte

Nome	Tipo	Descrizione
200 OK	AgentPool	Va bene
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Get Agent Pool

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2025-09-01

from azure.identity import DefaultAzureCredential

from azure.mgmt.containerservice import ContainerServiceClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-containerservice
# USAGE
    python agent_pools_get.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ContainerServiceClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.agent_pools.get(
        resource_group_name="rg1",
        resource_name="clustername1",
        agent_pool_name="agentpool1",
    )
    print(response)


# x-ms-original-file: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-09-01/examples/AgentPoolsGet.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "eTag": "ebwiyfneowv",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
    "upgradeSettings": {
      "maxSurge": "33%"
    }
  }
}

Definizioni

Nome	Descrizione
AgentPool	Pool di agenti.
AgentPoolGatewayProfile	Profilo del pool di agenti del gateway del cluster gestito.
AgentPoolMode	Modalità di un pool di agenti. Un cluster deve avere sempre almeno un pool di agenti "System". Per altre informazioni sulle restrizioni del pool di agenti e sulle procedure consigliate, vedere: https://docs.microsoft.com/azure/aks/use-system-pools
AgentPoolNetworkProfile	Impostazioni di rete di un pool di agenti.
AgentPoolSecurityProfile	Impostazioni di sicurezza di un pool di agenti.
AgentPoolSSHAccess	Metodo di accesso SSH di un pool di agenti.
AgentPoolStatus	Contiene informazioni di sola lettura sul pool di agenti.
AgentPoolType	Tipo di pool di agenti.
AgentPoolUpgradeSettings	Impostazioni per l'aggiornamento di un pool di agenti
AgentPoolWindowsProfile	Profilo specifico del pool di agenti di Windows.
code	Indica se il cluster è in esecuzione o arrestato
CreationData	Dati usati durante la creazione di una risorsa di destinazione da una risorsa di origine.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
GPUDriver	Indica se installare i driver GPU. Quando non è specificato, il valore predefinito è Install.
GPUInstanceProfile	GPUInstanceProfile da usare per specificare il profilo di istanza MIG della GPU per lo SKU di VM GPU supportato.
GPUProfile	Impostazioni GPU per il pool di agenti.
IPTag	Contiene l'IPTag associato all'oggetto .
KubeletConfig	Configurazioni kubelet dei nodi dell'agente. Per altre informazioni, vedere di configurazione del nodo personalizzato del servizio Azure Kubernetes.
KubeletDiskType	Determina la posizione dei volumi emptyDir, della radice dei dati di runtime del contenitore e dell'archiviazione temporanea di Kubelet.
LinuxOSConfig	Configurazioni del sistema operativo dei nodi dell'agente Linux. Per altre informazioni, vedere di configurazione del nodo personalizzato del servizio Azure Kubernetes.
LocalDNSForwardDestination	Server di destinazione per le query DNS da inoltrare da localDNS.
LocalDNSForwardPolicy	Criterio di inoltro per la selezione del server DNS upstream. Per ulteriori informazioni, vedere il plug-in forward .
LocalDNSMode	Modalità di abilitazione per il DNS locale.
LocalDNSOverride	Sostituzioni per il profilo localDNS.
LocalDNSProfile	Configura il DNS locale per nodo, con override di VnetDNS e KubeDNS. LocalDNS consente di migliorare le prestazioni e l'affidabilità della risoluzione DNS in un cluster del servizio Azure Kubernetes. Per maggiori dettagli vedere aka.ms/aks/localdns.
LocalDNSProtocol	Applicare TCP o preferire il protocollo UDP per le connessioni da localDNS al server DNS upstream.
LocalDNSQueryLogging	Livello di log per le query DNS in localDNS.
LocalDNSServeStale	Criteri per la pubblicazione di dati non aggiornati. Per ulteriori informazioni, vedere il plug-in cache .
LocalDNSState	Stato generato dal sistema di localDNS.
ManualScaleProfile	Specifiche sul numero di computer.
OSDiskType	Tipo di disco del sistema operativo da usare per i computer nel pool di agenti. Il valore predefinito è "Ephemeral" se la macchina virtuale lo supporta e ha un disco della cache maggiore di quello richiesto OSDiskSizeGB. In caso contrario, il valore predefinito è "Gestito". Non può essere modificato dopo la creazione. Per altre informazioni, vedere Sistema operativo temporaneo.
OSSKU	Specifica lo SKU del sistema operativo usato dal pool di agenti. Il valore predefinito è Ubuntu se OSType è Linux. Il valore predefinito è Windows2019 quando Kubernetes <= 1.24 o Windows2022 quando Kubernetes >= 1.25 se OSType è Windows.
OSType	Tipo di sistema operativo. Il valore predefinito è Linux.
PodIPAllocationMode	Modalità di allocazione IP del pod. Modalità di allocazione IP per i pod nel pool di agenti. Deve essere usato con podSubnetId. Il valore predefinito è "DynamicIndividual".
PortRange	Intervallo di porte.
PowerState	Descrive lo stato di alimentazione del cluster
Protocol	Protocollo di rete della porta.
ScaleDownMode	Descrive il modo in cui le macchine virtuali vengono aggiunte o rimosse dai pool di agenti. Vedere gli stati di fatturazione.
ScaleProfile	Specifiche su come ridimensionare un pool di agenti VirtualMachines.
ScaleSetEvictionPolicy	Criteri di rimozione del set di scalabilità di macchine virtuali. I criteri di rimozione specificano cosa fare con la macchina virtuale quando viene rimossa. Il valore predefinito è Elimina. Per altre informazioni sulla rimozione, vedere Macchine virtuali spot
ScaleSetPriority	Priorità del set di scalabilità di macchine virtuali.
SysctlConfig	Impostazioni sysctl per i nodi dell'agente Linux.
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.
VirtualMachineNodes	Stato corrente in un gruppo di nodi con le stesse dimensioni della macchina virtuale.
VirtualMachinesProfile	Specifiche nel pool di agenti VirtualMachines.
WorkloadRuntime	Determina il tipo di carico di lavoro che un nodo può eseguire.

AgentPool

Object

Pool di agenti.

Nome	Tipo	Valore predefinito	Descrizione
id	string		ID risorsa.
name	string		Nome della risorsa univoca all'interno di un gruppo di risorse. Questo nome può essere usato per accedere alla risorsa.
properties.availabilityZones	string[]		Elenco delle zone di disponibilità da usare per i nodi. Questa opzione può essere specificata solo se la proprietà AgentPoolType è "VirtualMachineScaleSets".
properties.capacityReservationGroupID	string (arm-id)		Il servizio Azure Kubernetes assocerà il pool di agenti specificato al gruppo di prenotazioni di capacità.
properties.count	integer (int32)		Numero di agenti (VM) per ospitare contenitori Docker. I valori consentiti devono essere compresi nell'intervallo compreso tra 0 e 1.000 (inclusi) per i pool di utenti e nell'intervallo compreso tra 1 e 1.000 (inclusi) per i pool di sistema. Il valore predefinito è 1.
properties.creationData	CreationData		CreationData da usare per specificare l'ID snapshot di origine se il pool di nodi verrà creato/aggiornato usando uno snapshot.
properties.currentOrchestratorVersion	string		La versione di Kubernetes in esecuzione nel pool di agenti. Se orchestratorVersion è una versione <completamente specificata major.minor.patch>, questo campo sarà esattamente uguale a esso. Se orchestratorVersion è <major.minor>, questo campo conterrà la versione completa <di major.minor.patch> in uso.
properties.eTag	string		Stringa di sola lettura univoca usata per implementare la concorrenza ottimistica. Il valore eTag cambierà quando la risorsa viene aggiornata. Specificare un'intestazione if-match o if-none-match con il valore eTag per una richiesta successiva per abilitare la concorrenza ottimistica in base alla normale convenzione eTag.
properties.enableAutoScaling	boolean		Se abilitare il ridimensionamento automatico
properties.enableEncryptionAtHost	boolean		Indica se abilitare la crittografia del sistema operativo e dell'unità dati basata su host. Questa opzione è supportata solo in determinate dimensioni di vm e in determinate aree di Azure. Per altre informazioni, vedere: https://docs.microsoft.com/azure/aks/enable-host-encryption
properties.enableFIPS	boolean		Indica se usare un sistema operativo abilitato per FIPS. Per altri dettagli, vedere Aggiungere un pool di nodi abilitato per FIPS .
properties.enableNodePublicIP	boolean		Indica se ogni nodo viene allocato il proprio indirizzo IP pubblico. 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.
properties.enableUltraSSD	boolean		Se abilitare UltraSSD
properties.gatewayProfile	AgentPoolGatewayProfile		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.
properties.gpuInstanceProfile	GPUInstanceProfile		GPUInstanceProfile da usare per specificare il profilo di istanza MIG della GPU per lo SKU di VM GPU supportato.
properties.gpuProfile	GPUProfile		Impostazioni GPU per il pool di agenti.
properties.hostGroupID	string (arm-id)		ID risorsa completo del gruppo host dedicato da cui effettuare il provisioning delle macchine virtuali, usato solo nello scenario di creazione e non consentito di modificarlo una volta impostato. Questo è il formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Per altre informazioni, vedere Host dedicati di Azure.
properties.kubeletConfig	KubeletConfig		Configurazione di Kubelet nei nodi del pool di agenti.
properties.kubeletDiskType	KubeletDiskType		Determina la posizione dei volumi emptyDir, della radice dei dati di runtime del contenitore e dell'archiviazione temporanea di Kubelet.
properties.linuxOSConfig	LinuxOSConfig		Configurazione del sistema operativo dei nodi dell'agente Linux.
properties.localDNSProfile	LocalDNSProfile		Configura il DNS locale per nodo, con override di VnetDNS e KubeDNS. LocalDNS consente di migliorare le prestazioni e l'affidabilità della risoluzione DNS in un cluster del servizio Azure Kubernetes. Per maggiori dettagli vedere aka.ms/aks/localdns.
properties.maxCount	integer (int32)		Numero massimo di nodi per il ridimensionamento automatico
properties.maxPods	integer (int32)		Numero massimo di pod che possono essere eseguiti in un nodo.
properties.messageOfTheDay	string		Messaggio del giorno per i nodi Linux, con codifica Base64. Stringa con codifica base64 che verrà scritta in /etc/motd dopo la decodifica. In questo modo è possibile personalizzare il messaggio del giorno per i nodi Linux. Non deve essere specificato per i nodi Windows. Deve essere una stringa statica (ad esempio, verrà stampato non elaborato e non verrà eseguito come script).
properties.minCount	integer (int32)		Numero minimo di nodi per il ridimensionamento automatico
properties.mode	AgentPoolMode		Modalità di un pool di agenti. Un cluster deve avere sempre almeno un pool di agenti "System". Per altre informazioni sulle restrizioni del pool di agenti e sulle procedure consigliate, vedere: https://docs.microsoft.com/azure/aks/use-system-pools
properties.networkProfile	AgentPoolNetworkProfile		Impostazioni correlate alla rete di un pool di agenti.
properties.nodeImageVersion	string		Versione dell'immagine del nodo
properties.nodeLabels	object		Etichette dei nodi da rendere persistenti in tutti i nodi nel pool di agenti.
properties.nodePublicIPPrefixID	string (arm-id)		ID prefisso IP pubblico da cui devono essere usati i nodi della macchina virtuale. Modulo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
properties.nodeTaints	string[]		I contenitori aggiunti ai nuovi nodi durante la creazione e la scalabilità del pool di nodi. Ad esempio, key=value:NoSchedule.
properties.orchestratorVersion	string		Versione di Kubernetes specificata dall'utente. Sono supportate entrambe le versioni <patch major.minor.patch> (ad esempio 1.20.13) e <major.minor> (ad esempio 1.20). Quando <si specifica major.minor> , viene scelta automaticamente la versione della patch ga supportata più recente. L'aggiornamento del cluster con lo stesso <major.minor> dopo la creazione (ad esempio 1.14.x -> 1.14) 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.
properties.osDiskSizeGB	integer (int32) minimum: 0 maximum: 2048		Dimensioni disco del sistema operativo in GB da usare per specificare le dimensioni del disco per ogni computer nel pool master/agente. Se si specifica 0, verrà applicata la dimensione osDisk predefinita in base all'opzione vmSize specificata.
properties.osDiskType	OSDiskType		Tipo di disco del sistema operativo da usare per i computer nel pool di agenti. Il valore predefinito è "Ephemeral" se la macchina virtuale lo supporta e ha un disco della cache maggiore di quello richiesto OSDiskSizeGB. In caso contrario, il valore predefinito è "Gestito". Non può essere modificato dopo la creazione. Per altre informazioni, vedere Sistema operativo temporaneo.
properties.osSKU	OSSKU		Specifica lo SKU del sistema operativo usato dal pool di agenti. Il valore predefinito è Ubuntu se OSType è Linux. Il valore predefinito è Windows2019 quando Kubernetes <= 1.24 o Windows2022 quando Kubernetes >= 1.25 se OSType è Windows.
properties.osType	OSType	Linux	Tipo di sistema operativo. Il valore predefinito è Linux.
properties.podIPAllocationMode	PodIPAllocationMode		Modalità di allocazione IP del pod. Modalità di allocazione IP per i pod nel pool di agenti. Deve essere usato con podSubnetId. Il valore predefinito è "DynamicIndividual".
properties.podSubnetID	string (arm-id)		ID della subnet a cui verranno aggiunti i pod al momento dell'avvio. Se omesso, gli indirizzi IP dei pod vengono assegnati in modo statico nella subnet del nodo (vedere vnetSubnetID per altri dettagli). Questo è il formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.powerState	PowerState		Indica se il pool di agenti è in esecuzione o arrestato. 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
properties.provisioningState	string		Stato di distribuzione o provisioning corrente.
properties.proximityPlacementGroupID	string (arm-id)		ID del gruppo di posizionamento di prossimità.
properties.scaleDownMode	ScaleDownMode		Modalità di riduzione da usare per il ridimensionamento del pool di agenti. Questo influisce anche sul comportamento del ridimensionamento automatico del cluster. Se non specificato, il valore predefinito è Delete.
properties.scaleSetEvictionPolicy	ScaleSetEvictionPolicy	Delete	Criteri di rimozione del set di scalabilità di macchine virtuali da usare. Questa impostazione non può essere specificata a meno che scaleSetPriority non sia "Spot". Se non specificato, il valore predefinito è 'Delete'.
properties.scaleSetPriority	ScaleSetPriority	Regular	Priorità del set di scalabilità di macchine virtuali. Se non specificato, il valore predefinito è 'Regular'.
properties.securityProfile	AgentPoolSecurityProfile		Impostazioni di sicurezza di un pool di agenti.
properties.spotMaxPrice	number	-1	Il prezzo massimo (in dollari statunitensi) che si è disposti a pagare per le istanze spot. I valori possibili sono qualsiasi valore decimale maggiore di zero o -1 che indica il prezzo predefinito da up-to su richiesta. 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
properties.status	AgentPoolStatus		Contiene informazioni di sola lettura sul pool di agenti.
properties.tags	object		Tag da rendere persistenti nel set di scalabilità di macchine virtuali del pool di agenti.
properties.type	AgentPoolType		Tipo di pool di agenti.
properties.upgradeSettings	AgentPoolUpgradeSettings		Impostazioni per l'aggiornamento del pool di agenti
properties.virtualMachineNodesStatus	VirtualMachineNodes[]		Stato dei nodi in un pool di agenti VirtualMachines.
properties.virtualMachinesProfile	VirtualMachinesProfile		Specifiche nel pool di agenti VirtualMachines.
properties.vmSize	string		Dimensioni delle macchine virtuali del pool di agenti. La disponibilità delle dimensioni della macchina virtuale varia in base all'area. Se un nodo contiene risorse di calcolo insufficienti (memoria, CPU e così via) i pod potrebbero non essere eseguiti correttamente. Per altre informazioni sulle dimensioni delle macchine virtuali con restrizioni, vedere: https://docs.microsoft.com/azure/aks/quotas-skus-regions
properties.vnetSubnetID	string (arm-id)		ID della subnet a cui verranno aggiunti i nodi del pool di agenti e facoltativamente i pod all'avvio. Se non viene specificato, verrà generata e usata una rete virtuale e una subnet. Se non viene specificato alcun podSubnetID, questo vale per nodi e pod, altrimenti si applica solo ai nodi. Questo è il formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
properties.windowsProfile	AgentPoolWindowsProfile		Profilo specifico del pool di agenti di Windows.
properties.workloadRuntime	WorkloadRuntime		Determina il tipo di carico di lavoro che un nodo può eseguire.
type	string		Tipo di risorsa

AgentPoolGatewayProfile

Object

Profilo del pool di agenti del gateway del cluster gestito.

Nome	Tipo	Valore predefinito	Descrizione
publicIPPrefixSize	integer (int32) minimum: 28 maximum: 31	31	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.

AgentPoolMode

Enumerazione

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

Valore	Descrizione
System	I pool di agenti di sistema sono principalmente per l'hosting di pod di sistema critici come CoreDNS e metrics-server. I pool di agenti di sistema osType devono essere Linux. Lo SKU della macchina virtuale dei pool di agenti di sistema deve avere almeno 2 vCPU e 4 GB di memoria.
User	I pool di agenti utente servono principalmente per ospitare i pod dell'applicazione.
Gateway	I pool di agenti gateway sono dedicati a fornire indirizzi IP di uscita statici ai pod. Per altri dettagli, vedere https://aka.ms/aks/static-egress-gateway.

AgentPoolNetworkProfile

Object

Impostazioni di rete di un pool di agenti.

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

AgentPoolSecurityProfile

Object

Impostazioni di sicurezza di un pool di agenti.

Nome	Tipo	Descrizione
enableSecureBoot	boolean	L'avvio protetto è una funzionalità di avvio attendibile che garantisce l'avvio solo dei sistemi operativi e dei driver firmati. Per altri dettagli, vedere aka.ms/aks/trustedlaunch. Se non specificato, il valore predefinito è false.
enableVTPM	boolean	vTPM è una funzionalità di avvio attendibile per la configurazione di un insieme di credenziali sicuro dedicato per chiavi e misurazioni mantenute localmente nel nodo. Per altri dettagli, vedere aka.ms/aks/trustedlaunch. Se non specificato, il valore predefinito è false.
sshAccess	AgentPoolSSHAccess	Metodo di accesso SSH di un pool di agenti.

AgentPoolSSHAccess

Enumerazione

Metodo di accesso SSH di un pool di agenti.

Valore	Descrizione
LocalUser	Può eseguire SSH nel nodo come utente locale usando la chiave privata.
Disabled	Il servizio SSH verrà disattivato nel nodo.

AgentPoolStatus

Object

Contiene informazioni di sola lettura sul pool di agenti.

Nome	Tipo	Descrizione
provisioningError	ErrorDetail	Informazioni dettagliate sull'errore del pool di agenti. Conserva le informazioni dettagliate dell'errore. Se non si è verificato alcun errore, questo campo viene omesso.

AgentPoolType

Enumerazione

Tipo di pool di agenti.

Valore	Descrizione
VirtualMachineScaleSets	Creare un pool di agenti supportato da un set di scalabilità di macchine virtuali.
AvailabilitySet	L'uso di questo è fortemente sconsigliato.
VirtualMachines	Creare un pool di agenti supportato da una modalità di orchestrazione della macchina virtuale a istanza singola.

AgentPoolUpgradeSettings

Object

Impostazioni per l'aggiornamento di un pool di agenti

Nome	Tipo	Descrizione
drainTimeoutInMinutes	integer (int32) minimum: 1 maximum: 1440	Timeout di svuotamento per un nodo. 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.
maxSurge	string	Numero massimo o percentuale di nodi che vengono distribuiti durante l'aggiornamento. 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 ulteriori informazioni, incluse le procedure consigliate, consultare: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster
maxUnavailable	string	Numero massimo o percentuale di nodi che possono essere simultaneamente non disponibili durante l'aggiornamento. 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 ulteriori informazioni, incluse le procedure consigliate, consultare: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster
nodeSoakDurationInMinutes	integer (int32) minimum: 0 maximum: 30	Durata dell'ammollo per un nodo. 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.
undrainableNodeBehavior	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.

AgentPoolWindowsProfile

Object

Profilo specifico del pool di agenti di Windows.

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

code

Enumerazione

Indica se il cluster è in esecuzione o arrestato

Valore	Descrizione
Running	Il cluster è in esecuzione.
Stopped	Il cluster è stato arrestato.

CreationData

Object

Dati usati durante la creazione di una risorsa di destinazione da una risorsa di origine.

Nome	Tipo	Descrizione
sourceResourceId	string (arm-id)	Si tratta dell'ID ARM dell'oggetto di origine da usare per creare l'oggetto di destinazione.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

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

ErrorDetail

Object

Dettagli dell'errore.

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

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

GPUDriver

Enumerazione

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

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

GPUInstanceProfile

Enumerazione

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

Valore	Descrizione
MIG1g
MIG2g
MIG3g
MIG4g
MIG7g

GPUProfile

Object

Impostazioni GPU per il pool di agenti.

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

IPTag

Object

Contiene l'IPTag associato all'oggetto .

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

KubeletConfig

Object

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

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

KubeletDiskType

Enumerazione

Determina la posizione dei volumi emptyDir, della radice dei dati di runtime del contenitore e dell'archiviazione temporanea di Kubelet.

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

LinuxOSConfig

Object

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

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

LocalDNSForwardDestination

Enumerazione

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

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

LocalDNSForwardPolicy

Enumerazione

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

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

LocalDNSMode

Enumerazione

Modalità di abilitazione per il DNS locale.

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

LocalDNSOverride

Object

Sostituzioni per il profilo localDNS.

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

LocalDNSProfile

Object

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

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

LocalDNSProtocol

Enumerazione

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

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

LocalDNSQueryLogging

Enumerazione

Livello di log per le query DNS in localDNS.

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

LocalDNSServeStale

Enumerazione

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

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

LocalDNSState

Enumerazione

Stato generato dal sistema di localDNS.

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

ManualScaleProfile

Object

Specifiche sul numero di computer.

Nome	Tipo	Descrizione
count	integer (int32)	Numero di nodi.
size	string	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".

OSDiskType

Enumerazione

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

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

Valore

Descrizione

Managed

Azure replica il disco del sistema operativo per una macchina virtuale in Archiviazione di Azure per evitare la perdita di dati nel caso in cui la macchina virtuale debba essere riposizionata in un altro host. Poiché i contenitori non sono progettati per rendere persistente lo stato locale, questo comportamento offre un valore limitato, fornendo alcuni svantaggi, tra cui il provisioning dei nodi più lento e una latenza di lettura/scrittura superiore.

Ephemeral

I dischi temporanei del sistema operativo vengono archiviati solo nel computer host, proprio come un disco temporaneo. Ciò garantisce una latenza di lettura/scrittura inferiore, oltre a un ridimensionamento più rapido dei nodi e agli aggiornamenti del cluster.

OSSKU

Enumerazione

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

Valore	Descrizione
AzureLinux	Usare AzureLinux come sistema operativo per le immagini dei nodi. Linux di Azure è una distribuzione Linux ottimizzata per i contenitori creata da Microsoft. Per altre informazioni, visitare https://aka.ms/azurelinux.
AzureLinux3	Usare AzureLinux3 come sistema operativo per le immagini dei nodi. Linux di Azure è una distribuzione Linux ottimizzata per i contenitori creata da Microsoft. Per altre informazioni, visitare https://aka.ms/azurelinux. Per le limitazioni, visitare il sito https://aka.ms/aks/node-images. Per indicazioni sulla migrazione del sistema operativo, vedere https://aka.ms/aks/upgrade-os-version.
CBLMariner	OSSKU deprecato. Microsoft consiglia di scegliere invece "AzureLinux" per le nuove distribuzioni.
Ubuntu	Usare Ubuntu come sistema operativo per le immagini del nodo.
Ubuntu2204	Utilizzare Ubuntu2204 come sistema operativo per le immagini dei nodi, tuttavia, Ubuntu 22.04 potrebbe non essere supportato per tutti i pool di nodi. Per le limitazioni e le versioni di Kubernetes supportate, vedere https://aka.ms/aks/supported-ubuntu-versions
Windows2019	Usare Windows2019 come sistema operativo per le immagini del nodo. Non supportato per i pool di nodi di sistema. Windows2019 supporta solo i contenitori Windows2019; non può eseguire contenitori Windows2022 e viceversa.
Windows2022	Usare Windows2022 come sistema operativo per le immagini del nodo. Non supportato per i pool di nodi di sistema. Windows2022 supporta solo contenitori Windows2022; non può eseguire contenitori Windows2019 e viceversa.

OSType

Enumerazione

Tipo di sistema operativo. Il valore predefinito è Linux.

Valore	Descrizione
Linux	Usa Linux.
Windows	Usa Windows.

PodIPAllocationMode

Enumerazione

Modalità di allocazione IP del pod. Modalità di allocazione IP per i pod nel pool di agenti. Deve essere usato con podSubnetId. Il valore predefinito è "DynamicIndividual".

Valore	Descrizione
DynamicIndividual	Ogni nodo viene allocato con un elenco non contiguo di indirizzi IP assegnabili ai pod. È preferibile ottimizzare una subnet da piccola a media di dimensioni /16 o inferiori. Per impostazione predefinita, il cluster Azure CNI con allocazione IP dinamica utilizza questa modalità se il cliente non specifica in modo esplicito un podIPAllocationMode
StaticBlock	A ogni nodo vengono allocati staticamente blocchi CIDR di dimensioni /28 = 16 IP per blocco per soddisfare i maxPod per nodo. Numero di blocchi CIDR >= (maxPods/ 16). Il blocco, anziché un singolo IP, viene conteggiato rispetto al limite di IP privato della rete virtuale di Azure di 65.000. La modalità di blocco è quindi adatta per l'esecuzione di carichi di lavoro di dimensioni maggiori con più del limite corrente di 65.000 pod in un cluster. Questa modalità è più adatta per la scalabilità con subnet più grandi di /15 o superiori

Valore

Descrizione

DynamicIndividual

Ogni nodo viene allocato con un elenco non contiguo di indirizzi IP assegnabili ai pod. È preferibile ottimizzare una subnet da piccola a media di dimensioni /16 o inferiori. Per impostazione predefinita, il cluster Azure CNI con allocazione IP dinamica utilizza questa modalità se il cliente non specifica in modo esplicito un podIPAllocationMode

StaticBlock

A ogni nodo vengono allocati staticamente blocchi CIDR di dimensioni /28 = 16 IP per blocco per soddisfare i maxPod per nodo. Numero di blocchi CIDR >= (maxPods/ 16). Il blocco, anziché un singolo IP, viene conteggiato rispetto al limite di IP privato della rete virtuale di Azure di 65.000. La modalità di blocco è quindi adatta per l'esecuzione di carichi di lavoro di dimensioni maggiori con più del limite corrente di 65.000 pod in un cluster. Questa modalità è più adatta per la scalabilità con subnet più grandi di /15 o superiori

PortRange

Object

Intervallo di porte.

Nome	Tipo	Descrizione
portEnd	integer (int32) minimum: 1 maximum: 65535	Porta massima inclusa nell'intervallo. Deve essere compreso tra 1 e 65535 e deve essere maggiore o uguale a portStart.
portStart	integer (int32) minimum: 1 maximum: 65535	Porta minima inclusa nell'intervallo. Deve essere compreso tra 1 e 65535 e deve essere minore o uguale a portEnd.
protocol	Protocol	Protocollo di rete della porta.

PowerState

Object

Descrive lo stato di alimentazione del cluster

Nome	Tipo	Descrizione
code	code	Indica se il cluster è in esecuzione o arrestato

Protocol

Enumerazione

Protocollo di rete della porta.

Valore	Descrizione
TCP	TCP.
UDP	Protocollo UDP.

ScaleDownMode

Enumerazione

Descrive il modo in cui le macchine virtuali vengono aggiunte o rimosse dai pool di agenti. Vedere gli stati di fatturazione.

Valore	Descrizione
Delete	Creare nuove istanze durante la scalabilità verticale e rimuovere le istanze durante la riduzione delle istanze.
Deallocate	Tentare di avviare le istanze deallocate (se esistenti) durante la scalabilità verticale e deallocare le istanze durante la riduzione delle istanze.

ScaleProfile

Object

Specifiche su come ridimensionare un pool di agenti VirtualMachines.

Nome	Tipo	Descrizione
manual	ManualScaleProfile[]	Specifiche su come ridimensionare il pool di agenti VirtualMachines a dimensioni fisse.

ScaleSetEvictionPolicy

Enumerazione

Criteri di rimozione del set di scalabilità di macchine virtuali. I criteri di rimozione specificano cosa fare con la macchina virtuale quando viene rimossa. Il valore predefinito è Elimina. Per altre informazioni sulla rimozione, vedere Macchine virtuali spot

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

ScaleSetPriority

Enumerazione

Priorità del set di scalabilità di macchine virtuali.

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

SysctlConfig

Object

Impostazioni sysctl per i nodi dell'agente Linux.

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

UndrainableNodeBehavior

Enumerazione

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.

Valore	Descrizione
Schedule	Il servizio Azure Kubernetes contrassegnerà i nodi bloccati come pianificabili, ma i nodi bloccati non vengono aggiornati. Verrà effettuato un tentativo di eliminazione di tutti i nodi di picco. L'operazione di aggiornamento e il cluster gestito saranno in stato di errore se sono presenti nodi bloccati.
Cordon	Il servizio Azure Kubernetes limiterà i nodi bloccati e li sostituirà con nodi di picco durante l'aggiornamento. I nodi bloccati verranno bloccati e sostituiti da nodi di picco. I nodi bloccati avranno l'etichetta "kubernetes.azure.com/upgrade-status:Quarantined". Verrà mantenuto un nodo di picco per ogni nodo bloccato. Verrà effettuato un tentativo di eliminazione di tutti gli altri nodi di picco. Se sono presenti nodi con picchi sufficienti per sostituire i nodi bloccati, l'operazione di aggiornamento e il cluster gestito sarà in stato di errore. In caso contrario, l'operazione di aggiornamento e il cluster gestito saranno in stato annullato.

Valore

Descrizione

Schedule

Il servizio Azure Kubernetes contrassegnerà i nodi bloccati come pianificabili, ma i nodi bloccati non vengono aggiornati. Verrà effettuato un tentativo di eliminazione di tutti i nodi di picco. L'operazione di aggiornamento e il cluster gestito saranno in stato di errore se sono presenti nodi bloccati.

Cordon

Il servizio Azure Kubernetes limiterà i nodi bloccati e li sostituirà con nodi di picco durante l'aggiornamento. I nodi bloccati verranno bloccati e sostituiti da nodi di picco. I nodi bloccati avranno l'etichetta "kubernetes.azure.com/upgrade-status:Quarantined". Verrà mantenuto un nodo di picco per ogni nodo bloccato. Verrà effettuato un tentativo di eliminazione di tutti gli altri nodi di picco. Se sono presenti nodi con picchi sufficienti per sostituire i nodi bloccati, l'operazione di aggiornamento e il cluster gestito sarà in stato di errore. In caso contrario, l'operazione di aggiornamento e il cluster gestito saranno in stato annullato.

VirtualMachineNodes

Object

Stato corrente in un gruppo di nodi con le stesse dimensioni della macchina virtuale.

Nome	Tipo	Descrizione
count	integer (int32)	Numero di nodi.
size	string	Dimensioni della macchina virtuale degli agenti usati per ospitare questo gruppo di nodi.

VirtualMachinesProfile

Object

Specifiche nel pool di agenti VirtualMachines.

Nome	Tipo	Descrizione
scale	ScaleProfile	Specifiche su come ridimensionare un pool di agenti VirtualMachines.

WorkloadRuntime

Enumerazione

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

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

Condividi tramite

Agent Pools - Get

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Get Agent Pool

Esempio di richiesta

Risposta di esempio

Definizioni

AgentPool

AgentPoolGatewayProfile

AgentPoolMode

AgentPoolNetworkProfile

AgentPoolSecurityProfile

AgentPoolSSHAccess

AgentPoolStatus

AgentPoolType

AgentPoolUpgradeSettings

AgentPoolWindowsProfile

code

CreationData

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GPUDriver

GPUInstanceProfile

GPUProfile

IPTag

KubeletConfig

KubeletDiskType

LinuxOSConfig

LocalDNSForwardDestination

LocalDNSForwardPolicy

LocalDNSMode

LocalDNSOverride

LocalDNSProfile

LocalDNSProtocol

LocalDNSQueryLogging

LocalDNSServeStale

LocalDNSState

ManualScaleProfile

OSDiskType

OSSKU

OSType

PodIPAllocationMode

PortRange

PowerState

Protocol

ScaleDownMode

ScaleProfile

ScaleSetEvictionPolicy

ScaleSetPriority

SysctlConfig

UndrainableNodeBehavior

VirtualMachineNodes

VirtualMachinesProfile

WorkloadRuntime