Partager via

Managed Clusters - Create Or Update

Service:
AKS
Version d'API:
2025-10-01

Crée ou met à jour un cluster géré.

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

Paramètres URI

Nom Dans Obligatoire Type Description
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 Obligatoire Type Description
location True

string

Emplacement géographique où réside la ressource
extendedLocation

ExtendedLocation

Emplacement étendu de la machine virtuelle.
identity

ManagedClusterIdentity

Identité du cluster managé, s’il est configuré.
kind

string

Ceci est principalement utilisé pour exposer différentes expériences d’interface utilisateur dans le portail pour différents types
properties.aadProfile

ManagedClusterAADProfile

Configuration d’Azure Active Directory.
properties.addonProfiles

<string,  ManagedClusterAddonProfile>

Profil du module complémentaire de cluster managé.
properties.agentPoolProfiles

ManagedClusterAgentPoolProfile[]

Propriétés du pool d’agents.
properties.aiToolchainOperatorProfile

ManagedClusterAIToolchainOperatorProfile

Paramètres de l’opérateur de chaîne d’outils IA qui s’appliquent à l’ensemble du cluster.
properties.apiServerAccessProfile

ManagedClusterAPIServerAccessProfile

Profil d’accès pour le serveur d’API de cluster managé.
properties.autoScalerProfile

AutoScalerProfile

Paramètres à appliquer à la mise à l’échelle automatique du cluster en cas d’activation
properties.autoUpgradeProfile

ManagedClusterAutoUpgradeProfile

Configuration de la mise à niveau automatique.
properties.azureMonitorProfile

ManagedClusterAzureMonitorProfile

Profils de complément Azure Monitor pour la surveillance du cluster managé.
properties.bootstrapProfile

ManagedClusterBootstrapProfile

Profil de la configuration de démarrage du cluster.
properties.disableLocalAccounts

boolean

Si les comptes locaux doivent être désactivés sur le cluster managé. Si la valeur est true, l’obtention d’informations d’identification statiques est désactivée pour ce cluster. Cela ne doit être utilisé que sur les clusters managés activés par AAD. Pour plus d’informations, consultez désactiver les comptes locaux.
properties.diskEncryptionSetID

string (arm-id)

ID de ressource du jeu de chiffrement de disque à utiliser pour activer le chiffrement au repos. Il s’agit de la forme suivante : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskEncryptionSets/{encryptionSetName} »
properties.dnsPrefix

string

Préfixe DNS du cluster managé. Cette opération ne peut pas être mise à jour une fois le cluster managé créé.
properties.enableRBAC

boolean

Indique s’il faut activer Kubernetes Role-Based contrôle d’accès.
properties.fqdnSubdomain

string

Sous-domaine du nom de domaine complet du cluster privé avec une zone dns privée personnalisée. Cette opération ne peut pas être mise à jour une fois le cluster managé créé.
properties.httpProxyConfig

ManagedClusterHTTPProxyConfig

Configurations pour l’approvisionnement du cluster avec des serveurs proxy HTTP.
properties.identityProfile

<string,  UserAssignedIdentity>

Identité de l’utilisateur associée au cluster managé. Cette identité sera utilisée par le kubelet. Une seule identité affectée par l’utilisateur est autorisée. La seule clé acceptée est « kubeletidentity », avec la valeur « resourceId » : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».
properties.ingressProfile

ManagedClusterIngressProfile

Profil d’entrée pour le cluster managé.
properties.kubernetesVersion

string

Version de Kubernetes spécifiée par l’utilisateur. Les deux versions de correctif <> major.minor.patch (par exemple, 1.20.13) et <> major.minor (par exemple, 1,20) sont prises en charge. Lorsque <> major.minor est spécifié, la dernière version de correctif ga prise en charge est choisie automatiquement. La mise à jour du cluster avec le même <major.minor> une fois qu’il a été créé (par exemple, 1.14.x -> 1.14) ne déclenche pas de mise à niveau, même si une version de correctif plus récente est disponible. Lorsque vous mettez à niveau un cluster AKS pris en charge, les versions mineures de Kubernetes ne peuvent pas être ignorées. Toutes les mises à niveau doivent être effectuées séquentiellement par numéro de version principal. Par exemple, les mises à niveau entre 1.14.x -> 1.15.x ou 1.15.x -> 1.16.x sont autorisées, mais 1.14.x -> 1.16.x n’est pas autorisée. Pour plus d’informations, consultez mise à niveau d’un cluster AKS.
properties.linuxProfile

ContainerServiceLinuxProfile

Profil pour les machines virtuelles Linux dans le cluster managé.
properties.metricsProfile

ManagedClusterMetricsProfile

Configuration facultative des métriques de cluster.
properties.networkProfile

ContainerServiceNetworkProfile

Profil de configuration réseau.
properties.nodeProvisioningProfile

ManagedClusterNodeProvisioningProfile

Paramètres d’approvisionnement de nœuds qui s’appliquent à l’ensemble du cluster.
properties.nodeResourceGroup

string

Nom du groupe de ressources contenant des nœuds de pool d’agents.
properties.nodeResourceGroupProfile

ManagedClusterNodeResourceGroupProfile

Profil de la configuration du groupe de ressources de nœud.
properties.oidcIssuerProfile

ManagedClusterOIDCIssuerProfile

Profil d’émetteur OIDC du cluster managé.
properties.podIdentityProfile

ManagedClusterPodIdentityProfile

Profil d’identité de pod du cluster managé. Consultez utiliser l’identité de pod AAD pour plus d’informations sur l’intégration des identités de pod AAD.
properties.privateLinkResources

PrivateLinkResource[]

Ressources de liaison privée associées au cluster.
properties.publicNetworkAccess

PublicNetworkAccess

PublicNetworkAccess du managedCluster. Autoriser ou refuser l’accès au réseau public pour AKS
properties.securityProfile

ManagedClusterSecurityProfile

Profil de sécurité pour le cluster managé.
properties.serviceMeshProfile

ServiceMeshProfile

Profil de maillage de service pour un cluster managé.
properties.servicePrincipalProfile

ManagedClusterServicePrincipalProfile

Informations sur une identité de principal de service pour le cluster à utiliser pour manipuler des API Azure.
properties.status

ManagedClusterStatus

Contient des informations en lecture seule sur le cluster managé.
properties.storageProfile

ManagedClusterStorageProfile

Profil de stockage pour le cluster managé.
properties.supportPlan

KubernetesSupportPlan

Plan de support pour le cluster managé. Si elle n’est pas spécifiée, la valeur par défaut est « KubernetesOfficial ».
properties.upgradeSettings

ClusterUpgradeSettings

Paramètres de mise à niveau d’un cluster.
properties.windowsProfile

ManagedClusterWindowsProfile

Profil des machines virtuelles Windows dans le cluster managé.
properties.workloadAutoScalerProfile

ManagedClusterWorkloadAutoScalerProfile

Profil de mise à l’échelle automatique de la charge de travail pour le cluster managé.
sku

ManagedClusterSKU

Référence SKU de cluster managé.
tags

object

Balises de ressource.

Réponses

Nom Type Description
200 OK

ManagedCluster

Le cluster géré existant a été mis à jour avec succès.
201 Created

ManagedCluster

Le nouveau cluster géré a été créé avec succès.
Other Status Codes

ErrorResponse

Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

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 Managed Cluster using an agent pool snapshot
Create Managed Cluster with AKS-managed NAT gateway as outbound type
Create Managed Cluster with Azure KeyVault Secrets Provider Addon
Create Managed Cluster with Capacity Reservation Group
Create Managed Cluster with Custom CA Trust Certificates
Create Managed Cluster with Dedicated Host Group
Create Managed Cluster with EncryptionAtHost enabled
Create Managed Cluster with FIPS enabled OS
Create Managed Cluster with GPUMIG
Create Managed Cluster with HTTP proxy configured
Create Managed Cluster with LongTermSupport
Create Managed Cluster with Node Public IP Prefix
Create Managed Cluster with OSSKU
Create Managed Cluster with PodIdentity enabled
Create Managed Cluster with PPG
Create Managed Cluster with RunCommand disabled
Create Managed Cluster with Security Profile configured
Create Managed Cluster with UltraSSD enabled
Create Managed Cluster with user-assigned NAT gateway as outbound type
Create Managed Cluster with Web App Routing Ingress Profile configured
Create Managed Private Cluster with fqdn subdomain specified
Create Managed Private Cluster with Public FQDN specified
Create/Update AAD Managed Cluster with EnableAzureRBAC
Create/Update Managed Cluster
Create/Update Managed Cluster with Azure Service Mesh
Create/Update Managed Cluster with dual-stack networking
Create/Update Managed Cluster with EnableAHUB
Create/Update Managed Cluster with Windows gMSA enabled

Create Managed Cluster using an agent pool snapshot

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableFIPS": true,
        "creationData": {
          "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
        }
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "enableFIPS": true,
        "creationData": {
          "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
        }
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableFIPS": true,
        "creationData": {
          "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
        }
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}

Create Managed Cluster with AKS-managed NAT gateway as outbound type

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": false,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "managedNATGateway",
      "natGatewayProfile": {
        "managedOutboundIPProfile": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": false,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "managedNATGateway",
      "natGatewayProfile": {
        "idleTimeoutInMinutes": 4,
        "managedOutboundIPProfile": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": false,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "managedNATGateway",
      "natGatewayProfile": {
        "idleTimeoutInMinutes": 4,
        "managedOutboundIPProfile": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}

Create Managed Cluster with Azure KeyVault Secrets Provider Addon

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {
      "azureKeyvaultSecretsProvider": {
        "enabled": true,
        "config": {
          "enableSecretRotation": "true",
          "rotationPollInterval": "2m"
        }
      }
    },
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "addonProfiles": {
      "azureKeyvaultSecretsProvider": {
        "enabled": true,
        "config": {
          "enableSecretRotation": "true",
          "rotationPollInterval": "2m"
        }
      }
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "addonProfiles": {
      "azureKeyvaultSecretsProvider": {
        "enabled": true,
        "config": {
          "enableSecretRotation": "true",
          "rotationPollInterval": "2m"
        }
      }
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}

Create Managed Cluster with Capacity Reservation Group

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/capacityReservationGroups/crg1"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/capacityReservationGroups/crg1"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/capacityReservationGroups/crg1"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}

Create Managed Cluster with Custom CA Trust Certificates

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "securityProfile": {
      "customCATrustCertificates": [
        "ZHVtbXlFeGFtcGxlVGVzdFZhbHVlRm9yQ2VydGlmaWNhdGVUb0JlQWRkZWQ="
      ]
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "securityProfile": {
      "customCATrustCertificates": [
        "ZHVtbXlFeGFtcGxlVGVzdFZhbHVlRm9yQ2VydGlmaWNhdGVUb0JlQWRkZWQ="
      ]
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "securityProfile": {
      "customCATrustCertificates": [
        "ZHVtbXlFeGFtcGxlVGVzdFZhbHVlRm9yQ2VydGlmaWNhdGVUb0JlQWRkZWQ="
      ]
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}

Create Managed Cluster with Dedicated Host Group

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}

Create Managed Cluster with EncryptionAtHost enabled

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}

Create Managed Cluster with FIPS enabled OS

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableFIPS": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "enableFIPS": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableFIPS": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}

Create Managed Cluster with GPUMIG

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_ND96asr_v4",
        "osType": "Linux",
        "gpuInstanceProfile": "MIG3g",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "httpProxyConfig": {
      "httpProxy": "http://myproxy.server.com:8080",
      "httpsProxy": "https://myproxy.server.com:8080",
      "noProxy": [
        "localhost",
        "127.0.0.1"
      ],
      "trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
    }
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_ND96asr_v4",
        "maxPods": 110,
        "osType": "Linux",
        "gpuInstanceProfile": "MIG3g",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "httpProxyConfig": {
      "httpProxy": "http://myproxy.server.com:8080",
      "httpsProxy": "https://myproxy.server.com:8080",
      "noProxy": [
        "localhost",
        "127.0.0.1"
      ],
      "trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_ND96asr_v4",
        "maxPods": 110,
        "osType": "Linux",
        "gpuInstanceProfile": "MIG3g",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "httpProxyConfig": {
      "httpProxy": "http://myproxy.server.com:8080",
      "httpsProxy": "https://myproxy.server.com:8080",
      "noProxy": [
        "localhost",
        "127.0.0.1"
      ],
      "trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
    }
  }
}

Create Managed Cluster with HTTP proxy configured

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "httpProxyConfig": {
      "httpProxy": "http://myproxy.server.com:8080",
      "httpsProxy": "https://myproxy.server.com:8080",
      "noProxy": [
        "localhost",
        "127.0.0.1"
      ],
      "trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
    }
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "httpProxyConfig": {
      "httpProxy": "http://myproxy.server.com:8080",
      "httpsProxy": "https://myproxy.server.com:8080",
      "noProxy": [
        "localhost",
        "127.0.0.1"
      ],
      "trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "httpProxyConfig": {
      "httpProxy": "http://myproxy.server.com:8080",
      "httpsProxy": "https://myproxy.server.com:8080",
      "noProxy": [
        "localhost",
        "127.0.0.1"
      ],
      "trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
    }
  }
}

Create Managed Cluster with LongTermSupport

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Base",
    "tier": "Premium"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "apiServerAccessProfile": {
      "disableRunCommand": true
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "supportPlan": "AKSLongTermSupport"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "sku": {
    "name": "Base",
    "tier": "Premium"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "apiServerAccessProfile": {
      "disableRunCommand": true
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "fqdn": "dnsprefix1-ee788a1f.hcp.location1.azmk8s.io",
    "privateFQDN": "dnsprefix1-aae7e0f0.5cef6058-b6b5-414d-8cb1-4bd14eb0b15c.privatelink.location1.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "supportPlan": "AKSLongTermSupport"
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "sku": {
    "name": "Base",
    "tier": "Premium"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "apiServerAccessProfile": {
      "disableRunCommand": true
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "fqdn": "dnsprefix1-ee788a1f.hcp.location1.azmk8s.io",
    "privateFQDN": "dnsprefix1-aae7e0f0.5cef6058-b6b5-414d-8cb1-4bd14eb0b15c.privatelink.location1.azmk8s.io",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "supportPlan": "AKSLongTermSupport"
  }
}

Create Managed Cluster with Node Public IP Prefix

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodePublicIPPrefixID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Network/publicIPPrefixes/public-ip-prefix"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "nodePublicIPPrefixID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Network/publicIPPrefixes/public-ip-prefix"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodePublicIPPrefixID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Network/publicIPPrefixes/public-ip-prefix"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}

Create Managed Cluster with OSSKU

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "osSKU": "AzureLinux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "httpProxyConfig": {
      "httpProxy": "http://myproxy.server.com:8080",
      "httpsProxy": "https://myproxy.server.com:8080",
      "noProxy": [
        "localhost",
        "127.0.0.1"
      ],
      "trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
    }
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "osSKU": "AzureLinux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "httpProxyConfig": {
      "httpProxy": "http://myproxy.server.com:8080",
      "httpsProxy": "https://myproxy.server.com:8080",
      "noProxy": [
        "localhost",
        "127.0.0.1"
      ],
      "trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "osSKU": "AzureLinux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "httpProxyConfig": {
      "httpProxy": "http://myproxy.server.com:8080",
      "httpsProxy": "https://myproxy.server.com:8080",
      "noProxy": [
        "localhost",
        "127.0.0.1"
      ],
      "trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
    }
  }
}

Create Managed Cluster with PodIdentity enabled

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "podIdentityProfile": {
      "enabled": true,
      "allowNetworkPluginKubenet": true
    }
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "podIdentityProfile": {
      "enabled": true,
      "allowNetworkPluginKubenet": true
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "podIdentityProfile": {
      "enabled": true,
      "allowNetworkPluginKubenet": true
    }
  }
}

Create Managed Cluster with PPG

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}

Create Managed Cluster with RunCommand disabled

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "apiServerAccessProfile": {
      "disableRunCommand": true
    },
    "addonProfiles": {},
    "enableRBAC": true
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "apiServerAccessProfile": {
      "disableRunCommand": true
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "fqdn": "dnsprefix1-ee788a1f.hcp.location1.azmk8s.io",
    "privateFQDN": "dnsprefix1-aae7e0f0.5cef6058-b6b5-414d-8cb1-4bd14eb0b15c.privatelink.location1.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "supportPlan": "KubernetesOfficial"
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "apiServerAccessProfile": {
      "disableRunCommand": true
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "fqdn": "dnsprefix1-ee788a1f.hcp.location1.azmk8s.io",
    "privateFQDN": "dnsprefix1-aae7e0f0.5cef6058-b6b5-414d-8cb1-4bd14eb0b15c.privatelink.location1.azmk8s.io",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "supportPlan": "KubernetesOfficial"
  }
}

Create Managed Cluster with Security Profile configured

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "securityProfile": {
      "defender": {
        "logAnalyticsWorkspaceResourceId": "/subscriptions/SUB_ID/resourcegroups/RG_NAME/providers/microsoft.operationalinsights/workspaces/WORKSPACE_NAME",
        "securityMonitoring": {
          "enabled": true
        }
      },
      "workloadIdentity": {
        "enabled": true
      }
    }
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "securityProfile": {
      "defender": {
        "logAnalyticsWorkspaceResourceId": "/subscriptions/SUB_ID/resourcegroups/RG_NAME/providers/microsoft.operationalinsights/workspaces/WORKSPACE_NAME",
        "securityMonitoring": {
          "enabled": true
        }
      },
      "workloadIdentity": {
        "enabled": true
      }
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "securityProfile": {
      "defender": {
        "logAnalyticsWorkspaceResourceId": "/subscriptions/SUB_ID/resourcegroups/RG_NAME/providers/microsoft.operationalinsights/workspaces/WORKSPACE_NAME",
        "securityMonitoring": {
          "enabled": true
        }
      },
      "workloadIdentity": {
        "enabled": true
      }
    }
  }
}

Create Managed Cluster with UltraSSD enabled

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableUltraSSD": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "enableUltraSSD": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableUltraSSD": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}

Create Managed Cluster with user-assigned NAT gateway as outbound type

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": false,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "userAssignedNATGateway"
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": false,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "userAssignedNATGateway"
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": false,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "userAssignedNATGateway"
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}

