Machines - Create Or Update

Service:: AKS

Version d'API:: 2026-01-02-preview

Crée ou met à jour une machine dans le pool d’agents spécifié.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	Nom du pool d’agents.
machineName	path	True	string pattern: ^[a-z][a-z0-9]{0,11}$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,39}$	Nom d’hôte de la machine.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
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]$	Nom de la ressource de cluster géré.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

En-tête de la demande

Nom	Obligatoire	Type	Description
if-match		string	La requête ne doit continuer que si une entité correspond à cette chaîne.
if-none-match		string	La requête ne doit continuer que si aucune entité ne correspond à cette chaîne.

Corps de la demande

Nom	Type	Description
properties	MachineProperties	Propriétés de l’ordinateur

Réponses

Nom	Type	Description
200 OK	Machine	Opération de mise à jour de la ressource 'Machine' réussie
201 Created	Machine	Resource 'Machine' créer l’opération réussie En-têtes Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Nom

Type

Description

200 OK

Machine

Opération de mise à jour de la ressource 'Machine' réussie

201 Created

Machine

Resource 'Machine' créer l’opération réussie

En-têtes

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

Create/Update Machine

Exemple de requête

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1?api-version=2026-01-02-preview

{
  "properties": {
    "hardware": {
      "vmSize": "Standard_DS1_v2"
    },
    "kubernetes": {
      "kubeletDiskType": "OS",
      "maxPods": 110,
      "nodeLabels": {
        "key1": "val1"
      },
      "nodeTaints": [
        "Key1=Value1:NoSchedule"
      ],
      "orchestratorVersion": "1.30"
    },
    "mode": "User",
    "operatingSystem": {
      "enableFIPS": false,
      "osSKU": "Ubuntu",
      "osType": "Linux"
    },
    "priority": "Spot",
    "tags": {
      "name1": "val1"
    }
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.containerservice import ContainerServiceClient

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

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


def main():
    client = ContainerServiceClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.machines.begin_create_or_update(
        resource_group_name="rg1",
        resource_name="clustername1",
        agent_pool_name="agentpool1",
        machine_name="machine1",
        parameters={
            "properties": {
                "hardware": {"vmSize": "Standard_DS1_v2"},
                "kubernetes": {
                    "kubeletDiskType": "OS",
                    "maxPods": 110,
                    "nodeLabels": {"key1": "val1"},
                    "nodeTaints": ["Key1=Value1:NoSchedule"],
                    "orchestratorVersion": "1.30",
                },
                "mode": "User",
                "operatingSystem": {"enableFIPS": False, "osSKU": "Ubuntu", "osType": "Linux"},
                "priority": "Spot",
                "tags": {"name1": "val1"},
            }
        },
    ).result()
    print(response)


# x-ms-original-file: 2026-01-02-preview/MachineCreate_Update.json
if __name__ == "__main__":
    main()

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

package armcontainerservice_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/containerservice/armcontainerservice/v9"
)

// Generated from example definition: 2026-01-02-preview/MachineCreate_Update.json
func ExampleMachinesClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcontainerservice.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewMachinesClient().BeginCreateOrUpdate(ctx, "rg1", "clustername1", "agentpool1", "machine1", armcontainerservice.Machine{
		Properties: &armcontainerservice.MachineProperties{
			Hardware: &armcontainerservice.MachineHardwareProfile{
				VMSize: to.Ptr("Standard_DS1_v2"),
			},
			Kubernetes: &armcontainerservice.MachineKubernetesProfile{
				KubeletDiskType: to.Ptr(armcontainerservice.KubeletDiskTypeOS),
				MaxPods:         to.Ptr[int32](110),
				NodeLabels: map[string]*string{
					"key1": to.Ptr("val1"),
				},
				NodeTaints: []*string{
					to.Ptr("Key1=Value1:NoSchedule"),
				},
				OrchestratorVersion: to.Ptr("1.30"),
			},
			Mode: to.Ptr(armcontainerservice.AgentPoolModeUser),
			OperatingSystem: &armcontainerservice.MachineOSProfile{
				EnableFIPS: to.Ptr(false),
				OSSKU:      to.Ptr(armcontainerservice.OSSKUUbuntu),
				OSType:     to.Ptr(armcontainerservice.OSTypeLinux),
			},
			Priority: to.Ptr(armcontainerservice.ScaleSetPrioritySpot),
			Tags: map[string]*string{
				"name1": to.Ptr("val1"),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armcontainerservice.MachinesClientCreateOrUpdateResponse{
	// 	Machine: &armcontainerservice.Machine{
	// 		Name: to.Ptr("machine1"),
	// 		Type: to.Ptr("Microsoft.ContainerService/managedClusters/agentPools/machines"),
	// 		ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1"),
	// 		Properties: &armcontainerservice.MachineProperties{
	// 			Hardware: &armcontainerservice.MachineHardwareProfile{
	// 				VMSize: to.Ptr("Standard_DS1_v2"),
	// 			},
	// 			Kubernetes: &armcontainerservice.MachineKubernetesProfile{
	// 				CurrentOrchestratorVersion: to.Ptr("1.30.6"),
	// 				KubeletDiskType: to.Ptr(armcontainerservice.KubeletDiskTypeOS),
	// 				MaxPods: to.Ptr[int32](110),
	// 				NodeLabels: map[string]*string{
	// 					"key1": to.Ptr("val1"),
	// 				},
	// 				NodeName: to.Ptr("aks-nodepool1-machine1-25481572-vm0"),
	// 				NodeTaints: []*string{
	// 					to.Ptr("Key1=Value1:NoSchedule"),
	// 				},
	// 				OrchestratorVersion: to.Ptr("1.30"),
	// 			},
	// 			Mode: to.Ptr(armcontainerservice.AgentPoolModeUser),
	// 			NodeImageVersion: to.Ptr("AKSUbuntu:1604:2023.03.11"),
	// 			OperatingSystem: &armcontainerservice.MachineOSProfile{
	// 				EnableFIPS: to.Ptr(false),
	// 				OSSKU: to.Ptr(armcontainerservice.OSSKUUbuntu),
	// 				OSType: to.Ptr(armcontainerservice.OSTypeLinux),
	// 			},
	// 			Priority: to.Ptr(armcontainerservice.ScaleSetPrioritySpot),
	// 			ProvisioningState: to.Ptr("Succeeded"),
	// 			Status: &armcontainerservice.MachineStatus{
	// 				CreationTimestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2025-04-02T12:00:00Z"); return t}()),
	// 				DriftAction: to.Ptr(armcontainerservice.DriftActionSynced),
	// 				VMState: to.Ptr(armcontainerservice.VMStateRunning),
	// 			},
	// 			Tags: map[string]*string{
	// 				"name1": to.Ptr("val1"),
	// 			},
	// 		},
	// 		Zones: []*string{
	// 			to.Ptr("1"),
	// 		},
	// 	},
	// }
}

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

Exemple de réponse

Code d’état:: 200

{
  "name": "machine1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools/machines",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1",
  "properties": {
    "hardware": {
      "vmSize": "Standard_DS1_v2"
    },
    "kubernetes": {
      "currentOrchestratorVersion": "1.30.6",
      "kubeletDiskType": "OS",
      "maxPods": 110,
      "nodeLabels": {
        "key1": "val1"
      },
      "nodeName": "aks-nodepool1-machine1-25481572-vm0",
      "nodeTaints": [
        "Key1=Value1:NoSchedule"
      ],
      "orchestratorVersion": "1.30"
    },
    "mode": "User",
    "nodeImageVersion": "AKSUbuntu:1604:2023.03.11",
    "operatingSystem": {
      "enableFIPS": false,
      "osSKU": "Ubuntu",
      "osType": "Linux"
    },
    "priority": "Spot",
    "provisioningState": "Succeeded",
    "status": {
      "creationTimestamp": "2025-04-02T12:00:00Z",
      "driftAction": "Synced",
      "vmState": "Running"
    },
    "tags": {
      "name1": "val1"
    }
  },
  "zones": [
    "1"
  ]
}

Code d’état:: 201

{
  "name": "machine1",
  "type": "Microsoft.ContainerService/managedClusters/agentPools/machines",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/machines/machine1",
  "properties": {
    "hardware": {
      "vmSize": "Standard_DS1_v2"
    },
    "kubernetes": {
      "currentOrchestratorVersion": "1.30.6",
      "kubeletDiskType": "OS",
      "maxPods": 110,
      "nodeLabels": {
        "key1": "val1"
      },
      "nodeName": "aks-nodepool1-machine1-25481572-vm0",
      "nodeTaints": [
        "Key1=Value1:NoSchedule"
      ],
      "orchestratorVersion": "1.30"
    },
    "mode": "User",
    "nodeImageVersion": "AKSUbuntu:1604:2023.03.11",
    "operatingSystem": {
      "enableFIPS": false,
      "osSKU": "Ubuntu",
      "osType": "Linux"
    },
    "priority": "Spot",
    "provisioningState": "Creating",
    "status": {
      "creationTimestamp": "2025-04-02T12:00:00Z",
      "driftAction": "Synced",
      "vmState": "Running"
    },
    "tags": {
      "name1": "val1"
    }
  },
  "zones": [
    "1"
  ]
}

Définitions

Nom	Description
AgentPoolArtifactStreamingProfile	Profil de streaming d’artefacts pour le pool d’agents.
AgentPoolMode	Mode d’un pool d’agents. Un cluster doit avoir au moins un pool d’agents « Système » à tout moment. Pour plus d’informations sur les restrictions de pool d’agents et les meilleures pratiques, consultez : https://docs.microsoft.com/azure/aks/use-system-pools
AgentPoolSSHAccess	Méthode d’accès SSH d’un pool d’agents.
AgentPoolWindowsProfile	Profil spécifique du pool d’agents Windows.
createdByType	Type d’identité qui a créé la ressource.
DriftAction	L’action de dérive de la machine. Indique si une machine s’est écartée de son état attendu en raison de modifications apportées aux propriétés du cluster géré, nécessitant une action corrective.
DriverType	Spécifiez le type de pilote GPU à installer lors de la création de pools d’agents Windows. S’il n’est pas fourni, AKS sélectionne le pilote en fonction de la compatibilité du système. Cela ne peut pas être modifié une fois que AgentPool a été créé. Cela ne peut pas être défini sur Les pools d’agents Linux. Pour Linux AgentPools, le pilote est sélectionné en fonction de la compatibilité du système.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
GPUDriver	Indique s’il faut installer des pilotes GPU. Quand elle n’est pas spécifiée, la valeur par défaut est Install.
GPUInstanceProfile	GPUInstanceProfile à utiliser pour spécifier le profil d’instance GPU MIG pour la référence SKU de machine virtuelle GPU prise en charge.
GPUProfile	Paramètres GPU pour le pool d’agents.
IPFamily	Pour déterminer si l’adresse appartient à la famille IPv4 ou IPv6
IPTag	Contient l’IPTag associé à l’objet.
KubeletConfig	Configurations Kubelet des nœuds d’agent. Pour plus d’informations, consultez de configuration de nœud personnalisée AKS.
KubeletDiskType	Détermine le placement des volumes vides de Dir, de la racine de données à l’exécution du conteneur, et du storage éphémère Kubelet.
LinuxOSConfig	Configurations du système d’exploitation des nœuds d’agent Linux. Pour plus d’informations, consultez de configuration de nœud personnalisée AKS.
LocalDNSForwardDestination	Serveur de destination pour les requêtes DNS à transmettre à partir de localDNS.
LocalDNSForwardPolicy	Stratégie de transfert pour la sélection du serveur DNS en amont. Voir le plug-in de transfert pour plus d’informations.
LocalDNSMode	Mode d’activation pour localDNS.
LocalDNSOverride	Remplacements pour le profil localDNS.
LocalDNSProfile	Configure le DNS local par nœud, avec les remplacements VnetDNS et KubeDNS. LocalDNS permet d’améliorer les performances et la fiabilité de la résolution DNS dans un cluster AKS. Pour plus de détails, consultez aka.ms/aks/localdns.
LocalDNSProtocol	Appliquez TCP ou préférez le protocole UDP pour les connexions de localDNS au serveur DNS en amont.
LocalDNSQueryLogging	Niveau de journalisation des requêtes DNS dans localDNS.
LocalDNSServeStale	Politique de diffusion des données obsolètes. Voir le plugin de cache pour plus d’informations.
LocalDNSState	État généré par le système de localDNS.
Machine	Une machine. Contient des détails sur la machine virtuelle sous-jacente. Une machine peut être visible ici, mais pas dans les nœuds kubectl get ; si tel est le cas, cela peut être dû au fait que la machine n’a pas encore été inscrite auprès du serveur d’API Kubernetes.
MachineBillingProfile	Les propriétés concernent la facturation des machines.
MachineHardwareProfile	Les paramètres matériels et GPU de la machine.
MachineIpAddress	Détails de l’adresse IP de l’ordinateur.
MachineKubernetesProfile	Les configurations Kubernetes utilisées par la machine.
MachineNetworkProperties	propriétés réseau de l’ordinateur
MachineOSProfile	Le système d’exploitation et le disque utilisés par la machine.
MachineOSProfileLinuxProfile	Le profil spécifique de la machine Linux.
MachineProperties	Propriétés de l’ordinateur
MachineSecurityProfile	Les paramètres de sécurité de la machine.
MachineStatus	Contient des informations en lecture seule sur la machine.
ManagementMode	L’expérience GPU gérée installe des composants supplémentaires, tels que les métriques Data Center GPU Manager (DCGM) pour la surveillance, en plus du pilote GPU pour vous. Pour plus de détails sur ce qui est installé, consultez aka.ms/aks/managed-gpu.
MigStrategy	Définit la stratégie MIG (GPU Multi-Instance) qui sera utilisée pour la prise en charge du MIG géré. Pour plus d’informations sur les différentes stratégies, rendez-vous sur aka.ms/aks/managed-gpu. Lorsque ce n’est pas spécifié, le défaut est Aucun.
NvidiaGPUProfile	Réglages GPU spécifiques à NVIDIA
OSDiskType	Type de disque du système d’exploitation à utiliser pour les machines du pool d’agents. La valeur par défaut est « Éphémère » si la machine virtuelle la prend en charge et a un disque de cache supérieur à celui demandé d’OSDiskSizeGB. Sinon, la valeur par défaut est « Gérée ». Peut ne pas être modifié après la création. Pour plus d’informations, voir éphémère OS .
OSSKU	Spécifie la référence SKU du système d’exploitation utilisée par le pool d’agents. La valeur par défaut est Ubuntu si OSType est Linux. La valeur par défaut est Windows2019 quand Kubernetes <= 1.24 ou Windows2022 quand Kubernetes >= 1.25 si OSType est Windows.
OSType	Type de système d’exploitation. La valeur par défaut est Linux.
ScaleSetEvictionPolicy	Stratégie d’éviction du groupe de machines virtuelles identiques. La politique d’expulsion précise ce qui to do avec la VM lorsqu’elle est expulsée. La valeur par défaut est Supprimer. Pour plus d’informations sur l’expulsion, voir spot VMs
ScaleSetPriority	Priorité du groupe de machines virtuelles identiques.
SeccompDefault	Spécifie le profil seccomp par défaut appliqué à toutes les charges de travail. S’il n’est pas spécifié, « Non défini » est utilisé par défaut.
SysctlConfig	Paramètres Sysctl pour les nœuds d’agent Linux.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
VmState	État de la machine virtuelle. Indique l’état actuel de la machine virtuelle sous-jacente.
WorkloadRuntime	Détermine le type de charge de travail qu’un nœud peut exécuter.

AgentPoolArtifactStreamingProfile

Objet

Profil de streaming d’artefacts pour le pool d’agents.

Nom	Type	Description
enabled	boolean	Le streaming d’artefacts accélère le démarrage froid des conteneurs sur un nœud via le chargement d’images à la demande. Pour utiliser cette fonctionnalité, les images conteneur doivent également activer le streaming d’artefacts sur ACR. S’il n’est pas spécifié, la valeur par défaut est false.

AgentPoolMode

Énumération

Mode d’un pool d’agents. Un cluster doit avoir au moins un pool d’agents « Système » à tout moment. Pour plus d’informations sur les restrictions de pool d’agents et les meilleures pratiques, consultez : https://docs.microsoft.com/azure/aks/use-system-pools

Valeur	Description
System	Les pools d’agents système sont principalement destinés à l’hébergement de pods système critiques tels que CoreDNS et metrics-server. Les pools d’agents système osType doivent être Linux. La référence SKU de machine virtuelle des pools d’agents système doit avoir au moins 2 processeurs virtuels et 4 Go de mémoire.
User	Les pools d’agents utilisateurs sont principalement destinés à l’hébergement de vos pods d’application.
Gateway	Les pools d’agents de passerelle sont dédiés à la fourniture d’adresses IP de sortie statiques aux espaces. Pour plus d’informations, consultez https://aka.ms/aks/static-egress-gateway.
ManagedSystem	ManagedSystem est un pool système géré par AKS. Le pool évolue de manière dynamique en fonction de l’utilisation du cluster et dispose de fonctionnalités supplémentaires de surveillance et de réparation automatisées. Il ne peut y avoir qu’un seul pool ManagedSystem, et il est recommandé de supprimer tous les autres pools système pour une expérience optimale.
Machines	Les pools d’agents Machines sont dédiés à l’hébergement de machines. Seules des opérations limitées, telles que la création et la suppression, sont autorisées au niveau du pool. Veuillez utiliser les API de la machine pour gérer le cycle de vie complet de la machine.

AgentPoolSSHAccess

Énumération

Méthode d’accès SSH d’un pool d’agents.

Valeur	Description
LocalUser	Peut accéder à SSH sur le nœud en tant qu’utilisateur local à l’aide d’une clé privée.
Disabled	Le service SSH est désactivé sur le nœud.
EntraId	SSH vers nœud avec intégration EntraId. Vous trouverez plus d’informations sous https://aka.ms/aks/ssh/aad

AgentPoolWindowsProfile

Objet

Profil spécifique du pool d’agents Windows.

Nom	Type	Description
disableOutboundNat	boolean	Indique s’il faut désactiver OutboundNAT dans les nœuds Windows. La valeur par défaut est false. La nat sortante ne peut être désactivée que si le type de trafic sortant du cluster est une passerelle NAT et que le pool d’agents Windows n’a pas d’adresse IP publique de nœud activée.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

DriftAction

Énumération

L’action de dérive de la machine. Indique si une machine s’est écartée de son état attendu en raison de modifications apportées aux propriétés du cluster géré, nécessitant une action corrective.

Valeur	Description
Synced	La machine est à la pointe de la technologie.
Recreate	La machine a dérivé et doit être supprimée et recréée.

DriverType

Énumération

Spécifiez le type de pilote GPU à installer lors de la création de pools d’agents Windows. S’il n’est pas fourni, AKS sélectionne le pilote en fonction de la compatibilité du système. Cela ne peut pas être modifié une fois que AgentPool a été créé. Cela ne peut pas être défini sur Les pools d’agents Linux. Pour Linux AgentPools, le pilote est sélectionné en fonction de la compatibilité du système.

Valeur	Description
GRID	Installez le pilote GRID pour le GPU, adapté aux applications nécessitant la prise en charge de la virtualisation.
CUDA	Installez le pilote CUDA pour le GPU, optimisé pour les tâches de calcul dans le calcul scientifique et les applications à forte intensité de données.

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

GPUDriver

Énumération

Indique s’il faut installer des pilotes GPU. Quand elle n’est pas spécifiée, la valeur par défaut est Install.

Valeur	Description
Install	Installez le pilote.
None	Ignorez l’installation du pilote.

GPUInstanceProfile

Énumération

GPUInstanceProfile à utiliser pour spécifier le profil d’instance GPU MIG pour la référence SKU de machine virtuelle GPU prise en charge.

Valeur	Description
MIG1g	Profil d’instance GPU MIG 1g.
MIG2g	Profil d’instance GPU MIG 2g.
MIG3g	Profil d’instance GPU MIG 3g.
MIG4g	Profil d’instance GPU MIG 4G.
MIG7g	Profil d’instance GPU MIG 7g.

GPUProfile

Objet

Paramètres GPU pour le pool d’agents.

Nom	Type	Description
driver	GPUDriver	Indique s’il faut installer des pilotes GPU. Quand elle n’est pas spécifiée, la valeur par défaut est Install.
driverType	DriverType	Spécifiez le type de pilote GPU à installer lors de la création de pools d’agents Windows. S’il n’est pas fourni, AKS sélectionne le pilote en fonction de la compatibilité du système. Cela ne peut pas être modifié une fois que AgentPool a été créé. Cela ne peut pas être défini sur Les pools d’agents Linux. Pour Linux AgentPools, le pilote est sélectionné en fonction de la compatibilité du système.
nvidia	NvidiaGPUProfile	Paramètres GPU spécifiques à NVIDIA.

IPFamily

Énumération

Pour déterminer si l’adresse appartient à la famille IPv4 ou IPv6

Valeur	Description
IPv4	Famille IPv4
IPv6	Famille IPv6

IPTag

Objet

Contient l’IPTag associé à l’objet.

Nom	Type	Description
ipTagType	string	Type d’étiquette IP. Exemple : RoutingPreference.
tag	string	Valeur de la balise IP associée à l’adresse IP publique. Exemple : Internet.

KubeletConfig

Objet

Configurations Kubelet des nœuds d’agent. Pour plus d’informations, consultez de configuration de nœud personnalisée AKS.

Nom	Type	Description
allowedUnsafeSysctls	string[]	Liste autorisée de sysctls non sécurisés ou de modèles sysctl non sécurisés (se terminant par `*`).
containerLogMaxFiles	integer (int32) minimum: 2	Nombre maximal de fichiers journaux de conteneur pouvant être présents pour un conteneur. Le nombre doit être ≥ 2.
containerLogMaxSizeMB	integer (int32)	Taille maximale (par exemple, 10Mi) du fichier journal conteneur avant sa rotation.
cpuCfsQuota	boolean	Si l’application du quota CFS du processeur est activée pour les conteneurs qui spécifient des limites d’UC. La valeur par défaut est true.
cpuCfsQuotaPeriod	string	Valeur de la période de quota CFS du processeur. La valeur par défaut est « 100ms ». Les valeurs valides sont une séquence de nombres décimaux avec une fraction facultative et un suffixe d’unité. Par exemple : « 300ms », « 2h45m ». Les unités prises en charge sont « ns », « us », « ms », « s », « m » et « h ».
cpuManagerPolicy	string	Stratégie du Gestionnaire d’UC à utiliser. La valeur par défaut est « none ». Pour plus d’informations, consultez les stratégies de gestion du processeur Kubernetes . Les valeurs autorisées sont « none » et « static ».
failSwapOn	boolean	Si la valeur est true, kubelet ne démarre pas si l’échange est activé sur le nœud.
imageGcHighThreshold	integer (int32)	Pourcentage d’utilisation du disque après laquelle le garbage collection d’images est toujours exécuté. Pour désactiver le garbage collection d’images, définissez sur 100. La valeur par défaut est 85%
imageGcLowThreshold	integer (int32)	Pourcentage d’utilisation du disque avant laquelle le garbage collection d’images n’est jamais exécuté. Cela ne peut pas être défini plus haut que imageGcHighThreshold. La valeur par défaut est 80%
podMaxPids	integer (int32)	Nombre maximal de processus par pod.
seccompDefault	SeccompDefault	Spécifie le profil seccomp par défaut appliqué à toutes les charges de travail. S’il n’est pas spécifié, « Non défini » est utilisé par défaut.
topologyManagerPolicy	string	Stratégie du Gestionnaire de topologie à utiliser. Pour plus d’informations, consultez le Gestionnaire de topologie Kubernetes. La valeur par défaut est « none ». Les valeurs autorisées sont « none », « best-effort », « restricted » et « single-numa-node ».

KubeletDiskType

Énumération

Détermine le placement des volumes vides de Dir, de la racine de données à l’exécution du conteneur, et du storage éphémère Kubelet.

Valeur	Description
OS	Kubelet utilisera le disque du système d’exploitation pour ses données.
Temporary	Kubelet utilisera le disque temporaire pour ses données.

LinuxOSConfig

Objet

Configurations du système d’exploitation des nœuds d’agent Linux. Pour plus d’informations, consultez de configuration de nœud personnalisée AKS.

Nom	Type	Description
swapFileSizeMB	integer (int32)	Taille en Mo d’un fichier d’échange qui sera créé sur chaque nœud.
sysctls	SysctlConfig	Paramètres Sysctl pour les nœuds d’agent Linux.
transparentHugePageDefrag	string	Indique si le noyau doit utiliser agressivement le compactage de la mémoire pour rendre plus énormes pages disponibles. Les valeurs valides sont « always », « defer », « defer+madvise », « madvise » et « never ». La valeur par défaut est « madvise ». Pour plus d’informations, consultez Transparent Hugepages.
transparentHugePageEnabled	string	Indique si les énormes pages transparentes sont activées. Les valeurs valides sont « always », « madvise » et « never ». La valeur par défaut est « always ». Pour plus d’informations, consultez Transparent Hugepages.

LocalDNSForwardDestination

Énumération

Serveur de destination pour les requêtes DNS à transmettre à partir de localDNS.

Valeur	Description
ClusterCoreDNS	Transférez les requêtes DNS de localDNS vers le cluster CoreDNS.
VnetDNS	Transférez les requêtes DNS de localDNS vers le serveur DNS configuré dans le réseau virtuel. Un réseau virtuel peut avoir plusieurs serveurs DNS configurés.

LocalDNSForwardPolicy

Énumération

Stratégie de transfert pour la sélection du serveur DNS en amont. Voir le plug-in de transfert pour plus d’informations.

Valeur	Description
Sequential	Implémente la sélection séquentielle du serveur DNS en amont. Voir le plug-in de transfert pour plus d’informations.
RoundRobin	Implémente la sélection de serveur DNS en amont par tourniquet. Voir le plug-in de transfert pour plus d’informations.
Random	Implémente la sélection aléatoire du serveur DNS en amont. Voir le plug-in de transfert pour plus d’informations.

LocalDNSMode

Énumération

Mode d’activation pour localDNS.

Valeur	Description
Preferred	Si la version actuelle d’Orchestrator prend en charge cette fonctionnalité, préférez l’activation de localDNS.
Required	Activez localDNS.
Disabled	Désactivez localDNS.

LocalDNSOverride

Objet

Remplacements pour le profil localDNS.

Nom	Type	Valeur par défaut	Description
cacheDurationInSeconds	integer (int32)	3600	Cache TTL max en secondes. Voir le plugin de cache pour plus d’informations.
forwardDestination	LocalDNSForwardDestination	ClusterCoreDNS	Serveur de destination pour les requêtes DNS à transmettre à partir de localDNS.
forwardPolicy	LocalDNSForwardPolicy	Sequential	Stratégie de transfert pour la sélection du serveur DNS en amont. Voir le plug-in de transfert pour plus d’informations.
maxConcurrent	integer (int32)	1000	Nombre maximal de requêtes simultanées. Voir le plug-in de transfert pour plus d’informations.
protocol	LocalDNSProtocol	PreferUDP	Appliquez TCP ou préférez le protocole UDP pour les connexions de localDNS au serveur DNS en amont.
queryLogging	LocalDNSQueryLogging	Error	Niveau de journalisation des requêtes DNS dans localDNS.
serveStale	LocalDNSServeStale	Immediate	Politique de diffusion des données obsolètes. Voir le plugin de cache pour plus d’informations.
serveStaleDurationInSeconds	integer (int32)	3600	Servir la durée périmée en quelques secondes. Voir le plugin de cache pour plus d’informations.

LocalDNSProfile

Objet

Configure le DNS local par nœud, avec les remplacements VnetDNS et KubeDNS. LocalDNS permet d’améliorer les performances et la fiabilité de la résolution DNS dans un cluster AKS. Pour plus de détails, consultez aka.ms/aks/localdns.

Nom	Type	Valeur par défaut	Description
kubeDNSOverrides	<string, LocalDNSOverride>		Les remplacements KubeDNS s’appliquent au trafic DNS des pods avec dnsPolicy :ClusterFirst (appelé trafic KubeDNS).
mode	LocalDNSMode	Preferred	Mode d’activation pour localDNS.
state	LocalDNSState		État généré par le système de localDNS.
vnetDNSOverrides	<string, LocalDNSOverride>		Les remplacements VnetDNS s’appliquent au trafic DNS des pods avec dnsPolicy :default ou kubelet (appelé trafic VnetDNS).

LocalDNSProtocol

Énumération

Appliquez TCP ou préférez le protocole UDP pour les connexions de localDNS au serveur DNS en amont.

Valeur	Description
PreferUDP	Préférez le protocole UDP pour les connexions de localDNS au serveur DNS en amont.
ForceTCP	Appliquez le protocole TCP pour les connexions de localDNS vers le serveur DNS en amont.

LocalDNSQueryLogging

Énumération

Niveau de journalisation des requêtes DNS dans localDNS.

Valeur	Description
Error	Active la journalisation des erreurs dans localDNS. Voir le plugin d’erreurs pour plus d’informations.
Log	Active l’enregistrement des requêtes dans localDNS. Voir le plugin de journal pour plus d’informations.

LocalDNSServeStale

Énumération

Politique de diffusion des données obsolètes. Voir le plugin de cache pour plus d’informations.

Valeur	Description
Verify	Diffusez des données obsolètes avec vérification. Vérifiez d’abord qu’une entrée est toujours indisponible à partir de la source avant d’envoyer l’entrée expirée au client. Voir le plugin de cache pour plus d’informations.
Immediate	Diffusez immédiatement les données obsolètes. Envoyez l’entrée expirée au client avant de vérifier si l’entrée est disponible à partir de la source. Voir le plugin de cache pour plus d’informations.
Disable	Désactiver la diffusion des données obsolètes.

LocalDNSState

Énumération

État généré par le système de localDNS.

Valeur	Description
Enabled	localDNS est activé.
Disabled	localDNS est désactivé.

Machine

Objet

Une machine. Contient des détails sur la machine virtuelle sous-jacente. Une machine peut être visible ici, mais pas dans les nœuds kubectl get ; si tel est le cas, cela peut être dû au fait que la machine n’a pas encore été inscrite auprès du serveur d’API Kubernetes.

Nom	Type	Description
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
name	string	Nom de la ressource
properties	MachineProperties	Propriétés de l’ordinateur
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »
zones	string[]	Zone de disponibilité dans laquelle se trouve la machine.

MachineBillingProfile

Objet

Les propriétés concernent la facturation des machines.

Nom	Type	Valeur par défaut	Description
spotMaxPrice	number (float)	-1	Le prix maximal (en dollars AMÉRICAINs) que vous êtes prêt à payer pour les instances spot. Les valeurs possibles sont toutes les valeurs décimales supérieures à zéro ou -1 qui indiquent le prix par défaut up-to à la demande. Pour plus de détails sur les prix au moment, voir c0

MachineHardwareProfile

Objet

Les paramètres matériels et GPU de la machine.

Nom	Type	Description
gpuInstanceProfile	GPUInstanceProfile	GPUInstanceProfile à utiliser pour spécifier le profil d’instance GPU MIG pour la référence SKU de machine virtuelle GPU prise en charge.
gpuProfile	GPUProfile	Les paramètres GPU de la machine.
ultraSsdEnabled	boolean	Indique s’il faut activer UltraSSD
vmSize	string	Taille de la machine virtuelle. La disponibilité de la taille des machines virtuelles varie selon la région. Si un nœud contient des ressources de calcul insuffisantes (mémoire, processeur, etc.) les pods peuvent échouer à s’exécuter correctement. Pour plus d’informations sur les tailles de machine virtuelle restreintes, consultez : https://docs.microsoft.com/azure/aks/quotas-skus-regions

MachineIpAddress

Objet

Détails de l’adresse IP de l’ordinateur.

Nom	Type	Description
family	IPFamily	Pour déterminer si l’adresse appartient à la famille IPv4 ou IPv6
ip	string	Adresse IPv4 ou IPv6 de la machine

MachineKubernetesProfile

Objet

Les configurations Kubernetes utilisées par la machine.

Nom	Type	Description
artifactStreamingProfile	AgentPoolArtifactStreamingProfile	Configuration pour l’utilisation de la diffusion en continu d’artefacts sur AKS.
currentOrchestratorVersion	string	Version de Kubernetes exécutée sur la machine. Si orchestratorVersion était une version entièrement spécifiée major.minor.patch<>, ce champ sera exactement égal à celui-ci. Si orchestratorVersion était <major.minor>, ce champ contiendra la version complète <de major.minor.patch> utilisée.
kubeletConfig	KubeletConfig	La configuration Kubelet sur la machine.
kubeletDiskType	KubeletDiskType	Détermine le placement des volumes vides de Dir, de la racine de données à l’exécution du conteneur, et du storage éphémère Kubelet.
maxPods	integer (int32)	Nombre maximal de pods qui peuvent s’exécuter sur un nœud.
nodeInitializationTaints	string[]	Teintes ajoutées sur le nœud lors de la création qui ne seront pas réconciliées par AKS. Ces teintes ne seront pas réconciliées par AKS et peuvent être supprimées avec un appel kubectl. Ces teintes permettent l’exécution de la configuration requise avant que le nœud soit prêt à accepter des charges de travail, par exemple « key1=value1 :NoSchedule » qui peut ensuite être supprimé avec `kubectl taint nodes node1 key1=value1:NoSchedule-`
nodeLabels	object	Les étiquettes de nœud sur la machine.
nodeName	string	Nom du nœud dans le cluster Kubernetes.
nodeTaints	string[]	Les taches ajoutées au nouveau nœud lors de la création de la machine. Par exemple, key=value :NoSchedule.
orchestratorVersion	string	Version de Kubernetes spécifiée par l’utilisateur. Les deux versions correctives <major.minor.patch> et <major.minor> sont prises en charge. Lorsque <major.minor> est spécifié, la dernière version de correctif prise en charge est choisie automatiquement.
workloadRuntime	WorkloadRuntime	Détermine le type de charge de travail qu’un nœud peut exécuter.

MachineNetworkProperties

Objet

propriétés réseau de l’ordinateur

Nom	Type	Description
enableNodePublicIP	boolean	Si la machine se voit attribuer sa propre adresse IP publique. Dans certains scénarios, il peut être nécessaire que la machine reçoive ses propres adresses IP publiques dédiées. Un scénario courant concerne les charges de travail de jeu, où une console doit établir une connexion directe à une machine virtuelle cloud afin de réduire les tronçons. La valeur par défaut est false.
ipAddresses	MachineIpAddress[]	Adresses IPv4, IPv6 de la machine
nodePublicIPPrefixID	string (arm-id)	ID de préfixe d’adresse IP publique à partir duquel le nœud de machine virtuelle doit utiliser les adresses IP. Il s’agit de la forme suivante : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
nodePublicIPTags	IPTag[]	IPTags d’adresses IP publiques au niveau de l’instance.
podSubnetID	string (arm-id)	ID du sous-réseau auquel les pods seront joints lors du lancement. En cas d’omission, les adresses IP de pod sont affectées statiquement sur le sous-réseau de nœud (voir vnetSubnetID pour plus d’informations). Il s’agit de la forme suivante : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
vnetSubnetID	string (arm-id)	ID du sous-réseau auquel le nœud et éventuellement les pods se joindront au démarrage. Si ce n’est pas spécifié, un réseau virtuel et un sous-réseau sont générés et utilisés. Si aucun podSubnetID n’est spécifié, cela s’applique aux nœuds et aux pods, sinon il s’applique uniquement aux nœuds. Il s’agit de la forme suivante : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

MachineOSProfile

Objet

Le système d’exploitation et le disque utilisés par la machine.

Nom	Type	Valeur par défaut	Description
enableFIPS	boolean		Indique s’il faut utiliser un système d’exploitation compatible FIPS.
linuxProfile	MachineOSProfileLinuxProfile		Le profil spécifique de la machine Linux.
osDiskSizeGB	integer (int32) minimum: 0 maximum: 2048		Taille du disque du système d’exploitation en Go à utiliser pour spécifier la taille du disque pour chaque ordinateur du pool maître/agent. Si vous spécifiez 0, elle applique la taille osDisk par défaut en fonction de vmSize spécifiée.
osDiskType	OSDiskType		Type de disque du système d’exploitation à utiliser pour les machines du pool d’agents. La valeur par défaut est « Éphémère » si la machine virtuelle la prend en charge et a un disque de cache supérieur à celui demandé d’OSDiskSizeGB. Sinon, la valeur par défaut est « Gérée ». Peut ne pas être modifié après la création. Pour plus d’informations, voir éphémère OS .
osSKU	OSSKU		Spécifie la référence SKU du système d’exploitation utilisée par le pool d’agents. Si ce n’est pas spécifié, la valeur par défaut est Ubuntu si OSType=Linux ou Windows2019 si OSType=Windows. Et la référence WINDOWS OSSKU par défaut sera remplacée par Windows2022 après la dépréciation de Windows2019.
osType	OSType	Linux	Type de système d’exploitation. La valeur par défaut est Linux.
windowsProfile	AgentPoolWindowsProfile		Profil spécifique de la machine Windows.

MachineOSProfileLinuxProfile

Objet

Le profil spécifique de la machine Linux.

Nom	Type	Description
linuxOSConfig	LinuxOSConfig	La configuration du système d’exploitation de la machine Linux.
messageOfTheDay	string	Message du jour pour les nœuds Linux, encodés en base64. Chaîne encodée en base64 qui sera écrite dans /etc/motd après le décodage. Cela permet la personnalisation du message du jour pour les nœuds Linux. Il ne doit pas être spécifié pour les nœuds Windows. Il doit s’agir d’une chaîne statique (c’est-à-dire d’impression brute et non exécutée en tant que script).

MachineProperties

Objet

Propriétés de l’ordinateur

Nom	Type	Valeur par défaut	Description
billing	MachineBillingProfile		Les propriétés concernent la facturation des machines.
eTag	string		Chaîne en lecture seule unique utilisée pour implémenter l’accès concurrentiel optimiste. La valeur eTag change lorsque la ressource est mise à jour. Spécifiez un en-tête if-match ou if-none-match avec la valeur eTag pour une demande ultérieure afin d’activer la simultanéité optimiste conformément à la convention eTag normale.
evictionPolicy	ScaleSetEvictionPolicy	Delete	La politique d’expulsion pour la machine. Cela ne peut être spécifié que si la priorité est « Spot ». S’il n’est pas spécifié, la valeur par défaut est « Supprimer ».
hardware	MachineHardwareProfile		Les paramètres matériels et GPU de la machine.
kubernetes	MachineKubernetesProfile		Les configurations Kubernetes utilisées par la machine.
localDNSProfile	LocalDNSProfile		Configure le DNS local par nœud, avec les remplacements VnetDNS et KubeDNS. LocalDNS permet d’améliorer les performances et la fiabilité de la résolution DNS dans un cluster AKS. Pour plus de détails, consultez aka.ms/aks/localdns.
mode	AgentPoolMode		La machine n’autorise que les modes « Système » et « Utilisateur ».
network	MachineNetworkProperties		propriétés réseau de l’ordinateur
nodeImageVersion	string		Version de l’image de nœud.
operatingSystem	MachineOSProfile		Le système d’exploitation et le disque utilisés par la machine.
priority	ScaleSetPriority	Regular	La priorité pour la machine. S’il n’est pas spécifié, la valeur par défaut est « Standard ».
provisioningState	string		État actuel du déploiement ou de l’approvisionnement.
resourceId	string (arm-id)		ID de ressource Azure de la machine. Il peut être utilisé pour GET l’instance de machine virtuelle sous-jacente
security	MachineSecurityProfile		Les paramètres de sécurité de la machine.
status	MachineStatus		Contient des informations en lecture seule sur la machine.
tags	object		Les balises à conserver sur l’ordinateur.

MachineSecurityProfile

Objet

Les paramètres de sécurité de la machine.

Nom	Type	Description
enableEncryptionAtHost	boolean	Indique s’il faut activer le chiffrement du système d’exploitation et du lecteur de données basés sur l’hôte. Cela n’est pris en charge que sur certaines tailles de VM et dans certaines régions Azure. Pour plus d’informations, consultez : https://docs.microsoft.com/azure/aks/enable-host-encryption
enableSecureBoot	boolean	Le démarrage sécurisé est une fonctionnalité de lancement approuvé qui garantit que seuls les systèmes d’exploitation signés et les pilotes peuvent démarrer. Pour plus d’informations, consultez aka.ms/aks/trustedlaunch. S’il n’est pas spécifié, la valeur par défaut est false.
enableVTPM	boolean	vTPM est une fonctionnalité de lancement approuvé permettant de configurer un coffre sécurisé dédié pour les clés et les mesures conservées localement sur le nœud. Pour plus d’informations, consultez aka.ms/aks/trustedlaunch. S’il n’est pas spécifié, la valeur par défaut est false.
sshAccess	AgentPoolSSHAccess	Méthode d’accès SSH d’un pool d’agents.

MachineStatus

Objet

Contient des informations en lecture seule sur la machine.

Nom	Type	Description
creationTimestamp	string (date-time)	Spécifie l’heure de création de la machine.
driftAction	DriftAction	L’action de dérive de la machine. Indique si une machine s’est écartée de son état attendu en raison de modifications apportées aux propriétés du cluster géré, nécessitant une action corrective.
driftReason	string	Raison de la dérive de la machine. Fournit des informations détaillées sur la raison pour laquelle la machine a dérivé. Ce champ est omis si la machine est à jour.
provisioningError	ErrorDetail	L’erreur détaille les informations de la machine. Préserve les informations détaillées de l’échec. S’il n’y a pas eu d’erreur, ce champ est omis.
vmState	VmState	État de la machine virtuelle. Indique l’état actuel de la machine virtuelle sous-jacente.

ManagementMode

Énumération

L’expérience GPU gérée installe des composants supplémentaires, tels que les métriques Data Center GPU Manager (DCGM) pour la surveillance, en plus du pilote GPU pour vous. Pour plus de détails sur ce qui est installé, consultez aka.ms/aks/managed-gpu.

Valeur	Description
Unmanaged	L’expérience GPU gérée est désactivée pour les GPU NVIDIA.
Managed	L’expérience GPU gérée est activée pour les GPU NVIDIA.

MigStrategy

Énumération

Définit la stratégie MIG (GPU Multi-Instance) qui sera utilisée pour la prise en charge du MIG géré. Pour plus d’informations sur les différentes stratégies, rendez-vous sur aka.ms/aks/managed-gpu. Lorsque ce n’est pas spécifié, le défaut est Aucun.

Valeur	Description
None	Ne définissez pas de stratégie MIG. Si vous en aviez déjà un configuré, cela le supprimera et supprimera la stratégie MIG du set.
Single	Définissez la stratégie MIG pour le MIG géré comme simple.
Mixed	Définissez la stratégie MIG pour le MIG géré comme mixte.

NvidiaGPUProfile

Objet

Réglages GPU spécifiques à NVIDIA

Nom	Type	Description
managementMode	ManagementMode	L’expérience GPU gérée installe des composants supplémentaires, tels que les métriques Data Center GPU Manager (DCGM) pour la surveillance, en plus du pilote GPU pour vous. Pour plus de détails sur ce qui est installé, consultez aka.ms/aks/managed-gpu.
migStrategy	MigStrategy	Définit la stratégie MIG (GPU Multi-Instance) qui sera utilisée pour la prise en charge du MIG géré. Pour plus d’informations sur les différentes stratégies, rendez-vous sur aka.ms/aks/managed-gpu. Lorsque ce n’est pas spécifié, le défaut est Aucun.

OSDiskType

Énumération

Type de disque du système d’exploitation à utiliser pour les machines du pool d’agents. La valeur par défaut est « Éphémère » si la machine virtuelle la prend en charge et a un disque de cache supérieur à celui demandé d’OSDiskSizeGB. Sinon, la valeur par défaut est « Gérée ». Peut ne pas être modifié après la création. Pour plus d’informations, voir éphémère OS .

Valeur	Description
Managed	Azure réplique le disque du système d’exploitation d’une machine virtuelle sur le stockage Azure afin d’éviter la perte de données si la machine virtuelle doit être déplacée vers un autre hôte. Étant donné que les conteneurs ne sont pas conçus pour conserver l’état local, ce comportement offre une valeur limitée tout en fournissant certains inconvénients, notamment l’approvisionnement de nœuds lent et une latence de lecture/écriture plus élevée.
Ephemeral	Les disques de système d’exploitation éphémères sont stockés uniquement sur la machine hôte, tout comme un disque temporaire. Cela fournit une latence de lecture/écriture inférieure, ainsi que des mises à niveau de nœud et de cluster plus rapides.

Valeur

Description

Managed

Azure réplique le disque du système d’exploitation d’une machine virtuelle sur le stockage Azure afin d’éviter la perte de données si la machine virtuelle doit être déplacée vers un autre hôte. Étant donné que les conteneurs ne sont pas conçus pour conserver l’état local, ce comportement offre une valeur limitée tout en fournissant certains inconvénients, notamment l’approvisionnement de nœuds lent et une latence de lecture/écriture plus élevée.

Ephemeral

Les disques de système d’exploitation éphémères sont stockés uniquement sur la machine hôte, tout comme un disque temporaire. Cela fournit une latence de lecture/écriture inférieure, ainsi que des mises à niveau de nœud et de cluster plus rapides.

OSSKU

Énumération

Spécifie la référence SKU du système d’exploitation utilisée par le pool d’agents. La valeur par défaut est Ubuntu si OSType est Linux. La valeur par défaut est Windows2019 quand Kubernetes <= 1.24 ou Windows2022 quand Kubernetes >= 1.25 si OSType est Windows.

Valeur	Description
Ubuntu	Utilisez Ubuntu comme système d’exploitation pour les images de nœud.
AzureLinux	Utilisez AzureLinux comme système d’exploitation pour les images de nœud. Azure Linux est une distribution Linux optimisée par conteneur créée par Microsoft, visitez https://aka.ms/azurelinux pour plus d’informations.
AzureLinux3	Utilisez AzureLinux3 comme système d’exploitation pour les images de nœud. Azure Linux est une distribution Linux optimisée par conteneur créée par Microsoft, visitez https://aka.ms/azurelinux pour plus d’informations. Pour connaître les limitations, visitez https://aka.ms/aks/node-images. Pour obtenir des conseils sur la migration du système d’exploitation, reportez-vous à la section https://aka.ms/aks/upgrade-os-version.
Mariner	Référence OSSKU déconseillée. Microsoft recommande que les nouveaux déploiements choisissent « AzureLinux » à la place.
Flatcar	Utilisez Flatcar Container Linux comme système d’exploitation pour les images de nœuds. Flatcar est un système d’exploitation Linux optimisé pour les conteneurs, axé sur la sécurité, doté d’un système de fichiers immuable et faisant partie de la Cloud Native Computing Foundation (CNCF). Pour plus d’informations sur Flatcar Container Linux pour AKS, consultez aka.ms/aks/flatcar-container-linux-for-aks
CBLMariner	Référence OSSKU déconseillée. Microsoft recommande que les nouveaux déploiements choisissent « AzureLinux » à la place.
Windows2019	Utilisez Windows2019 comme système d’exploitation pour les images de nœud. Non pris en charge pour les pools de nœuds système. Windows2019 prend uniquement en charge les conteneurs Windows2019 ; il ne peut pas exécuter les conteneurs Windows2022 et vice versa.
Windows2022	Utilisez Windows2022 comme système d’exploitation pour les images de nœud. Non pris en charge pour les pools de nœuds système. Windows2022 prend uniquement en charge les conteneurs Windows2022 ; il ne peut pas exécuter les conteneurs Windows2019 et vice versa.
Ubuntu2204	Utilisez Ubuntu2204 comme système d’exploitation pour les images de nœuds, cependant, Ubuntu 22.04 peut ne pas être pris en charge pour tous les pools de nœuds. Pour connaître les limitations et les versions de kubernetes prises en charge, consultez https://aka.ms/aks/supported-ubuntu-versions
Windows2025	Utilisez Windows2025 comme système d’exploitation pour les images de nœud. Non pris en charge pour les pools de nœuds système. Windows2025 prend en charge les conteneurs Windows2022 et Windows 2025 ; il ne peut pas exécuter les conteneurs Windows2019 et vice versa.
WindowsAnnual	Utilisez la version du canal annuel Windows comme système d’exploitation pour les images de nœud. Non pris en charge pour les pools de nœuds système. Des détails sur les images conteneur prises en charge et les versions kubernetes sous différentes versions de canal annuel AKS peuvent être vus dans https://aka.ms/aks/windows-annual-channel-details.
Ubuntu2404	Utilisez Ubuntu2404 comme système d’exploitation pour les images de nœuds, cependant, Ubuntu 24.04 peut ne pas être pris en charge pour tous les pools de nœuds. Pour connaître les limitations et les versions de Kubernetes prises en charge, consultez https://aka.ms/aks/supported-ubuntu-versions

OSType

Énumération

Type de système d’exploitation. La valeur par défaut est Linux.

Valeur	Description
Linux	Utilisez Linux.
Windows	Utilisez Windows.

ScaleSetEvictionPolicy

Énumération

Stratégie d’éviction du groupe de machines virtuelles identiques. La politique d’expulsion précise ce qui to do avec la VM lorsqu’elle est expulsée. La valeur par défaut est Supprimer. Pour plus d’informations sur l’expulsion, voir spot VMs

Valeur	Description
Delete	Les nœuds du groupe identique sous-jacent du pool de nœuds sont supprimés lorsqu’ils sont supprimés.
Deallocate	Les nœuds du groupe identique sous-jacent du pool de nœuds sont définis à l’état arrêté-désalloué lors de l’éviction. Les nœuds dans le nombre d’états désalloués arrêtés par rapport à votre quota de calcul peuvent entraîner des problèmes de mise à l’échelle ou de mise à niveau de cluster.

ScaleSetPriority

Énumération

Priorité du groupe de machines virtuelles identiques.

Valeur	Description
Spot	Des machines virtuelles prioritaires Spot seront utilisées. Il n’existe aucun contrat SLA pour les nœuds spot. Pour plus d’informations, consultez spot sur AKS.
Regular	Des machines virtuelles normales seront utilisées.

SeccompDefault

Énumération

Spécifie le profil seccomp par défaut appliqué à toutes les charges de travail. S’il n’est pas spécifié, « Non défini » est utilisé par défaut.

Valeur	Description
Unconfined	Aucun profil seccomp n’est appliqué, ce qui permet tous les appels système.
RuntimeDefault	Le profil seccomp par défaut pour l’exécution du conteneur est appliqué, ce qui limite certains appels système pour une sécurité renforcée.

SysctlConfig

Objet

Paramètres Sysctl pour les nœuds d’agent Linux.

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

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

VmState

Énumération

État de la machine virtuelle. Indique l’état actuel de la machine virtuelle sous-jacente.

Valeur	Description
Running	La machine virtuelle est en cours d’exécution.
Deleted	La machine virtuelle a été supprimée par l’utilisateur ou en raison d’une éviction ponctuelle.

WorkloadRuntime

Énumération

Détermine le type de charge de travail qu’un nœud peut exécuter.

Valeur	Description
OCIContainer	Les nœuds utilisent Kubelet pour exécuter des charges de travail de conteneur OCI standard.
WasmWasi	Les nœuds utilisent Krustlet pour exécuter des charges de travail WASM à l’aide du fournisseur WASI (préversion).
KataMshvVmIsolation	Les nœuds peuvent utiliser (Kata + Hypervisor cloud + Hyper-V) pour activer les pods imbriqués basés sur des machines virtuelles (préversion). En raison de l’utilisation d’Hyper-V, le système d’exploitation de nœud AKS lui-même est une machine virtuelle imbriquée (le système d’exploitation racine) d’Hyper-V. Il ne peut donc être utilisé qu’avec des séries de machines virtuelles qui prennent en charge la virtualisation imbriquée, comme la série Dv3. Cette convention de nommage sera dépréciée dans les futures versions en faveur de KataVmIsolation.
KataVmIsolation	Les nœuds peuvent utiliser (Kata + Cloud Hypervisor + Hyper-V) pour activer les pods basés sur des machines virtuelles imbriquées. En raison de l’utilisation d’Hyper-V, le système d’exploitation de nœud AKS lui-même est une machine virtuelle imbriquée (le système d’exploitation racine) d’Hyper-V. Il ne peut donc être utilisé qu’avec des séries de machines virtuelles qui prennent en charge la virtualisation imbriquée, comme la série Dv3.

Partager via

Machines - Create Or Update

Paramètres URI

En-tête de la demande

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

Create/Update Machine

Exemple de requête

Exemple de réponse

Définitions

AgentPoolArtifactStreamingProfile

AgentPoolMode

AgentPoolSSHAccess

AgentPoolWindowsProfile

createdByType

DriftAction

DriverType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GPUDriver

GPUInstanceProfile

GPUProfile

IPFamily

IPTag

KubeletConfig

KubeletDiskType

LinuxOSConfig

LocalDNSForwardDestination

LocalDNSForwardPolicy

LocalDNSMode

LocalDNSOverride

LocalDNSProfile

LocalDNSProtocol

LocalDNSQueryLogging

LocalDNSServeStale

LocalDNSState

Machine

MachineBillingProfile

MachineHardwareProfile

MachineIpAddress

MachineKubernetesProfile

MachineNetworkProperties

MachineOSProfile

MachineOSProfileLinuxProfile

MachineProperties

MachineSecurityProfile

MachineStatus

ManagementMode

MigStrategy

NvidiaGPUProfile

OSDiskType

OSSKU

OSType

ScaleSetEvictionPolicy

ScaleSetPriority

SeccompDefault

SysctlConfig

systemData

VmState

WorkloadRuntime