Create Managed Cluster with Web App Routing Ingress Profile configured

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "ingressProfile": {
      "webAppRouting": {
        "enabled": true,
        "dnsZoneResourceIds": [
          "/subscriptions/SUB_ID/resourceGroups/RG_NAME/providers/Microsoft.Network/dnszones/DNS_ZONE_NAME"
        ]
      }
    }
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "ingressProfile": {
      "webAppRouting": {
        "enabled": true,
        "dnsZoneResourceIds": [
          "/subscriptions/SUB_ID/resourceGroups/RG_NAME/providers/Microsoft.Network/dnszones/DNS_ZONE_NAME"
        ]
      }
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "ingressProfile": {
      "webAppRouting": {
        "enabled": true,
        "dnsZoneResourceIds": [
          "/subscriptions/SUB_ID/resourceGroups/RG_NAME/providers/Microsoft.Network/dnszones/DNS_ZONE_NAME"
        ]
      }
    }
  }
}

Create Managed Private Cluster with fqdn subdomain specified

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "fqdnSubdomain": "domain1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "apiServerAccessProfile": {
      "enablePrivateCluster": true,
      "privateDNSZone": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Network/privateDnsZones/privatelink.location1.azmk8s.io"
    },
    "addonProfiles": {},
    "enableRBAC": true
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "fqdnSubdomain": "domain1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "apiServerAccessProfile": {
      "enablePrivateCluster": true,
      "privateDNSZone": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Network/privateDnsZones/privatelink.location1.azmk8s.io"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "privateFQDN": "domain1.privatelink.location1.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "fqdnSubdomain": "domain1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "apiServerAccessProfile": {
      "enablePrivateCluster": true,
      "privateDNSZone": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Network/privateDnsZones/privatelink.location1.azmk8s.io"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "privateFQDN": "domain1.privatelink.location1.azmk8s.io",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}

Create Managed Private Cluster with Public FQDN specified

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "apiServerAccessProfile": {
      "enablePrivateCluster": true,
      "enablePrivateClusterPublicFQDN": true
    },
    "addonProfiles": {},
    "enableRBAC": true
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "apiServerAccessProfile": {
      "enablePrivateCluster": true,
      "enablePrivateClusterPublicFQDN": true,
      "privateDNSZone": "system"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "fqdn": "dnsprefix1-ee788a1f.hcp.location1.azmk8s.io",
    "privateFQDN": "dnsprefix1-aae7e0f0.5cef6058-b6b5-414d-8cb1-4bd14eb0b15c.privatelink.location1.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "apiServerAccessProfile": {
      "enablePrivateCluster": true,
      "enablePrivateClusterPublicFQDN": true,
      "privateDNSZone": "system"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "fqdn": "dnsprefix1-ee788a1f.hcp.location1.azmk8s.io",
    "privateFQDN": "dnsprefix1-aae7e0f0.5cef6058-b6b5-414d-8cb1-4bd14eb0b15c.privatelink.location1.azmk8s.io",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}

Create/Update AAD Managed Cluster with EnableAzureRBAC

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "availabilityZones": [
          "1",
          "2",
          "3"
        ],
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "aadProfile": {
      "managed": true,
      "enableAzureRBAC": true
    },
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "availabilityZones": [
          "1",
          "2",
          "3"
        ],
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "aadProfile": {
      "managed": true,
      "adminGroupObjectIDs": null,
      "enableAzureRBAC": true,
      "tenantID": "tenantID"
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "availabilityZones": [
          "1",
          "2",
          "3"
        ],
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "aadProfile": {
      "managed": true,
      "adminGroupObjectIDs": null,
      "enableAzureRBAC": true,
      "tenantID": "tenantID"
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  }
}

Create/Update Managed Cluster

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "scaleDownMode": "Deallocate",
        "availabilityZones": [
          "1",
          "2",
          "3"
        ],
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "upgradeSettings": {
      "overrideSettings": {
        "forceUpgrade": false,
        "until": "2022-11-01T13:00:00Z"
      }
    },
    "autoScalerProfile": {
      "balance-similar-node-groups": "true",
      "expander": "priority",
      "max-node-provision-time": "15m",
      "new-pod-scale-up-delay": "1m",
      "scale-down-delay-after-add": "15m",
      "scan-interval": "20s",
      "skip-nodes-with-system-pods": "false"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {}
    }
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "scaleDownMode": "Deallocate",
        "availabilityZones": [
          "1",
          "2",
          "3"
        ],
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "upgradeSettings": {
      "overrideSettings": {
        "forceUpgrade": false,
        "until": "2022-11-01T13:00:00Z"
      }
    },
    "autoScalerProfile": {
      "balance-similar-node-groups": "true",
      "expander": "priority",
      "max-node-provision-time": "15m",
      "new-pod-scale-up-delay": "1m",
      "scale-down-delay-after-add": "15m",
      "scan-interval": "20s",
      "skip-nodes-with-system-pods": "false"
    }
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
        "principalId": "principalId1",
        "clientId": "clientId1"
      }
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "scaleDownMode": "Deallocate",
        "availabilityZones": [
          "1",
          "2",
          "3"
        ],
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
        "principalId": "principalId1",
        "clientId": "clientId1"
      }
    }
  }
}

Create/Update Managed Cluster with Azure Service Mesh

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "serviceMeshProfile": {
      "mode": "Istio",
      "istio": {
        "components": {
          "ingressGateways": [
            {
              "enabled": true,
              "mode": "Internal"
            }
          ],
          "egressGateways": [
            {
              "enabled": true,
              "name": "test-istio-egress",
              "gatewayConfigurationName": "test-gateway-configuration"
            }
          ]
        },
        "certificateAuthority": {
          "plugin": {
            "keyVaultId": "/subscriptions/854c9ddb-fe9e-4aea-8d58-99ed88282881/resourceGroups/ddama-test/providers/Microsoft.KeyVault/vaults/my-akv",
            "certObjectName": "ca-cert",
            "keyObjectName": "ca-key",
            "rootCertObjectName": "root-cert",
            "certChainObjectName": "cert-chain"
          }
        }
      }
    },
    "addonProfiles": {
      "azureKeyvaultSecretsProvider": {
        "enabled": true,
        "config": {
          "enableSecretRotation": "true",
          "rotationPollInterval": "2m"
        }
      }
    },
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "addonProfiles": {
      "azureKeyvaultSecretsProvider": {
        "enabled": true,
        "config": {
          "enableSecretRotation": "true",
          "rotationPollInterval": "2m"
        }
      }
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "serviceMeshProfile": {
      "mode": "Istio",
      "istio": {
        "components": {
          "ingressGateways": [
            {
              "enabled": true,
              "mode": "Internal"
            }
          ],
          "egressGateways": [
            {
              "enabled": true,
              "name": "test-istio-egress",
              "gatewayConfigurationName": "test-gateway-configuration"
            }
          ]
        },
        "certificateAuthority": {
          "plugin": {
            "keyVaultId": "/subscriptions/854c9ddb-fe9e-4aea-8d58-99ed88282881/resourceGroups/ddama-test/providers/Microsoft.KeyVault/vaults/my-akv",
            "certObjectName": "ca-cert",
            "keyObjectName": "ca-key",
            "rootCertObjectName": "root-cert",
            "certChainObjectName": "cert-chain"
          }
        },
        "revisions": [
          "asm-1-17"
        ]
      }
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS2_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "enableNodePublicIP": true,
        "mode": "System",
        "enableEncryptionAtHost": true
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "addonProfiles": {
      "azureKeyvaultSecretsProvider": {
        "enabled": true,
        "config": {
          "enableSecretRotation": "true",
          "rotationPollInterval": "2m"
        }
      }
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "serviceMeshProfile": {
      "mode": "Istio",
      "istio": {
        "components": {
          "ingressGateways": [
            {
              "enabled": true,
              "mode": "Internal"
            }
          ],
          "egressGateways": [
            {
              "enabled": true,
              "name": "test-istio-egress",
              "gatewayConfigurationName": "test-gateway-configuration"
            }
          ]
        },
        "certificateAuthority": {
          "plugin": {
            "keyVaultId": "/subscriptions/854c9ddb-fe9e-4aea-8d58-99ed88282881/resourceGroups/ddama-test/providers/Microsoft.KeyVault/vaults/my-akv",
            "certObjectName": "ca-cert",
            "keyObjectName": "ca-key",
            "rootCertObjectName": "root-cert",
            "certChainObjectName": "cert-chain"
          }
        },
        "revisions": [
          "asm-1-17"
        ]
      }
    }
  }
}

Create/Update Managed Cluster with dual-stack networking

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "scaleDownMode": "Deallocate",
        "availabilityZones": [
          "1",
          "2",
          "3"
        ],
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      },
      "ipFamilies": [
        "IPv4",
        "IPv6"
      ]
    },
    "autoScalerProfile": {
      "balance-similar-node-groups": "true",
      "expander": "priority",
      "max-node-provision-time": "15m",
      "new-pod-scale-up-delay": "1m",
      "scale-down-delay-after-add": "15m",
      "scan-interval": "20s",
      "skip-nodes-with-system-pods": "false"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {}
    }
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.22.1",
    "currentKubernetesVersion": "1.22.1",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.22.1",
        "currentOrchestratorVersion": "1.22.1",
        "type": "VirtualMachineScaleSets",
        "scaleDownMode": "Deallocate",
        "availabilityZones": [
          "1",
          "2",
          "3"
        ],
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16",
        "fd11:1234::/64"
      ],
      "serviceCidrs": [
        "10.0.0.0/16",
        "fd00:1234::/108"
      ],
      "ipFamilies": [
        "IPv4",
        "IPv6"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2,
          "countIPv6": 1
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip3-ipv6"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "balance-similar-node-groups": "true",
      "expander": "priority",
      "max-node-provision-time": "15m",
      "new-pod-scale-up-delay": "1m",
      "scale-down-delay-after-add": "15m",
      "scan-interval": "20s",
      "skip-nodes-with-system-pods": "false"
    }
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
        "principalId": "principalId1",
        "clientId": "clientId1"
      }
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.22.1",
    "currentKubernetesVersion": "1.22.1",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.22.1",
        "currentOrchestratorVersion": "1.22.1",
        "type": "VirtualMachineScaleSets",
        "scaleDownMode": "Deallocate",
        "availabilityZones": [
          "1",
          "2",
          "3"
        ],
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16",
        "fd11:1234::/64"
      ],
      "serviceCidrs": [
        "10.0.0.0/16",
        "fd00:1234::/108"
      ],
      "ipFamilies": [
        "IPv4",
        "IPv6"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2,
          "countIPv6": 1
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip3-ipv6"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
        "principalId": "principalId1",
        "clientId": "clientId1"
      }
    }
  }
}

Create/Update Managed Cluster with EnableAHUB

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "availabilityZones": [
          "1",
          "2",
          "3"
        ],
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$",
      "licenseType": "Windows_Server"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {}
    }
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "availabilityZones": [
          "1",
          "2",
          "3"
        ],
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "licenseType": "Windows_Server"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
        "principalId": "principalId1",
        "clientId": "clientId1"
      }
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "availabilityZones": [
          "1",
          "2",
          "3"
        ],
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "licenseType": "Windows_Server"
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
        "principalId": "principalId1",
        "clientId": "clientId1"
      }
    }
  }
}

Create/Update Managed Cluster with Windows gMSA enabled

Exemple de requête

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

{
  "location": "location1",
  "tags": {
    "tier": "production",
    "archv2": ""
  },
  "sku": {
    "name": "Basic",
    "tier": "Free"
  },
  "properties": {
    "kubernetesVersion": "",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "osType": "Linux",
        "type": "VirtualMachineScaleSets",
        "availabilityZones": [
          "1",
          "2",
          "3"
        ],
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "loadBalancerProfile": {
        "managedOutboundIPs": {
          "count": 2
        }
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "adminPassword": "replacePassword1234$",
      "gmsaProfile": {
        "enabled": true
      }
    },
    "servicePrincipalProfile": {
      "clientId": "clientid",
      "secret": "secret"
    },
    "addonProfiles": {},
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {}
    }
  }
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Succeeded",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Succeeded",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "availabilityZones": [
          "1",
          "2",
          "3"
        ],
        "enableNodePublicIP": true,
        "mode": "System",
        "nodeImageVersion": "AKSUbuntu:1604:2020.03.11"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "gmsaProfile": {
        "enabled": true
      }
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
    "networkProfile": {
      "loadBalancerSku": "basic",
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
        "principalId": "principalId1",
        "clientId": "clientId1"
      }
    }
  }
}
Code d’état:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
  "location": "location1",
  "name": "clustername1",
  "tags": {
    "archv2": "",
    "tier": "production"
  },
  "type": "Microsoft.ContainerService/ManagedClusters",
  "properties": {
    "provisioningState": "Creating",
    "maxAgentPools": 1,
    "kubernetesVersion": "1.9.6",
    "currentKubernetesVersion": "1.9.6",
    "dnsPrefix": "dnsprefix1",
    "agentPoolProfiles": [
      {
        "name": "nodepool1",
        "count": 3,
        "vmSize": "Standard_DS1_v2",
        "maxPods": 110,
        "osType": "Linux",
        "provisioningState": "Creating",
        "orchestratorVersion": "1.9.6",
        "currentOrchestratorVersion": "1.9.6",
        "type": "VirtualMachineScaleSets",
        "availabilityZones": [
          "1",
          "2",
          "3"
        ],
        "enableNodePublicIP": true,
        "mode": "System"
      }
    ],
    "linuxProfile": {
      "adminUsername": "azureuser",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "keydata"
          }
        ]
      }
    },
    "windowsProfile": {
      "adminUsername": "azureuser",
      "gmsaProfile": {
        "enabled": true
      }
    },
    "servicePrincipalProfile": {
      "clientId": "clientid"
    },
    "nodeResourceGroup": "MC_rg1_clustername1_location1",
    "enableRBAC": true,
    "diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
    "networkProfile": {
      "networkPlugin": "kubenet",
      "podCidr": "10.244.0.0/16",
      "serviceCidr": "10.0.0.0/16",
      "dnsServiceIP": "10.0.0.10",
      "loadBalancerSku": "standard",
      "outboundType": "loadBalancer",
      "podCidrs": [
        "10.244.0.0/16"
      ],
      "serviceCidrs": [
        "10.0.0.0/16"
      ],
      "ipFamilies": [
        "IPv4"
      ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": 2000,
        "idleTimeoutInMinutes": 10,
        "managedOutboundIPs": {
          "count": 2
        },
        "effectiveOutboundIPs": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip1"
          },
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MC_rg1/providers/Microsoft.Network/publicIPAddresses/mgdoutboundip2"
          }
        ]
      }
    },
    "autoScalerProfile": {
      "scan-interval": "20s",
      "scale-down-delay-after-add": "15m"
    }
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
        "principalId": "principalId1",
        "clientId": "clientId1"
      }
    }
  }
}

Définitions

Nom Description
AdvancedNetworking

Profil réseau avancé pour activer l’observabilité et la suite de fonctionnalités de sécurité sur un cluster. Pour plus d’informations, consultez aka.ms/aksadvancednetworking.
AdvancedNetworkingObservability

Profil d’observabilité pour activer les métriques réseau avancées et les journaux de flux avec des contextes historiques.
AdvancedNetworkingSecurity

Profil de sécurité pour activer les fonctionnalités de sécurité sur un cluster basé sur cilium.
advancedNetworkPolicies

Activez les stratégies réseau avancées. Cela permet aux utilisateurs de configurer des stratégies réseau de couche 7 (FQDN, HTTP, Kafka). Les stratégies elles-mêmes doivent être configurées via les ressources de stratégie réseau Cilium, consultez https://docs.cilium.io/en/latest/security/policy/index.html. Cela ne peut être activé que sur les clusters basés sur cilium. Si elle n’est pas spécifiée, la valeur par défaut est FQDN si security.enabled a la valeur true.
AgentPoolGatewayProfile

Profil du pool d’agents de passerelle de cluster managé.
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
AgentPoolNetworkProfile

Paramètres réseau d’un pool d’agents.
AgentPoolSecurityProfile

Paramètres de sécurité d’un pool d’agents.
AgentPoolSSHAccess

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

Contient des informations en lecture seule sur le pool d’agents.
AgentPoolType

Type de pool d’agents.
AgentPoolUpgradeSettings

Paramètres de mise à niveau d’un pool d’agents
AgentPoolWindowsProfile

Profil spécifique du pool d’agents Windows.
ArtifactSource

Source de l’artefact. Source à partir de laquelle les artefacts sont téléchargés.
AutoScalerProfile

Paramètres à appliquer à la mise à l’échelle automatique du cluster en cas d’activation
AzureKeyVaultKms

Paramètres du service de gestion des clés Azure Key Vault pour le profil de sécurité.
BackendPoolType

Type du pool principal de l’équilibreur de charge entrant managé.
ClusterUpgradeSettings

Paramètres de mise à niveau d’un cluster.
code

Indique si le cluster est en cours d’exécution ou arrêté
ContainerServiceLinuxProfile

Profil des machines virtuelles Linux dans le cluster de service de conteneur.
ContainerServiceNetworkProfile

Profil de la configuration réseau.
ContainerServiceSshConfiguration

Configuration SSH pour les machines virtuelles Linux s’exécutant sur Azure.
ContainerServiceSshPublicKey

Contient des informations sur les données de clé publique du certificat SSH.
createdByType

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

Données utilisées lors de la création d’une ressource cible à partir d’une ressource source.
DelegatedResource

Propriétés de ressource déléguées : utilisation interne uniquement.
ErrorAdditionalInfo

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

Détail de l’erreur.
ErrorResponse

Réponse d’erreur
expander

L’expandeur à utiliser lors de la mise à l’échelle. S’il n’est pas spécifié, la valeur par défaut est « aléatoire ». Pour plus d’informations, consultez les expandeurs .
ExtendedLocation

Type complexe de l’emplacement étendu.
ExtendedLocationTypes

Type de l’emplacement étendu.
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.
Identity

Identité de la ressource.
ipFamily

Les familles d’adresses IP utilisées pour spécifier les versions IP disponibles pour le cluster. Les familles d’adresses IP sont utilisées pour déterminer des clusters à pile unique ou double pile. Pour une pile unique, la valeur attendue est IPv4. Pour la double pile, les valeurs attendues sont IPv4 et IPv6.
IPTag

Contient l’IPTag associé à l’objet.
IstioCertificateAuthority

Configuration de l’autorité de certification Istio Service Mesh. Pour l’instant, nous prenons uniquement en charge les certificats de plug-in comme décrit ici https://aka.ms/asm-plugin-ca
IstioComponents

Configuration des composants Istio.
IstioEgressGateway

Configuration de la passerelle de sortie Istio.
IstioIngressGateway

Configuration de la passerelle d’entrée Istio. Pour l’instant, nous prenons en charge jusqu’à une passerelle d’entrée externe nommée aks-istio-ingressgateway-external et une passerelle d’entrée interne nommée aks-istio-ingressgateway-internal.
IstioIngressGatewayMode

Mode d’une passerelle d’entrée.
IstioPluginCertificateAuthority

Informations sur les certificats de plug-in pour Service Mesh.
IstioServiceMesh

Configuration du maillage de service Istio.
KeyVaultNetworkAccessTypes

Accès réseau du coffre de clés. Accès réseau du coffre de clés. Les valeurs possibles sont Public et Private. Public signifie que le coffre de clés autorise l’accès public à partir de tous les réseaux. Private signifie que le coffre de clés désactive l’accès public et active une liaison privée. La valeur par défaut est Public.
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 emptyDir, de la racine des données du runtime de conteneur et du stockage éphémère Kubelet.
KubernetesSupportPlan

Différents niveaux de prise en charge pour les clusters gérés par AKS
licenseType

Type de licence à utiliser pour les machines virtuelles Windows. Pour plus d’informations, consultez Azure Hybrid User Benefits .
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.
loadBalancerSku

Référence sKU de l’équilibreur de charge pour le cluster managé. La valeur par défaut est « standard ». Consultez les références SKU Azure Load Balancer pour plus d’informations sur les différences entre les références SKU de l’équilibreur de charge.
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.
ManagedCluster

Cluster géré.
ManagedClusterAADProfile

AADProfile spécifie des attributs pour l’intégration d’Azure Active Directory. Pour plus d’informations, consultez AAD managé sur AKS.
ManagedClusterAddonProfile

Profil de module complémentaire Kubernetes pour un cluster managé.
ManagedClusterAgentPoolProfile

Profil du pool d’agents de service de conteneur.
ManagedClusterAIToolchainOperatorProfile

Lors de l’activation de l’opérateur, un ensemble de CRD et de contrôleurs managés AKS est installé dans le cluster. L’opérateur automatise le déploiement de modèles OSS à des fins d’inférence et/ou d’entraînement. Il fournit un ensemble de modèles prédéfinis et active l’inférence distribuée par rapport à eux.
ManagedClusterAPIServerAccessProfile

Profil d’accès pour le serveur d’API de cluster managé.
ManagedClusterAutoUpgradeProfile

Profil de mise à niveau automatique pour un cluster managé.
ManagedClusterAzureMonitorProfile

Profils de complément Azure Monitor pour la surveillance du cluster managé.
ManagedClusterAzureMonitorProfileKubeStateMetrics

Profil de métriques Kube State pour le module complémentaire Prometheus managé Azure. Ces paramètres facultatifs concernent le pod kube-state-metrics déployé avec le module complémentaire. Consultez aka.ms/AzureManagedPrometheus-optional-parameters pour plus d’informations.
ManagedClusterAzureMonitorProfileMetrics

Profil de métriques pour le service managé Azure Monitor pour le module complémentaire Prometheus. Collectez les métriques d’infrastructure Kubernetes prêtes à l’emploi pour les envoyer à un espace de travail Azure Monitor et configurez la récupération supplémentaire pour les cibles personnalisées. Consultez aka.ms/AzureManagedPrometheus pour obtenir une vue d’ensemble.
ManagedClusterBootstrapProfile

Profil d’amorçage.
ManagedClusterCostAnalysis

Configuration de l’analyse des coûts pour le cluster
ManagedClusterHTTPProxyConfig

Configuration du proxy HTTP du cluster.
ManagedClusterIdentity

Identité du cluster managé.
ManagedClusterIngressProfile

Profil d’entrée pour le cluster de service de conteneur.
ManagedClusterIngressProfileNginx
ManagedClusterIngressProfileWebAppRouting

Paramètres du module complémentaire Routage des applications pour le profil d’entrée.
ManagedClusterLoadBalancerProfile

Profil de l’équilibreur de charge de cluster managé.
ManagedClusterManagedOutboundIPProfile

Profil des ressources IP sortantes gérées du cluster managé.
ManagedClusterMetricsProfile

Profil de métriques pour ManagedCluster.
ManagedClusterNATGatewayProfile

Profil de la passerelle NAT de cluster managé.
ManagedClusterNodeProvisioningProfile
ManagedClusterNodeResourceGroupProfile

Profil de verrouillage de groupe de ressources de nœud pour un cluster managé.
ManagedClusterOIDCIssuerProfile

Profil d’émetteur OIDC du cluster managé.
ManagedClusterPodIdentity

Détails sur l’identité de pod affectée au cluster managé.
ManagedClusterPodIdentityException

Exception d’identité de pod, qui permet aux pods avec certaines étiquettes d’accéder au point de terminaison IMDS (Azure Instance Metadata Service) sans être interceptés par le serveur DMI (Node-Managed Identity). Pour plus d’informations, consultez désactiver l’identité de pod AAD pour un pod/application spécifique.
ManagedClusterPodIdentityProfile

Profil d’identité de pod du cluster managé. Consultez utiliser l’identité de pod AAD pour plus d’informations sur l’intégration de l’identité de pod.
ManagedClusterPodIdentityProvisioningError

Réponse d’erreur de l’approvisionnement d’identité de pod.
ManagedClusterPodIdentityProvisioningErrorBody

Réponse d’erreur de l’approvisionnement d’identité de pod.
ManagedClusterPodIdentityProvisioningState

État d’approvisionnement actuel de l’identité de l’espace.
ManagedClusterSecurityProfile

Profil de sécurité pour le cluster de service de conteneur.
ManagedClusterSecurityProfileDefender

Paramètres Microsoft Defender pour le profil de sécurité.
ManagedClusterSecurityProfileDefenderSecurityMonitoring

Paramètres Microsoft Defender pour la détection des menaces de profil de sécurité.
ManagedClusterSecurityProfileImageCleaner

Image Cleaner supprime les images inutilisées des nœuds, libère de l’espace disque et contribue à réduire la surface d’attaque. Voici les paramètres du profil de sécurité.
ManagedClusterSecurityProfileWorkloadIdentity

Paramètres d’identité de charge de travail pour le profil de sécurité.
ManagedClusterServicePrincipalProfile

Informations sur une identité de principal de service pour le cluster à utiliser pour manipuler des API Azure.
ManagedClusterSKU

Référence SKU d’un cluster managé.
ManagedClusterSKUName

Nom d’une référence SKU de cluster managé.
ManagedClusterSKUTier

Niveau d’une référence SKU de cluster managé. S’il n’est pas spécifié, la valeur par défaut est « Free ». Pour plus d’informations, consultez le niveau tarifaire AKS .
ManagedClusterStaticEgressGatewayProfile

Configuration du module complémentaire de passerelle de sortie statique pour le cluster.
ManagedClusterStatus

Contient des informations en lecture seule sur le cluster managé.
ManagedClusterStorageProfile

Profil de stockage pour le cluster de service de conteneur.
ManagedClusterStorageProfileBlobCSIDriver

Paramètres du pilote CSI AzureBlob pour le profil de stockage.
ManagedClusterStorageProfileDiskCSIDriver

Paramètres du pilote CSI AzureDisk pour le profil de stockage.
ManagedClusterStorageProfileFileCSIDriver

Paramètres du pilote CSI AzureFile pour le profil de stockage.
ManagedClusterStorageProfileSnapshotController

Paramètres du contrôleur d’instantané pour le profil de stockage.
ManagedClusterWindowsProfile

Profil des machines virtuelles Windows dans le cluster managé.
ManagedClusterWorkloadAutoScalerProfile

Profil de mise à l’échelle automatique de la charge de travail pour le cluster managé.
ManagedClusterWorkloadAutoScalerProfileKeda

Paramètres KEDA (Mise à l’échelle automatique pilotée par les événements Kubernetes) pour le profil de mise à l’échelle automatique de la charge de travail.
ManagedClusterWorkloadAutoScalerProfileVerticalPodAutoscaler

Paramètres VPA (Vertical Pod Autoscaler) pour le profil de mise à l’échelle automatique de la charge de travail.
ManagedOutboundIPs

Adresses IP sortantes gérées souhaitées pour l’équilibreur de charge du cluster.
ManualScaleProfile

Spécifications sur le nombre de machines.
networkDataplane

Plan de données réseau utilisé dans le cluster Kubernetes.
networkMode

Le mode réseau avec lequel Azure CNI est configuré. Cela ne peut pas être spécifié si networkPlugin est autre que « azure ».
NetworkPlugin

Plug-in réseau utilisé pour créer le réseau Kubernetes.
NetworkPluginMode

Mode que le plug-in réseau doit utiliser.
NetworkPolicy

Stratégie réseau utilisée pour créer le réseau Kubernetes.
NginxIngressControllerType

Type d’entrée pour la ressource personnalisée NginxIngressController par défaut
nodeOSUpgradeChannel

Canal de mise à niveau du système d’exploitation du nœud. Manière dont le système d’exploitation sur vos nœuds est mis à jour. La valeur par défaut est NodeImage.
NodeProvisioningDefaultNodePools

Ensemble de Karpenter NodePools (CRD) par défaut configurés pour le provisionnement de nœuds. Ce champ n’a aucun effet à moins que le mode ne soit « Auto ». Avertissement : Si vous passez de Auto à Aucun sur un cluster existant, les NodePools Karpenter par défaut seront supprimés, ce qui drainera et supprimera les nœuds associés à ces pools. Il est fortement recommandé de ne pas le faire à moins qu’il n’y ait des nœuds inactifs prêts à prendre les pods expulsés par cette action. S’il n’est pas spécifié, la valeur par défaut est Auto. Pour plus d’informations, reportez-vous à la aka.ms/aks/nap#node-pools.
NodeProvisioningMode

Mode d’approvisionnement de nœud. S’il n’est pas spécifié, la valeur par défaut est Manuelle.
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, consultez système d’exploitation éphémère.
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.
OutboundIPPrefixes

Ressources de préfixe IP sortantes souhaitées pour l’équilibreur de charge du cluster.
OutboundIPs

Ressources IP sortantes souhaitées pour l’équilibreur de charge du cluster.
outboundType

Méthode de routage sortante (sortie). Cela ne peut être défini qu’au moment de la création du cluster et ne peut pas être modifié ultérieurement. Pour plus d’informations, consultez le type sortant de sortie.
PodIPAllocationMode

Mode d’allocation IP du pod. Mode d’allocation IP pour les pods dans le pool d’agents. Doit être utilisé avec podSubnetId. La valeur par défaut est « DynamicIndividual ».
PortRange

Plage de ports.
PowerState

Décrit l’état de l’alimentation du cluster
PrivateLinkResource

Ressource de liaison privée
Protocol

Protocole réseau du port.
ProvisioningInfo
PublicNetworkAccess

PublicNetworkAccess du managedCluster. Autoriser ou refuser l’accès au réseau public pour AKS
ResourceIdentityType

Type d’identité utilisé pour le cluster managé. Pour plus d’informations, consultez Utiliser des identités managées dans AKS.
ResourceReference

Référence à une ressource Azure.
RestrictionLevel

Niveau de restriction appliqué au groupe de ressources de nœud du cluster. S’il n’est pas spécifié, la valeur par défaut est « Sans restriction »
ScaleDownMode

Décrit comment les machines virtuelles sont ajoutées ou supprimées des pools d’agents. Voir les états de facturation.
ScaleProfile

Spécifications sur la façon de mettre à l’échelle un pool d’agents VirtualMachines.
ScaleSetEvictionPolicy

Stratégie d’éviction du groupe de machines virtuelles identiques. La stratégie d’éviction spécifie ce qu’il faut faire de la machine virtuelle lorsqu’elle est expulsée. La valeur par défaut est Supprimer. Pour plus d’informations sur l’éviction, consultez VM spot
ScaleSetPriority

Priorité du groupe de machines virtuelles identiques.
ServiceMeshMode

Mode du maillage de service.
ServiceMeshProfile

Profil de maillage de service pour un cluster managé.
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.
UndrainableNodeBehavior

Définit le comportement des nœuds indrainables pendant la mise à niveau. La cause la plus courante des nœuds indrainables est les budgets d’interruption de pod (PDB), mais d’autres problèmes, tels que la période de grâce de terminaison de pod, dépassent le délai d’expiration du drainage par nœud restant ou le pod est toujours dans un état d’exécution, peut également entraîner des nœuds indrainables.
upgradeChannel

Canal de mise à niveau pour la mise à niveau automatique. La valeur par défaut est « none ». Pour plus d’informations, consultez la définition du canal de mise à niveau automatique du cluster AKS.
UpgradeOverrideSettings

Paramètres des remplacements lors de la mise à niveau d’un cluster.
UserAssignedIdentities

Identité de l’utilisateur associée au cluster managé. Cette identité sera utilisée dans le plan de contrôle. Une seule identité affectée par l’utilisateur est autorisée. Les clés doivent être des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».
UserAssignedIdentity

Détails sur une identité affectée par l’utilisateur.
VirtualMachineNodes

État actuel sur un groupe de nœuds de la même taille de machine virtuelle.
VirtualMachinesProfile

Spécifications sur le pool d’agents VirtualMachines.
WindowsGmsaProfile

Profil gMSA Windows dans le cluster managé.
WorkloadRuntime

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

AdvancedNetworking

Objet

Profil réseau avancé pour activer l’observabilité et la suite de fonctionnalités de sécurité sur un cluster. Pour plus d’informations, consultez aka.ms/aksadvancednetworking.

Nom Type Description
enabled

boolean

Indique l’activation des fonctionnalités de mise en réseau avancées de l’observabilité et de la sécurité sur les clusters AKS. Lorsque cette valeur est définie sur true, toutes les fonctionnalités d’observabilité et de sécurité sont activées, sauf si elles sont désactivées explicitement. S’il n’est pas spécifié, la valeur par défaut est false.
observability

AdvancedNetworkingObservability

Profil d’observabilité pour activer les métriques réseau avancées et les journaux de flux avec des contextes historiques.
security

AdvancedNetworkingSecurity

Profil de sécurité pour activer les fonctionnalités de sécurité sur un cluster basé sur cilium.

AdvancedNetworkingObservability

Objet

Profil d’observabilité pour activer les métriques réseau avancées et les journaux de flux avec des contextes historiques.

Nom Type Description
enabled

boolean

Indique l’activation des fonctionnalités d’observabilité de mise en réseau avancée sur les clusters.

AdvancedNetworkingSecurity

Objet

Profil de sécurité pour activer les fonctionnalités de sécurité sur un cluster basé sur cilium.

Nom Type Description
advancedNetworkPolicies

advancedNetworkPolicies

Activez les stratégies réseau avancées. Cela permet aux utilisateurs de configurer des stratégies réseau de couche 7 (FQDN, HTTP, Kafka). Les stratégies elles-mêmes doivent être configurées via les ressources de stratégie réseau Cilium, consultez https://docs.cilium.io/en/latest/security/policy/index.html. Cela ne peut être activé que sur les clusters basés sur cilium. Si elle n’est pas spécifiée, la valeur par défaut est FQDN si security.enabled a la valeur true.
enabled

boolean

Cette fonctionnalité permet à l’utilisateur de configurer la stratégie réseau en fonction des noms DNS (FQDN). Elle ne peut être activée que sur les clusters cilium. S’il n’est pas spécifié, la valeur par défaut est false.

advancedNetworkPolicies

Énumération

Activez les stratégies réseau avancées. Cela permet aux utilisateurs de configurer des stratégies réseau de couche 7 (FQDN, HTTP, Kafka). Les stratégies elles-mêmes doivent être configurées via les ressources de stratégie réseau Cilium, consultez https://docs.cilium.io/en/latest/security/policy/index.html. Cela ne peut être activé que sur les clusters basés sur cilium. Si elle n’est pas spécifiée, la valeur par défaut est FQDN si security.enabled a la valeur true.

Valeur Description
L7

Activez les stratégies réseau de couche 7 (FQDN, HTTP/S, Kafka). Cette option est un sur-ensemble de l’option FQDN.
FQDN

Activer les stratégies réseau basées sur le nom de domaine complet
None

Désactiver les stratégies réseau de couche 7 (FQDN, HTTP/S, Kafka)

AgentPoolGatewayProfile

Objet

Profil du pool d’agents de passerelle de cluster managé.

Nom Type Valeur par défaut Description
publicIPPrefixSize

integer (int32)

minimum: 28
maximum: 31 		31

Le pool d’agents de passerelle associe un IPPrefix public pour chaque passerelle de sortie statique pour fournir une sortie publique. La taille d’IPPrefix publique doit être sélectionnée par l’utilisateur. Chaque nœud du pool d’agents est affecté avec une adresse IP à partir de l’adresse IPPrefix. La taille IPPrefix sert donc de limite à la taille du pool d’agents de passerelle. En raison de la limitation de taille d’IPPrefix publique Azure, la plage de valeurs valide est [28, 31] (/31 = 2 nœuds/adresses IP, /30 = 4 nœuds/adresses IP, /29 = 8 nœuds/adresses IP, /28 = 16 nœuds/adresses IP). La valeur par défaut est 31.

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.

AgentPoolNetworkProfile

Objet

Paramètres réseau d’un pool d’agents.

Nom Type Description
allowedHostPorts

PortRange[]

Plages de ports autorisées à accéder. Les plages spécifiées sont autorisées à se chevaucher.
applicationSecurityGroups

string[] (arm-id)

ID des groupes de sécurité d’application associés au pool d’agents lors de la création.
nodePublicIPTags

IPTag[]

IPTags d’adresses IP publiques au niveau de l’instance.

AgentPoolSecurityProfile

Objet

Paramètres de sécurité d’un pool d’agents.

Nom Type Description
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.

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.

AgentPoolStatus

Objet

Contient des informations en lecture seule sur le pool d’agents.

Nom Type Description
provisioningError

ErrorDetail

Informations détaillées sur les erreurs du pool d’agents. Préserve les informations détaillées de l’échec. S’il n’y a pas eu d’erreur, ce champ est omis.

AgentPoolType

Énumération

Type de pool d’agents.

Valeur Description
VirtualMachineScaleSets

Créez un pool d’agents basé sur un groupe de machines virtuelles identiques.
AvailabilitySet

L’utilisation de ce système est fortement déconseillée.
VirtualMachines

Créez un pool d’agents basé sur un mode d’orchestration de machine virtuelle à instance unique.

AgentPoolUpgradeSettings

Objet

Paramètres de mise à niveau d’un pool d’agents

Nom Type Description
drainTimeoutInMinutes

integer (int32)

minimum: 1
maximum: 1440

Délai d’expiration de l’écoulement d’un nœud. Durée (en minutes) d’attente de l’éviction des pods et de l’arrêt approprié par nœud. Ce temps d’attente d’éviction respecte les budgets d’interruption des pods. Si cette durée est dépassée, la mise à niveau échoue. Si aucun délai n’est spécifié, la valeur par défaut est de 30 minutes.
maxSurge

string

Nombre maximal ou pourcentage de nœuds qui sont augmentés pendant la mise à niveau. Cela peut être défini sur un entier (par exemple, « 5 ») ou sur un pourcentage (par exemple, « 50%»). Si un pourcentage est spécifié, il s’agit du pourcentage de la taille totale du pool d’agents au moment de la mise à niveau. Pour les pourcentages, les nœuds fractionnaires sont arrondis. Si ce n’est pas spécifié, la valeur par défaut est 10%. Pour plus d’informations, y compris les meilleures pratiques, consultez : https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster
maxUnavailable

string

Nombre maximal ou pourcentage de nœuds qui peuvent être simultanément indisponibles pendant la mise à niveau. Cela peut être défini sur un entier (par exemple, « 1 ») ou un pourcentage (par exemple, « 5%»). Si un pourcentage est spécifié, il s’agit du pourcentage de la taille totale du pool d’agents au moment de la mise à niveau. Pour les pourcentages, les nœuds fractionnaires sont arrondis. Si ce n’est pas spécifié, la valeur par défaut est 0. Pour plus d’informations, y compris les meilleures pratiques, consultez : https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster
nodeSoakDurationInMinutes

integer (int32)

minimum: 0
maximum: 30

Durée d’imprégnation d’un nœud. Durée (en minutes) d’attente après le drainage d’un nœud et avant de la réimager et passer au nœud suivant. S’il n’est pas spécifié, la valeur par défaut est de 0 minutes.
undrainableNodeBehavior

UndrainableNodeBehavior

Définit le comportement des nœuds indrainables pendant la mise à niveau. La cause la plus courante des nœuds indrainables est les budgets d’interruption de pod (PDB), mais d’autres problèmes, tels que la période de grâce de terminaison de pod, dépassent le délai d’expiration du drainage par nœud restant ou le pod est toujours dans un état d’exécution, peut également entraîner des nœuds indrainables.

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.

ArtifactSource

Énumération

Source de l’artefact. Source à partir de laquelle les artefacts sont téléchargés.

Valeur Description
Direct

extraire des images de Microsoft Artifact Registry
Cache

extraire des images d’Azure Container Registry avec cache

AutoScalerProfile

Objet

Paramètres à appliquer à la mise à l’échelle automatique du cluster en cas d’activation

Nom Type Description
balance-similar-node-groups

string

Détecte les pools de nœuds similaires et équilibre le nombre de nœuds entre eux. Les valeurs valides sont « true » et « false »
daemonset-eviction-for-empty-nodes

boolean

Les pods DaemonSet seront supprimés gracieusement à partir de nœuds vides. Si la valeur est true, tous les pods daemonset sur des nœuds vides sont supprimés avant la suppression du nœud. Si le pod daemonset ne peut pas être supprimé, un autre nœud sera choisi pour la mise à l’échelle. Si la valeur est false, le nœud est supprimé sans s’assurer que les pods daemonset sont supprimés ou supprimés.
daemonset-eviction-for-occupied-nodes

boolean

Les pods DaemonSet seront supprimés gracieusement à partir de nœuds non vides. Si la valeur est true, tous les pods daemonset sur les nœuds occupés sont supprimés avant la suppression du nœud. Si le pod daemonset ne peut pas être supprimé, un autre nœud sera choisi pour la mise à l’échelle. Si la valeur est false, le nœud est supprimé sans s’assurer que les pods daemonset sont supprimés ou supprimés.
expander

expander

L’expandeur à utiliser lors de la mise à l’échelle. S’il n’est pas spécifié, la valeur par défaut est « aléatoire ». Pour plus d’informations, consultez les expandeurs .
ignore-daemonsets-utilization

boolean

L’autorité de certification doit-elle ignorer les pods DaemonSet lors du calcul de l’utilisation des ressources pour la réduction de la charge ? Si la valeur est true, les ressources utilisées par daemonset sont prises en compte lors de la prise de décisions de scale-down.
max-empty-bulk-delete

string

Nombre maximal de nœuds vides qui peuvent être supprimés en même temps. Il doit s’agir d’un entier positif. La valeur par défaut est de 10.
max-graceful-termination-sec

string

Le nombre maximal de secondes pendant lesquelles le générateur de mise à l’échelle automatique du cluster attend l’arrêt du pod lors de la tentative de scale-down d’un nœud. La valeur par défaut est 600.
max-node-provision-time

string

Durée maximale pendant laquelle le générateur de mise à l’échelle automatique attend qu’un nœud soit provisionné. La valeur par défaut est « 15 m ». Les valeurs doivent être un entier suivi d’un ' m'. Aucune unité de temps autre que les minutes (m) n’est prise en charge.
max-total-unready-percentage

string

Pourcentage maximal de nœuds non lus dans le cluster. Une fois ce pourcentage dépassé, l’autoscaler de cluster arrête les opérations. La valeur par défaut est 45. La valeur maximale est 100 et la valeur minimale est de 0.
new-pod-scale-up-delay

string

Ignorez les pods non planifiés avant qu’ils ne soient d’un certain âge. Pour les scénarios tels que la mise à l’échelle burst/batch où vous ne souhaitez pas que l’autorité de certification agisse avant que le planificateur Kubernetes puisse planifier tous les pods, vous pouvez indiquer à l’autorité de certification d’ignorer les pods non planifiés avant qu’ils ne soient d’un certain âge. La valeur par défaut est « 0s ». Les valeurs doivent être un entier suivi d’une unité (s’pendant les secondes, 'm' pendant les minutes, 'h' pendant les heures, etc.).
ok-total-unready-count

string

Nombre de nœuds non lus autorisés, quel que soit le pourcentage max-total-unready-. Il doit s’agir d’un entier. La valeur par défaut est 3.
scale-down-delay-after-add

string

Durée, après le scale-up, à l’issue de laquelle s’effectue la reprise de l’évaluation de scale-down. La valeur par défaut est « 10m ». Les valeurs doivent être un entier suivi d’un ' m'. Aucune unité de temps autre que les minutes (m) n’est prise en charge.
scale-down-delay-after-delete

string

Durée, après la suppression du nœud, à l’issue de laquelle s’effectue la reprise de l’évaluation de scale-down. La valeur par défaut est l’intervalle d’analyse. Les valeurs doivent être un entier suivi d’un ' m'. Aucune unité de temps autre que les minutes (m) n’est prise en charge.
scale-down-delay-after-failure

string

Combien de temps après l’échec de scale-down de l’évaluation reprend. La valeur par défaut est « 3m ». Les valeurs doivent être un entier suivi d’un ' m'. Aucune unité de temps autre que les minutes (m) n’est prise en charge.
scale-down-unneeded-time

string

Durée pendant laquelle un nœud ne doit pas être nécessaire avant qu’il ne soit éligible à un scale-down. La valeur par défaut est « 10m ». Les valeurs doivent être un entier suivi d’un ' m'. Aucune unité de temps autre que les minutes (m) n’est prise en charge.
scale-down-unready-time

string

Durée pendant laquelle un nœud non prêt doit être inutile avant de pouvoir être mis à l’échelle. La valeur par défaut est « 20m ». Les valeurs doivent être un entier suivi d’un ' m'. Aucune unité de temps autre que les minutes (m) n’est prise en charge.
scale-down-utilization-threshold

string

Niveau d’utilisation du nœud, défini comme somme des ressources demandées divisées par capacité, sous laquelle un nœud peut être pris en compte pour un scale-down. La valeur par défaut est « 0.5 ».
scan-interval

string

Fréquence à laquelle le cluster est réévalué pour effectuer un scale-up ou un scale-down. La valeur par défaut est « 10 ». Les valeurs doivent être un nombre entier de secondes.
skip-nodes-with-local-storage

string

Si l’autoscaler de cluster ignore la suppression de nœuds avec des pods avec un stockage local, par exemple EmptyDir ou HostPath. La valeur par défaut est true.
skip-nodes-with-system-pods

string

Si l’autoscaler de cluster ignore la suppression des nœuds avec des pods de kube-system (à l’exception de DaemonSet ou des pods miroirs). La valeur par défaut est true.

AzureKeyVaultKms

Objet

Paramètres du service de gestion des clés Azure Key Vault pour le profil de sécurité.

Nom Type Valeur par défaut Description
enabled

boolean

Indique s’il faut activer le service de gestion des clés Azure Key Vault. La valeur par défaut est false.
keyId

string

Identificateur de la clé Azure Key Vault. Pour plus d’informations, consultez le format d’identificateur de clé . Lorsque le service de gestion des clés Azure Key Vault est activé, ce champ est requis et doit être un identificateur de clé valide. Lorsque le service de gestion des clés Azure Key Vault est désactivé, laissez le champ vide.
keyVaultNetworkAccess

KeyVaultNetworkAccessTypes

Public

Accès réseau du coffre de clés. Accès réseau du coffre de clés. Les valeurs possibles sont Public et Private. Public signifie que le coffre de clés autorise l’accès public à partir de tous les réseaux. Private signifie que le coffre de clés désactive l’accès public et active une liaison privée. La valeur par défaut est Public.
keyVaultResourceId

string (arm-id)

ID de ressource du coffre de clés. Lorsque keyVaultNetworkAccess est Private, ce champ est obligatoire et doit être un ID de ressource valide. Lorsque keyVaultNetworkAccess est Public, laissez le champ vide.

BackendPoolType

Énumération

Type du pool principal de l’équilibreur de charge entrant managé.

Valeur Description
NodeIPConfiguration

Type du pool principal de l’équilibreur de charge entrant managé. https://cloud-provider-azure.sigs.k8s.io/topics/loadbalancer/#configure-load-balancer-backend.
NodeIP

Type du pool principal de l’équilibreur de charge entrant managé. https://cloud-provider-azure.sigs.k8s.io/topics/loadbalancer/#configure-load-balancer-backend.

ClusterUpgradeSettings

Objet

Paramètres de mise à niveau d’un cluster.

Nom Type Description
overrideSettings

UpgradeOverrideSettings

Paramètres des remplacements.

code

Énumération

Indique si le cluster est en cours d’exécution ou arrêté

Valeur Description
Running

Le cluster est en cours d’exécution.
Stopped

Le cluster est arrêté.

ContainerServiceLinuxProfile

Objet

Profil des machines virtuelles Linux dans le cluster de service de conteneur.

Nom Type Description
adminUsername

string

pattern: ^[A-Za-z][-A-Za-z0-9_]*$

Nom d’utilisateur administrateur à utiliser pour les machines virtuelles Linux.
ssh

ContainerServiceSshConfiguration

Configuration SSH pour les machines virtuelles Linux s’exécutant sur Azure.

ContainerServiceNetworkProfile

Objet

Profil de la configuration réseau.

Nom Type Valeur par défaut Description
advancedNetworking

AdvancedNetworking

Profil réseau avancé pour activer l’observabilité et la suite de fonctionnalités de sécurité sur un cluster. Pour plus d’informations, consultez aka.ms/aksadvancednetworking.
dnsServiceIP

string

pattern: ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$ 		10.0.0.10

Adresse IP affectée au service DNS Kubernetes. Elle doit se trouver dans la plage d’adresses du service Kubernetes spécifiée dans serviceCidr.
ipFamilies

ipFamily[]

Les familles d’adresses IP utilisées pour spécifier les versions IP disponibles pour le cluster. Les familles d’adresses IP sont utilisées pour déterminer des clusters à pile unique ou double pile. Pour une pile unique, la valeur attendue est IPv4. Pour la double pile, les valeurs attendues sont IPv4 et IPv6.
loadBalancerProfile

ManagedClusterLoadBalancerProfile

Profil de l’équilibreur de charge du cluster.
loadBalancerSku

loadBalancerSku

Référence sKU de l’équilibreur de charge pour le cluster managé. La valeur par défaut est « standard ». Consultez les références SKU Azure Load Balancer pour plus d’informations sur les différences entre les références SKU de l’équilibreur de charge.
natGatewayProfile

ManagedClusterNATGatewayProfile

Profil de la passerelle NAT de cluster.
networkDataplane

networkDataplane

Plan de données réseau utilisé dans le cluster Kubernetes.
networkMode

networkMode

Le mode réseau avec lequel Azure CNI est configuré. Cela ne peut pas être spécifié si networkPlugin est autre que « azure ».
networkPlugin

NetworkPlugin

Plug-in réseau utilisé pour créer le réseau Kubernetes.
networkPluginMode

NetworkPluginMode

Mode que le plug-in réseau doit utiliser.
networkPolicy

NetworkPolicy

Stratégie réseau utilisée pour créer le réseau Kubernetes.
outboundType

outboundType

loadBalancer

Méthode de routage sortante (sortie). Cela ne peut être défini qu’au moment de la création du cluster et ne peut pas être modifié ultérieurement. Pour plus d’informations, consultez le type sortant de sortie.
podCidr

string

pattern: ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$ 		10.244.0.0/16

Plage d’adresses IP de notation CIDR à partir de laquelle affecter des adresses IP de pod lorsque kubenet est utilisé.
podCidrs

string[]

Les plages d’adresses IP de notation CIDR à partir desquelles attribuer des adresses IP de pod. Un CIDR IPv4 est attendu pour la mise en réseau à pile unique. Deux CIDR, un pour chaque famille IP (IPv4/IPv6), sont attendus pour la mise en réseau à double pile.
serviceCidr

string

pattern: ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$ 		10.0.0.0/16

Plage d’adresses IP de notation CIDR à partir de laquelle attribuer des adresses IP de cluster de service. Elle ne doit pas chevaucher les plages d’adresses IP de sous-réseau.
serviceCidrs

string[]

Les plages d’adresses IP de notation CIDR à partir desquelles attribuer des adresses IP de cluster de service. Un CIDR IPv4 est attendu pour la mise en réseau à pile unique. Deux CIDR, un pour chaque famille IP (IPv4/IPv6), sont attendus pour la mise en réseau à double pile. Ils ne doivent pas chevaucher les plages d’adresses IP de sous-réseau.
staticEgressGatewayProfile

ManagedClusterStaticEgressGatewayProfile

Profil du module complémentaire de passerelle de sortie statique. Pour plus d’informations sur la passerelle de sortie statique, consultez https://aka.ms/aks/static-egress-gateway.

ContainerServiceSshConfiguration

Objet

Configuration SSH pour les machines virtuelles Linux s’exécutant sur Azure.

Nom Type Description
publicKeys

ContainerServiceSshPublicKey[]

Liste des clés publiques SSH utilisées pour s’authentifier auprès de machines virtuelles Linux. Un maximum de 1 clé peut être spécifié.

ContainerServiceSshPublicKey

Objet

Contient des informations sur les données de clé publique du certificat SSH.

Nom Type Description
keyData

string

Clé publique de certificat utilisée pour s’authentifier auprès de machines virtuelles via SSH. Le certificat doit être au format PEM avec ou sans en-têtes.

createdByType

Énumération

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

Valeur Description
User
Application
ManagedIdentity
Key

CreationData

Objet

Données utilisées lors de la création d’une ressource cible à partir d’une ressource source.

Nom Type Description
sourceResourceId

string (arm-id)

Il s’agit de l’ID ARM de l’objet source à utiliser pour créer l’objet cible.

DelegatedResource

Objet

Propriétés de ressource déléguées : utilisation interne uniquement.

Nom Type Description
location

string

Emplacement de la ressource source : utilisation interne uniquement.
referralResource

string

ID de délégation de la délégation de référence (facultatif) : utilisation interne uniquement.
resourceId

string

ID de ressource ARM de la ressource déléguée : utilisation interne uniquement.
tenantId

string (uuid)

ID de locataire de la ressource déléguée : utilisation interne uniquement.

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.

expander

Énumération

L’expandeur à utiliser lors de la mise à l’échelle. S’il n’est pas spécifié, la valeur par défaut est « aléatoire ». Pour plus d’informations, consultez les expandeurs .

Valeur Description
least-waste

Sélectionne le groupe de nœuds qui aura le moins de CPU inactif (s’il est lié, mémoire inutilisée) après la montée en charge. Cela est utile lorsque vous avez différentes classes de nœuds, par exemple, des nœuds processeurs élevés ou mémoire élevée, et que vous souhaitez uniquement développer ceux lorsqu’il existe des pods en attente qui ont besoin de beaucoup de ces ressources.
most-pods

Sélectionne le groupe de nœuds qui serait en mesure de planifier le plus grand nombre d’espaces lors de la montée en charge. Cela est utile lorsque vous utilisez nodeSelector pour vous assurer que certains pods atterrissent sur certains nœuds. Notez que cela n’entraîne pas la sélection de nœuds plus volumineux par rapport à des nœuds plus petits, car il peut ajouter plusieurs nœuds plus petits à la fois.
priority

Sélectionne le groupe de nœuds dont la priorité est la plus élevée attribuée par l’utilisateur. La configuration est décrite dans plus de détails ici.
random

Utilisé lorsque vous n’avez pas besoin que les groupes de nœuds soient mis à l’échelle différemment.

ExtendedLocation

Objet

Type complexe de l’emplacement étendu.

Nom Type Description
name

string

Nom de l’emplacement étendu.
type

ExtendedLocationTypes

Type de l’emplacement étendu.

ExtendedLocationTypes

Énumération

Type de l’emplacement étendu.

Valeur Description
EdgeZone

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
MIG2g
MIG3g
MIG4g
MIG7g

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.

Identity

Objet

Identité de la ressource.

Nom Type Description
principalId

string (uuid)

ID principal de l’identité de ressource. La valeur doit être un UUID.
tenantId

string (uuid)

ID de locataire de la ressource. La valeur doit être un UUID.
type

ResourceIdentityType

Type d’identité.

ipFamily

Énumération

Les familles d’adresses IP utilisées pour spécifier les versions IP disponibles pour le cluster. Les familles d’adresses IP sont utilisées pour déterminer des clusters à pile unique ou double pile. Pour une pile unique, la valeur attendue est IPv4. Pour la double pile, les valeurs attendues sont IPv4 et IPv6.

Valeur Description
IPv4
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.

IstioCertificateAuthority

Objet

Configuration de l’autorité de certification Istio Service Mesh. Pour l’instant, nous prenons uniquement en charge les certificats de plug-in comme décrit ici https://aka.ms/asm-plugin-ca

Nom Type Description
plugin

IstioPluginCertificateAuthority

Informations sur les certificats de plug-in pour Service Mesh.

IstioComponents

Objet

Configuration des composants Istio.

Nom Type Description
egressGateways

IstioEgressGateway[]

Passerelles de sortie Istio.
ingressGateways

IstioIngressGateway[]

Passerelles d’entrée Istio.

IstioEgressGateway

Objet

Configuration de la passerelle de sortie Istio.

Nom Type Description
enabled

boolean

Indique s’il faut activer la passerelle de sortie.
gatewayConfigurationName

string

Nom de la ressource personnalisée de configuration de la passerelle pour la passerelle de sortie du module complémentaire Istio. Doit être spécifié lors de l’activation de la passerelle de sortie Istio. Doit être déployé dans le même espace de noms que la passerelle de sortie Istio sera déployée.
name

string

pattern: [a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*

Nom de la passerelle de sortie du module complémentaire Istio.
namespace

string

Espace de noms dans lequel la passerelle de sortie du module complémentaire Istio doit être déployée. S’il n’est pas spécifié, la valeur par défaut est aks-istio-egress.

IstioIngressGateway

Objet

Configuration de la passerelle d’entrée Istio. Pour l’instant, nous prenons en charge jusqu’à une passerelle d’entrée externe nommée aks-istio-ingressgateway-external et une passerelle d’entrée interne nommée aks-istio-ingressgateway-internal.

Nom Type Description
enabled

boolean

Indique s’il faut activer la passerelle d’entrée.
mode

IstioIngressGatewayMode

Mode d’une passerelle d’entrée.

IstioIngressGatewayMode

Énumération

Mode d’une passerelle d’entrée.

Valeur Description
External

Une adresse IP publique est attribuée à la passerelle entrante et elle est accessible au public.
Internal

Une adresse IP interne est attribuée à la passerelle d’entrée et n’est pas accessible publiquement.

IstioPluginCertificateAuthority

Objet

Informations sur les certificats de plug-in pour Service Mesh.

Nom Type Description
certChainObjectName

string

Nom de l’objet de la chaîne de certificats dans Azure Key Vault.
certObjectName

string

Nom d’objet de certificat intermédiaire dans Azure Key Vault.
keyObjectName

string

Nom d’objet de clé privée de certificat intermédiaire dans Azure Key Vault.
keyVaultId

string (arm-id)

ID de ressource du coffre de clés.
rootCertObjectName

string

Nom de l’objet de certificat racine dans Azure Key Vault.

IstioServiceMesh

Objet

Configuration du maillage de service Istio.

Nom Type Description
certificateAuthority

IstioCertificateAuthority

Configuration de l’autorité de certification Istio Service Mesh. Pour l’instant, nous prenons uniquement en charge les certificats de plug-in comme décrit ici https://aka.ms/asm-plugin-ca
components

IstioComponents

Configuration des composants Istio.
revisions

string[]

Liste des révisions du plan de contrôle Istio. Lorsqu’une mise à niveau n’est pas en cours, celle-ci contient une valeur. Lorsque la mise à niveau de canary est en cours, cela ne peut contenir que deux valeurs consécutives. Pour plus d’informations, consultez : https://learn.microsoft.com/en-us/azure/aks/istio-upgrade

KeyVaultNetworkAccessTypes

Énumération

Accès réseau du coffre de clés. Accès réseau du coffre de clés. Les valeurs possibles sont Public et Private. Public signifie que le coffre de clés autorise l’accès public à partir de tous les réseaux. Private signifie que le coffre de clés désactive l’accès public et active une liaison privée. La valeur par défaut est Public.

Valeur Description
Public
Private

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.
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 emptyDir, de la racine des données du runtime de conteneur et du stockage é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.

KubernetesSupportPlan

Énumération

Différents niveaux de prise en charge pour les clusters gérés par AKS

Valeur Description
KubernetesOfficial

La prise en charge de cette version est la même que celle de l’offre open source Kubernetes. La communauté open source Kubernetes officielle prend en charge les versions de 1 an après la publication.
AKSLongTermSupport

La prise en charge de la version a été prolongée au-delà de la période de support officielle de 1 an. AKS continue de corriger les CVE pour un autre an, pour un total de 2 ans de support.

licenseType

Énumération

Type de licence à utiliser pour les machines virtuelles Windows. Pour plus d’informations, consultez Azure Hybrid User Benefits .

Valeur Description
None

Aucune licence supplémentaire n’est appliquée.
Windows_Server

Permet d’utiliser Azure Hybrid User Benefits pour les machines virtuelles Windows.

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.

loadBalancerSku

Énumération

Référence sKU de l’équilibreur de charge pour le cluster managé. La valeur par défaut est « standard ». Consultez les références SKU Azure Load Balancer pour plus d’informations sur les différences entre les références SKU de l’équilibreur de charge.

Valeur Description
standard

Utilisez un équilibreur de charge standard. Il s’agit de la référence SKU Load Balancer recommandée. Pour plus d’informations sur l’utilisation de l’équilibreur de charge dans le cluster managé, consultez l’article standard Load Balancer.
basic

Utilisez un équilibreur de charge de base avec des fonctionnalités limitées.

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é.

ManagedCluster

Objet

Cluster géré.

Nom Type Description
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.
extendedLocation

ExtendedLocation

Emplacement étendu de la machine virtuelle.
id

string (arm-id)

ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
identity

ManagedClusterIdentity

Identité du cluster managé, s’il est configuré.
kind

string

Ceci est principalement utilisé pour exposer différentes expériences d’interface utilisateur dans le portail pour différents types
location

string

Emplacement géographique où réside la ressource
name

string

Nom de la ressource
properties.aadProfile

ManagedClusterAADProfile

Configuration d’Azure Active Directory.
properties.addonProfiles

<string,  ManagedClusterAddonProfile>

Profil du module complémentaire de cluster managé.
properties.agentPoolProfiles

ManagedClusterAgentPoolProfile[]

Propriétés du pool d’agents.
properties.aiToolchainOperatorProfile

ManagedClusterAIToolchainOperatorProfile

Paramètres de l’opérateur de chaîne d’outils IA qui s’appliquent à l’ensemble du cluster.
properties.apiServerAccessProfile

ManagedClusterAPIServerAccessProfile

Profil d’accès pour le serveur d’API de cluster managé.
properties.autoScalerProfile

AutoScalerProfile

Paramètres à appliquer à la mise à l’échelle automatique du cluster en cas d’activation
properties.autoUpgradeProfile

ManagedClusterAutoUpgradeProfile

Configuration de la mise à niveau automatique.
properties.azureMonitorProfile

ManagedClusterAzureMonitorProfile

Profils de complément Azure Monitor pour la surveillance du cluster managé.
properties.azurePortalFQDN

string

Nom de domaine complet spécial utilisé par le portail Azure pour accéder au cluster managé. Ce nom de domaine complet est utilisé uniquement par le portail Azure et ne doit pas être utilisé par d’autres clients. Le portail Azure nécessite que certains en-têtes CORS (Cross-Origin Resource Sharing) soient envoyés dans certaines réponses, que Kubernetes APIServer ne gère pas par défaut. Ce nom de domaine complet spécial prend en charge CORS, ce qui permet au portail Azure de fonctionner correctement.
properties.bootstrapProfile

ManagedClusterBootstrapProfile

Profil de la configuration de démarrage du cluster.
properties.currentKubernetesVersion

string

La version de Kubernetes du cluster managé est en cours d’exécution. Si kubernetesVersion était une version entièrement spécifiée <major.minor.patch>, ce champ sera exactement égal à celui-ci. Si kubernetesVersion a été <>major.minor, ce champ contient la version complète <major.minor.patch> utilisée.
properties.disableLocalAccounts

boolean

Si les comptes locaux doivent être désactivés sur le cluster managé. Si la valeur est true, l’obtention d’informations d’identification statiques est désactivée pour ce cluster. Cela ne doit être utilisé que sur les clusters managés activés par AAD. Pour plus d’informations, consultez désactiver les comptes locaux.
properties.diskEncryptionSetID

string (arm-id)

ID de ressource du jeu de chiffrement de disque à utiliser pour activer le chiffrement au repos. Il s’agit de la forme suivante : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskEncryptionSets/{encryptionSetName} »
properties.dnsPrefix

string

Préfixe DNS du cluster managé. Cette opération ne peut pas être mise à jour une fois le cluster managé créé.
properties.enableRBAC

boolean

Indique s’il faut activer Kubernetes Role-Based contrôle d’accès.
properties.fqdn

string

Nom de domaine complet du pool maître.
properties.fqdnSubdomain

string

Sous-domaine du nom de domaine complet du cluster privé avec une zone dns privée personnalisée. Cette opération ne peut pas être mise à jour une fois le cluster managé créé.
properties.httpProxyConfig

ManagedClusterHTTPProxyConfig

Configurations pour l’approvisionnement du cluster avec des serveurs proxy HTTP.
properties.identityProfile

<string,  UserAssignedIdentity>

Identité de l’utilisateur associée au cluster managé. Cette identité sera utilisée par le kubelet. Une seule identité affectée par l’utilisateur est autorisée. La seule clé acceptée est « kubeletidentity », avec la valeur « resourceId » : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».
properties.ingressProfile

ManagedClusterIngressProfile

Profil d’entrée pour le cluster managé.
properties.kubernetesVersion

string

Version de Kubernetes spécifiée par l’utilisateur. Les deux versions de correctif <> major.minor.patch (par exemple, 1.20.13) et <> major.minor (par exemple, 1,20) sont prises en charge. Lorsque <> major.minor est spécifié, la dernière version de correctif ga prise en charge est choisie automatiquement. La mise à jour du cluster avec le même <major.minor> une fois qu’il a été créé (par exemple, 1.14.x -> 1.14) ne déclenche pas de mise à niveau, même si une version de correctif plus récente est disponible. Lorsque vous mettez à niveau un cluster AKS pris en charge, les versions mineures de Kubernetes ne peuvent pas être ignorées. Toutes les mises à niveau doivent être effectuées séquentiellement par numéro de version principal. Par exemple, les mises à niveau entre 1.14.x -> 1.15.x ou 1.15.x -> 1.16.x sont autorisées, mais 1.14.x -> 1.16.x n’est pas autorisée. Pour plus d’informations, consultez mise à niveau d’un cluster AKS.
properties.linuxProfile

ContainerServiceLinuxProfile

Profil pour les machines virtuelles Linux dans le cluster managé.
properties.maxAgentPools

integer (int32)

Nombre maximal de pools d’agents pour le cluster managé.
properties.metricsProfile

ManagedClusterMetricsProfile

Configuration facultative des métriques de cluster.
properties.networkProfile

ContainerServiceNetworkProfile

Profil de configuration réseau.
properties.nodeProvisioningProfile

ManagedClusterNodeProvisioningProfile

Paramètres d’approvisionnement de nœuds qui s’appliquent à l’ensemble du cluster.
properties.nodeResourceGroup

string

Nom du groupe de ressources contenant des nœuds de pool d’agents.
properties.nodeResourceGroupProfile

ManagedClusterNodeResourceGroupProfile

Profil de la configuration du groupe de ressources de nœud.
properties.oidcIssuerProfile

ManagedClusterOIDCIssuerProfile

Profil d’émetteur OIDC du cluster managé.
properties.podIdentityProfile

ManagedClusterPodIdentityProfile

Profil d’identité de pod du cluster managé. Consultez utiliser l’identité de pod AAD pour plus d’informations sur l’intégration des identités de pod AAD.
properties.powerState

PowerState

État d’alimentation du cluster.
properties.privateFQDN

string

Nom de domaine complet du cluster privé.
properties.privateLinkResources

PrivateLinkResource[]

Ressources de liaison privée associées au cluster.
properties.provisioningState

string

État d’approvisionnement actuel.
properties.publicNetworkAccess

PublicNetworkAccess

PublicNetworkAccess du managedCluster. Autoriser ou refuser l’accès au réseau public pour AKS
properties.resourceUID

string

resourceUID identifie de manière unique les ManagedClusters qui réutilisent les ResourceId ARM (c’est-à-dire : créer, supprimer, créer une séquence)
properties.securityProfile

ManagedClusterSecurityProfile

Profil de sécurité pour le cluster managé.
properties.serviceMeshProfile

ServiceMeshProfile

Profil de maillage de service pour un cluster managé.
properties.servicePrincipalProfile

ManagedClusterServicePrincipalProfile

Informations sur une identité de principal de service pour le cluster à utiliser pour manipuler des API Azure.
properties.status

ManagedClusterStatus

Contient des informations en lecture seule sur le cluster managé.
properties.storageProfile

ManagedClusterStorageProfile

Profil de stockage pour le cluster managé.
properties.supportPlan

KubernetesSupportPlan

Plan de support pour le cluster managé. Si elle n’est pas spécifiée, la valeur par défaut est « KubernetesOfficial ».
properties.upgradeSettings

ClusterUpgradeSettings

Paramètres de mise à niveau d’un cluster.
properties.windowsProfile

ManagedClusterWindowsProfile

Profil des machines virtuelles Windows dans le cluster managé.
properties.workloadAutoScalerProfile

ManagedClusterWorkloadAutoScalerProfile

Profil de mise à l’échelle automatique de la charge de travail pour le cluster managé.
sku

ManagedClusterSKU

Référence SKU de cluster managé.
systemData

systemData

Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags

object

Balises de ressource.
type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

ManagedClusterAADProfile

Objet

AADProfile spécifie des attributs pour l’intégration d’Azure Active Directory. Pour plus d’informations, consultez AAD managé sur AKS.

Nom Type Description
adminGroupObjectIDs

string[]

Liste des ID d’objet de groupe AAD qui auront le rôle d’administrateur du cluster.
clientAppID

string

(DÉCONSEILLÉ) ID d’application AAD client. En savoir plus sur https://aka.ms/aks/aad-legacy.
enableAzureRBAC

boolean

Indique s’il faut activer Azure RBAC pour l’autorisation Kubernetes.
managed

boolean

Indique s’il faut activer AAD managé.
serverAppID

string

(DÉCONSEILLÉ) ID d’application AAD du serveur. En savoir plus sur https://aka.ms/aks/aad-legacy.
serverAppSecret

string

(DÉCONSEILLÉ) Secret de l’application AAD du serveur. En savoir plus sur https://aka.ms/aks/aad-legacy.
tenantID

string

ID de locataire AAD à utiliser pour l’authentification. S’il n’est pas spécifié, utilisez le locataire de l’abonnement de déploiement.

ManagedClusterAddonProfile

Objet

Profil de module complémentaire Kubernetes pour un cluster managé.

Nom Type Description
config

object

Paires clé-valeur pour la configuration d’un module complémentaire.
enabled

boolean

Indique si le module complémentaire est activé ou non.
identity

Identity

Informations sur l’identité affectée par l’utilisateur utilisée par ce module complémentaire.

ManagedClusterAgentPoolProfile

Objet

Profil du pool d’agents de service de conteneur.

Nom Type Valeur par défaut Description
availabilityZones

string[]

Liste des zones de disponibilité à utiliser pour les nœuds. Cela ne peut être spécifié que si la propriété AgentPoolType est « VirtualMachineScaleSets ».
capacityReservationGroupID

string (arm-id)

AKS associe le pool d’agents spécifié au groupe de réservations de capacité.
count

integer (int32)

Nombre d’agents (machines virtuelles) pour héberger des conteneurs Docker. Les valeurs autorisées doivent être comprises entre 0 et 1 000 (inclus) pour les pools d’utilisateurs et dans la plage comprise entre 1 et 1 000 (inclus) pour les pools système. La valeur par défaut est 1.
creationData

CreationData

CreationData à utiliser pour spécifier l’ID d’instantané source si le pool de nœuds sera créé/mis à niveau à l’aide d’un instantané.
currentOrchestratorVersion

string

La version de Kubernetes du pool d’agents est en cours d’exécution. Si orchestratorVersion est une version entièrement spécifiée <major.minor.patch>, ce champ est exactement égal à celui-ci. Si orchestratorVersion est <>major.minor, ce champ contient la version complète <major.minor.patch> utilisée.
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.
enableAutoScaling

boolean

Indique s’il faut activer la mise à l’échelle automatique
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 machine virtuelle et dans certaines régions Azure. Pour plus d’informations, consultez : https://docs.microsoft.com/azure/aks/enable-host-encryption
enableFIPS

boolean

Indique s’il faut utiliser un système d’exploitation compatible FIPS. Pour plus d’informations, consultez Ajouter un pool de nœuds compatible FIPS.
enableNodePublicIP

boolean

Indique si chaque nœud est alloué à sa propre adresse IP publique. Certains scénarios peuvent nécessiter des nœuds dans un pool de nœuds pour recevoir leurs 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. Pour plus d’informations, consultez affectation d’une adresse IP publique par nœud. La valeur par défaut est false.
enableUltraSSD

boolean

Indique s’il faut activer UltraSSD
gatewayProfile

AgentPoolGatewayProfile

Profil spécifique à un pool d’agents managés en mode passerelle. Ce champ ne peut pas être défini si le mode pool d’agents n’est pas passerelle.
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

Paramètres GPU pour le pool d’agents.
hostGroupID

string (arm-id)

ID de ressource complet du groupe hôte dédié à partir duquel provisionner des machines virtuelles, utilisé uniquement dans le scénario de création et non autorisé à changer une fois défini. Il s’agit de la forme suivante : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Pour plus d’informations, consultez hôtes dédiés Azure.
kubeletConfig

KubeletConfig

Configuration Kubelet sur les nœuds du pool d’agents.
kubeletDiskType

KubeletDiskType

Détermine le placement des volumes emptyDir, de la racine des données du runtime de conteneur et du stockage éphémère Kubelet.
linuxOSConfig

LinuxOSConfig

Configuration du système d’exploitation des nœuds de l’agent Linux.
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.
maxCount

integer (int32)

Nombre maximal de nœuds pour la mise à l’échelle automatique
maxPods

integer (int32)

Nombre maximal de pods qui peuvent s’exécuter sur un nœud.
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).
minCount

integer (int32)

Nombre minimal de nœuds pour la mise à l’échelle automatique
mode

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
name

string

pattern: ^[a-z][a-z0-9]{0,11}$

Nom unique du profil du pool d’agents dans le contexte de l’abonnement et du groupe de ressources. Les noms de pool d’agents Windows doivent être de 6 caractères ou moins.
networkProfile

AgentPoolNetworkProfile

Paramètres liés au réseau d’un pool d’agents.
nodeImageVersion

string

Version de l’image de nœud
nodeLabels

object

Étiquettes de nœud à conserver sur tous les nœuds du pool d’agents.
nodePublicIPPrefixID

string (arm-id)

ID de préfixe IP public à partir duquel les nœuds de machine virtuelle doivent utiliser des adresses IP. Il s’agit de la forme suivante : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
nodeTaints

string[]

Les teintes ajoutées aux nouveaux nœuds pendant la création et la mise à l’échelle du pool de nœuds. Par exemple, key=value :NoSchedule.
orchestratorVersion

string

Version de Kubernetes spécifiée par l’utilisateur. Les deux versions de correctif <> major.minor.patch (par exemple, 1.20.13) et <> major.minor (par exemple, 1,20) sont prises en charge. Lorsque <> major.minor est spécifié, la dernière version de correctif ga prise en charge est choisie automatiquement. La mise à jour du cluster avec le même <major.minor> une fois qu’il a été créé (par exemple, 1.14.x -> 1.14) ne déclenche pas de mise à niveau, même si une version de correctif plus récente est disponible. En guise de meilleure pratique, vous devez mettre à niveau tous les pools de nœuds d’un cluster AKS vers la même version de Kubernetes. La version du pool de nœuds doit avoir la même version principale que le plan de contrôle. La version mineure du pool de nœuds doit se trouver dans deux versions mineures de la version du plan de contrôle. La version du pool de nœuds ne peut pas être supérieure à la version du plan de contrôle. Pour plus d’informations, consultez mise à niveau d’un pool de nœuds.
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, consultez système d’exploitation éphémère.
osSKU

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

OSType

Linux

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

PodIPAllocationMode

Mode d’allocation IP du pod. Mode d’allocation IP pour les pods dans le pool d’agents. Doit être utilisé avec podSubnetId. La valeur par défaut est « DynamicIndividual ».
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}
powerState

PowerState

Indique si le pool d’agents est en cours d’exécution ou arrêté. Lorsqu’un pool d’agents est créé pour la première fois, il est en cours d’exécution. Le pool d’agents peut être arrêté en définissant ce champ sur Arrêté. Un pool d’agents arrêté arrête toutes ses machines virtuelles et n’accumule pas de frais de facturation. Un pool d’agents ne peut être arrêté que s’il est en cours d’exécution et si l’état d’approvisionnement est Réussi
provisioningState

string

État actuel du déploiement ou de l’approvisionnement.
proximityPlacementGroupID

string (arm-id)

ID du groupe de placement de proximité.
scaleDownMode

ScaleDownMode

Mode scale-down à utiliser lors de la mise à l’échelle du pool d’agents. Cela affecte également le comportement du générateur de mise à l’échelle automatique du cluster. S’il n’est pas spécifié, il est défini par défaut sur Delete.
scaleSetEvictionPolicy

ScaleSetEvictionPolicy

Delete

Stratégie d’éviction du groupe de machines virtuelles identiques à utiliser. Cela ne peut pas être spécifié, sauf si scaleSetPriority est « Spot ». S’il n’est pas spécifié, la valeur par défaut est « Supprimer ».
scaleSetPriority

ScaleSetPriority

Regular

Priorité du groupe de machines virtuelles identiques. S’il n’est pas spécifié, la valeur par défaut est « Standard ».
securityProfile

AgentPoolSecurityProfile

Paramètres de sécurité d’un pool d’agents.
spotMaxPrice

number

-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. Les valeurs possibles sont une valeur décimale supérieure à zéro ou -1 qui indique la volonté de payer n’importe quel prix à la demande. Pour plus d’informations sur la tarification spot, consultez tarification des machines virtuelles spot
status

AgentPoolStatus

Contient des informations en lecture seule sur le pool d’agents.
tags

object

Balises à conserver sur le groupe de machines virtuelles identiques du pool d’agents.
type

AgentPoolType

Type de pool d’agents.
upgradeSettings

AgentPoolUpgradeSettings

Paramètres de mise à niveau du pool d’agents
virtualMachineNodesStatus

VirtualMachineNodes[]

État des nœuds dans un pool d’agents VirtualMachines.
virtualMachinesProfile

VirtualMachinesProfile

Spécifications sur le pool d’agents VirtualMachines.
vmSize

string

Taille des machines virtuelles du pool d’agents. 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
vnetSubnetID

string (arm-id)

ID du sous-réseau sur lequel les nœuds du pool d’agents et éventuellement les pods se joignent 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}
windowsProfile

AgentPoolWindowsProfile

Profil spécifique du pool d’agents Windows.
workloadRuntime

WorkloadRuntime

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

ManagedClusterAIToolchainOperatorProfile

Objet

Lors de l’activation de l’opérateur, un ensemble de CRD et de contrôleurs managés AKS est installé dans le cluster. L’opérateur automatise le déploiement de modèles OSS à des fins d’inférence et/ou d’entraînement. Il fournit un ensemble de modèles prédéfinis et active l’inférence distribuée par rapport à eux.

Nom Type Description
enabled

boolean

Indique s’il faut activer l’opérateur de chaîne d’outils d’IA dans le cluster. Indique si l’opérateur de chaîne d’outils IA est activé ou non.

ManagedClusterAPIServerAccessProfile

Objet

Profil d’accès pour le serveur d’API de cluster managé.

Nom Type Description
authorizedIPRanges

string[]

Les plages d’adresses IP autorisées à accéder au serveur d’API Kubernetes. Les plages d’adresses IP sont spécifiées au format CIDR, par exemple 137.117.106.88/29. Cette fonctionnalité n’est pas compatible avec les clusters qui utilisent l’adresse IP publique par nœud ou les clusters qui utilisent un équilibreur de charge de base. Pour plus d’informations, consultez plages d’adresses IP autorisées du serveur d’API.
disableRunCommand

boolean

Indique s’il faut désactiver la commande d’exécution pour le cluster ou non.
enablePrivateCluster

boolean

Indique s’il faut créer le cluster en tant que cluster privé ou non. Pour plus d’informations, consultez Création d’un cluster AKS privé.
enablePrivateClusterPublicFQDN

boolean

Indique s’il faut créer un nom de domaine complet public supplémentaire pour un cluster privé ou non.
enableVnetIntegration

boolean

Indique s’il faut activer l’intégration du réseau virtuel apiserver pour le cluster ou non. Voir aka.ms/AksVnetIntegration pour plus de détails.
privateDNSZone

string

Mode de zone DNS privé pour le cluster. La valeur par défaut est System. Pour plus d’informations, consultez configurer une zone DNS privée. Les valeurs autorisées sont « system » et « none ».
subnetId

string (arm-id)

Sous-réseau à utiliser lorsque l’intégration au réseau virtuel apiserver est activée. Il est requis lors de la création d’un cluster avec BYO Vnet ou lors de la mise à jour d’un cluster existant pour activer l’intégration de l’intégrateur de réseau virtuel apiserver.

ManagedClusterAutoUpgradeProfile

Objet

Profil de mise à niveau automatique pour un cluster managé.

Nom Type Description
nodeOSUpgradeChannel

nodeOSUpgradeChannel

Canal de mise à niveau du système d’exploitation du nœud. Manière dont le système d’exploitation sur vos nœuds est mis à jour. La valeur par défaut est NodeImage.
upgradeChannel

upgradeChannel

Canal de mise à niveau pour la mise à niveau automatique. La valeur par défaut est « none ». Pour plus d’informations, consultez la définition du canal de mise à niveau automatique du cluster AKS.

ManagedClusterAzureMonitorProfile

Objet

Profils de complément Azure Monitor pour la surveillance du cluster managé.

Nom Type Description
metrics

ManagedClusterAzureMonitorProfileMetrics

Profil de métriques pour le service managé Azure Monitor pour le module complémentaire Prometheus. Collectez les métriques d’infrastructure Kubernetes prêtes à l’emploi pour les envoyer à un espace de travail Azure Monitor et configurez la récupération supplémentaire pour les cibles personnalisées. Consultez aka.ms/AzureManagedPrometheus pour obtenir une vue d’ensemble.

ManagedClusterAzureMonitorProfileKubeStateMetrics

Objet

Profil de métriques Kube State pour le module complémentaire Prometheus managé Azure. Ces paramètres facultatifs concernent le pod kube-state-metrics déployé avec le module complémentaire. Consultez aka.ms/AzureManagedPrometheus-optional-parameters pour plus d’informations.

Nom Type Description
metricAnnotationsAllowList

string

Liste séparée par des virgules des clés d’annotation Kubernetes qui seront utilisées dans la métrique des étiquettes de la ressource (exemple : « namespaces=[kubernetes.io/team,...], pods=[kubernetes.io/team],... »). Par défaut, la métrique contient uniquement le nom de ressource et les étiquettes d’espace de noms.
metricLabelsAllowlist

string

Liste séparée par des virgules de clés d’étiquette Kubernetes supplémentaires qui seront utilisées dans la métrique d’étiquettes de la ressource (exemple : 'namespaces=[k8s-label-1,k8s-label-n,...],pods=[app],...'). Par défaut, la métrique contient uniquement le nom de ressource et les étiquettes d’espace de noms.

ManagedClusterAzureMonitorProfileMetrics

Objet

Profil de métriques pour le service managé Azure Monitor pour le module complémentaire Prometheus. Collectez les métriques d’infrastructure Kubernetes prêtes à l’emploi pour les envoyer à un espace de travail Azure Monitor et configurez la récupération supplémentaire pour les cibles personnalisées. Consultez aka.ms/AzureManagedPrometheus pour obtenir une vue d’ensemble.

Nom Type Description
enabled

boolean

Indique s’il faut activer ou désactiver le module complémentaire Prometheus managé Azure pour la surveillance Prometheus. Consultez aka.ms/AzureManagedPrometheus-aks-enable pour plus d’informations sur l’activation et la désactivation.
kubeStateMetrics

ManagedClusterAzureMonitorProfileKubeStateMetrics

Profil de métriques Kube State pour le module complémentaire Prometheus managé Azure. Ces paramètres facultatifs concernent le pod kube-state-metrics déployé avec le module complémentaire. Consultez aka.ms/AzureManagedPrometheus-optional-parameters pour plus d’informations.

ManagedClusterBootstrapProfile

Objet

Profil d’amorçage.

Nom Type Valeur par défaut Description
artifactSource

ArtifactSource

Direct

Source de l’artefact. Source à partir de laquelle les artefacts sont téléchargés.
containerRegistryId

string (arm-id)

ID de ressource d’Azure Container Registry. Le Registre doit disposer d’un accès réseau privé, d’une référence SKU Premium et d’une redondance de zone.

ManagedClusterCostAnalysis

Objet

Configuration de l’analyse des coûts pour le cluster

Nom Type Description
enabled

boolean

S’il faut activer l’analyse des coûts. Le niveau sku.tier du cluster managé doit être défini sur « Standard » ou « Premium » pour activer cette fonctionnalité. L’activation de cet outil ajoute les détails de l’espace de noms Kubernetes et du déploiement aux vues Analyse des coûts dans le portail Azure. S’il n’est pas spécifié, la valeur par défaut est false. Pour plus d’informations, consultez aka.ms/aks/docs/cost-analysis.

ManagedClusterHTTPProxyConfig

Objet

Configuration du proxy HTTP du cluster.

Nom Type Description
httpProxy

string

Point de terminaison du serveur proxy HTTP à utiliser.
httpsProxy

string

Point de terminaison du serveur proxy HTTPS à utiliser.
noProxy

string[]

Points de terminaison qui ne doivent pas passer par proxy.
trustedCa

string

Autre certificat d’autorité de certification à utiliser pour la connexion aux serveurs proxy.

ManagedClusterIdentity

Objet

Identité du cluster managé.

Nom Type Description
delegatedResources

<string,  DelegatedResource>

Ressources d’identité déléguées affectées à ce cluster managé. Cela ne peut être défini que par un autre fournisseur de ressources Azure et un cluster managé n’accepte qu’une seule ressource d’identité déléguée. Utilisation interne uniquement.
principalId

string

ID principal de l’identité attribuée par le système qui est utilisée par les composants maîtres.
tenantId

string

ID de locataire de l’identité attribuée au système qui est utilisée par les composants maîtres.
type

ResourceIdentityType

Type d’identité utilisé pour le cluster managé. Pour plus d’informations, consultez Utiliser des identités managées dans AKS.
userAssignedIdentities

UserAssignedIdentities

Identité de l’utilisateur associée au cluster managé. Cette identité sera utilisée dans le plan de contrôle. Une seule identité affectée par l’utilisateur est autorisée. Les clés doivent être des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».

ManagedClusterIngressProfile

Objet

Profil d’entrée pour le cluster de service de conteneur.

Nom Type Description
webAppRouting

ManagedClusterIngressProfileWebAppRouting

Paramètres de routage des applications pour le profil d’entrée. Vous trouverez une vue d’ensemble et un guide d’intégration de cette fonctionnalité à l’adresse https://learn.microsoft.com/en-us/azure/aks/app-routing?tabs=default%2Cdeploy-app-default.

ManagedClusterIngressProfileNginx

Objet
Nom Type Description
defaultIngressControllerType

NginxIngressControllerType

Type d’entrée pour la ressource personnalisée NginxIngressController par défaut

ManagedClusterIngressProfileWebAppRouting

Objet

Paramètres du module complémentaire Routage des applications pour le profil d’entrée.

Nom Type Description
dnsZoneResourceIds

string[] (arm-id)

ID de ressource des zones DNS à associer au module complémentaire Routage des applications. Utilisé uniquement lorsque le module complémentaire De routage des applications est activé. Les zones DNS publiques et privées peuvent se trouver dans différents groupes de ressources, mais toutes les zones DNS publiques doivent se trouver dans le même groupe de ressources et toutes les zones DNS privées doivent se trouver dans le même groupe de ressources.
enabled

boolean

Indique s’il faut activer le module complémentaire Routage des applications.
identity

UserAssignedIdentity

Identité managée du module complémentaire Application Routage. Il s’agit de l’identité à laquelle doivent être accordées les autorisations, par exemple, pour gérer la ressource DNS Azure associée et obtenir des certificats d’Azure Key Vault. Consultez cette présentation de l’add-on pour plus d’instructions .
nginx

ManagedClusterIngressProfileNginx

Configuration de NginxIngressController par défaut. Voir plus à https://learn.microsoft.com/en-us/azure/aks/app-routing-nginx-configuration#the-default-nginx-ingress-controller.

ManagedClusterLoadBalancerProfile

Objet

Profil de l’équilibreur de charge de cluster managé.

Nom Type Valeur par défaut Description
allocatedOutboundPorts

integer (int32)

minimum: 0
maximum: 64000 		0

Nombre souhaité de ports SNAT alloués par machine virtuelle. Les valeurs autorisées sont comprises entre 0 et 64 000 (inclus). La valeur par défaut est 0, ce qui entraîne l’allocation dynamique de ports dans Azure.
backendPoolType

BackendPoolType

NodeIPConfiguration

Type du pool principal de l’équilibreur de charge entrant managé.
effectiveOutboundIPs

ResourceReference[]

Ressources IP sortantes effectives de l’équilibreur de charge du cluster.
enableMultipleStandardLoadBalancers

boolean

Activez plusieurs équilibreurs de charge standard par cluster AKS ou non.
idleTimeoutInMinutes

integer (int32)

minimum: 4
maximum: 120 		30

Délai d’inactivité du flux sortant souhaité en minutes. Les valeurs autorisées sont comprises entre 4 et 120 (inclus). La valeur par défaut est 30 minutes.
managedOutboundIPs

ManagedOutboundIPs

Adresses IP sortantes gérées souhaitées pour l’équilibreur de charge du cluster.
outboundIPPrefixes

OutboundIPPrefixes

Ressources de préfixe IP sortantes souhaitées pour l’équilibreur de charge du cluster.
outboundIPs

OutboundIPs

Ressources IP sortantes souhaitées pour l’équilibreur de charge du cluster.

ManagedClusterManagedOutboundIPProfile

Objet

Profil des ressources IP sortantes gérées du cluster managé.

Nom Type Valeur par défaut Description
count

integer (int32)

minimum: 1
maximum: 16 		1

Nombre souhaité d’adresses IP sortantes créées/gérées par Azure. Les valeurs autorisées doivent être comprises entre 1 et 16 (inclus). La valeur par défaut est 1.

ManagedClusterMetricsProfile

Objet

Profil de métriques pour ManagedCluster.

Nom Type Description
costAnalysis

ManagedClusterCostAnalysis

Configuration pour une analyse détaillée des coûts des ressources par Kubernetes.

ManagedClusterNATGatewayProfile

Objet

Profil de la passerelle NAT de cluster managé.

Nom Type Valeur par défaut Description
effectiveOutboundIPs

ResourceReference[]

Ressources IP sortantes effectives de la passerelle NAT de cluster.
idleTimeoutInMinutes

integer (int32)

minimum: 4
maximum: 120 		4

Délai d’inactivité du flux sortant souhaité en minutes. Les valeurs autorisées sont comprises entre 4 et 120 (inclus). La valeur par défaut est de 4 minutes.
managedOutboundIPProfile

ManagedClusterManagedOutboundIPProfile

Profil des ressources IP sortantes gérées de la passerelle NAT de cluster.

ManagedClusterNodeProvisioningProfile

Objet
Nom Type Valeur par défaut Description
defaultNodePools

NodeProvisioningDefaultNodePools

Auto

Ensemble de Karpenter NodePools (CRD) par défaut configurés pour le provisionnement de nœuds. Ce champ n’a aucun effet à moins que le mode ne soit « Auto ». Avertissement : Si vous passez de Auto à Aucun sur un cluster existant, les NodePools Karpenter par défaut seront supprimés, ce qui drainera et supprimera les nœuds associés à ces pools. Il est fortement recommandé de ne pas le faire à moins qu’il n’y ait des nœuds inactifs prêts à prendre les pods expulsés par cette action. S’il n’est pas spécifié, la valeur par défaut est Auto. Pour plus d’informations, reportez-vous à la aka.ms/aks/nap#node-pools.
mode

NodeProvisioningMode

Mode d’approvisionnement de nœud. S’il n’est pas spécifié, la valeur par défaut est Manuelle.

ManagedClusterNodeResourceGroupProfile

Objet

Profil de verrouillage de groupe de ressources de nœud pour un cluster managé.

Nom Type Description
restrictionLevel

RestrictionLevel

Niveau de restriction appliqué au groupe de ressources de nœud du cluster. S’il n’est pas spécifié, la valeur par défaut est « Sans restriction »

ManagedClusterOIDCIssuerProfile

Objet

Profil d’émetteur OIDC du cluster managé.

Nom Type Description
enabled

boolean

Indique si l’émetteur OIDC est activé.
issuerURL

string

URL de l’émetteur OIDC du cluster géré.

ManagedClusterPodIdentity

Objet

Détails sur l’identité de pod affectée au cluster managé.

Nom Type Description
bindingSelector

string

Sélecteur de liaison à utiliser pour la ressource AzureIdentityBinding.
identity

UserAssignedIdentity

Détails de l’identité affectée par l’utilisateur.
name

string

Nom de l’identité de pod.
namespace

string

Espace de noms de l’identité de pod.
provisioningInfo

ProvisioningInfo

provisioningState

ManagedClusterPodIdentityProvisioningState

État d’approvisionnement actuel de l’identité de l’espace.

ManagedClusterPodIdentityException

Objet

Exception d’identité de pod, qui permet aux pods avec certaines étiquettes d’accéder au point de terminaison IMDS (Azure Instance Metadata Service) sans être interceptés par le serveur DMI (Node-Managed Identity). Pour plus d’informations, consultez désactiver l’identité de pod AAD pour un pod/application spécifique.

Nom Type Description
name

string

Nom de l’exception d’identité de pod.
namespace

string

Espace de noms de l’exception d’identité de pod.
podLabels

object

Étiquettes de pod à mettre en correspondance.

ManagedClusterPodIdentityProfile

Objet

Profil d’identité de pod du cluster managé. Consultez utiliser l’identité de pod AAD pour plus d’informations sur l’intégration de l’identité de pod.

Nom Type Description
allowNetworkPluginKubenet

boolean

Indique si l’identité de pod est autorisée à s’exécuter sur des clusters avec la mise en réseau Kubenet. L’exécution dans Kubenet est désactivée par défaut en raison de la nature liée à la sécurité de l’identité de pod AAD et des risques d’usurpation d’adresse IP. Pour plus d’informations, consultez l’utilisation du plug-in réseau Kubenet avec AAD Pod Identity .
enabled

boolean

Indique si le module complémentaire d’identité de pod est activé.
userAssignedIdentities

ManagedClusterPodIdentity[]

Identités de pod à utiliser dans le cluster.
userAssignedIdentityExceptions

ManagedClusterPodIdentityException[]

Exceptions d’identité de pod à autoriser.

ManagedClusterPodIdentityProvisioningError

Objet

Réponse d’erreur de l’approvisionnement d’identité de pod.

Nom Type Description
error

ManagedClusterPodIdentityProvisioningErrorBody

Détails de l’erreur.

ManagedClusterPodIdentityProvisioningErrorBody

Objet

Réponse d’erreur de l’approvisionnement d’identité de pod.

Nom Type Description
code

string

Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
details

ManagedClusterPodIdentityProvisioningErrorBody[]

Liste des détails supplémentaires sur l’erreur.
message

string

Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.
target

string

Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur.

ManagedClusterPodIdentityProvisioningState

Énumération

État d’approvisionnement actuel de l’identité de l’espace.

Valeur Description
Assigned
Canceled
Deleting
Failed
Succeeded
Updating

ManagedClusterSecurityProfile

Objet

Profil de sécurité pour le cluster de service de conteneur.

Nom Type Description
azureKeyVaultKms

AzureKeyVaultKms

Paramètres du service de gestion des clés Azure Key Vault pour le profil de sécurité.
customCATrustCertificates

string[] (byte)

Liste de 10 autorités de certification encodées en base64 pouvant être ajoutées au magasin d’approbations sur tous les nœuds du cluster. Pour plus d’informations, consultez Certificats d’approbation d’autorité de certification personnalisés.
defender

ManagedClusterSecurityProfileDefender

Paramètres Microsoft Defender pour le profil de sécurité.
imageCleaner

ManagedClusterSecurityProfileImageCleaner

Paramètres de nettoyage d’image pour le profil de sécurité.
workloadIdentity

ManagedClusterSecurityProfileWorkloadIdentity

Paramètres d’identité de charge de travail pour le profil de sécurité. L’identité de charge de travail permet aux applications Kubernetes d’accéder en toute sécurité aux ressources cloud Azure avec Azure AD. Pour plus d’informations, consultez l’article https://aka.ms/aks/wi.

ManagedClusterSecurityProfileDefender

Objet

Paramètres Microsoft Defender pour le profil de sécurité.

Nom Type Description
logAnalyticsWorkspaceResourceId

string (arm-id)

ID de ressource de l’espace de travail Log Analytics à associer à Microsoft Defender. Lorsque Microsoft Defender est activé, ce champ est obligatoire et doit être un ID de ressource d’espace de travail valide. Lorsque Microsoft Defender est désactivé, laissez le champ vide.
securityMonitoring

ManagedClusterSecurityProfileDefenderSecurityMonitoring

Détection des menaces Microsoft Defender pour les paramètres cloud du profil de sécurité.

ManagedClusterSecurityProfileDefenderSecurityMonitoring

Objet

Paramètres Microsoft Defender pour la détection des menaces de profil de sécurité.

Nom Type Description
enabled

boolean

Indique s’il faut activer la détection des menaces Defender

ManagedClusterSecurityProfileImageCleaner

Objet

Image Cleaner supprime les images inutilisées des nœuds, libère de l’espace disque et contribue à réduire la surface d’attaque. Voici les paramètres du profil de sécurité.

Nom Type Description
enabled

boolean

Indique s’il faut activer Image Cleaner sur le cluster AKS.
intervalHours

integer (int32)

Intervalle d’analyse de nettoyage d’image en heures.

ManagedClusterSecurityProfileWorkloadIdentity

Objet

Paramètres d’identité de charge de travail pour le profil de sécurité.

Nom Type Description
enabled

boolean

Indique s’il faut activer l’identité de charge de travail.

ManagedClusterServicePrincipalProfile

Objet

Informations sur une identité de principal de service pour le cluster à utiliser pour manipuler des API Azure.

Nom Type Description
clientId

string

ID du principal de service.
secret

string

Mot de passe secret associé au principal de service en texte brut.

ManagedClusterSKU

Objet

Référence SKU d’un cluster managé.

Nom Type Description
name

ManagedClusterSKUName

Nom d’une référence SKU de cluster managé.
tier

ManagedClusterSKUTier

Niveau d’une référence SKU de cluster managé. S’il n’est pas spécifié, la valeur par défaut est « Free ». Pour plus d’informations, consultez le niveau tarifaire AKS .

ManagedClusterSKUName

Énumération

Nom d’une référence SKU de cluster managé.

Valeur Description
Base

Option de base pour le plan de contrôle AKS.
Automatic

Les clusters automatiques sont optimisés pour exécuter la plupart des charges de travail de production avec une configuration qui suit les meilleures pratiques AKS et les recommandations pour la configuration, l’évolutivité et la sécurité des clusters et des charges de travail. Pour plus d’informations sur les clusters automatiques, consultez aka.ms/aks/automatic.

ManagedClusterSKUTier

Énumération

Niveau d’une référence SKU de cluster managé. S’il n’est pas spécifié, la valeur par défaut est « Free ». Pour plus d’informations, consultez le niveau tarifaire AKS .

Valeur Description
Standard

Recommandé pour les charges de travail stratégiques et de production. Inclut la mise à l’échelle automatique du plan de contrôle Kubernetes, les tests gourmands en charge de travail et jusqu’à 5 000 nœuds par cluster. Garantit la disponibilité de 99,95% du point de terminaison du serveur d’API Kubernetes pour les clusters qui utilisent des zones de disponibilité et 99,9% de disponibilité pour les clusters qui n’utilisent pas de zones de disponibilité.
Free

La gestion du cluster est gratuite, mais payante pour l’utilisation de la machine virtuelle, du stockage et de la mise en réseau. Il est préférable d’expérimenter, d’apprendre, de tester facilement ou de charges de travail avec moins de 10 nœuds. Non recommandé pour les cas d’usage de production.
Premium

Le cluster dispose de fonctionnalités premium en plus de toutes les fonctionnalités incluses dans « Standard ». Premium active la sélection de LongTermSupport (aka.ms/aks/lts) pour certaines versions de Kubernetes.

ManagedClusterStaticEgressGatewayProfile

Objet

Configuration du module complémentaire de passerelle de sortie statique pour le cluster.

Nom Type Description
enabled

boolean

Activez l’addon Static Egress Gateway. Indique si le module complémentaire passerelle de sortie statique est activé ou non.

ManagedClusterStatus

Objet

Contient des informations en lecture seule sur le cluster managé.

Nom Type Description
provisioningError

ErrorDetail

Informations détaillées de l’erreur sur le cluster géré. Préserve les informations détaillées de l’échec. S’il n’y a pas eu d’erreur, ce champ est omis.

ManagedClusterStorageProfile

Objet

Profil de stockage pour le cluster de service de conteneur.

Nom Type Description
blobCSIDriver

ManagedClusterStorageProfileBlobCSIDriver

Paramètres du pilote CSI AzureBlob pour le profil de stockage.
diskCSIDriver

ManagedClusterStorageProfileDiskCSIDriver

Paramètres du pilote CSI AzureDisk pour le profil de stockage.
fileCSIDriver

ManagedClusterStorageProfileFileCSIDriver

Paramètres du pilote CSI AzureFile pour le profil de stockage.
snapshotController

ManagedClusterStorageProfileSnapshotController

Paramètres du contrôleur d’instantané pour le profil de stockage.

ManagedClusterStorageProfileBlobCSIDriver

Objet

Paramètres du pilote CSI AzureBlob pour le profil de stockage.

Nom Type Description
enabled

boolean

Indique s’il faut activer le pilote CSI AzureBlob. La valeur par défaut est false.

ManagedClusterStorageProfileDiskCSIDriver

Objet

Paramètres du pilote CSI AzureDisk pour le profil de stockage.

Nom Type Description
enabled

boolean

Indique s’il faut activer le pilote CSI AzureDisk. La valeur par défaut est true.

ManagedClusterStorageProfileFileCSIDriver

Objet

Paramètres du pilote CSI AzureFile pour le profil de stockage.

Nom Type Description
enabled

boolean

Indique s’il faut activer le pilote CSI AzureFile. La valeur par défaut est true.

ManagedClusterStorageProfileSnapshotController

Objet

Paramètres du contrôleur d’instantané pour le profil de stockage.

Nom Type Description
enabled

boolean

Indique s’il faut activer le contrôleur d’instantané. La valeur par défaut est true.

ManagedClusterWindowsProfile

Objet

Profil des machines virtuelles Windows dans le cluster managé.

Nom Type Description
adminPassword

string

Spécifie le mot de passe du compte d’administrateur.

Longueur minimale : 8 caractères

Longueur maximale : 123 caractères

Exigences de complexité : 3 conditions sur 4 ci-dessous doivent être remplies
Comporte des caractères inférieurs
Comporte des caractères supérieurs
A un chiffre
A un caractère spécial (correspondance Regex [\W_])

Valeurs non autorisées : « abc@123 », « P@$$w 0rd », « P@ssw0rd », « P@ssword123 », « Pa$$word », « pass@word1 », « Password ! », « Password1 », « Password22 », « iloveyou ! »
adminUsername

string

Spécifie le nom du compte d’administrateur.

restriction : impossible de se terminer par « ».

Valeurs non autorisées : « administrateur », « admin », « user », « user1 », « test », « user2 », « test1 », « user3 », « admin1 », « admin1 », « 1 », « 123 », « a », « actuser », « adm », « admin2 », « aspnet », « backup », « console », « david », « guest », « john », « owner », « root », « server », « sql », « support », « support_388945a0 », « sys », « test2 », « test3 », « user4 », « user5 ».

Longueur minimale : 1 caractère

Longueur maximale : 20 caractères
enableCSIProxy

boolean

Indique s’il faut activer le proxy CSI. Pour plus d’informations sur le proxy CSI, consultez le dépôt GitHub du proxy CSI.
gmsaProfile

WindowsGmsaProfile

Profil gMSA Windows dans le cluster managé.
licenseType

licenseType

Type de licence à utiliser pour les machines virtuelles Windows. Pour plus d’informations, consultez Azure Hybrid User Benefits .

ManagedClusterWorkloadAutoScalerProfile

Objet

Profil de mise à l’échelle automatique de la charge de travail pour le cluster managé.

Nom Type Description
keda

ManagedClusterWorkloadAutoScalerProfileKeda

Paramètres KEDA (Mise à l’échelle automatique pilotée par les événements Kubernetes) pour le profil de mise à l’échelle automatique de la charge de travail.
verticalPodAutoscaler

ManagedClusterWorkloadAutoScalerProfileVerticalPodAutoscaler

Paramètres VPA (Vertical Pod Autoscaler) pour le profil de mise à l’échelle automatique de la charge de travail.

ManagedClusterWorkloadAutoScalerProfileKeda

Objet

Paramètres KEDA (Mise à l’échelle automatique pilotée par les événements Kubernetes) pour le profil de mise à l’échelle automatique de la charge de travail.

Nom Type Description
enabled

boolean

Indique s’il faut activer KEDA.

ManagedClusterWorkloadAutoScalerProfileVerticalPodAutoscaler

Objet

Paramètres VPA (Vertical Pod Autoscaler) pour le profil de mise à l’échelle automatique de la charge de travail.

Nom Type Valeur par défaut Description
enabled

boolean

False

Indique s’il faut activer VPA. La valeur par défaut est False.

ManagedOutboundIPs

Objet

Adresses IP sortantes gérées souhaitées pour l’équilibreur de charge du cluster.

Nom Type Valeur par défaut Description
count

integer (int32)

minimum: 1
maximum: 100 		1

Nombre souhaité d’adresses IP sortantes IPv4 créées/gérées par Azure pour l’équilibreur de charge du cluster. Les valeurs autorisées doivent être comprises entre 1 et 100 (inclus). La valeur par défaut est 1.
countIPv6

integer (int32)

minimum: 0
maximum: 100 		0

Nombre souhaité d’adresses IP sortantes IPv6 créées/gérées par Azure pour l’équilibreur de charge du cluster. Les valeurs autorisées doivent être comprises entre 1 et 100 (inclus). La valeur par défaut est 0 pour une pile unique et 1 pour la double pile.

ManualScaleProfile

Objet

Spécifications sur le nombre de machines.

Nom Type Description
count

integer (int32)

Nombre de nœuds.
size

string

Taille de machine virtuelle utilisée par AKS lors de la création et de la mise à l’échelle, par exemple , « Standard_E4s_v3 », « Standard_E16s_v3 » ou « Standard_D16s_v5 ».

networkDataplane

Énumération

Plan de données réseau utilisé dans le cluster Kubernetes.

Valeur Description
azure

Utilisez le plan de données réseau Azure.
cilium

Utilisez le plan de données réseau Cilium. Pour plus d’informations, consultez Azure CNI optimisé par Cilium.

networkMode

Énumération

Le mode réseau avec lequel Azure CNI est configuré. Cela ne peut pas être spécifié si networkPlugin est autre que « azure ».

Valeur Description
transparent

Aucun pont n’est créé. Intra-VM communication pod à pod est via des itinéraires IP créés par Azure CNI. Pour plus d’informations, consultez en mode transparent.
bridge

Ce n’est plus pris en charge

NetworkPlugin

Énumération

Plug-in réseau utilisé pour créer le réseau Kubernetes.

Valeur Description
azure

Utilisez le plug-in réseau Azure CNI. Pour plus d’informations, consultez mise en réseau Azure CNI (avancée).
kubenet

Utilisez le plugin réseau Kubenet. Pour plus d’informations, consultez de mise en réseau Kubenet (de base).
none

Aucun plugin CNI n’est préinstallé. Pour plus d’informations, consultez BYO CNI.

NetworkPluginMode

Énumération

Mode que le plug-in réseau doit utiliser.

Valeur Description
overlay

Utilisé avec networkPlugin=azure, les pods reçoivent des adresses IP de l’espace d’adressage PodCIDR, mais utilisent Azure Routing Domains plutôt que la méthode des tables de routage de Kubenet. Pour plus d’informations, visitez https://aka.ms/aks/azure-cni-overlay.

NetworkPolicy

Énumération

Stratégie réseau utilisée pour créer le réseau Kubernetes.

Valeur Description
none

Les politiques réseau ne seront pas appliquées. Il s’agit de la valeur par défaut lorsque NetworkPolicy n’est pas spécifié.
calico

Utilisez les politiques réseau Calico. Pour plus d’informations, consultez différences entre les stratégies Azure et Calico.
azure

Utilisez les stratégies réseau Azure. Pour plus d’informations, consultez différences entre les stratégies Azure et Calico.
cilium

Utilisez Cilium pour appliquer les politiques réseau. Cela nécessite que networkDataplane soit « cilium ».

NginxIngressControllerType

Énumération

Type d’entrée pour la ressource personnalisée NginxIngressController par défaut

Valeur Description
AnnotationControlled

Le NginxIngressController par défaut sera créé. Les utilisateurs peuvent modifier la ressource personnalisée NginxIngressController par défaut pour configurer les annotations de l’équilibreur de charge.
External

Le NginxIngressController par défaut sera créé et l’opérateur provisionnera un équilibreur de charge externe avec celui-ci. Toute annotation permettant de remplacer l’élément interne du équilibreur de charge par défaut.
Internal

Le NginxIngressController par défaut sera créé et l’opérateur provisionnera un équilibreur de charge interne avec celui-ci. Toute annotation permettant de remplacer l’élément loadbalancer externe par défaut.
None

Le contrôleur d’entrée par défaut ne sera pas créé. Il ne sera pas supprimé par le système s’il existe. Les utilisateurs doivent supprimer manuellement la ressource personnalisée NginxIngressController par défaut si vous le souhaitez.

nodeOSUpgradeChannel

Énumération

Canal de mise à niveau du système d’exploitation du nœud. Manière dont le système d’exploitation sur vos nœuds est mis à jour. La valeur par défaut est NodeImage.

Valeur Description
Unmanaged

Les mises à jour du système d’exploitation seront appliquées automatiquement via l’infrastructure de correctifs intégrée au système d’exploitation. Les machines nouvellement mises à l’échelle ne seront pas corrigées initialement et seront corrigées à un moment donné par l’infrastructure du système d’exploitation. Le comportement de cette option dépend du système d’exploitation en question. Ubuntu et Mariner appliquent des correctifs de sécurité via une mise à niveau sans assistance environ une fois par jour vers 06:00 UTC. Windows n’applique pas automatiquement les correctifs de sécurité et cette option est donc équivalente à Aucun jusqu’à nouvel ordre
None

Aucune tentative de mise à jour du système d’exploitation de votre machine ne sera effectuée, que ce soit par le système d’exploitation ou par le roulement des disques durs. Cela signifie que vous êtes responsable de vos mises à jour de sécurité
NodeImage

AKS mettra à jour les nœuds avec un disque dur virtuel récemment corrigé contenant des correctifs de sécurité et des correctifs de bogues à une fréquence hebdomadaire. Les machines à jour de disque dur virtuel sont réinitialnées sur ce disque dur virtuel après les fenêtres de maintenance et les paramètres d’augmentation. Aucun coût supplémentaire de disque dur virtuel n’est facturé lors du choix de cette option, car AKS héberge les images.
SecurityPatch

AKS télécharge et met à jour les nœuds avec des mises à jour de sécurité testées. Ces mises à jour respectent les paramètres de la fenêtre de maintenance et produisent un nouveau disque dur virtuel utilisé sur de nouveaux nœuds. Dans certains cas, il n’est pas possible d’appliquer les mises à jour en place, dans ce cas, les nœuds existants seront également re-imagené au disque dur virtuel nouvellement produit afin d’appliquer les modifications. Cette option entraîne un coût supplémentaire d’hébergement des nouveaux disques durs virtuels correctifs de sécurité dans votre groupe de ressources pour une consommation juste-à-temps.

NodeProvisioningDefaultNodePools

Énumération

Ensemble de Karpenter NodePools (CRD) par défaut configurés pour le provisionnement de nœuds. Ce champ n’a aucun effet à moins que le mode ne soit « Auto ». Avertissement : Si vous passez de Auto à Aucun sur un cluster existant, les NodePools Karpenter par défaut seront supprimés, ce qui drainera et supprimera les nœuds associés à ces pools. Il est fortement recommandé de ne pas le faire à moins qu’il n’y ait des nœuds inactifs prêts à prendre les pods expulsés par cette action. S’il n’est pas spécifié, la valeur par défaut est Auto. Pour plus d’informations, reportez-vous à la aka.ms/aks/nap#node-pools.

Valeur Description
None

Non, les NodePools Karpenter sont provisionnés automatiquement. La mise à l’échelle automatique ne se produira que si l’utilisateur crée une ou plusieurs instances CRD NodePool.
Auto

Un ensemble standard de NodePools Karpenter est provisionné

NodeProvisioningMode

Énumération

Mode d’approvisionnement de nœud. S’il n’est pas spécifié, la valeur par défaut est Manuelle.

Valeur Description
Manual

Les nœuds sont provisionnés manuellement par l’utilisateur
Auto

Les nœuds sont provisionnés automatiquement par AKS à l’aide de Karpenter (voir aka.ms/aks/nap pour plus d’informations). Les pools de nœuds de taille fixe peuvent toujours être créés, mais la mise à l’échelle automatique des pools de nœuds ne peut pas être. (Pour plus d’informations, consultez aka.ms/aks/nap).

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, consultez système d’exploitation éphémère.

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
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.
CBLMariner

Référence OSSKU déconseillée. Microsoft recommande que les nouveaux déploiements choisissent « AzureLinux » à la place.
Ubuntu

Utilisez Ubuntu comme système d’exploitation pour les images de nœud.
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
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
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.

OSType

Énumération

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

Valeur Description
Linux

Utilisez Linux.
Windows

Utilisez Windows.

OutboundIPPrefixes

Objet

Ressources de préfixe IP sortantes souhaitées pour l’équilibreur de charge du cluster.

Nom Type Description
publicIPPrefixes

ResourceReference[]

Liste des ressources de préfixe d’adresse IP publique.

OutboundIPs

Objet

Ressources IP sortantes souhaitées pour l’équilibreur de charge du cluster.

Nom Type Description
publicIPs

ResourceReference[]

Liste des ressources IP publiques.

outboundType

Énumération

Méthode de routage sortante (sortie). Cela ne peut être défini qu’au moment de la création du cluster et ne peut pas être modifié ultérieurement. Pour plus d’informations, consultez le type sortant de sortie.

Valeur Description
loadBalancer

L’équilibreur de charge est utilisé pour la sortie via une adresse IP publique attribuée par AKS. Cela prend en charge les services Kubernetes de type « loadBalancer ». Pour plus d’informations, consultez loadbalancer de type sortant.
userDefinedRouting

Les chemins de sortie doivent être définis par l’utilisateur. Il s’agit d’un scénario avancé et nécessite une configuration réseau appropriée. Pour plus d’informations, consultez userDefinedRouting de type sortant.
managedNATGateway

La passerelle NAT gérée par AKS est utilisée pour la sortie.
userAssignedNATGateway

La passerelle NAT affectée par l’utilisateur associée au sous-réseau du cluster est utilisée pour la sortie. Il s’agit d’un scénario avancé et nécessite une configuration réseau appropriée.
none

Le cluster AKS n’est pas défini avec un type sortant. Tous les nœuds AKS suivent le comportement sortant par défaut de la machine virtuelle Azure. Veuillez consulter https://azure.microsoft.com/en-us/updates/default-outbound-access-for-vms-in-azure-will-be-retired-transition-to-a-new-method-of-internet-access/

PodIPAllocationMode

Énumération

Mode d’allocation IP du pod. Mode d’allocation IP pour les pods dans le pool d’agents. Doit être utilisé avec podSubnetId. La valeur par défaut est « DynamicIndividual ».

Valeur Description
DynamicIndividual

Chaque nœud est alloué avec une liste non contiguë d’adresses IP pouvant être attribuées à des pods. Il est préférable d’optimiser un sous-réseau petit à moyen de taille /16 ou plus petite. Le cluster Azure CNI avec allocation d’adresses IP dynamique utilise par défaut ce mode si le client ne spécifie pas explicitement un podIPAllocationMode
StaticBlock

Chaque nœud se voit attribuer statiquement un ou plusieurs blocs CIDR de taille /28 = 16 adresses IP par bloc pour satisfaire les maxPods par nœud. Nombre de blocs CIDR >= (maxPods / 16). Le bloc, plutôt qu’une seule adresse IP, compte sur la limite d’adresses IP privées du réseau virtuel Azure de 65 Ko. Par conséquent, le mode bloc convient à l’exécution de charges de travail plus volumineuses avec plus que la limite actuelle de pods de 65 Ko dans un cluster. Ce mode est mieux adapté à la mise à l’échelle avec des sous-réseaux plus volumineux de /15 ou plus

PortRange

Objet

Plage de ports.

Nom Type Description
portEnd

integer (int32)

minimum: 1
maximum: 65535

Port maximal inclus dans la plage. Elle doit être comprise entre 1 et 65535, et être supérieure ou égale à portStart.
portStart

integer (int32)

minimum: 1
maximum: 65535

Port minimal inclus dans la plage. Elle doit être comprise entre 1 et 65535, et être inférieure ou égale à portEnd.
protocol

Protocol

Protocole réseau du port.

PowerState

Objet

Décrit l’état de l’alimentation du cluster

Nom Type Description
code

code

Indique si le cluster est en cours d’exécution ou arrêté

PrivateLinkResource

Objet

Ressource de liaison privée

Nom Type Description
groupId

string

ID de groupe de la ressource.
id

string

ID de la ressource de liaison privée.
name

string

Nom de la ressource de liaison privée.
privateLinkServiceID

string (arm-id)

L’ID du service de liaison privée de la ressource, ce champ n’est exposé qu’à NRP en interne.
requiredMembers

string[]

RequiredMembers de la ressource
type

string

Type de ressource.

Protocol

Énumération

Protocole réseau du port.

Valeur Description
TCP

Protocole TCP.
UDP

Protocole UDP.

ProvisioningInfo

Objet
Nom Type Description
error

ManagedClusterPodIdentityProvisioningError

Erreur d’attribution de l’identité de l’espace (le cas échéant).

PublicNetworkAccess

Énumération

PublicNetworkAccess du managedCluster. Autoriser ou refuser l’accès au réseau public pour AKS

Valeur Description
Enabled
Disabled

ResourceIdentityType

Énumération

Type d’identité utilisé pour le cluster managé. Pour plus d’informations, consultez Utiliser des identités managées dans AKS.

Valeur Description
SystemAssigned

Utilisez une identité managée attribuée à un système créé implicitement pour gérer les ressources du cluster. Les composants maîtres dans le plan de contrôle, tels que kube-controller-manager, utilisent l’identité managée attribuée par le système pour manipuler les ressources Azure.
UserAssigned

Utilisez une identité spécifiée par l’utilisateur pour gérer les ressources du cluster. Les composants maîtres dans le plan de contrôle, tels que kube-controller-manager, utilisent l’identité managée spécifiée affectée par l’utilisateur pour manipuler les ressources Azure.
None

N’utilisez pas d’identité managée pour le cluster managé, le principal de service sera utilisé à la place.

ResourceReference

Objet

Référence à une ressource Azure.

Nom Type Description
id

string (arm-id)

ID de ressource Azure complet.

RestrictionLevel

Énumération

Niveau de restriction appliqué au groupe de ressources de nœud du cluster. S’il n’est pas spécifié, la valeur par défaut est « Sans restriction »

Valeur Description
Unrestricted

Toutes les autorisations RBAC sont autorisées sur le groupe de ressources de nœud géré
ReadOnly

Seules les autorisations RBAC */lecture sont autorisées sur le groupe de ressources de nœud géré

ScaleDownMode

Énumération

Décrit comment les machines virtuelles sont ajoutées ou supprimées des pools d’agents. Voir les états de facturation.

Valeur Description
Delete

Créez de nouvelles instances pendant la montée en charge et supprimez des instances pendant la montée en charge.
Deallocate

Essayez de démarrer les instances désallouées (le cas échéant) pendant la montée en charge et de désallouer des instances pendant la mise à l’échelle.

ScaleProfile

Objet

Spécifications sur la façon de mettre à l’échelle un pool d’agents VirtualMachines.

Nom Type Description
manual

ManualScaleProfile[]

Spécifications sur la façon de mettre à l’échelle le pool d’agents VirtualMachines à une taille fixe.

ScaleSetEvictionPolicy

Énumération

Stratégie d’éviction du groupe de machines virtuelles identiques. La stratégie d’éviction spécifie ce qu’il faut faire de la machine virtuelle lorsqu’elle est expulsée. La valeur par défaut est Supprimer. Pour plus d’informations sur l’éviction, consultez VM spot

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.

ServiceMeshMode

Énumération

Mode du maillage de service.

Valeur Description
Istio

Istio déployé en tant qu’addon AKS.
Disabled

Le maillage est désactivé.

ServiceMeshProfile

Objet

Profil de maillage de service pour un cluster managé.

Nom Type Description
istio

IstioServiceMesh

Configuration du maillage de service Istio.
mode

ServiceMeshMode

Mode du maillage de service.

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.

UndrainableNodeBehavior

Énumération

Définit le comportement des nœuds indrainables pendant la mise à niveau. La cause la plus courante des nœuds indrainables est les budgets d’interruption de pod (PDB), mais d’autres problèmes, tels que la période de grâce de terminaison de pod, dépassent le délai d’expiration du drainage par nœud restant ou le pod est toujours dans un état d’exécution, peut également entraîner des nœuds indrainables.

Valeur Description
Schedule

AKS marquera les nœuds bloqués planifiables, mais les nœuds bloqués ne sont pas mis à niveau. Une tentative optimale sera effectuée pour supprimer tous les nœuds de surtension. L’opération de mise à niveau et le cluster managé sont en état d’échec s’il existe des nœuds bloqués.
Cordon

AKS isolera les nœuds bloqués et les remplacera par des nœuds de surtension lors de la mise à niveau. Les nœuds bloqués sont cordonnés et remplacés par des nœuds de surtension. Les nœuds bloqués auront l’étiquette « kubernetes.azure.com/upgrade-status:Quarantined ». Un nœud de surtension sera conservé pour chaque nœud bloqué. Une tentative optimale sera effectuée pour supprimer tous les autres nœuds de surtension. S’il existe suffisamment de nœuds d’augmentation pour remplacer les nœuds bloqués, l’opération de mise à niveau et le cluster managé sont en état d’échec. Sinon, l’opération de mise à niveau et le cluster managé sont à l’état annulé.

upgradeChannel

Énumération

Canal de mise à niveau pour la mise à niveau automatique. La valeur par défaut est « none ». Pour plus d’informations, consultez la définition du canal de mise à niveau automatique du cluster AKS.

Valeur Description
rapid

Mettez automatiquement à niveau le cluster vers la dernière version de correctif prise en charge sur la dernière version mineure prise en charge. Dans les cas où le cluster se trouve dans une version de Kubernetes qui se trouve dans une version mineure N-2 où N est la dernière version mineure prise en charge, le cluster effectue d’abord une mise à niveau vers la dernière version de correctif prise en charge sur la version mineure N-1. Par exemple, si un cluster exécute la version 1.17.7 et les versions 1.17.9, 1.18.4, 1.18.6 et 1.19.1 sont disponibles, votre cluster est d’abord mis à niveau vers la version 1.18.6, puis est mis à niveau vers la version 1.19.1.
stable

Mettez automatiquement à niveau le cluster vers la dernière version de correctif prise en charge sur la version mineure N-1, où N est la dernière version mineure prise en charge. Par exemple, si un cluster exécute la version 1.17.7 et les versions 1.17.9, 1.18.4, 1.18.6 et 1.19.1 sont disponibles, votre cluster est mis à niveau vers la version 1.18.6.
patch

Mettez automatiquement à niveau le cluster vers la dernière version de correctif prise en charge lorsqu’elle est disponible, tout en conservant la version mineure inchangée. Par exemple, si un cluster exécute la version 1.17.7 et les versions 1.17.9, 1.18.4, 1.18.6 et 1.19.1 sont disponibles, votre cluster est mis à niveau vers la version 1.17.9.
node-image

Mettez automatiquement à niveau l’image du nœud vers la dernière version disponible. Envisagez d’utiliser nodeOSUpgradeChannel à la place, car cela vous permet de configurer l’application de correctifs d’OS de nœud séparément de l’application d’un correctif de version Kubernetes
none

Désactive les mises à niveau automatiques et conserve le cluster dans sa version actuelle de Kubernetes.

UpgradeOverrideSettings

Objet

Paramètres des remplacements lors de la mise à niveau d’un cluster.

Nom Type Description
forceUpgrade

boolean

Indique s’il faut forcer la mise à niveau du cluster. Notez que cette option indique à l’opération de mise à niveau de contourner les protections de mise à niveau, telles que la vérification de l’utilisation déconseillée de l’API. Activez cette option uniquement avec précaution.
until

string (date-time)

Jusqu’à ce que les remplacements soient effectifs. Notez que cela correspond uniquement à l’heure de début d’une mise à niveau et que l’efficacité ne change pas une fois qu’une mise à niveau démarre même si la until mise à niveau expire à mesure que la mise à niveau se poursuit. Ce champ n’est pas défini par défaut. Elle doit être définie pour que les remplacements prennent effet.

UserAssignedIdentities

Objet

Identité de l’utilisateur associée au cluster managé. Cette identité sera utilisée dans le plan de contrôle. Une seule identité affectée par l’utilisateur est autorisée. Les clés doivent être des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».

Nom Type Description

UserAssignedIdentity

Objet

Détails sur une identité affectée par l’utilisateur.

Nom Type Description
clientId

string

ID client de l’identité affectée par l’utilisateur.
objectId

string

ID d’objet de l’identité affectée par l’utilisateur.
resourceId

string (arm-id)

ID de ressource de l’identité affectée par l’utilisateur.

VirtualMachineNodes

Objet

État actuel sur un groupe de nœuds de la même taille de machine virtuelle.

Nom Type Description
count

integer (int32)

Nombre de nœuds.
size

string

Taille de machine virtuelle des agents utilisés pour héberger ce groupe de nœuds.

VirtualMachinesProfile

Objet

Spécifications sur le pool d’agents VirtualMachines.

Nom Type Description
scale

ScaleProfile

Spécifications sur la façon de mettre à l’échelle un pool d’agents VirtualMachines.

WindowsGmsaProfile

Objet

Profil gMSA Windows dans le cluster managé.

Nom Type Description
dnsServer

string

Spécifie le serveur DNS pour Windows gMSA.

Définissez-le sur vide si vous avez configuré le serveur DNS dans le réseau virtuel utilisé pour créer le cluster managé.
enabled

boolean

Indique s’il faut activer gMSA Windows. Spécifie s’il faut activer gMSA Windows dans le cluster managé.
rootDomainName

string

Spécifie le nom de domaine racine pour Windows gMSA.

Définissez-le sur vide si vous avez configuré le serveur DNS dans le réseau virtuel utilisé pour créer le cluster managé.

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).
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.