Managed Clusters - Create Or Update
Cria ou atualiza um cluster gerenciado.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}?api-version=2026-01-01Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
resource
|
path | True |
string minLength: 1maxLength: 63 pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$ |
O nome do recurso de cluster gerenciado. |
|
subscription
|
path | True |
string (uuid) |
A ID da assinatura de destino. O valor deve ser uma UUID. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a ser usada para esta operação. |
Cabeçalho da solicitação
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| if-match |
string |
A solicitação só deve continuar se uma entidade corresponder a essa cadeia de caracteres. |
|
| if-none-match |
string |
A solicitação só deve continuar se nenhuma entidade corresponder a essa cadeia de caracteres. |
Corpo da solicitação
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| location | True |
string |
A localização geográfica onde o recurso reside |
| extendedLocation |
O local estendido da Máquina Virtual. |
||
| identity |
A identidade do cluster gerenciado, se configurada. |
||
| kind |
string |
Isso é usado principalmente para expor diferentes experiências de interface do usuário no portal para diferentes tipos |
|
| properties.aadProfile |
A configuração do Azure Active Directory. |
||
| properties.addonProfiles |
<string,
Managed |
O perfil do complemento de cluster gerenciado. |
|
| properties.agentPoolProfiles |
As propriedades do pool de agentes. |
||
| properties.aiToolchainOperatorProfile |
Configurações do operador de cadeia de ferramentas de IA que se aplicam a todo o cluster. |
||
| properties.apiServerAccessProfile |
O perfil de acesso para servidor API de cluster gerenciado. |
||
| properties.autoScalerProfile |
Parâmetros a serem aplicados ao cluster-autoscaler quando habilitados |
||
| properties.autoUpgradeProfile |
A configuração de atualização automática. |
||
| properties.azureMonitorProfile |
Perfis adicionais do Azure Monitor para monitoramento do cluster gerenciado. |
||
| properties.bootstrapProfile |
Perfil da configuração de inicialização do cluster. |
||
| properties.disableLocalAccounts |
boolean |
Se as contas locais devem ser desabilitadas no Cluster Gerenciado. Se definido como true, obter credenciais estáticas será desabilitado para esse cluster. Isso só deve ser usado em Clusters Gerenciados habilitados para AAD. Para mais detalhes, veja desabilitar contas locais. |
|
| properties.diskEncryptionSetID |
string (arm-id) |
A ID de recurso do conjunto de criptografia de disco a ser usado para habilitar a criptografia em repouso. Isso é do formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskEncryptionSets/{encryptionSetName}' |
|
| properties.dnsPrefix |
string |
O prefixo DNS do Cluster Gerenciado. Isso não pode ser atualizado depois que o Cluster Gerenciado tiver sido criado. |
|
| properties.enableRBAC |
boolean |
Se deveria ativar o Kubernetes Role-Based Access Control. |
|
| properties.fqdnSubdomain |
string |
O subdomínio FQDN do cluster privado com zona DNS privada personalizada. Isso não pode ser atualizado depois que o Cluster Gerenciado tiver sido criado. |
|
| properties.httpProxyConfig |
Configurações para provisionar o cluster com servidores proxy HTTP. |
||
| properties.identityProfile |
<string,
User |
A identidade do usuário associada ao cluster gerenciado. Essa identidade será usada pelo kubelet. Somente uma identidade atribuída pelo usuário é permitida. A única chave aceita é "kubeletidentity", com o valor de "resourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". |
|
| properties.ingressProfile |
Perfil de entrada para o cluster gerenciado. |
||
| properties.kubernetesVersion |
string |
A versão do Kubernetes especificada pelo usuário. Há suporte para a versão <de patch major.minor.patch> (por exemplo, 1.20.13) e <major.minor> (por exemplo, 1.20). Quando <major.minor> é especificado, a versão mais recente do patch ga com suporte é escolhida automaticamente. Atualizar o cluster com o mesmo <major.minor> depois que ele tiver sido criado (por exemplo, 1.14.x -> 1.14) não disparará uma atualização, mesmo se uma versão de patch mais recente estiver disponível. Quando você atualiza um cluster do AKS com suporte, as versões secundárias do Kubernetes não podem ser ignoradas. Todas as atualizações devem ser executadas sequencialmente pelo número de versão principal. Por exemplo, atualizações entre 1.14.x -> 1.15.x ou 1.15.x -> 1.16.x são permitidas, no entanto, 1.14.x -> 1.16.x não é permitido. Veja upgrade de um cluster AKS para mais detalhes. |
|
| properties.linuxProfile |
O perfil de VMs do Linux no Cluster Gerenciado. |
||
| properties.metricsProfile |
Configuração de métricas de cluster opcionais. |
||
| properties.networkProfile |
O perfil de configuração de rede. |
||
| properties.nodeProvisioningProfile |
Configurações de provisionamento de nó que se aplicam a todo o cluster. |
||
| properties.nodeResourceGroup |
string |
O nome do grupo de recursos que contém nós do pool de agentes. |
|
| properties.nodeResourceGroupProfile |
Perfil da configuração do grupo de recursos do nó. |
||
| properties.oidcIssuerProfile |
O perfil do emissor OIDC do Cluster Gerenciado. |
||
| properties.podIdentityProfile |
O perfil de identidade do pod do Cluster Gerenciado. Veja use identidade de pod AAD para mais detalhes sobre integração de identidade de pod AAD. |
||
| properties.privateLinkResources |
Private link resources associados ao cluster. |
||
| properties.publicNetworkAccess |
PublicNetworkAccess do managedCluster. Permitir ou negar acesso à rede pública para AKS |
||
| properties.securityProfile |
Perfil de segurança para o cluster gerenciado. |
||
| properties.serviceMeshProfile |
Perfil de malha de serviço para um cluster gerenciado. |
||
| properties.servicePrincipalProfile |
Informações sobre uma identidade de principal de serviço para o cluster usar na manipulação das APIs do Azure. |
||
| properties.status |
Contém informações somente leitura sobre o Cluster Gerenciado. |
||
| properties.storageProfile |
Perfil de Storage para o cluster gerenciado. |
||
| properties.supportPlan |
O plano de suporte para o Cluster Gerenciado. Se não for especificado, o padrão será 'KubernetesOfficial'. |
||
| properties.upgradeSettings |
Configurações para atualizar um cluster. |
||
| properties.windowsProfile |
O perfil para VMs do Windows no Cluster Gerenciado. |
||
| properties.workloadAutoScalerProfile |
Perfil de dimensionador automático de carga de trabalho para o cluster gerenciado. |
||
| sku |
A SKU do cluster gerenciado. |
||
| tags |
object |
Tags de recursos. |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
Operação de atualização do recurso 'ManagedCluster' bem-sucedida |
|
| 201 Created |
Recurso 'GerenciadoCluster' criar operação bem-sucedida Cabeçalhos
|
|
| Other Status Codes |
Uma resposta de erro inesperada. |
Segurança
azure_auth
Azure Active Directory OAuth2 Flow.
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
| Nome | Description |
|---|---|
| user_impersonation | representar sua conta de usuário |
Exemplos
Create Managed Cluster using an agent pool snapshot
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"creationData": {
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
},
"enableFIPS": true,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"creationData": {
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
},
"currentOrchestratorVersion": "1.9.6",
"enableFIPS": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"creationData": {
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1"
},
"currentOrchestratorVersion": "1.9.6",
"enableFIPS": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with Advanced Networking Transit Encryption
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"advancedNetworking": {
"enabled": true,
"observability": {
"enabled": false
},
"security": {
"advancedNetworkPolicies": "FQDN",
"enabled": true,
"transitEncryption": {
"type": "WireGuard"
}
}
},
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkDataplane": "cilium",
"networkPlugin": "azure",
"networkPluginMode": "overlay",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"advancedNetworking": {
"enabled": true,
"observability": {
"enabled": false
},
"security": {
"advancedNetworkPolicies": "FQDN",
"enabled": true,
"transitEncryption": {
"type": "WireGuard"
}
}
},
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkDataplane": "cilium",
"networkPlugin": "azure",
"networkPluginMode": "overlay",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded"
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"advancedNetworking": {
"enabled": true,
"observability": {
"enabled": false
},
"security": {
"advancedNetworkPolicies": "FQDN",
"enabled": true,
"transitEncryption": {
"type": "WireGuard"
}
}
},
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkDataplane": "cilium",
"networkPlugin": "azure",
"networkPluginMode": "overlay",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded"
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with AKS-managed NAT gateway as outbound type
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": false,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerSku": "standard",
"natGatewayProfile": {
"managedOutboundIPProfile": {
"count": 2
}
},
"outboundType": "managedNATGateway"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": false,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"loadBalancerSku": "basic",
"natGatewayProfile": {
"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"
}
],
"idleTimeoutInMinutes": 4,
"managedOutboundIPProfile": {
"count": 2
}
},
"networkPlugin": "kubenet",
"outboundType": "managedNATGateway",
"podCidr": "10.244.0.0/16",
"serviceCidr": "10.0.0.0/16"
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": false,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"loadBalancerSku": "standard",
"natGatewayProfile": {
"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"
}
],
"idleTimeoutInMinutes": 4,
"managedOutboundIPProfile": {
"count": 2
}
},
"networkPlugin": "kubenet",
"outboundType": "managedNATGateway",
"podCidr": "10.244.0.0/16",
"serviceCidr": "10.0.0.0/16"
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with Azure KeyVault Secrets Provider Addon
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {
"azureKeyvaultSecretsProvider": {
"config": {
"enableSecretRotation": "true",
"rotationPollInterval": "2m"
},
"enabled": true
}
},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"addonProfiles": {
"azureKeyvaultSecretsProvider": {
"config": {
"enableSecretRotation": "true",
"rotationPollInterval": "2m"
},
"enabled": true
}
},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"serviceCidr": "10.0.0.0/16"
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"addonProfiles": {
"azureKeyvaultSecretsProvider": {
"config": {
"enableSecretRotation": "true",
"rotationPollInterval": "2m"
},
"enabled": true
}
},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"serviceCidr": "10.0.0.0/16"
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with Capacity Reservation Group
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/capacityReservationGroups/crg1",
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/capacityReservationGroups/crg1",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"capacityReservationGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/capacityReservationGroups/crg1",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with Custom CA Trust Certificates
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"securityProfile": {
"customCATrustCertificates": [
"ZHVtbXlFeGFtcGxlVGVzdFZhbHVlRm9yQ2VydGlmaWNhdGVUb0JlQWRkZWQ="
]
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"securityProfile": {
"customCATrustCertificates": [
"ZHVtbXlFeGFtcGxlVGVzdFZhbHVlRm9yQ2VydGlmaWNhdGVUb0JlQWRkZWQ="
]
},
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"securityProfile": {
"customCATrustCertificates": [
"ZHVtbXlFeGFtcGxlVGVzdFZhbHVlRm9yQ2VydGlmaWNhdGVUb0JlQWRkZWQ="
]
},
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with Dedicated Host Group
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1",
"maxPods": 110,
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"hostGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.Compute/hostGroups/hostgroup1",
"maxPods": 110,
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with EncryptionAtHost enabled
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with FIPS enabled OS
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableFIPS": true,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableFIPS": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableFIPS": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with GPUMIG
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"gpuInstanceProfile": "MIG3g",
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_ND96asr_v4"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"httpProxyConfig": {
"httpProxy": "http://myproxy.server.com:8080",
"httpsProxy": "https://myproxy.server.com:8080",
"noProxy": [
"localhost",
"127.0.0.1"
],
"trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
},
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"gpuInstanceProfile": "MIG3g",
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_ND96asr_v4"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"httpProxyConfig": {
"httpProxy": "http://myproxy.server.com:8080",
"httpsProxy": "https://myproxy.server.com:8080",
"noProxy": [
"localhost",
"127.0.0.1"
],
"trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
},
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"gpuInstanceProfile": "MIG3g",
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_ND96asr_v4"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"httpProxyConfig": {
"httpProxy": "http://myproxy.server.com:8080",
"httpsProxy": "https://myproxy.server.com:8080",
"noProxy": [
"localhost",
"127.0.0.1"
],
"trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
},
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with HTTP proxy configured
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"httpProxyConfig": {
"httpProxy": "http://myproxy.server.com:8080",
"httpsProxy": "https://myproxy.server.com:8080",
"noProxy": [
"localhost",
"127.0.0.1"
],
"trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
},
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"httpProxyConfig": {
"httpProxy": "http://myproxy.server.com:8080",
"httpsProxy": "https://myproxy.server.com:8080",
"noProxy": [
"localhost",
"127.0.0.1"
],
"trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
},
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"httpProxyConfig": {
"httpProxy": "http://myproxy.server.com:8080",
"httpsProxy": "https://myproxy.server.com:8080",
"noProxy": [
"localhost",
"127.0.0.1"
],
"trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
},
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with LongTermSupport
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"apiServerAccessProfile": {
"disableRunCommand": true
},
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"supportPlan": "AKSLongTermSupport",
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Base",
"tier": "Premium"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"apiServerAccessProfile": {
"disableRunCommand": true
},
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-ee788a1f.hcp.location1.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"privateFQDN": "dnsprefix1-aae7e0f0.5cef6058-b6b5-414d-8cb1-4bd14eb0b15c.privatelink.location1.azmk8s.io",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"supportPlan": "AKSLongTermSupport",
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Base",
"tier": "Premium"
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"apiServerAccessProfile": {
"disableRunCommand": true
},
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-ee788a1f.hcp.location1.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"privateFQDN": "dnsprefix1-aae7e0f0.5cef6058-b6b5-414d-8cb1-4bd14eb0b15c.privatelink.location1.azmk8s.io",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"supportPlan": "AKSLongTermSupport",
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Base",
"tier": "Premium"
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with Node Public IP Prefix
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"nodePublicIPPrefixID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/public-ip-prefix",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"nodePublicIPPrefixID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/public-ip-prefix",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodePublicIPPrefixID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/public-ip-prefix",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with OSSKU
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osSKU": "AzureLinux",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"httpProxyConfig": {
"httpProxy": "http://myproxy.server.com:8080",
"httpsProxy": "https://myproxy.server.com:8080",
"noProxy": [
"localhost",
"127.0.0.1"
],
"trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
},
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osSKU": "AzureLinux",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"httpProxyConfig": {
"httpProxy": "http://myproxy.server.com:8080",
"httpsProxy": "https://myproxy.server.com:8080",
"noProxy": [
"localhost",
"127.0.0.1"
],
"trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
},
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osSKU": "AzureLinux",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"httpProxyConfig": {
"httpProxy": "http://myproxy.server.com:8080",
"httpsProxy": "https://myproxy.server.com:8080",
"noProxy": [
"localhost",
"127.0.0.1"
],
"trustedCa": "Q29uZ3JhdHMhIFlvdSBoYXZlIGZvdW5kIGEgaGlkZGVuIG1lc3NhZ2U="
},
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with PodIdentity enabled
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"podIdentityProfile": {
"allowNetworkPluginKubenet": true,
"enabled": true
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"podIdentityProfile": {
"allowNetworkPluginKubenet": true,
"enabled": true
},
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"podIdentityProfile": {
"allowNetworkPluginKubenet": true,
"enabled": true
},
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with PPG
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"proximityPlacementGroupID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/proximityPlacementGroups/ppg1",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with RunCommand disabled
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"apiServerAccessProfile": {
"disableRunCommand": true
},
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"apiServerAccessProfile": {
"disableRunCommand": true
},
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-ee788a1f.hcp.location1.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"privateFQDN": "dnsprefix1-aae7e0f0.5cef6058-b6b5-414d-8cb1-4bd14eb0b15c.privatelink.location1.azmk8s.io",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"supportPlan": "KubernetesOfficial",
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"apiServerAccessProfile": {
"disableRunCommand": true
},
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-ee788a1f.hcp.location1.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"privateFQDN": "dnsprefix1-aae7e0f0.5cef6058-b6b5-414d-8cb1-4bd14eb0b15c.privatelink.location1.azmk8s.io",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"supportPlan": "KubernetesOfficial",
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with Security Profile configured
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"dnsPrefix": "dnsprefix1",
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"securityProfile": {
"defender": {
"logAnalyticsWorkspaceResourceId": "/subscriptions/SUB_ID/resourceGroups/RG_NAME/providers/microsoft.operationalinsights/workspaces/WORKSPACE_NAME",
"securityMonitoring": {
"enabled": true
}
},
"workloadIdentity": {
"enabled": true
}
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"securityProfile": {
"defender": {
"logAnalyticsWorkspaceResourceId": "/subscriptions/SUB_ID/resourceGroups/RG_NAME/providers/microsoft.operationalinsights/workspaces/WORKSPACE_NAME",
"securityMonitoring": {
"enabled": true
}
},
"workloadIdentity": {
"enabled": true
}
},
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"securityProfile": {
"defender": {
"logAnalyticsWorkspaceResourceId": "/subscriptions/SUB_ID/resourceGroups/RG_NAME/providers/microsoft.operationalinsights/workspaces/WORKSPACE_NAME",
"securityMonitoring": {
"enabled": true
}
},
"workloadIdentity": {
"enabled": true
}
},
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with UltraSSD enabled
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"enableUltraSSD": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"enableUltraSSD": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"enableUltraSSD": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with user-assigned NAT gateway as outbound type
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": false,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerSku": "standard",
"outboundType": "userAssignedNATGateway"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": false,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "userAssignedNATGateway",
"podCidr": "10.244.0.0/16",
"serviceCidr": "10.0.0.0/16"
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": false,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "userAssignedNATGateway",
"podCidr": "10.244.0.0/16",
"serviceCidr": "10.0.0.0/16"
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Cluster with Web App Routing Ingress Profile configured
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"dnsPrefix": "dnsprefix1",
"ingressProfile": {
"webAppRouting": {
"dnsZoneResourceIds": [
"/subscriptions/SUB_ID/resourceGroups/RG_NAME/providers/Microsoft.Network/dnszones/DNS_ZONE_NAME"
],
"enabled": true
}
},
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"ingressProfile": {
"webAppRouting": {
"dnsZoneResourceIds": [
"/subscriptions/SUB_ID/resourceGroups/RG_NAME/providers/Microsoft.Network/dnszones/DNS_ZONE_NAME"
],
"enabled": true
}
},
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"ingressProfile": {
"webAppRouting": {
"dnsZoneResourceIds": [
"/subscriptions/SUB_ID/resourceGroups/RG_NAME/providers/Microsoft.Network/dnszones/DNS_ZONE_NAME"
],
"enabled": true
}
},
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Private Cluster with fqdn subdomain specified
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"apiServerAccessProfile": {
"enablePrivateCluster": true,
"privateDNSZone": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/privateDnsZones/privatelink.location1.azmk8s.io"
},
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"enableRBAC": true,
"fqdnSubdomain": "domain1",
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"apiServerAccessProfile": {
"enablePrivateCluster": true,
"privateDNSZone": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/privateDnsZones/privatelink.location1.azmk8s.io"
},
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"enableRBAC": true,
"fqdnSubdomain": "domain1",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"privateFQDN": "domain1.privatelink.location1.azmk8s.io",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"apiServerAccessProfile": {
"enablePrivateCluster": true,
"privateDNSZone": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/privateDnsZones/privatelink.location1.azmk8s.io"
},
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"enableRBAC": true,
"fqdnSubdomain": "domain1",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"privateFQDN": "domain1.privatelink.location1.azmk8s.io",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create Managed Private Cluster with Public FQDN specified
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"apiServerAccessProfile": {
"enablePrivateCluster": true,
"enablePrivateClusterPublicFQDN": true
},
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"apiServerAccessProfile": {
"enablePrivateCluster": true,
"enablePrivateClusterPublicFQDN": true,
"privateDNSZone": "system"
},
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-ee788a1f.hcp.location1.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"privateFQDN": "dnsprefix1-aae7e0f0.5cef6058-b6b5-414d-8cb1-4bd14eb0b15c.privatelink.location1.azmk8s.io",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"apiServerAccessProfile": {
"enablePrivateCluster": true,
"enablePrivateClusterPublicFQDN": true,
"privateDNSZone": "system"
},
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-ee788a1f.hcp.location1.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"privateFQDN": "dnsprefix1-aae7e0f0.5cef6058-b6b5-414d-8cb1-4bd14eb0b15c.privatelink.location1.azmk8s.io",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create/Update AAD Managed Cluster with EnableAzureRBAC
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"aadProfile": {
"enableAzureRBAC": true,
"managed": true
},
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"availabilityZones": [
"1",
"2",
"3"
],
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS1_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"aadProfile": {
"adminGroupObjectIDs": null,
"enableAzureRBAC": true,
"managed": true,
"tenantID": "tenantID"
},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"availabilityZones": [
"1",
"2",
"3"
],
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS1_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"aadProfile": {
"adminGroupObjectIDs": null,
"enableAzureRBAC": true,
"managed": true,
"tenantID": "tenantID"
},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"availabilityZones": [
"1",
"2",
"3"
],
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS1_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create/Update Managed Cluster
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {}
}
},
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"availabilityZones": [
"1",
"2",
"3"
],
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"scaleDownMode": "Deallocate",
"vmSize": "Standard_DS1_v2"
}
],
"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"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"upgradeSettings": {
"overrideSettings": {
"forceUpgrade": false,
"until": "2022-11-01T13:00:00Z"
}
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
"clientId": "clientId1",
"principalId": "principalId1"
}
}
},
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"availabilityZones": [
"1",
"2",
"3"
],
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"scaleDownMode": "Deallocate",
"vmSize": "Standard_DS1_v2"
}
],
"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"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"upgradeSettings": {
"overrideSettings": {
"forceUpgrade": false,
"until": "2022-11-01T13:00:00Z"
}
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
"clientId": "clientId1",
"principalId": "principalId1"
}
}
},
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"availabilityZones": [
"1",
"2",
"3"
],
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"scaleDownMode": "Deallocate",
"vmSize": "Standard_DS1_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create/Update Managed Cluster with Azure Service Mesh
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"location": "location1",
"properties": {
"addonProfiles": {
"azureKeyvaultSecretsProvider": {
"config": {
"enableSecretRotation": "true",
"rotationPollInterval": "2m"
},
"enabled": true
}
},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"serviceMeshProfile": {
"istio": {
"certificateAuthority": {
"plugin": {
"certChainObjectName": "cert-chain",
"certObjectName": "ca-cert",
"keyObjectName": "ca-key",
"keyVaultId": "/subscriptions/854c9ddb-fe9e-4aea-8d58-99ed88282881/resourceGroups/ddama-test/providers/Microsoft.KeyVault/vaults/my-akv",
"rootCertObjectName": "root-cert"
}
},
"components": {
"egressGateways": [
{
"name": "test-istio-egress",
"enabled": true,
"gatewayConfigurationName": "test-gateway-configuration"
}
],
"ingressGateways": [
{
"enabled": true,
"mode": "Internal"
}
]
}
},
"mode": "Istio"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"addonProfiles": {
"azureKeyvaultSecretsProvider": {
"config": {
"enableSecretRotation": "true",
"rotationPollInterval": "2m"
},
"enabled": true
}
},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"serviceCidr": "10.0.0.0/16"
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"serviceMeshProfile": {
"istio": {
"certificateAuthority": {
"plugin": {
"certChainObjectName": "cert-chain",
"certObjectName": "ca-cert",
"keyObjectName": "ca-key",
"keyVaultId": "/subscriptions/854c9ddb-fe9e-4aea-8d58-99ed88282881/resourceGroups/ddama-test/providers/Microsoft.KeyVault/vaults/my-akv",
"rootCertObjectName": "root-cert"
}
},
"components": {
"egressGateways": [
{
"name": "test-istio-egress",
"enabled": true,
"gatewayConfigurationName": "test-gateway-configuration"
}
],
"ingressGateways": [
{
"enabled": true,
"mode": "Internal"
}
]
},
"revisions": [
"asm-1-17"
]
},
"mode": "Istio"
},
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"location": "location1",
"properties": {
"addonProfiles": {
"azureKeyvaultSecretsProvider": {
"config": {
"enableSecretRotation": "true",
"rotationPollInterval": "2m"
},
"enabled": true
}
},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"count": 3,
"enableEncryptionAtHost": true,
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS2_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"serviceCidr": "10.0.0.0/16"
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"serviceMeshProfile": {
"istio": {
"certificateAuthority": {
"plugin": {
"certChainObjectName": "cert-chain",
"certObjectName": "ca-cert",
"keyObjectName": "ca-key",
"keyVaultId": "/subscriptions/854c9ddb-fe9e-4aea-8d58-99ed88282881/resourceGroups/ddama-test/providers/Microsoft.KeyVault/vaults/my-akv",
"rootCertObjectName": "root-cert"
}
},
"components": {
"egressGateways": [
{
"name": "test-istio-egress",
"enabled": true,
"gatewayConfigurationName": "test-gateway-configuration"
}
],
"ingressGateways": [
{
"enabled": true,
"mode": "Internal"
}
]
},
"revisions": [
"asm-1-17"
]
},
"mode": "Istio"
},
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create/Update Managed Cluster with dual-stack networking
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {}
}
},
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"availabilityZones": [
"1",
"2",
"3"
],
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"scaleDownMode": "Deallocate",
"vmSize": "Standard_DS1_v2"
}
],
"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"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"ipFamilies": [
"IPv4",
"IPv6"
],
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
"clientId": "clientId1",
"principalId": "principalId1"
}
}
},
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"availabilityZones": [
"1",
"2",
"3"
],
"count": 3,
"currentOrchestratorVersion": "1.22.1",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.22.1",
"osType": "Linux",
"provisioningState": "Succeeded",
"scaleDownMode": "Deallocate",
"vmSize": "Standard_DS1_v2"
}
],
"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"
},
"currentKubernetesVersion": "1.22.1",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.22.1",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4",
"IPv6"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2,
"countIPv6": 1
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16",
"fd11:1234::/64"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16",
"fd00:1234::/108"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
"clientId": "clientId1",
"principalId": "principalId1"
}
}
},
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"availabilityZones": [
"1",
"2",
"3"
],
"count": 3,
"currentOrchestratorVersion": "1.22.1",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.22.1",
"osType": "Linux",
"provisioningState": "Creating",
"scaleDownMode": "Deallocate",
"vmSize": "Standard_DS1_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.22.1",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.22.1",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4",
"IPv6"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2,
"countIPv6": 1
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16",
"fd11:1234::/64"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16",
"fd00:1234::/108"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create/Update Managed Cluster with EnableAHUB
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {}
}
},
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"availabilityZones": [
"1",
"2",
"3"
],
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS1_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser",
"licenseType": "Windows_Server"
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
"clientId": "clientId1",
"principalId": "principalId1"
}
}
},
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"availabilityZones": [
"1",
"2",
"3"
],
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS1_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser",
"licenseType": "Windows_Server"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
"clientId": "clientId1",
"principalId": "principalId1"
}
}
},
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"availabilityZones": [
"1",
"2",
"3"
],
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS1_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser",
"licenseType": "Windows_Server"
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Create/Update Managed Cluster with Windows gMSA enabled
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1?api-version=2026-01-01
{
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {}
}
},
"location": "location1",
"properties": {
"addonProfiles": {},
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"availabilityZones": [
"1",
"2",
"3"
],
"count": 3,
"enableNodePublicIP": true,
"mode": "System",
"osType": "Linux",
"vmSize": "Standard_DS1_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"networkProfile": {
"loadBalancerProfile": {
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"outboundType": "loadBalancer"
},
"servicePrincipalProfile": {
"clientId": "clientid",
"secret": "secret"
},
"windowsProfile": {
"adminPassword": "replacePassword1234$",
"adminUsername": "azureuser",
"gmsaProfile": {
"enabled": true
}
}
},
"sku": {
"name": "Basic",
"tier": "Free"
},
"tags": {
"archv2": "",
"tier": "production"
}
}
Resposta de exemplo
{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
"clientId": "clientId1",
"principalId": "principalId1"
}
}
},
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"availabilityZones": [
"1",
"2",
"3"
],
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Succeeded",
"vmSize": "Standard_DS1_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"fqdn": "dnsprefix1-abcd1234.hcp.eastus.azmk8s.io",
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "basic",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Succeeded",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser",
"gmsaProfile": {
"enabled": true
}
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}{
"name": "clustername1",
"type": "Microsoft.ContainerService/managedClusters",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1",
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgName1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {
"clientId": "clientId1",
"principalId": "principalId1"
}
}
},
"location": "location1",
"properties": {
"agentPoolProfiles": [
{
"name": "nodepool1",
"type": "VirtualMachineScaleSets",
"availabilityZones": [
"1",
"2",
"3"
],
"count": 3,
"currentOrchestratorVersion": "1.9.6",
"enableNodePublicIP": true,
"maxPods": 110,
"mode": "System",
"orchestratorVersion": "1.9.6",
"osType": "Linux",
"provisioningState": "Creating",
"vmSize": "Standard_DS1_v2"
}
],
"autoScalerProfile": {
"scale-down-delay-after-add": "15m",
"scan-interval": "20s"
},
"currentKubernetesVersion": "1.9.6",
"diskEncryptionSetID": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/diskEncryptionSets/des",
"dnsPrefix": "dnsprefix1",
"enableRBAC": true,
"kubernetesVersion": "1.9.6",
"linuxProfile": {
"adminUsername": "azureuser",
"ssh": {
"publicKeys": [
{
"keyData": "keydata"
}
]
}
},
"maxAgentPools": 1,
"networkProfile": {
"dnsServiceIP": "10.0.0.10",
"ipFamilies": [
"IPv4"
],
"loadBalancerProfile": {
"allocatedOutboundPorts": 2000,
"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"
}
],
"idleTimeoutInMinutes": 10,
"managedOutboundIPs": {
"count": 2
}
},
"loadBalancerSku": "standard",
"networkPlugin": "kubenet",
"outboundType": "loadBalancer",
"podCidr": "10.244.0.0/16",
"podCidrs": [
"10.244.0.0/16"
],
"serviceCidr": "10.0.0.0/16",
"serviceCidrs": [
"10.0.0.0/16"
]
},
"nodeResourceGroup": "MC_rg1_clustername1_location1",
"provisioningState": "Creating",
"servicePrincipalProfile": {
"clientId": "clientid"
},
"windowsProfile": {
"adminUsername": "azureuser",
"gmsaProfile": {
"enabled": true
}
}
},
"tags": {
"archv2": "",
"tier": "production"
}
}Definições
| Nome | Description |
|---|---|
|
Acceleration |
Ative as opções avançadas de aceleração de rede. Isso permite que os usuários configurem a aceleração usando o roteamento de host BPF. Isso pode ser ativado somente com o plano de dados do Cilium. Se não for especificado, o valor padrão será Nenhum (sem aceleração). O modo de aceleração pode ser alterado em um cluster pré-existente. Veja https://aka.ms/acnsperformance uma explicação detalhada |
|
Advanced |
Perfil avançado de rede para habilitar a observabilidade e o pacote de recursos de segurança em um cluster. Para obter mais informações, consulte aka.ms/aksadvancednetworking. |
|
Advanced |
Perfil de observabilidade para habilitar métricas de rede avançadas e logs de fluxo com contextos históricos. |
|
Advanced |
Profile para habilitar recursos de aprimoramento de desempenho em clusters que utilizam o Azure CNI alimentado pela Cilium. |
|
Advanced |
Perfil de segurança para habilitar recursos de segurança no cluster baseado em cilium. |
|
Advanced |
Configuração de criptografia para clusters baseados em Cilium. Uma vez ativado, todo o tráfego entre os pods gerenciados do Cilium será criptografado quando sair do limite do nó. |
|
Advanced |
Habilite políticas de rede avançadas. Isso permite que os usuários configurem políticas de rede da Camada 7 (FQDN, HTTP, Kafka). As próprias políticas devem ser configuradas por meio dos recursos da Política de Rede do Cilium, consulte https://docs.cilium.io/en/latest/security/policy/index.html. Isso só pode ser habilitado em clusters baseados em cilium. Se não for especificado, o valor padrão será FQDN se security.enabled for definido como true. |
|
Agent |
Perfil do pool de agentes do gateway de cluster gerenciado. |
|
Agent |
O modo de um pool de agentes. Um cluster deve ter pelo menos um pool de agentes 'System' o tempo todo. Para obter informações adicionais sobre restrições de pool de agentes e práticas recomendadas, consulte: https://docs.microsoft.com/azure/aks/use-system-pools |
|
Agent |
Configurações de rede de um pool de agentes. |
|
Agent |
As configurações de segurança de um pool de agentes. |
|
Agent |
Método de acesso SSH de um pool de agentes. |
|
Agent |
Contém informações somente leitura sobre o Pool de Agentes. |
|
Agent |
O tipo de Pool de Agentes. |
|
Agent |
Configurações para atualizar um agentpool |
|
Agent |
O perfil específico do pool de agentes do Windows. |
|
Artifact |
A origem do artefato. A origem da qual os artefatos são baixados. |
|
Azure |
Configurações do serviço de gerenciamento de chaves do Azure Key Vault para o perfil de segurança. |
|
Backend |
O tipo de entrada gerenciada Load Balancer BackendPool. |
|
Cluster |
Configurações para atualizar um cluster. |
| Code |
Informa se o cluster está em execução ou parado |
|
Container |
Perfil para VMs linux no cluster de serviço de contêiner. |
|
Container |
Perfil da configuração de rede. |
|
Container |
Configuração de SSH para VMs baseadas em Linux em execução no Azure. |
|
Container |
Contém informações sobre dados de chave pública do certificado SSH. |
|
created |
O tipo de identidade que criou o recurso. |
|
Creation |
Dados usados ao criar um recurso de destino de um recurso de origem. |
|
Delegated |
Propriedades de recurso delegadas – somente uso interno. |
|
Error |
As informações adicionais do erro de gerenciamento de recursos. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
| Expander |
O expansor a ser usado ao aumentar a escala. Se não for especificado, o padrão será "aleatório". Veja expanders para mais informações. |
|
Extended |
O tipo complexo do local estendido. |
|
Extended |
O tipo de extendedLocation. |
| GPUDriver |
Se os drivers de GPU devem ser instalados. Quando não for especificado, o padrão é Instalar. |
|
GPUInstance |
GPUInstanceProfile a ser usado para especificar o perfil de instância de GPU MIG para SKU de VM de GPU com suporte. |
| GPUProfile |
Configurações de GPU para o Pool de Agentes. |
| IPFamily |
Para determinar se o endereço pertence à família IPv4 ou IPv6 |
| IPTag |
Contém a IPTag associada ao objeto. |
|
Istio |
Configuração da AC (Autoridade de Certificação de Malha de Serviço) istio. Por enquanto, só damos suporte a certificados de plug-in, conforme descrito aqui https://aka.ms/asm-plugin-ca |
|
Istio |
Configuração de componentes istio. |
|
Istio |
Configuração do gateway de saída istio. |
|
Istio |
Configuração do gateway de entrada istio. Por enquanto, há suporte para até um gateway de entrada externo chamado |
|
Istio |
Modo de um gateway de entrada. |
|
Istio |
Informações de certificados de plug-in para a Malha de Serviço. |
|
Istio |
Configuração da malha de serviço istio. |
|
Key |
Acesso à rede do key vault. Acesso à rede do cofre de chaves. Os valores possíveis são |
|
Kubelet |
Configurações do Kubelet de nós de agente. Consulte de configuração de nó personalizado do AKS para obter mais detalhes. |
|
Kubelet |
Determina a posição dos volumes vazio de Dir, raiz de dados em tempo de execução do container e storage efêmero do Kubelet. |
|
Kubernetes |
Diferentes camadas de suporte para clusters gerenciados do AKS |
|
License |
O tipo de licença a ser usado para VMs do Windows. Veja Azure Benefícios para Usuários Híbridos para mais detalhes. |
|
Linux |
Configurações do sistema operacional de nós de agente do Linux. Consulte de configuração de nó personalizado do AKS para obter mais detalhes. |
|
Load |
O sku do balanceador de carga para o cluster gerenciado. O padrão é 'standard'. Veja Azure Load Balancer SKUs para mais informações sobre as diferenças entre load balancer SKUs. |
|
Local |
Servidor de destino para consultas DNS a serem encaminhadas do localDNS. |
|
Local |
Política de encaminhamento para selecionar o servidor DNS upstream. Consulte o plug-in de encaminhamento para obter mais informações. |
|
Local |
Modo de ativação para localDNS. |
|
Local |
Substituições para o perfil localDNS. |
|
Local |
Configura o DNS local por nó, com substituições de VnetDNS e KubeDNS. O LocalDNS ajuda a melhorar o desempenho e a confiabilidade da resolução DNS em um cluster do AKS. Para obter mais detalhes, consulte aka.ms/aks/localdns. |
|
Local |
Imponha o TCP ou prefira o protocolo UDP para conexões do localDNS ao servidor DNS upstream. |
|
Local |
Nível de log para consultas DNS no localDNS. |
|
Local |
Política para veiculação de dados obsoletos. Consulte o plug-in de cache para obter mais informações. |
|
Local |
Estado gerado pelo sistema de localDNS. |
|
Managed |
Cluster gerenciado. |
|
Managed |
O AADProfile especifica atributos para integração do Azure Active Directory. Para obter mais detalhes, consulte AAD gerenciado no AKS. |
|
Managed |
Um perfil de complemento do Kubernetes para um cluster gerenciado. |
|
Managed |
Informações da identidade atribuída pelo usuário usada por este complemento. |
|
Managed |
Perfil para o pool de agentes do serviço de contêiner. |
|
Managed |
Ao habilitar o operador, um conjunto de CRDs e controladores gerenciados pelo AKS será instalado no cluster. O operador automatiza a implantação de modelos de OSS para fins de inferência e/ou treinamento. Ele fornece um conjunto de modelos predefinidos e habilita a inferência distribuída contra eles. |
|
Managed |
Perfil de acesso para o servidor de API de cluster gerenciado. |
|
Managed |
Perfil de atualização automática para um cluster gerenciado. |
|
Managed |
Perfis adicionais do Azure Monitor para monitoramento do cluster gerenciado. |
|
Managed |
Perfil Kube State Metrics para o addon Azure Managed Prometheus. Essas configurações opcionais são para o pod kube-state-metrics implantado com o complemento. Consulte aka.ms/AzureManagedPrometheus-optional-parameters para obter detalhes. |
|
Managed |
Perfil de métricas para o serviço gerenciado Azure Monitor para o addon Prometheus. Colete métricas de infraestrutura Kubernetes prontas para enviar a um Workspace do Azure Monitor e configure scraping adicional para alvos personalizados. Consulte aka.ms/AzureManagedPrometheus para obter uma visão geral. |
|
Managed |
O perfil de inicialização. |
|
Managed |
A configuração de análise de custo para o cluster |
|
Managed |
Configuração do proxy HTTP do cluster. |
|
Managed |
Identidade para o cluster gerenciado. |
|
Managed |
Perfil de entrada para o cluster do serviço de contêiner. |
|
Managed |
Configuração do controlador de entrada Nginx para o perfil de entrada gerenciado do cluster. |
|
Managed |
Configurações de complemento de roteamento de aplicativo para o perfil de entrada. |
|
Managed |
Perfil do balanceador de carga do cluster gerenciado. |
|
Managed |
IPs gerenciados de saída desejados para o cluster load balancer. |
|
Managed |
Recursos de prefixo de IP de saída desejados para o balanceador de carga do cluster. |
|
Managed |
Recursos de IP de saída desejados para o balanceador de carga do cluster. |
|
Managed |
Perfil dos recursos de IP de saída gerenciados do cluster gerenciado. |
|
Managed |
O perfil de métricas do ManagedCluster. |
|
Managed |
Perfil do gateway NAT do cluster gerenciado. |
|
Managed |
Perfil de provisão de nós para o cluster gerenciado. |
|
Managed |
Perfil de bloqueio do grupo de recursos do nó para um cluster gerenciado. |
|
Managed |
O perfil do emissor OIDC do Cluster Gerenciado. |
|
Managed |
Detalhes sobre a identidade do pod atribuída ao Cluster Gerenciado. |
|
Managed |
Uma exceção de identidade de pod, que permite que pods com determinados rótulos acessem o ponto de extremidade do IMDS (Serviço de Metadados de Instância do Azure) sem serem interceptados pelo servidor NMI (identidade gerenciada por nó). Consulte desabilitar a Identidade do Pod do AAD para obter um pod/ de aplicativo específico para obter mais detalhes. |
|
Managed |
O perfil de identidade do pod do Cluster Gerenciado. Consulte usar a identidade do pod do AAD para obter mais detalhes sobre a integração de identidade do pod. |
|
Managed |
Uma resposta de erro do provisionamento de identidade do pod. |
|
Managed |
Uma resposta de erro do provisionamento de identidade do pod. |
|
Managed |
Informações de provisão de identidade do pod. |
|
Managed |
O estado de provisionamento atual da identidade do pod. |
|
Managed |
Parâmetros a serem aplicados ao cluster-autoscaler quando habilitados |
|
Managed |
Perfil de segurança para o cluster do serviço de contêiner. |
|
Managed |
Configurações do Microsoft Defender para o perfil de segurança. |
|
Managed |
Configurações do Microsoft Defender para a detecção de ameaças do perfil de segurança. |
|
Managed |
O Limpador de Imagens remove imagens não utilizados de nós, liberando espaço em disco e ajudando a reduzir a área da superfície de ataque. Aqui estão as configurações para o perfil de segurança. |
|
Managed |
Configurações de identidade de carga de trabalho para o perfil de segurança. |
|
Managed |
Informações sobre uma identidade de principal de serviço para o cluster usar na manipulação das APIs do Azure. |
|
Managed |
A SKU de um cluster gerenciado. |
|
Managed |
O nome de um SKU de cluster gerenciado. |
|
Managed |
A camada de um SKU de cluster gerenciado. Se não for especificado, o padrão será "Gratuito". Veja AKS Pricing Tier para mais detalhes. |
|
Managed |
A configuração de complemento do Gateway de Saída Estática para o cluster. |
|
Managed |
Contém informações somente leitura sobre o Cluster Gerenciado. |
|
Managed |
Perfil de armazenamento para o cluster do serviço de contêiner. |
|
Managed |
Configurações do driver CSI do AzureBlob para o perfil de storage. |
|
Managed |
Configurações do driver CSI do AzureDisk para o perfil de storage. |
|
Managed |
Configurações do driver CSI do AzureFile para o perfil de storage. |
|
Managed |
Configurações do Controlador de Snapshot para o perfil de storage. |
|
Managed |
Perfil para VMs do Windows no cluster gerenciado. |
|
Managed |
Perfil de dimensionador automático de carga de trabalho para o cluster gerenciado. |
|
Managed |
Configurações keda (dimensionamento automático controlado por eventos do Kubernetes) para o perfil de dimensionador automático de carga de trabalho. |
|
Managed |
Configurações de VPA (Dimensionador Automático de Pod Vertical) para o perfil de dimensionador automático de carga de trabalho. |
|
Managed |
Propriedades de identidade atribuídas pelo usuário. |
|
Manual |
Especificações no número de computadores. |
|
Network |
Plano de dados de rede usado no cluster do Kubernetes. |
|
Network |
O modo de rede com o qual o Azure CNI está configurado. Isso não pode ser especificado se networkPlugin for algo além de 'azure'. |
|
Network |
Plug-in de rede usado para criar a rede do Kubernetes. |
|
Network |
O modo que o plug-in de rede deve usar. |
|
Network |
Política de rede usada para criar a rede do Kubernetes. |
|
Nginx |
Tipo de entrada para o recurso personalizado NginxIngressController padrão |
|
Node |
Canal de atualização do sistema operacional do nó. Maneira como o sistema operacional em seus nós é atualizado. O padrão é NodeImage. |
|
Node |
O conjunto de CRDs (Karpenter NodePools) padrão configurados para provisionamento de nós. Este campo não tem efeito, a menos que o modo seja 'Auto'. Aviso: Alterar isso de Automático para Nenhum em um cluster existente fará com que os NodePools Karpenter padrão sejam excluídos, o que drenará e excluirá os nós associados a esses pools. É altamente recomendável não fazer isso, a menos que haja nós ociosos prontos para receber os pods removidos por essa ação. Se não for especificado, o padrão será Auto. Para obter mais informações, consulte aka.ms/aks/nap#node-pools. |
|
Node |
O modo de provisionamento de nó. Se não for especificado, o padrão será Manual. |
|
OSDisk |
O tipo de disco do sistema operacional a ser usado para computadores no pool de agentes. O padrão será "Efêmero" se a VM der suporte a ela e tiver um disco de cache maior que o OSDiskSizeGB solicitado. Caso contrário, o padrão será 'Gerenciado'. Pode não ser alterado após a criação. Para mais informações, veja Ephemeral OS. |
| OSSKU |
Especifica o SKU do sistema operacional usado pelo pool de agentes. O padrão é Ubuntu se OSType for Linux. O padrão é Windows2019 quando Kubernetes <= 1,24 ou Windows2022 quando Kubernetes >= 1,25 se OSType for Windows. |
| OSType |
O tipo de sistema operacional. O padrão é Linux. |
|
Outbound |
O método de roteamento de saída (saída). Isso só pode ser definido no momento da criação do cluster e não pode ser alterado posteriormente. Para mais informações, veja |
|
Pod |
Modo de alocação de IP do pod. O modo de alocação de IP para pods no pool de agentes. Deve ser usado com podSubnetId. O padrão é 'DynamicIndividual'. |
|
Port |
O intervalo de portas. |
|
Power |
Descreve o Estado do Power do cluster |
|
Private |
Um recurso de link privado |
| Protocol |
O protocolo de rede da porta. |
|
Proxy |
Modo de redirecionamento de tráfego. |
|
Public |
PublicNetworkAccess do managedCluster. Permitir ou negar acesso à rede pública para AKS |
|
Resource |
O tipo de identidade usado para o cluster gerenciado. Para mais informações, veja use identidades gerenciadas no AKS. |
|
Resource |
Uma referência a um recurso do Azure. |
|
Restriction |
O nível de restrição aplicado ao grupo de recursos do nó do cluster. Se não for especificado, o padrão será 'Irrestrito' |
|
Scale |
Descreve como as VMs são adicionadas ou removidas dos Pools de Agentes. Consulte estados de faturamento. |
|
Scale |
Especificações sobre como dimensionar um pool de agentes VirtualMachines. |
|
Scale |
A política de remoção do Conjunto de Dimensionamento de Máquinas Virtuais. A política de despejo especifica o que to do com a VM quando ela é despejada. O padrão é Excluir. Para mais informações sobre despejo, veja |
|
Scale |
A prioridade do Conjunto de Dimensionamento de Máquinas Virtuais. |
|
Service |
Modo da malha de serviço. |
|
Service |
Perfil de malha de serviço para um cluster gerenciado. |
|
Sysctl |
Configurações de sysctl para nós de agente do Linux. |
|
system |
Metadados relativos à criação e última modificação do recurso. |
|
Transit |
Configura a criptografia de pod para pod. Isso só pode ser habilitado em clusters baseados em Cilium. Se não for especificado, o valor padrão será None. |
|
Undrainable |
Define o comportamento de nós não indisplicáveis durante a atualização. A causa mais comum de nós não indesaciáveis são PDBs (Orçamentos de Interrupção de Pod), mas outros problemas, como o período de carência de término do pod, excedem o tempo limite de drenagem por nó restante ou o pod ainda está em um estado de execução, também pode causar nós não indesaciáveis. |
|
Upgrade |
O canal de atualização para atualização automática. O padrão é 'none'. Para mais informações, veja setting do canal de atualização automática do cluster AKS. |
|
Upgrade |
Configurações para substituições ao atualizar um cluster. |
|
User |
Detalhes sobre uma identidade atribuída pelo usuário. |
|
Virtual |
Status atual em um grupo de nós do mesmo tamanho de vm. |
|
Virtual |
Especificações no pool de agentes do VirtualMachines. |
|
Windows |
Perfil gMSA do Windows no cluster gerenciado. |
|
Workload |
Determina o tipo de carga de trabalho que um nó pode executar. |
AccelerationMode
Ative as opções avançadas de aceleração de rede. Isso permite que os usuários configurem a aceleração usando o roteamento de host BPF. Isso pode ser ativado somente com o plano de dados do Cilium. Se não for especificado, o valor padrão será Nenhum (sem aceleração). O modo de aceleração pode ser alterado em um cluster pré-existente. Veja https://aka.ms/acnsperformance uma explicação detalhada
| Valor | Description |
|---|---|
| BpfVeth |
Habilite o roteamento de host eBPF com o modo de dispositivo veth. |
| None |
Desative as opções de aceleração. |
AdvancedNetworking
Perfil avançado de rede para habilitar a observabilidade e o pacote de recursos de segurança em um cluster. Para obter mais informações, consulte aka.ms/aksadvancednetworking.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Indica a habilitação de funcionalidades de Rede Avançada de observabilidade e segurança em clusters do AKS. Quando isso for definido como true, todos os recursos de observabilidade e segurança serão definidos como habilitados, a menos que sejam explicitamente desabilitados. Se não for especificado, o padrão será false. |
| observability |
Perfil de observabilidade para habilitar métricas de rede avançadas e logs de fluxo com contextos históricos. |
|
| performance |
Profile para habilitar recursos de aprimoramento de desempenho em clusters que utilizam o Azure CNI alimentado pela Cilium. |
|
| security |
Perfil de segurança para habilitar recursos de segurança no cluster baseado em cilium. |
AdvancedNetworkingObservability
Perfil de observabilidade para habilitar métricas de rede avançadas e logs de fluxo com contextos históricos.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Indica a habilitação de funcionalidades de observabilidade de rede avançada em clusters. |
AdvancedNetworkingPerformance
Profile para habilitar recursos de aprimoramento de desempenho em clusters que utilizam o Azure CNI alimentado pela Cilium.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| accelerationMode | None |
Ative as opções avançadas de aceleração de rede. Isso permite que os usuários configurem a aceleração usando o roteamento de host BPF. Isso pode ser ativado somente com o plano de dados do Cilium. Se não for especificado, o valor padrão será Nenhum (sem aceleração). O modo de aceleração pode ser alterado em um cluster pré-existente. Veja https://aka.ms/acnsperformance uma explicação detalhada |
AdvancedNetworkingSecurity
Perfil de segurança para habilitar recursos de segurança no cluster baseado em cilium.
| Nome | Tipo | Description |
|---|---|---|
| advancedNetworkPolicies |
Habilite políticas de rede avançadas. Isso permite que os usuários configurem políticas de rede da Camada 7 (FQDN, HTTP, Kafka). As próprias políticas devem ser configuradas por meio dos recursos da Política de Rede do Cilium, consulte https://docs.cilium.io/en/latest/security/policy/index.html. Isso só pode ser habilitado em clusters baseados em cilium. Se não for especificado, o valor padrão será FQDN se security.enabled for definido como true. |
|
| enabled |
boolean |
Esse recurso permite que o usuário configure a política de rede com base em nomes de DNS (FQDN). Ele só pode ser habilitado em clusters baseados em cilium. Se não for especificado, o padrão será false. |
| transitEncryption |
Configuração de criptografia para clusters baseados em Cilium. Uma vez ativado, todo o tráfego entre os pods gerenciados do Cilium será criptografado quando sair do limite do nó. |
AdvancedNetworkingSecurityTransitEncryption
Configuração de criptografia para clusters baseados em Cilium. Uma vez ativado, todo o tráfego entre os pods gerenciados do Cilium será criptografado quando sair do limite do nó.
| Nome | Tipo | Description |
|---|---|---|
| type |
Configura a criptografia de pod para pod. Isso só pode ser habilitado em clusters baseados em Cilium. Se não for especificado, o valor padrão será None. |
AdvancedNetworkPolicies
Habilite políticas de rede avançadas. Isso permite que os usuários configurem políticas de rede da Camada 7 (FQDN, HTTP, Kafka). As próprias políticas devem ser configuradas por meio dos recursos da Política de Rede do Cilium, consulte https://docs.cilium.io/en/latest/security/policy/index.html. Isso só pode ser habilitado em clusters baseados em cilium. Se não for especificado, o valor padrão será FQDN se security.enabled for definido como true.
| Valor | Description |
|---|---|
| L7 |
Habilite as políticas de rede da Camada 7 (FQDN, HTTP/S, Kafka). Essa opção é um superconjunto da opção FQDN. |
| FQDN |
Habilitar políticas de rede baseadas em FQDN |
| None |
Desabilitar políticas de rede de camada 7 (FQDN, HTTP/S, Kafka) |
AgentPoolGatewayProfile
Perfil do pool de agentes do gateway de cluster gerenciado.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| publicIPPrefixSize |
integer (int32) minimum: 28maximum: 31 |
31 |
O pool de agentes do Gateway associa um IPPrefix público para cada gateway de saída estático para fornecer saída pública. O tamanho do IPPrefix público deve ser selecionado pelo usuário. Cada nó no pool de agentes é atribuído com um IP do IPPrefix. O tamanho do IPPrefix, portanto, serve como um limite no tamanho do pool de agentes do Gateway. Devido à limitação de tamanho do IPPrefix público do Azure, o intervalo de valores válido é [28, 31] (/31 = 2 nós/IPs, /30 = 4 nós/IPs, /29 = 8 nós/IPs, /28 = 16 nós/IPs). O valor padrão é 31. |
AgentPoolMode
O modo de um pool de agentes. Um cluster deve ter pelo menos um pool de agentes 'System' o tempo todo. Para obter informações adicionais sobre restrições de pool de agentes e práticas recomendadas, consulte: https://docs.microsoft.com/azure/aks/use-system-pools
| Valor | Description |
|---|---|
| System |
Os pools de agentes do sistema são principalmente para hospedar pods críticos do sistema, como CoreDNS e metrics-server. Os osType de pools de agente do sistema devem ser Linux. O SKU de VM de pools de agentes do sistema deve ter pelo menos 2vCPUs e 4 GB de memória. |
| User |
Os pools de agentes de usuário são principalmente para hospedar seus pods de aplicativos. |
| Gateway |
Os pools de agentes de gateway são dedicados a fornecer IPs de saída estáticos para pods. Para obter mais detalhes, confira https://aka.ms/aks/static-egress-gateway. |
AgentPoolNetworkProfile
Configurações de rede de um pool de agentes.
| Nome | Tipo | Description |
|---|---|---|
| allowedHostPorts |
Os intervalos de portas que são permitidos para acesso. Os intervalos especificados têm permissão para se sobrepor. |
|
| applicationSecurityGroups |
string[] (arm-id) |
As IDs dos grupos de segurança do aplicativo que o pool de agentes associará quando criado. |
| nodePublicIPTags |
IPTag[] |
IPTags de IPs públicos no nível da instância. |
AgentPoolSecurityProfile
As configurações de segurança de um pool de agentes.
| Nome | Tipo | Description |
|---|---|---|
| enableSecureBoot |
boolean |
A Inicialização Segura é um recurso de Inicialização Confiável que garante que somente sistemas operacionais e drivers assinados possam ser inicializados. Para obter mais detalhes, consulte aka.ms/aks/trustedlaunch. Se não for especificado, o padrão será false. |
| enableVTPM |
boolean |
o vTPM é um recurso de Inicialização Confiável para configurar um cofre seguro dedicado para chaves e medidas mantidas localmente no nó. Para obter mais detalhes, consulte aka.ms/aks/trustedlaunch. Se não for especificado, o padrão será false. |
| sshAccess |
Método de acesso SSH de um pool de agentes. |
AgentPoolSSHAccess
Método de acesso SSH de um pool de agentes.
| Valor | Description |
|---|---|
| LocalUser |
Pode SSH no nó como um usuário local usando a chave privada. |
| Disabled |
O serviço SSH será desativado no nó. |
AgentPoolStatus
Contém informações somente leitura sobre o Pool de Agentes.
| Nome | Tipo | Description |
|---|---|---|
| provisioningError |
As informações detalhadas do erro do pool de agentes. Preserva as informações detalhadas da falha. Se não houver erro, esse campo será omitido. |
AgentPoolType
O tipo de Pool de Agentes.
| Valor | Description |
|---|---|
| VirtualMachineScaleSets |
Crie um Pool de Agentes com suporte de um Conjunto de Dimensionamento de Máquinas Virtuais. |
| AvailabilitySet |
O uso disso é fortemente desencorajado. |
| VirtualMachines |
Crie um Pool de Agentes com suporte de um modo de orquestração de VM de Instância Única. |
AgentPoolUpgradeSettings
Configurações para atualizar um agentpool
| Nome | Tipo | Description |
|---|---|---|
| drainTimeoutInMinutes |
integer (int32) minimum: 1maximum: 1440 |
O tempo limite de drenagem para um nó. A quantidade de tempo (em minutos) para aguardar a remoção de pods e o término normal por nó. Esse tempo de espera de remoção respeita a espera pelos orçamentos de interrupção do pod. Se esse tempo for excedido, a atualização falhará. Se não for especificado, o padrão será 30 minutos. |
| maxSurge |
string |
O número máximo ou a porcentagem de nós que são aumentados durante a atualização. Isso pode ser definido como um inteiro (por exemplo, '5') ou uma porcentagem (por exemplo, '50%'). Se uma porcentagem for especificada, será a porcentagem do tamanho total do pool de agentes no momento da atualização. Para porcentagens, nós fracionários são arredondados para cima. Se não for especificado, o padrão será 10%. Para obter mais informações, incluindo práticas recomendadas, consulte: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster |
| maxUnavailable |
string |
O número máximo ou percentual de nós que podem estar simultaneamente indisponíveis durante a atualização. Isso pode ser definido como um inteiro (por exemplo, '1') ou uma porcentagem (por exemplo, '5%'). Se uma porcentagem for especificada, será a porcentagem do tamanho total do pool de agentes no momento da atualização. Para porcentagens, nós fracionários são arredondados para cima. Se não for especificado, o padrão será 0. Para obter mais informações, incluindo práticas recomendadas, consulte: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster |
| nodeSoakDurationInMinutes |
integer (int32) minimum: 0maximum: 30 |
A duração da imersão de um nó. A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de reimaginá-lo e passar para o próximo nó. Se não for especificado, o padrão será 0 minutos. |
| undrainableNodeBehavior |
Define o comportamento de nós não indisplicáveis durante a atualização. A causa mais comum de nós não indesaciáveis são PDBs (Orçamentos de Interrupção de Pod), mas outros problemas, como o período de carência de término do pod, excedem o tempo limite de drenagem por nó restante ou o pod ainda está em um estado de execução, também pode causar nós não indesaciáveis. |
AgentPoolWindowsProfile
O perfil específico do pool de agentes do Windows.
| Nome | Tipo | Description |
|---|---|---|
| disableOutboundNat |
boolean |
Se o OutboundNAT deve ser desabilitado nos nós do Windows. O valor padrão é false. O NAT de saída só poderá ser desabilitado se o tipo de saída do cluster for o Gateway nat e o pool de agentes do Windows não tiver o IP público do nó habilitado. |
ArtifactSource
A origem do artefato. A origem da qual os artefatos são baixados.
| Valor | Description |
|---|---|
| Cache |
extrair imagens do Registro de Contêiner do Azure com cache |
| Direct |
extrair imagens do Registro do Microsoft Artifact |
AzureKeyVaultKms
Configurações do serviço de gerenciamento de chaves do Azure Key Vault para o perfil de segurança.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| enabled |
boolean |
Se deseja habilitar Azure Key Vault serviço de gerenciamento de chaves. O valor padrão é falso. |
|
| keyId |
string |
Identificador de Azure Key Vault chave. Veja |
|
| keyVaultNetworkAccess | Public |
Acesso à rede do key vault. Acesso à rede do cofre de chaves. Os valores possíveis são |
|
| keyVaultResourceId |
string (arm-id) |
ID de recurso do key vault. Quando keyVaultNetworkAccess é |
BackendPoolType
O tipo de entrada gerenciada Load Balancer BackendPool.
| Valor | Description |
|---|---|
| NodeIPConfiguration |
O tipo de entrada gerenciada Load Balancer BackendPool. https://cloud-provider-azure.sigs.k8s.io/topics/loadbalancer/#configure-load-balancer-backend. |
| NodeIP |
O tipo de entrada gerenciada Load Balancer BackendPool. https://cloud-provider-azure.sigs.k8s.io/topics/loadbalancer/#configure-load-balancer-backend. |
ClusterUpgradeSettings
Configurações para atualizar um cluster.
| Nome | Tipo | Description |
|---|---|---|
| overrideSettings |
Configurações para substituições. |
Code
Informa se o cluster está em execução ou parado
| Valor | Description |
|---|---|
| Running |
O cluster está em execução. |
| Stopped |
O cluster é interrompido. |
ContainerServiceLinuxProfile
Perfil para VMs linux no cluster de serviço de contêiner.
| Nome | Tipo | Description |
|---|---|---|
| adminUsername |
string pattern: ^[A-Za-z][-A-Za-z0-9_]*$ |
O nome de usuário do administrador a ser usado para VMs linux. |
| ssh |
A configuração de SSH para VMs baseadas em Linux rodando no Azure. |
ContainerServiceNetworkProfile
Perfil da configuração de rede.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| advancedNetworking |
Perfil avançado de rede para habilitar a observabilidade e o pacote de recursos de segurança em um cluster. Para obter mais informações, consulte 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 |
Um endereço IP atribuído ao serviço DNS do Kubernetes. Ele deve estar dentro do intervalo de endereços de serviço do Kubernetes especificado no serviceCidr. |
| ipFamilies |
IPFamily[] |
As famílias de IP usadas para especificar versões de IP disponíveis para o cluster. As famílias de IP são usadas para determinar clusters de pilha única ou de pilha dupla. Para pilha única, o valor esperado é IPv4. Para pilha dupla, os valores esperados são IPv4 e IPv6. |
|
| loadBalancerProfile |
Perfil do balanceador de carga do cluster. |
||
| loadBalancerSku |
O sku do balanceador de carga para o cluster gerenciado. O padrão é 'standard'. Veja Azure Load Balancer SKUs para mais informações sobre as diferenças entre load balancer SKUs. |
||
| natGatewayProfile |
Perfil do gateway NAT do cluster. |
||
| networkDataplane |
Plano de dados de rede usado no cluster do Kubernetes. |
||
| networkMode |
O modo de rede com o qual o Azure CNI está configurado. Isso não pode ser especificado se networkPlugin for algo além de 'azure'. |
||
| networkPlugin |
Plug-in de rede usado para criar a rede do Kubernetes. |
||
| networkPluginMode |
O modo que o plug-in de rede deve usar. |
||
| networkPolicy |
Política de rede usada para criar a rede do Kubernetes. |
||
| outboundType | loadBalancer |
O método de roteamento de saída (saída). Isso só pode ser definido no momento da criação do cluster e não pode ser alterado posteriormente. Para mais informações, veja |
|
| 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 |
Um intervalo de IP de notação CIDR do qual atribuir IPs de pod quando kubenet é usado. |
| podCidrs |
string[] |
Os intervalos de IP de notação CIDR dos quais atribuir IPs de pod. Uma CIDR IPv4 é esperada para rede de pilha única. Dois CIDRs, um para cada família IP (IPv4/IPv6), são esperados para rede de pilha dupla. |
|
| 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 |
Um intervalo de IP de notação CIDR do qual atribuir IPs de cluster de serviço. Ele não deve se sobrepor a nenhum intervalo de IP de sub-rede. |
| serviceCidrs |
string[] |
Os intervalos de IP de notação CIDR dos quais atribuir IPs de cluster de serviço. Uma CIDR IPv4 é esperada para rede de pilha única. Dois CIDRs, um para cada família IP (IPv4/IPv6), são esperados para rede de pilha dupla. Eles não devem se sobrepor a nenhum intervalo de IP de sub-rede. |
|
| staticEgressGatewayProfile |
O perfil do complemento do Gateway de Saída Estática. Para obter mais detalhes sobre o Gateway de Saída Estática, consulte https://aka.ms/aks/static-egress-gateway. |
ContainerServiceSshConfiguration
Configuração de SSH para VMs baseadas em Linux em execução no Azure.
| Nome | Tipo | Description |
|---|---|---|
| publicKeys |
A lista de chaves públicas SSH usadas para autenticar com VMs baseadas em Linux. Um máximo de 1 chave pode ser especificado. |
ContainerServiceSshPublicKey
Contém informações sobre dados de chave pública do certificado SSH.
| Nome | Tipo | Description |
|---|---|---|
| keyData |
string |
Chave pública de certificado usada para autenticar com VMs por meio do SSH. O certificado deve estar no formato PEM com ou sem cabeçalhos. |
createdByType
O tipo de identidade que criou o recurso.
| Valor | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
CreationData
Dados usados ao criar um recurso de destino de um recurso de origem.
| Nome | Tipo | Description |
|---|---|---|
| sourceResourceId |
string (arm-id) |
Esta é a ID do ARM do objeto de origem a ser usado para criar o objeto de destino. |
DelegatedResource
Propriedades de recurso delegadas – somente uso interno.
| Nome | Tipo | Description |
|---|---|---|
| location |
string |
O local do recurso de origem – somente uso interno. |
| referralResource |
string |
A ID de delegação da delegação de referência (opcional) – somente uso interno. |
| resourceId |
string |
A ID do recurso ARM do recurso delegado – somente uso interno. |
| tenantId |
string (uuid) |
A ID do locatário do recurso delegado – somente uso interno. |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
| Nome | Tipo | Description |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Nome | Tipo | Description |
|---|---|---|
| additionalInfo |
As informações adicionais do erro. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
| Nome | Tipo | Description |
|---|---|---|
| error |
O objeto de erro. |
Expander
O expansor a ser usado ao aumentar a escala. Se não for especificado, o padrão será "aleatório". Veja expanders para mais informações.
| Valor | Description |
|---|---|
| least-waste |
Seleciona o grupo de nós que terá menos CPU ociosa (se estiver empatado, memória não utilizada) após a expansão. Isso é útil quando você tem classes diferentes de nós, por exemplo, altos nós de CPU ou memória alta e só deseja expandi-los quando há pods pendentes que precisam de muitos desses recursos. |
| most-pods |
Seleciona o grupo de nós que seria capaz de agendar a maioria dos pods ao aumentar a escala. Isso é útil quando você está usando o nodeSelector para garantir que determinados pods cheguem a determinados nós. Observe que isso não fará com que o dimensionador automático selecione nós maiores versus menores, pois ele pode adicionar vários nós menores ao mesmo tempo. |
| priority |
Seleciona o grupo de nós que tem a prioridade mais alta atribuída pelo usuário. Sua configuração é descrita em mais detalhes aqui. |
| random |
Usado quando você não tem uma necessidade específica de que os grupos de nós sejam dimensionados de forma diferente. |
ExtendedLocation
O tipo complexo do local estendido.
| Nome | Tipo | Description |
|---|---|---|
| name |
string |
O nome do local estendido. |
| type |
O tipo de local estendido. |
ExtendedLocationTypes
O tipo de extendedLocation.
| Valor | Description |
|---|---|
| EdgeZone |
Tipo de localização estendida Azure Edge Zone. |
GPUDriver
Se os drivers de GPU devem ser instalados. Quando não for especificado, o padrão é Instalar.
| Valor | Description |
|---|---|
| Install |
Instale o driver. |
| None |
Ignorar a instalação do driver. |
GPUInstanceProfile
GPUInstanceProfile a ser usado para especificar o perfil de instância de GPU MIG para SKU de VM de GPU com suporte.
| Valor | Description |
|---|---|
| MIG1g |
Perfil de instância da GPU MIG 1g. |
| MIG2g |
Perfil de instância da GPU MIG 2g. |
| MIG3g |
Perfil de instância da GPU MIG 3g. |
| MIG4g |
Perfil de instância da GPU MIG 4G. |
| MIG7g |
Perfil de instância da GPU MIG 7g. |
GPUProfile
Configurações de GPU para o Pool de Agentes.
| Nome | Tipo | Description |
|---|---|---|
| driver |
Se os drivers de GPU devem ser instalados. Quando não for especificado, o padrão é Instalar. |
IPFamily
Para determinar se o endereço pertence à família IPv4 ou IPv6
| Valor | Description |
|---|---|
| IPv4 |
Família IPv4 |
| IPv6 |
Família IPv6 |
IPTag
Contém a IPTag associada ao objeto.
| Nome | Tipo | Description |
|---|---|---|
| ipTagType |
string |
O tipo de marca IP. Exemplo: RoutingPreference. |
| tag |
string |
O valor da marca IP associada ao IP público. Exemplo: Internet. |
IstioCertificateAuthority
Configuração da AC (Autoridade de Certificação de Malha de Serviço) istio. Por enquanto, só damos suporte a certificados de plug-in, conforme descrito aqui https://aka.ms/asm-plugin-ca
| Nome | Tipo | Description |
|---|---|---|
| plugin |
Informações de certificados de plug-in para a Malha de Serviço. |
IstioComponents
Configuração de componentes istio.
| Nome | Tipo | Description |
|---|---|---|
| egressGateways |
Gateways de saída istio. |
|
| ingressGateways |
Gateways de entrada istio. |
|
| proxyRedirectionMechanism |
Modo de redirecionamento de tráfego. |
IstioEgressGateway
Configuração do gateway de saída istio.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Se o gateway de saída deve ser habilitado. |
| gatewayConfigurationName |
string |
Nome do recurso personalizado de configuração do gateway para o gateway de saída de complemento istio. Deve ser especificado ao habilitar o gateway de saída istio. Deve ser implantado no mesmo namespace no qual o gateway de saída istio será implantado. |
| name |
string pattern: [a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)* |
Nome do gateway de saída do complemento istio. |
| namespace |
string |
Namespace no qual o gateway de saída do complemento istio deve ser implantado. Se não for especificado, o padrão será aks-istio-egress. |
IstioIngressGateway
Configuração do gateway de entrada istio. Por enquanto, há suporte para até um gateway de entrada externo chamado aks-istio-ingressgateway-external e um gateway de entrada interno chamado aks-istio-ingressgateway-internal.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Se o gateway de entrada deve ser habilitado. |
| mode |
Modo de um gateway de entrada. |
IstioIngressGatewayMode
Modo de um gateway de entrada.
| Valor | Description |
|---|---|
| External |
O gateway de entrada recebe um endereço IP público e pode ser acessado publicamente. |
| Internal |
O gateway de entrada recebe um endereço IP interno e não pode ser acessado publicamente. |
IstioPluginCertificateAuthority
Informações de certificados de plug-in para a Malha de Serviço.
| Nome | Tipo | Description |
|---|---|---|
| certChainObjectName |
string |
Nome do objeto da cadeia de certificados no Azure Key Vault. |
| certObjectName |
string |
Nome do objeto de certificado intermediário no Azure Key Vault. |
| keyObjectName |
string |
Nome do objeto de chave privada do certificado intermediário no Azure Key Vault. |
| keyVaultId |
string (arm-id) |
O ID de recurso do Key Vault. |
| rootCertObjectName |
string |
Nome do objeto do certificado raiz no Azure Key Vault. |
IstioServiceMesh
Configuração da malha de serviço istio.
| Nome | Tipo | Description |
|---|---|---|
| certificateAuthority |
Configuração da AC (Autoridade de Certificação de Malha de Serviço) istio. Por enquanto, só damos suporte a certificados de plug-in, conforme descrito aqui https://aka.ms/asm-plugin-ca |
|
| components |
Configuração de componentes istio. |
|
| revisions |
string[] |
A lista de revisões do plano de controle Istio. Quando uma atualização não está em andamento, isso contém um valor. Quando a atualização canária está em andamento, isso só pode conter dois valores consecutivos. Para obter mais informações, consulte: https://learn.microsoft.com/en-us/azure/aks/istio-upgrade |
KeyVaultNetworkAccessTypes
Acesso à rede do key vault. Acesso à rede do cofre de chaves. Os valores possíveis são Public e Private.
Public significa que o key vault permite access público de todas as redes.
Private significa que o key vault desativa access pública e permite private link. O valor padrão é Public.
| Valor | Description |
|---|---|
| Public |
O Key Vault permite acesso público a partir de todas as redes. |
| Private |
O cofre de chaves desativa o acesso público e habilita o link privado. |
KubeletConfig
Configurações do Kubelet de nós de agente. Consulte de configuração de nó personalizado do AKS para obter mais detalhes.
| Nome | Tipo | Description |
|---|---|---|
| allowedUnsafeSysctls |
string[] |
Lista permitida de sysctls não seguros ou padrões sysctl não seguros (terminando em |
| containerLogMaxFiles |
integer (int32) minimum: 2 |
O número máximo de arquivos de log de contêiner que podem estar presentes para um contêiner. O número deve ser ≥ 2. |
| containerLogMaxSizeMB |
integer (int32) |
O tamanho máximo (por exemplo, 10Mi) do arquivo de log de contêiner antes de ser girado. |
| cpuCfsQuota |
boolean |
Se a imposição de cota de CFS da CPU estiver habilitada para contêineres que especificam limites de CPU. O padrão é verdadeiro. |
| cpuCfsQuotaPeriod |
string |
O valor do período de cota da CPU CFS. O padrão é '100ms'. Valores válidos são uma sequência de números decimais com uma fração opcional e um sufixo de unidade. Por exemplo: '300ms', '2h45m'. As unidades com suporte são 'ns', 'us', 'ms', 's', 'm' e 'h'. |
| cpuManagerPolicy |
string |
A política do Gerenciador de CPU a ser usada. O padrão é 'none'. Consulte as políticas de gerenciamento de CPU do Kubernetes para obter mais informações. Os valores permitidos são 'none' e 'static'. |
| failSwapOn |
boolean |
Se definido como true, fará com que o Kubelet falhe ao iniciar se a troca estiver habilitada no nó. |
| imageGcHighThreshold |
integer (int32) |
A porcentagem de uso do disco após a qual a coleta de lixo da imagem é sempre executada. Para desabilitar a coleta de lixo de imagem, defina como 100. O padrão é 85% |
| imageGcLowThreshold |
integer (int32) |
A porcentagem de uso do disco antes da qual a coleta de lixo da imagem nunca é executada. Isso não pode ser definido acima de imageGcHighThreshold. O padrão é 80% |
| podMaxPids |
integer (int32) |
O número máximo de processos por pod. |
| topologyManagerPolicy |
string |
A política do Gerenciador de Topologia a ser usada. Para obter mais informações, consulte o Gerenciador de Topologia do Kubernetes. O padrão é 'none'. Os valores permitidos são 'none', 'best-effort', 'restricted' e 'single-numa-node'. |
KubeletDiskType
Determina a posição dos volumes vazio de Dir, raiz de dados em tempo de execução do container e storage efêmero do Kubelet.
| Valor | Description |
|---|---|
| OS |
O Kubelet usará o disco do sistema operacional para seus dados. |
| Temporary |
O Kubelet usará o disco temporário para seus dados. |
KubernetesSupportPlan
Diferentes camadas de suporte para clusters gerenciados do AKS
| Valor | Description |
|---|---|
| KubernetesOfficial |
O suporte para a versão é o mesmo que para a oferta de software livre do Kubernetes. Versões oficiais de suporte da comunidade de software livre do Kubernetes por 1 ano após o lançamento. |
| AKSLongTermSupport |
O suporte para a versão se estendeu além do KubernetesSuporte oficial de 1 ano. O AKS continua a aplicar patch a CVEs por mais 1 ano, para um total de 2 anos de suporte. |
LicenseType
O tipo de licença a ser usado para VMs do Windows. Veja Azure Benefícios para Usuários Híbridos para mais detalhes.
| Valor | Description |
|---|---|
| None |
Nenhum licenciamento adicional é aplicado. |
| Windows_Server |
Habilita os benefícios do usuário híbrido do Azure para VMs do Windows. |
LinuxOSConfig
Configurações do sistema operacional de nós de agente do Linux. Consulte de configuração de nó personalizado do AKS para obter mais detalhes.
| Nome | Tipo | Description |
|---|---|---|
| swapFileSizeMB |
integer (int32) |
O tamanho em MB de um arquivo de troca que será criado em cada nó. |
| sysctls |
Configurações de sysctl para nós de agente do Linux. |
|
| transparentHugePageDefrag |
string |
Se o kernel deve fazer uso agressivo da compactação de memória para disponibilizar mais páginas enormes. Os valores válidos são 'always', 'defer', 'defer+madvise', 'madvise' e 'never'. O padrão é "madvise". Para obter mais informações, consulte Transparent Hugepages. |
| transparentHugePageEnabled |
string |
Se as páginas enormes transparentes estão habilitadas. Os valores válidos são 'always', 'madvise' e 'never'. O padrão é "sempre". Para obter mais informações, consulte Transparent Hugepages. |
LoadBalancerSku
O sku do balanceador de carga para o cluster gerenciado. O padrão é 'standard'. Veja Azure Load Balancer SKUs para mais informações sobre as diferenças entre load balancer SKUs.
| Valor | Description |
|---|---|
| standard |
Use um balanceador de carga padrão. Essa é a SKU do Load Balancer recomendada. Para obter mais informações sobre como trabalhar com o balanceador de carga no cluster gerenciado, consulte o artigo load balancer padrão. |
| basic |
Use um balanceador de carga básico com funcionalidade limitada. |
LocalDNSForwardDestination
Servidor de destino para consultas DNS a serem encaminhadas do localDNS.
| Valor | Description |
|---|---|
| ClusterCoreDNS |
Encaminhe consultas DNS de localDNS para o CoreDNS do cluster. |
| VnetDNS |
Encaminhe consultas DNS de localDNS para o servidor DNS configurado na VNET. Uma VNET pode ter vários servidores DNS configurados. |
LocalDNSForwardPolicy
Política de encaminhamento para selecionar o servidor DNS upstream. Consulte o plug-in de encaminhamento para obter mais informações.
| Valor | Description |
|---|---|
| Sequential |
Implementa a seleção sequencial do servidor DNS upstream. Consulte o plug-in de encaminhamento para obter mais informações. |
| RoundRobin |
Implementa a seleção de servidor DNS upstream round robin. Consulte o plug-in de encaminhamento para obter mais informações. |
| Random |
Implementa a seleção aleatória do servidor DNS upstream. Consulte o plug-in de encaminhamento para obter mais informações. |
LocalDNSMode
Modo de ativação para localDNS.
| Valor | Description |
|---|---|
| Preferred |
Se a versão atual do orchestrator suportar esta funcionalidade, prefira ativar o localDNS. |
| Required |
Habilite o localDNS. |
| Disabled |
Desative o localDNS. |
LocalDNSOverride
Substituições para o perfil localDNS.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| cacheDurationInSeconds |
integer (int32) |
3600 |
Cache máximo de TTL em segundos. Consulte o plug-in de cache para obter mais informações. |
| forwardDestination | ClusterCoreDNS |
Servidor de destino para consultas DNS a serem encaminhadas do localDNS. |
|
| forwardPolicy | Sequential |
Política de encaminhamento para selecionar o servidor DNS upstream. Consulte o plug-in de encaminhamento para obter mais informações. |
|
| maxConcurrent |
integer (int32) |
1000 |
Número máximo de consultas simultâneas. Consulte o plug-in de encaminhamento para obter mais informações. |
| protocol | PreferUDP |
Imponha o TCP ou prefira o protocolo UDP para conexões do localDNS ao servidor DNS upstream. |
|
| queryLogging | Error |
Nível de log para consultas DNS no localDNS. |
|
| serveStale | Immediate |
Política para veiculação de dados obsoletos. Consulte o plug-in de cache para obter mais informações. |
|
| serveStaleDurationInSeconds |
integer (int32) |
3600 |
Serve a duração obsoleta em segundos. Consulte o plug-in de cache para obter mais informações. |
LocalDNSProfile
Configura o DNS local por nó, com substituições de VnetDNS e KubeDNS. O LocalDNS ajuda a melhorar o desempenho e a confiabilidade da resolução DNS em um cluster do AKS. Para obter mais detalhes, consulte aka.ms/aks/localdns.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| kubeDNSOverrides |
<string,
Local |
As substituições do KubeDNS se aplicam ao tráfego DNS de pods com dnsPolicy:ClusterFirst (conhecido como tráfego KubeDNS). |
|
| mode | Preferred |
Modo de ativação para localDNS. |
|
| state |
Estado gerado pelo sistema de localDNS. |
||
| vnetDNSOverrides |
<string,
Local |
As substituições de VnetDNS se aplicam ao tráfego DNS de pods com dnsPolicy:default ou kubelet (conhecido como tráfego VnetDNS). |
LocalDNSProtocol
Imponha o TCP ou prefira o protocolo UDP para conexões do localDNS ao servidor DNS upstream.
| Valor | Description |
|---|---|
| PreferUDP |
Prefira o protocolo UDP para conexões de localDNS para servidor DNS upstream. |
| ForceTCP |
Aplique o protocolo TCP para conexões de localDNS para servidor DNS upstream. |
LocalDNSQueryLogging
Nível de log para consultas DNS no localDNS.
| Valor | Description |
|---|---|
| Error |
Habilita o log de erros no localDNS. Consulte o plugin de erros para obter mais informações. |
| Log |
Habilita o log de consultas no localDNS. Consulte o plug-in de log para obter mais informações. |
LocalDNSServeStale
Política para veiculação de dados obsoletos. Consulte o plug-in de cache para obter mais informações.
| Valor | Description |
|---|---|
| Verify |
Forneça dados obsoletos com verificação. Primeiro, verifique se uma entrada ainda está indisponível na origem antes de enviar a entrada expirada para o cliente. Consulte o plug-in de cache para obter mais informações. |
| Immediate |
Forneça dados obsoletos imediatamente. Envie a entrada expirada para o cliente antes de verificar se a entrada está disponível na origem. Consulte o plug-in de cache para obter mais informações. |
| Disable |
Desative a veiculação de dados obsoletos. |
LocalDNSState
Estado gerado pelo sistema de localDNS.
| Valor | Description |
|---|---|
| Enabled |
localDNS está habilitado. |
| Disabled |
localDNS está desabilitado. |
ManagedCluster
Cluster gerenciado.
| Nome | Tipo | Description |
|---|---|---|
| eTag |
string |
Se a eTag for fornecida no corpo da resposta, ela também poderá ser fornecida como um cabeçalho de acordo com a convenção de etag normal. As marcas de entidade são usadas para comparar duas ou mais entidades do mesmo recurso solicitado. HTTP/1.1 usa marcas de entidade na etag (seção 14.19), If-Match (seção 14.24), If-None-Match (seção 14.26) e If-Range (seção 14.27). |
| extendedLocation |
O local estendido da Máquina Virtual. |
|
| id |
string (arm-id) |
ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| identity |
A identidade do cluster gerenciado, se configurada. |
|
| kind |
string |
Isso é usado principalmente para expor diferentes experiências de interface do usuário no portal para diferentes tipos |
| location |
string |
A localização geográfica onde o recurso reside |
| name |
string |
O nome do recurso |
| properties.aadProfile |
A configuração do Azure Active Directory. |
|
| properties.addonProfiles |
<string,
Managed |
O perfil do complemento de cluster gerenciado. |
| properties.agentPoolProfiles |
As propriedades do pool de agentes. |
|
| properties.aiToolchainOperatorProfile |
Configurações do operador de cadeia de ferramentas de IA que se aplicam a todo o cluster. |
|
| properties.apiServerAccessProfile |
O perfil de acesso para servidor API de cluster gerenciado. |
|
| properties.autoScalerProfile |
Parâmetros a serem aplicados ao cluster-autoscaler quando habilitados |
|
| properties.autoUpgradeProfile |
A configuração de atualização automática. |
|
| properties.azureMonitorProfile |
Perfis adicionais do Azure Monitor para monitoramento do cluster gerenciado. |
|
| properties.azurePortalFQDN |
string |
O FQDN especial usado pelo Portal do Azure para acessar o Cluster Gerenciado. Esse FQDN é para uso somente pelo Portal do Azure e não deve ser usado por outros clientes. O Portal do Azure requer que determinados cabeçalhos cors (compartilhamento de recursos entre origens) sejam enviados em algumas respostas, que a APIServer do Kubernetes não manipula por padrão. Esse FQDN especial dá suporte ao CORS, permitindo que o Portal do Azure funcione corretamente. |
| properties.bootstrapProfile |
Perfil da configuração de inicialização do cluster. |
|
| properties.currentKubernetesVersion |
string |
A versão do Kubernetes, o Cluster Gerenciado, está em execução. Se kubernetesVersion for uma versão totalmente especificada <major.minor.patch>, esse campo será exatamente igual a ele. Se kubernetesVersion foi <>major.minor, esse campo conterá a versão de< principal.minor.patch de >completa que está sendo usada. |
| properties.disableLocalAccounts |
boolean |
Se as contas locais devem ser desabilitadas no Cluster Gerenciado. Se definido como true, obter credenciais estáticas será desabilitado para esse cluster. Isso só deve ser usado em Clusters Gerenciados habilitados para AAD. Para mais detalhes, veja desabilitar contas locais. |
| properties.diskEncryptionSetID |
string (arm-id) |
A ID de recurso do conjunto de criptografia de disco a ser usado para habilitar a criptografia em repouso. Isso é do formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskEncryptionSets/{encryptionSetName}' |
| properties.dnsPrefix |
string |
O prefixo DNS do Cluster Gerenciado. Isso não pode ser atualizado depois que o Cluster Gerenciado tiver sido criado. |
| properties.enableRBAC |
boolean |
Se deveria ativar o Kubernetes Role-Based Access Control. |
| properties.fqdn |
string |
O FQDN do pool mestre. |
| properties.fqdnSubdomain |
string |
O subdomínio FQDN do cluster privado com zona DNS privada personalizada. Isso não pode ser atualizado depois que o Cluster Gerenciado tiver sido criado. |
| properties.httpProxyConfig |
Configurações para provisionar o cluster com servidores proxy HTTP. |
|
| properties.identityProfile |
<string,
User |
A identidade do usuário associada ao cluster gerenciado. Essa identidade será usada pelo kubelet. Somente uma identidade atribuída pelo usuário é permitida. A única chave aceita é "kubeletidentity", com o valor de "resourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". |
| properties.ingressProfile |
Perfil de entrada para o cluster gerenciado. |
|
| properties.kubernetesVersion |
string |
A versão do Kubernetes especificada pelo usuário. Há suporte para a versão <de patch major.minor.patch> (por exemplo, 1.20.13) e <major.minor> (por exemplo, 1.20). Quando <major.minor> é especificado, a versão mais recente do patch ga com suporte é escolhida automaticamente. Atualizar o cluster com o mesmo <major.minor> depois que ele tiver sido criado (por exemplo, 1.14.x -> 1.14) não disparará uma atualização, mesmo se uma versão de patch mais recente estiver disponível. Quando você atualiza um cluster do AKS com suporte, as versões secundárias do Kubernetes não podem ser ignoradas. Todas as atualizações devem ser executadas sequencialmente pelo número de versão principal. Por exemplo, atualizações entre 1.14.x -> 1.15.x ou 1.15.x -> 1.16.x são permitidas, no entanto, 1.14.x -> 1.16.x não é permitido. Veja upgrade de um cluster AKS para mais detalhes. |
| properties.linuxProfile |
O perfil de VMs do Linux no Cluster Gerenciado. |
|
| properties.maxAgentPools |
integer (int32) |
O número máximo de pools de agentes para o cluster gerenciado. |
| properties.metricsProfile |
Configuração de métricas de cluster opcionais. |
|
| properties.networkProfile |
O perfil de configuração de rede. |
|
| properties.nodeProvisioningProfile |
Configurações de provisionamento de nó que se aplicam a todo o cluster. |
|
| properties.nodeResourceGroup |
string |
O nome do grupo de recursos que contém nós do pool de agentes. |
| properties.nodeResourceGroupProfile |
Perfil da configuração do grupo de recursos do nó. |
|
| properties.oidcIssuerProfile |
O perfil do emissor OIDC do Cluster Gerenciado. |
|
| properties.podIdentityProfile |
O perfil de identidade do pod do Cluster Gerenciado. Veja use identidade de pod AAD para mais detalhes sobre integração de identidade de pod AAD. |
|
| properties.powerState |
O Estado do Power do cluster. |
|
| properties.privateFQDN |
string |
O FQDN do cluster privado. |
| properties.privateLinkResources |
Private link resources associados ao cluster. |
|
| properties.provisioningState |
string |
O estado de provisionamento atual. |
| properties.publicNetworkAccess |
PublicNetworkAccess do managedCluster. Permitir ou negar acesso à rede pública para AKS |
|
| properties.resourceUID |
string |
O resourceUID identifica exclusivamente ManagedClusters que reutilizam ResourceIds do ARM (ou seja: criar, excluir, criar sequência) |
| properties.securityProfile |
Perfil de segurança para o cluster gerenciado. |
|
| properties.serviceMeshProfile |
Perfil de malha de serviço para um cluster gerenciado. |
|
| properties.servicePrincipalProfile |
Informações sobre uma identidade de principal de serviço para o cluster usar na manipulação das APIs do Azure. |
|
| properties.status |
Contém informações somente leitura sobre o Cluster Gerenciado. |
|
| properties.storageProfile |
Perfil de Storage para o cluster gerenciado. |
|
| properties.supportPlan |
O plano de suporte para o Cluster Gerenciado. Se não for especificado, o padrão será 'KubernetesOfficial'. |
|
| properties.upgradeSettings |
Configurações para atualizar um cluster. |
|
| properties.windowsProfile |
O perfil para VMs do Windows no Cluster Gerenciado. |
|
| properties.workloadAutoScalerProfile |
Perfil de dimensionador automático de carga de trabalho para o cluster gerenciado. |
|
| sku |
A SKU do cluster gerenciado. |
|
| systemData |
Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy. |
|
| tags |
object |
Tags de recursos. |
| type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
ManagedClusterAADProfile
O AADProfile especifica atributos para integração do Azure Active Directory. Para obter mais detalhes, consulte AAD gerenciado no AKS.
| Nome | Tipo | Description |
|---|---|---|
| adminGroupObjectIDs |
string[] |
A lista de IDs de objeto do grupo do AAD que terão a função de administrador do cluster. |
| clientAppID |
string |
(PRETERIDO) A ID do aplicativo AAD do cliente. Saiba mais em https://aka.ms/aks/aad-legacy. |
| enableAzureRBAC |
boolean |
Se deseja habilitar Azure RBAC para autorização do Kubernetes. |
| managed |
boolean |
Se o AAD gerenciado deve ser habilitado. |
| serverAppID |
string |
(PRETERIDO) A ID do aplicativo AAD do servidor. Saiba mais em https://aka.ms/aks/aad-legacy. |
| serverAppSecret |
string (password) |
(PRETERIDO) O segredo do aplicativo AAD do servidor. Saiba mais em https://aka.ms/aks/aad-legacy. |
| tenantID |
string |
A ID do locatário do AAD a ser usada para autenticação. Se não for especificado, usará o locatário da assinatura de implantação. |
ManagedClusterAddonProfile
Um perfil de complemento do Kubernetes para um cluster gerenciado.
| Nome | Tipo | Description |
|---|---|---|
| config |
object |
Pares chave-valor para configurar um complemento. |
| enabled |
boolean |
Se o complemento está habilitado ou não. |
| identity |
Informações da identidade atribuída pelo usuário usada por este complemento. |
ManagedClusterAddonProfileIdentity
Informações da identidade atribuída pelo usuário usada por este complemento.
| Nome | Tipo | Description |
|---|---|---|
| clientId |
string |
A ID do cliente da identidade atribuída pelo usuário. |
| objectId |
string |
A ID do objeto da identidade atribuída pelo usuário. |
| resourceId |
string (arm-id) |
A ID do recurso da identidade atribuída pelo usuário. |
ManagedClusterAgentPoolProfile
Perfil para o pool de agentes do serviço de contêiner.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| availabilityZones |
string[] |
A lista de Availability zones para usar nos nós. Isso só poderá ser especificado se a propriedade AgentPoolType for 'VirtualMachineScaleSets'. |
|
| capacityReservationGroupID |
string (arm-id) |
O ID de recurso totalmente qualificado do Grupo de Reserva de Capacidade fornece virtual machines de um grupo reservado de Virtual Machines. Este é do tipo: '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Compute/capacityreservationgroups/{capacityReservationGroupName}' Os clientes o usam para criar um agentpool com um CRG especificado. Para mais informações, veja Reserva de Capacidade |
|
| count |
integer (int32) |
Número de agentes (VMs) para hospedar contêineres do Docker. Os valores permitidos devem estar no intervalo de 0 a 1000 (inclusive) para os pools de usuários e no intervalo de 1 a 1000 (inclusive) para os pools de sistema. O valor padrão é 1. |
|
| creationData |
CreationData a ser usado para especificar a ID do Instantâneo de origem se o pool de nós for criado/atualizado usando um instantâneo. |
||
| currentOrchestratorVersion |
string |
A versão do Kubernetes que o Pool de Agentes está em execução. Se orchestratorVersion for uma versão totalmente especificada <major.minor.patch>, esse campo será exatamente igual a ele. Se orchestratorVersion for <>major.minor, esse campo conterá a versão de< principal.minor.patch de >completa que está sendo usada. |
|
| eTag |
string |
Cadeia de caracteres somente leitura exclusiva usada para implementar simultaneidade otimista. O valor da eTag será alterado quando o recurso for atualizado. Especifique um cabeçalho if-match ou if-none-match com o valor eTag para uma solicitação subsequente para habilitar a simultaneidade otimista de acordo com a convenção normal de eTag. |
|
| enableAutoScaling |
boolean |
Se o dimensionador automático deve ser habilitado |
|
| enableEncryptionAtHost |
boolean |
Se deseja habilitar o sistema operacional baseado em host e a criptografia da unidade de dados. Isso só é suportado em certos tamanhos de VMs e em certas regiões do Azure. Para obter mais informações, consulte: https://docs.microsoft.com/azure/aks/enable-host-encryption |
|
| enableFIPS |
boolean |
Se deve usar um sistema operacional habilitado para FIPS. Veja Adicione um pool de nós habilitado para FIPS para mais detalhes. |
|
| enableNodePublicIP |
boolean |
Se cada nó é alocado seu próprio IP público. Alguns cenários podem exigir nós em um pool de nós para receber seus próprios endereços IP públicos dedicados. Um cenário comum é para cargas de trabalho de jogos, em que um console precisa fazer uma conexão direta com uma máquina virtual de nuvem para minimizar os saltos. Para mais informações, veja atribuindo um IP público por nó. O valor padrão é falso. |
|
| enableUltraSSD |
boolean |
Se deseja habilitar o UltraSSD |
|
| gatewayProfile |
Perfil específico para um pool de agentes gerenciados no modo Gateway. Esse campo não poderá ser definido se o modo de pool de agentes não for Gateway. |
||
| gpuInstanceProfile |
GPUInstanceProfile a ser usado para especificar o perfil de instância de GPU MIG para SKU de VM de GPU com suporte. |
||
| gpuProfile |
Configurações de GPU para o Pool de Agentes. |
||
| hostGroupID |
string (arm-id) |
A ID de recurso totalmente qualificada do Grupo de Hosts Dedicados para provisionar máquinas virtuais, usada somente no cenário de criação e não tem permissão para ser alterada depois de definida. Esse é o formulário: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Para mais informações, veja Azure hosts dedicados. |
|
| kubeletConfig |
A configuração do Kubelet nos nós do pool de agentes. |
||
| kubeletDiskType |
Determina a posição dos volumes vazio de Dir, raiz de dados em tempo de execução do container e storage efêmero do Kubelet. |
||
| linuxOSConfig |
A configuração do sistema operacional dos nós do agente do Linux. |
||
| localDNSProfile |
Configura o DNS local por nó, com substituições de VnetDNS e KubeDNS. O LocalDNS ajuda a melhorar o desempenho e a confiabilidade da resolução DNS em um cluster do AKS. Para obter mais detalhes, consulte aka.ms/aks/localdns. |
||
| maxCount |
integer (int32) |
O número máximo de nós para dimensionamento automático |
|
| maxPods |
integer (int32) |
O número máximo de pods que podem ser executados em um nó. |
|
| messageOfTheDay |
string |
Mensagem do dia para nós do Linux, codificados em base64. Uma cadeia de caracteres codificada em base64 que será gravada em /etc/motd após a decodificação. Isso permite a personalização da mensagem do dia para nós do Linux. Ele não deve ser especificado para nós Windows. Deve ser uma cadeia de caracteres estática (ou seja, será impressa em bruto e não será executada como um script). |
|
| minCount |
integer (int32) |
O número mínimo de nós para dimensionamento automático |
|
| mode |
O modo de um pool de agentes. Um cluster deve ter pelo menos um pool de agentes 'System' o tempo todo. Para obter informações adicionais sobre restrições de pool de agentes e práticas recomendadas, consulte: https://docs.microsoft.com/azure/aks/use-system-pools |
||
| name |
string pattern: ^[a-z][a-z0-9]{0,11}$ |
Nome exclusivo do perfil do pool de agentes no contexto da assinatura e do grupo de recursos. Os nomes do pool de agentes do Windows devem ter seis caracteres ou menos. |
|
| networkProfile |
Configurações relacionadas à rede de um pool de agentes. |
||
| nodeImageVersion |
string |
A versão da imagem do nó |
|
| nodeLabels |
object |
Os rótulos de nó a serem persistidos em todos os nós no pool de agentes. |
|
| nodePublicIPPrefixID |
string (arm-id) |
A ID do prefixo IP público da qual os nós de VM devem usar IPs. Isso é do formulário: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} |
|
| nodeTaints |
string[] |
Os taints adicionados a novos nós durante a criação e a escala do pool de nós. Por exemplo, key=value:NoSchedule. |
|
| orchestratorVersion |
string |
A versão do Kubernetes especificada pelo usuário. Há suporte para a versão <de patch major.minor.patch> (por exemplo, 1.20.13) e <major.minor> (por exemplo, 1.20). Quando <major.minor> é especificado, a versão mais recente do patch ga com suporte é escolhida automaticamente. Atualizar o cluster com o mesmo <major.minor> depois que ele tiver sido criado (por exemplo, 1.14.x -> 1.14) não disparará uma atualização, mesmo se uma versão de patch mais recente estiver disponível. Como melhor prática, você deve atualizar todos os pools de nós em um cluster do AKS para a mesma versão do Kubernetes. A versão do pool de nós deve ter a mesma versão principal do plano de controle. A versão secundária do pool de nós deve estar dentro de duas versões secundárias da versão do painel de controle. A versão do pool de nós não pode ser maior que a versão do painel de controle. Para mais informações, veja upgrade a node pool. |
|
| osDiskSizeGB |
integer (int32) minimum: 0maximum: 2048 |
Tamanho do disco do sistema operacional em GB a ser usado para especificar o tamanho do disco para cada computador no pool mestre/agente. Se você especificar 0, ele aplicará o tamanho do osDisk padrão de acordo com o vmSize especificado. |
|
| osDiskType |
O tipo de disco do sistema operacional a ser usado para computadores no pool de agentes. O padrão será "Efêmero" se a VM der suporte a ela e tiver um disco de cache maior que o OSDiskSizeGB solicitado. Caso contrário, o padrão será 'Gerenciado'. Pode não ser alterado após a criação. Para mais informações, veja Ephemeral OS. |
||
| osSKU |
Especifica o SKU do sistema operacional usado pelo pool de agentes. O padrão é Ubuntu se OSType for Linux. O padrão é Windows2019 quando Kubernetes <= 1,24 ou Windows2022 quando Kubernetes >= 1,25 se OSType for Windows. |
||
| osType | Linux |
O tipo de sistema operacional. O padrão é Linux. |
|
| podIPAllocationMode |
Modo de alocação de IP do pod. O modo de alocação de IP para pods no pool de agentes. Deve ser usado com podSubnetId. O padrão é 'DynamicIndividual'. |
||
| podSubnetID |
string (arm-id) |
O ID da sub-rede na qual os pods ingressarão quando iniciados. Se omitidos, os IPs de pod são atribuídos estaticamente na sub-rede do nó (consulte vnetSubnetID para obter mais detalhes). Esse é o formulário: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} |
|
| powerState |
Se o Pool de Agentes está em execução ou parado. Quando um Pool de Agentes é criado pela primeira vez, ele está em execução inicialmente. O Pool de Agentes pode ser interrompido definindo esse campo como Parado. Um Pool de Agentes interrompido interrompe todas as suas VMs e não acumula encargos de cobrança. Um pool de agentes só poderá ser interrompido se ele estiver em execução e o estado de provisionamento for bem-sucedido |
||
| provisioningState |
string |
O estado atual de implantação ou provisionamento. |
|
| proximityPlacementGroupID |
string (arm-id) |
A ID do Grupo de Posicionamento por Proximidade. |
|
| scaleDownMode |
O modo de redução horizontal a ser usado ao dimensionar o Pool de Agentes. Isso também afeta o comportamento do dimensionador automático do cluster. Se não for especificado, o padrão será Excluir. |
||
| scaleSetEvictionPolicy | Delete |
A política de remoção do Conjunto de Dimensionamento de Máquinas Virtuais. A política de despejo especifica o que to do com a VM quando ela é despejada. O padrão é Excluir. Para mais informações sobre despejo, veja |
|
| scaleSetPriority | Regular |
A prioridade do Conjunto de Dimensionamento de Máquinas Virtuais. |
|
| securityProfile |
As configurações de segurança de um pool de agentes. |
||
| spotMaxPrice |
number (float) |
-1 |
O preço máximo (em dólares americanos) que você está disposto a pagar por instâncias spot. Os valores possíveis são qualquer valor decimal maior que zero ou -1 que indica que o preço padrão é up-to sob demanda. Os valores possíveis são qualquer valor decimal maior que zero ou -1 que indica a disposição de pagar qualquer preço sob demanda. Para mais detalhes sobre preços à vista, veja |
| status |
Contém informações somente leitura sobre o Pool de Agentes. |
||
| tags |
object |
As marcas a serem mantidas no conjunto de dimensionamento de máquinas virtuais do pool de agentes. |
|
| type |
O tipo de Pool de Agentes. |
||
| upgradeSettings |
Configurações para atualizar o agentpool |
||
| virtualMachineNodesStatus |
O status dos nós em um pool de agentes VirtualMachines. |
||
| virtualMachinesProfile |
Especificações no pool de agentes do VirtualMachines. |
||
| vmSize |
string |
O tamanho das VMs do pool de agentes. A disponibilidade do tamanho da VM varia de acordo com a região. Se um nó contiver recursos de computação insuficientes (memória, cpu etc), os pods poderão não ser executados corretamente. Para obter mais detalhes sobre tamanhos restritos de VM, consulte: https://docs.microsoft.com/azure/aks/quotas-skus-regions |
|
| vnetSubnetID |
string (arm-id) |
A ID da sub-rede em que os nós do pool de agentes e, opcionalmente, os pods ingressarão na inicialização. Se isso não for especificado, uma VNET e uma sub-rede serão geradas e usadas. Se nenhum podSubnetID for especificado, isso se aplicará a nós e pods, caso contrário, aplica-se a apenas nós. Esse é o formulário: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} |
|
| windowsProfile |
O perfil específico do pool de agentes do Windows. |
||
| workloadRuntime |
Determina o tipo de carga de trabalho que um nó pode executar. |
ManagedClusterAIToolchainOperatorProfile
Ao habilitar o operador, um conjunto de CRDs e controladores gerenciados pelo AKS será instalado no cluster. O operador automatiza a implantação de modelos de OSS para fins de inferência e/ou treinamento. Ele fornece um conjunto de modelos predefinidos e habilita a inferência distribuída contra eles.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Se o operador da cadeia de ferramentas de IA deve ser habilitado para o cluster. Indica se o operador de cadeia de ferramentas de IA está habilitado ou não. |
ManagedClusterAPIServerAccessProfile
Perfil de acesso para o servidor de API de cluster gerenciado.
| Nome | Tipo | Description |
|---|---|---|
| authorizedIPRanges |
string[] |
Os intervalos de IP autorizados a acessar o servidor de API do Kubernetes. Os intervalos de IP são especificados no formato CIDR, por exemplo, 137.117.106.88/29. Esse recurso não é compatível com clusters que usam IP Público por Nó, ou clusters que utilizam um Basic Load Balancer. Para mais informações, veja API servidores autorizados de IP. |
| disableRunCommand |
boolean |
Se deve desabilitar o comando executar para o cluster ou não. |
| enablePrivateCluster |
boolean |
Se o cluster deve ser criado como um cluster privado ou não. Para mais detalhes, veja Criando um cluster AKS privado. |
| enablePrivateClusterPublicFQDN |
boolean |
Se deseja criar FQDN público adicional para cluster privado ou não. |
| enableVnetIntegration |
boolean |
Se deseja habilitar a integração de vnet do apiserver para o cluster ou não. Consulte aka.ms/AksVnetIntegration para obter mais detalhes. |
| privateDNSZone |
string |
O modo de zona DNS privada para o cluster. O padrão é System. Para mais detalhes, veja configure private DNS zona. Os valores permitidos são 'system' e 'none'. |
| subnetId |
string (arm-id) |
A sub-rede a ser usada quando a integração de vnet do apiserver estiver habilitada. Ele é necessário ao criar um novo cluster com a VNET BYO ou ao atualizar um cluster existente para habilitar a integração da vnet do apiserver. |
ManagedClusterAutoUpgradeProfile
Perfil de atualização automática para um cluster gerenciado.
| Nome | Tipo | Description |
|---|---|---|
| nodeOSUpgradeChannel |
Canal de atualização do sistema operacional do nó. Maneira como o sistema operacional em seus nós é atualizado. O padrão é NodeImage. |
|
| upgradeChannel |
O canal de atualização para atualização automática. O padrão é 'none'. Para mais informações, veja setting do canal de atualização automática do cluster AKS. |
ManagedClusterAzureMonitorProfile
Perfis adicionais do Azure Monitor para monitoramento do cluster gerenciado.
| Nome | Tipo | Description |
|---|---|---|
| metrics |
Perfil de métricas para o serviço gerenciado Azure Monitor para o addon Prometheus. Colete métricas de infraestrutura Kubernetes prontas para enviar a um Workspace do Azure Monitor e configure scraping adicional para alvos personalizados. Consulte aka.ms/AzureManagedPrometheus para obter uma visão geral. |
ManagedClusterAzureMonitorProfileKubeStateMetrics
Perfil Kube State Metrics para o addon Azure Managed Prometheus. Essas configurações opcionais são para o pod kube-state-metrics implantado com o complemento. Consulte aka.ms/AzureManagedPrometheus-optional-parameters para obter detalhes.
| Nome | Tipo | Description |
|---|---|---|
| metricAnnotationsAllowList |
string |
Lista separada por vírgulas de chaves de anotação do Kubernetes que serão usadas na métrica de rótulos do recurso (exemplo: 'namespaces=[kubernetes.io/team,...],pods=[kubernetes.io/team],...'). Por padrão, a métrica contém apenas o nome do recurso e os rótulos do namespace. |
| metricLabelsAllowlist |
string |
Lista separada por vírgulas de chaves de rótulo kubernetes adicionais que serão usadas na métrica de rótulos do recurso (exemplo: 'namespaces=[k8s-label-1,k8s-label-n,...],pods=[app],...'). Por padrão, a métrica contém apenas o nome do recurso e os rótulos do namespace. |
ManagedClusterAzureMonitorProfileMetrics
Perfil de métricas para o serviço gerenciado Azure Monitor para o addon Prometheus. Colete métricas de infraestrutura Kubernetes prontas para enviar a um Workspace do Azure Monitor e configure scraping adicional para alvos personalizados. Consulte aka.ms/AzureManagedPrometheus para obter uma visão geral.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Seja para habilitar ou desabilitar o suplemento prometheus gerenciado do Azure para monitoramento do Prometheus. Consulte aka.ms/AzureManagedPrometheus-aks-enable para obter detalhes sobre como habilitar e desabilitar. |
| kubeStateMetrics |
Perfil Kube State Metrics para o addon Azure Managed Prometheus. Essas configurações opcionais são para o pod kube-state-metrics implantado com o complemento. Consulte aka.ms/AzureManagedPrometheus-optional-parameters para obter detalhes. |
ManagedClusterBootstrapProfile
O perfil de inicialização.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| artifactSource | Direct |
A origem do artefato. A origem da qual os artefatos são baixados. |
|
| containerRegistryId |
string (arm-id) |
A ID do recurso de Azure Container Registry. O registro deve ter acesso à rede privada, SKU premium e redundância de zona. |
ManagedClusterCostAnalysis
A configuração de análise de custo para o cluster
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Se a análise de custos deve ser ativada. O sku.tier do Cluster Gerenciado deve ser definido como 'Standard' ou 'Premium' para habilitar esse recurso. Habilitar isso adicionará os detalhes do Namespace e da Implantação do Kubernetes às exibições de Análise de Custo no portal Azure. Se não for especificado, o padrão será false. Para obter mais informações, consulte aka.ms/aks/docs/cost-analysis. |
ManagedClusterHTTPProxyConfig
Configuração do proxy HTTP do cluster.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Se o proxy HTTP deve ser ativado. Se desativado, a configuração proxy especificada não será definida em pods e nós. Se não for especificado, o padrão será verdadeiro. |
| httpProxy |
string |
O ponto de extremidade do servidor proxy HTTP a ser usado. |
| httpsProxy |
string |
O ponto de extremidade do servidor proxy HTTPS a ser usado. |
| noProxy |
string[] |
Os pontos de extremidade que não devem passar pelo proxy. |
| trustedCa |
string |
Certificado de AC alternativo a ser usado para se conectar a servidores proxy. |
ManagedClusterIdentity
Identidade para o cluster gerenciado.
| Nome | Tipo | Description |
|---|---|---|
| delegatedResources |
<string,
Delegated |
Os recursos de identidade delegados atribuídos a esse cluster gerenciado. Isso só pode ser configurado por outro Provedor de Recursos do Azure, e o cluster gerenciado aceita apenas um recurso de identidade delegado. Somente para uso interno. |
| principalId |
string |
O ID principal da identidade atribuída pelo sistema que é usado pelos componentes mestre. |
| tenantId |
string |
A ID do locatário da identidade atribuída pelo sistema que é usada pelos componentes mestres. |
| type |
O tipo de identidade usado para o cluster gerenciado. Para mais informações, veja use identidades gerenciadas no AKS. |
|
| userAssignedIdentities |
A identidade do usuário associada ao cluster gerenciado. Essa identidade será usada no plano de controle. Somente uma identidade atribuída pelo usuário é permitida. As chaves devem ser IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
ManagedClusterIngressProfile
Perfil de entrada para o cluster do serviço de contêiner.
| Nome | Tipo | Description |
|---|---|---|
| webAppRouting |
Configurações de roteamento de aplicativo para o perfil de entrada. Você pode encontrar uma visão geral e um guia de integração para esse recurso em https://learn.microsoft.com/en-us/azure/aks/app-routing?tabs=default%2Cdeploy-app-default. |
ManagedClusterIngressProfileNginx
Configuração do controlador de entrada Nginx para o perfil de entrada gerenciado do cluster.
| Nome | Tipo | Description |
|---|---|---|
| defaultIngressControllerType |
Tipo de entrada para o recurso personalizado NginxIngressController padrão |
ManagedClusterIngressProfileWebAppRouting
Configurações de complemento de roteamento de aplicativo para o perfil de entrada.
| Nome | Tipo | Description |
|---|---|---|
| dnsZoneResourceIds |
string[] (arm-id) |
IDs de recurso das zonas DNS a serem associadas ao complemento de Roteamento de Aplicativos. Usado somente quando o complemento de Roteamento de Aplicativo está habilitado. Zonas públicas e private DNS podem estar em diferentes grupos de recursos, mas todas as zonas públicas de DNS devem estar no mesmo grupo de recursos e todas as zonas private DNS devem estar no mesmo grupo de recursos. |
| enabled |
boolean |
Se o complemento de Roteamento de Aplicativos deve ser habilitado. |
| identity |
Identidade gerenciada do complemento Roteamento de Aplicativo. Essa é a identidade que deve receber permissões, por exemplo, para gerenciar o recurso DNS do Azure associado e obter certificados do Azure Key Vault. Consulte esta visão geral do de complemento para obter mais instruções. |
|
| nginx |
Configuração do NginxIngressController padrão. Veja mais em https://learn.microsoft.com/en-us/azure/aks/app-routing-nginx-configuration#the-default-nginx-ingress-controller. |
ManagedClusterLoadBalancerProfile
Perfil do balanceador de carga do cluster gerenciado.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| allocatedOutboundPorts |
integer (int32) minimum: 0maximum: 64000 |
0 |
O número desejado de portas SNAT alocadas por VM. Os valores permitidos estão no intervalo de 0 a 64000 (inclusive). O valor padrão é 0, o que resulta no Azure alocando portas dinamicamente. |
| backendPoolType | NodeIPConfiguration |
O tipo de entrada gerenciada Load Balancer BackendPool. |
|
| effectiveOutboundIPs |
Os recursos de IP de saída efetivos do balanceador de carga do cluster. |
||
| enableMultipleStandardLoadBalancers |
boolean |
Habilite vários balanceadores de carga padrão por cluster do AKS ou não. |
|
| idleTimeoutInMinutes |
integer (int32) minimum: 4maximum: 120 |
30 |
Tempo limite de ociosidade do fluxo de saída desejado em minutos. Os valores permitidos estão no intervalo de 4 a 120 (inclusive). O valor-padrão é 30 minutos. |
| managedOutboundIPs |
IPs gerenciados de saída desejados para o cluster load balancer. |
||
| outboundIPPrefixes |
Recursos de prefixo de IP de saída desejados para o balanceador de carga do cluster. |
||
| outboundIPs |
Recursos de IP de saída desejados para o balanceador de carga do cluster. |
ManagedClusterLoadBalancerProfileManagedOutboundIPs
IPs gerenciados de saída desejados para o cluster load balancer.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| count |
integer (int32) minimum: 1maximum: 100 |
1 |
O número desejado de IPv4 de saída de IPv4 criado/gerenciado pelo Azure para o load balancer do cluster. Os valores permitidos devem estar no intervalo de 1 a 100 (inclusive). O valor padrão é 1. |
| countIPv6 |
integer (int32) minimum: 0maximum: 100 |
0 |
O número desejado de IPv6 de saída criado/gerenciado pelo Azure para o load balancer do cluster. Os valores permitidos devem estar no intervalo de 1 a 100 (inclusive). O valor padrão é 0 para pilha única e 1 para pilha dupla. |
ManagedClusterLoadBalancerProfileOutboundIPPrefixes
Recursos de prefixo de IP de saída desejados para o balanceador de carga do cluster.
| Nome | Tipo | Description |
|---|---|---|
| publicIPPrefixes |
Uma lista de recursos de prefixo ip público. |
ManagedClusterLoadBalancerProfileOutboundIPs
Recursos de IP de saída desejados para o balanceador de carga do cluster.
| Nome | Tipo | Description |
|---|---|---|
| publicIPs |
Uma lista de recursos ip públicos. |
ManagedClusterManagedOutboundIPProfile
Perfil dos recursos de IP de saída gerenciados do cluster gerenciado.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| count |
integer (int32) minimum: 1maximum: 16 |
1 |
O número desejado de IPs de saída criados/gerenciados por Azure. Os valores permitidos devem estar no intervalo de 1 a 16 (inclusive). O valor padrão é 1. |
ManagedClusterMetricsProfile
O perfil de métricas do ManagedCluster.
| Nome | Tipo | Description |
|---|---|---|
| costAnalysis |
A configuração para análise detalhada de custo de recurso por Kubernetes. |
ManagedClusterNATGatewayProfile
Perfil do gateway NAT do cluster gerenciado.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| effectiveOutboundIPs |
Os recursos de IP de saída efetivos do gateway NAT do cluster. |
||
| idleTimeoutInMinutes |
integer (int32) minimum: 4maximum: 120 |
4 |
Tempo limite de ociosidade do fluxo de saída desejado em minutos. Os valores permitidos estão no intervalo de 4 a 120 (inclusive). O valor padrão é 4 minutos. |
| managedOutboundIPProfile |
Perfil dos recursos de IP de saída gerenciados do gateway NAT do cluster. |
ManagedClusterNodeProvisioningProfile
Perfil de provisão de nós para o cluster gerenciado.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| defaultNodePools | Auto |
O conjunto de CRDs (Karpenter NodePools) padrão configurados para provisionamento de nós. Este campo não tem efeito, a menos que o modo seja 'Auto'. Aviso: Alterar isso de Automático para Nenhum em um cluster existente fará com que os NodePools Karpenter padrão sejam excluídos, o que drenará e excluirá os nós associados a esses pools. É altamente recomendável não fazer isso, a menos que haja nós ociosos prontos para receber os pods removidos por essa ação. Se não for especificado, o padrão será Auto. Para obter mais informações, consulte aka.ms/aks/nap#node-pools. |
|
| mode |
O modo de provisionamento de nó. Se não for especificado, o padrão será Manual. |
ManagedClusterNodeResourceGroupProfile
Perfil de bloqueio do grupo de recursos do nó para um cluster gerenciado.
| Nome | Tipo | Description |
|---|---|---|
| restrictionLevel |
O nível de restrição aplicado ao grupo de recursos do nó do cluster. Se não for especificado, o padrão será 'Irrestrito' |
ManagedClusterOIDCIssuerProfile
O perfil do emissor OIDC do Cluster Gerenciado.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Se o emissor do OIDC está habilitado. |
| issuerURL |
string |
A URL do emissor do OIDC do Cluster Gerenciado. |
ManagedClusterPodIdentity
Detalhes sobre a identidade do pod atribuída ao Cluster Gerenciado.
| Nome | Tipo | Description |
|---|---|---|
| bindingSelector |
string |
O seletor de associação a ser usado para o recurso AzureIdentityBinding. |
| identity |
Os detalhes de identidade atribuídos pelo usuário. |
|
| name |
string |
O nome da identidade do pod. |
| namespace |
string |
O namespace da identidade do pod. |
| provisioningInfo |
As informações de provisionamento para a identidade do pod. |
|
| provisioningState |
O estado de provisionamento atual da identidade do pod. |
ManagedClusterPodIdentityException
Uma exceção de identidade de pod, que permite que pods com determinados rótulos acessem o ponto de extremidade do IMDS (Serviço de Metadados de Instância do Azure) sem serem interceptados pelo servidor NMI (identidade gerenciada por nó). Consulte desabilitar a Identidade do Pod do AAD para obter um pod/ de aplicativo específico para obter mais detalhes.
| Nome | Tipo | Description |
|---|---|---|
| name |
string |
O nome da exceção de identidade do pod. |
| namespace |
string |
O namespace da exceção de identidade do pod. |
| podLabels |
object |
Os rótulos de pod a serem correspondentes. |
ManagedClusterPodIdentityProfile
O perfil de identidade do pod do Cluster Gerenciado. Consulte usar a identidade do pod do AAD para obter mais detalhes sobre a integração de identidade do pod.
| Nome | Tipo | Description |
|---|---|---|
| allowNetworkPluginKubenet |
boolean |
Se a identidade do pod tem permissão para ser executada em clusters com a rede Kubenet. A execução no Kubenet é desabilitada por padrão devido à natureza relacionada à segurança da Identidade de Pod do AAD e aos riscos de falsificação de IP. Veja using Kubenet network plugin com AAD Pod Identity para mais informações. |
| enabled |
boolean |
Se o complemento de identidade do pod está habilitado. |
| userAssignedIdentities |
As identidades do pod a serem usadas no cluster. |
|
| userAssignedIdentityExceptions |
As exceções de identidade do pod a serem permitidos. |
ManagedClusterPodIdentityProvisioningError
Uma resposta de erro do provisionamento de identidade do pod.
| Nome | Tipo | Description |
|---|---|---|
| error |
Detalhes sobre o erro. |
ManagedClusterPodIdentityProvisioningErrorBody
Uma resposta de erro do provisionamento de identidade do pod.
| Nome | Tipo | Description |
|---|---|---|
| code |
string |
Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente. |
| details |
Uma lista de detalhes adicionais sobre o erro. |
|
| message |
string |
Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário. |
| target |
string |
O destino do erro específico. Por exemplo, o nome da propriedade em erro. |
ManagedClusterPodIdentityProvisioningInfo
Informações de provisão de identidade do pod.
| Nome | Tipo | Description |
|---|---|---|
| error |
Erro de atribuição de identidade do pod (se houver). |
ManagedClusterPodIdentityProvisioningState
O estado de provisionamento atual da identidade do pod.
| Valor | Description |
|---|---|
| Assigned |
A identidade do pod é atribuída. |
| Canceled |
A atribuição de identidade do pod foi cancelada. |
| Deleting |
A identidade do pod está sendo excluída. |
| Failed |
Atribuição de identidade do pod falhou. |
| Succeeded |
Atribuição de identidade do pod bem-sucedida. |
| Updating |
A identidade do pod está sendo atualizada. |
ManagedClusterPropertiesAutoScalerProfile
Parâmetros a serem aplicados ao cluster-autoscaler quando habilitados
| Nome | Tipo | Description |
|---|---|---|
| balance-similar-node-groups |
string |
Detecta pools de nós semelhantes e equilibra o número de nós entre eles. Os valores válidos são 'true' e 'false' |
| daemonset-eviction-for-empty-nodes |
boolean |
Os pods do DaemonSet serão encerrados normalmente a partir de nós vazios. Se definido como true, todos os pods de daemonset em nós vazios serão removidos antes da exclusão do nó. Se o pod daemonset não puder ser removido, outro nó será escolhido para dimensionamento. Se definido como false, o nó será excluído sem garantir que os pods do daemonset sejam excluídos ou removidos. |
| daemonset-eviction-for-occupied-nodes |
boolean |
Os pods do DaemonSet serão encerrados normalmente a partir de nós não vazios. Se definido como true, todos os pods de daemonset em nós ocupados serão removidos antes da exclusão do nó. Se o pod daemonset não puder ser removido, outro nó será escolhido para dimensionamento. Se definido como false, o nó será excluído sem garantir que os pods do daemonset sejam excluídos ou removidos. |
| expander |
O expansor a ser usado ao aumentar a escala. Se não for especificado, o padrão será "aleatório". Veja expanders para mais informações. |
|
| ignore-daemonsets-utilization |
boolean |
A CA deve ignorar os pods do DaemonSet ao calcular a utilização de recursos para reduzir verticalmente. Se definido como true, os recursos usados pelo daemonset serão levados em conta ao tomar decisões de redução horizontal. |
| max-empty-bulk-delete |
string |
O número máximo de nós vazios que podem ser excluídos ao mesmo tempo. Deve ser um inteiro positivo. O padrão é 10. |
| max-graceful-termination-sec |
string |
O número máximo de segundos que o dimensionador automático do cluster aguarda o encerramento do pod ao tentar reduzir verticalmente um nó. O padrão é 600. |
| max-node-provision-time |
string |
O tempo máximo que o dimensionador automático aguarda que um nó seja provisionado. O padrão é '15m'. Os valores devem ser um inteiro seguido por um 'm'. Não há suporte para nenhuma unidade de tempo que não seja minutos (m). |
| max-total-unready-percentage |
string |
O percentual máximo de nós não ressardos no cluster. Depois que esse percentual for excedido, o dimensionador automático de cluster interromperá as operações. O padrão é 45. O máximo é 100 e o mínimo é 0. |
| new-pod-scale-up-delay |
string |
Ignore pods não programados antes de terem uma certa idade. Para cenários como a escala de lote/intermitência em que você não deseja que a AC atue antes que o agendador do kubernetes possa agendar todos os pods, você pode dizer à AC para ignorar pods não programados antes que eles sejam de uma determinada idade. O padrão é '0s'. Os valores devem ser um inteiro seguido por uma unidade ('s' por segundos, 'm' por minutos, 'h' por horas etc. |
| ok-total-unready-count |
string |
O número de nós não ressarços permitidos, independentemente do percentual máximo-total-desproduto. Isso deve ser um inteiro. O padrão é 3. |
| scale-down-delay-after-add |
string |
Quanto tempo depois da operação de escalar verticalmente a avaliação de redução vertical será retomada. O padrão é '10m'. Os valores devem ser um inteiro seguido por um 'm'. Não há suporte para nenhuma unidade de tempo que não seja minutos (m). |
| scale-down-delay-after-delete |
string |
Quanto tempo após a exclusão do nó a avaliação de redução vertical é retomada. O padrão é o intervalo de verificação. Os valores devem ser um inteiro seguido por um 'm'. Não há suporte para nenhuma unidade de tempo que não seja minutos (m). |
| scale-down-delay-after-failure |
string |
Quanto tempo após a falha na redução vertical a avaliação de redução vertical é retomada. O padrão é '3m'. Os valores devem ser um inteiro seguido por um 'm'. Não há suporte para nenhuma unidade de tempo que não seja minutos (m). |
| scale-down-unneeded-time |
string |
Por quanto tempo um nó deve ser desnecessário antes de ser elegível para reduzir verticalmente. O padrão é '10m'. Os valores devem ser um inteiro seguido por um 'm'. Não há suporte para nenhuma unidade de tempo que não seja minutos (m). |
| scale-down-unready-time |
string |
Por quanto tempo um nó despreparado deve ser desnecessário antes de ser qualificado para redução vertical. O padrão é '20m'. Os valores devem ser um inteiro seguido por um 'm'. Não há suporte para nenhuma unidade de tempo que não seja minutos (m). |
| scale-down-utilization-threshold |
string |
Nível de utilização do nó, definido como soma dos recursos solicitados divididos pela capacidade, abaixo do qual um nó pode ser considerado para reduzir verticalmente. O padrão é '0.5'. |
| scan-interval |
string |
Com que frequência o cluster é reavaliado para escalar verticalmente ou para baixo. O padrão é '10'. Os valores devem ser um número inteiro de segundos. |
| skip-nodes-with-local-storage |
string |
Se o cluster, o autoscaler pula a exclusão de nós com pods com storage local, por exemplo, EmptyDir ou HostPath. O padrão é verdadeiro. |
| skip-nodes-with-system-pods |
string |
Se o dimensionador automático de cluster ignorar a exclusão de nós com pods do kube-system (exceto para DaemonSet ou pods espelho). O padrão é verdadeiro. |
ManagedClusterSecurityProfile
Perfil de segurança para o cluster do serviço de contêiner.
| Nome | Tipo | Description |
|---|---|---|
| azureKeyVaultKms |
Azure Key Vault serviço de gerenciamento de chaves configurações para o perfil de segurança. |
|
| customCATrustCertificates |
string[] (byte) |
Uma lista de até 10 CAs codificadas em base64 que serão adicionadas ao repositório de confiança em todos os nós no cluster. Para mais informações, veja Certificados de Confiança CA Personalizados. |
| defender |
Configurações do Microsoft Defender para o perfil de segurança. |
|
| imageCleaner |
Configurações do Limpador de Imagens para o perfil de segurança. |
|
| workloadIdentity |
Configurações de identidade de carga de trabalho para o perfil de segurança. A identidade da carga de trabalho permite que aplicações Kubernetes access Azure recursos em nuvem com segurança com Azure AD. Confira https://aka.ms/aks/wi para obter mais detalhes. |
ManagedClusterSecurityProfileDefender
Configurações do Microsoft Defender para o perfil de segurança.
| Nome | Tipo | Description |
|---|---|---|
| logAnalyticsWorkspaceResourceId |
string (arm-id) |
ID de recurso do espaço de trabalho Log Analytics a ser associado ao Microsoft Defender. Quando Microsoft Defender está habilitado, esse campo é necessário e deve ser uma ID de recurso de workspace válida. Quando Microsoft Defender estiver desabilitado, deixe o campo vazio. |
| securityMonitoring |
Detecção de ameaças do Microsoft Defender para configurações de nuvem no perfil de segurança. |
ManagedClusterSecurityProfileDefenderSecurityMonitoring
Configurações do Microsoft Defender para a detecção de ameaças do perfil de segurança.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Se deseja habilitar a detecção de ameaças do Defender |
ManagedClusterSecurityProfileImageCleaner
O Limpador de Imagens remove imagens não utilizados de nós, liberando espaço em disco e ajudando a reduzir a área da superfície de ataque. Aqui estão as configurações para o perfil de segurança.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Se deseja habilitar o Limpador de Imagens no cluster do AKS. |
| intervalHours |
integer (int32) |
Intervalo de verificação do Limpador de Imagens em horas. |
ManagedClusterSecurityProfileWorkloadIdentity
Configurações de identidade de carga de trabalho para o perfil de segurança.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Se deseja habilitar a identidade da carga de trabalho. |
ManagedClusterServicePrincipalProfile
Informações sobre uma identidade de principal de serviço para o cluster usar na manipulação das APIs do Azure.
| Nome | Tipo | Description |
|---|---|---|
| clientId |
string |
A ID da entidade de serviço. |
| secret |
string (password) |
A senha secreta associada à entidade de serviço em texto sem formatação. |
ManagedClusterSKU
A SKU de um cluster gerenciado.
| Nome | Tipo | Description |
|---|---|---|
| name |
O nome de um SKU de cluster gerenciado. |
|
| tier |
A camada de um SKU de cluster gerenciado. Se não for especificado, o padrão será "Gratuito". Veja AKS Pricing Tier para mais detalhes. |
ManagedClusterSKUName
O nome de um SKU de cluster gerenciado.
| Valor | Description |
|---|---|
| Base |
Opção base para o plano de controle do AKS. |
| Automatic |
Os clusters automáticos são otimizados para executar a maioria das cargas de trabalho de produção com configuração que segue as práticas recomendadas e as recomendações do AKS para configuração, escalabilidade e segurança de cluster e carga de trabalho. Para obter mais detalhes sobre clusters automáticos, consulte aka.ms/aks/automatic. |
ManagedClusterSKUTier
A camada de um SKU de cluster gerenciado. Se não for especificado, o padrão será "Gratuito". Veja AKS Pricing Tier para mais detalhes.
| Valor | Description |
|---|---|
| Premium |
O Cluster tem recursos premium, além de todos os recursos incluídos no 'Standard'. O Premium habilita a seleção de LongTermSupport (aka.ms/aks/lts) para determinadas versões do Kubernetes. |
| Standard |
Recomendado para cargas de trabalho críticas e de produção. Inclui dimensionamento automático do plano de controle do Kubernetes, teste intensivo de carga de trabalho e até 5.000 nós por cluster. Garante 99,95% disponibilidade do ponto de extremidade do servidor de API do Kubernetes para clusters que usam Zonas de Disponibilidade e 99,9% de disponibilidade para clusters que não usam Zonas de Disponibilidade. |
| Free |
O gerenciamento de cluster é gratuito, mas cobrado pelo uso de VM, armazenamento e rede. Melhor para experimentar, aprender, testar simples ou cargas de trabalho com menos de 10 nós. Não recomendado para casos de uso de produção. |
ManagedClusterStaticEgressGatewayProfile
A configuração de complemento do Gateway de Saída Estática para o cluster.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Habilite o complemento Static Egress Gateway. Indica se o complemento do Gateway de Saída Estática está habilitado ou não. |
ManagedClusterStatus
Contém informações somente leitura sobre o Cluster Gerenciado.
| Nome | Tipo | Description |
|---|---|---|
| provisioningError |
O erro detalha as informações do cluster gerenciado. Preserva as informações detalhadas da falha. Se não houver erro, esse campo será omitido. |
ManagedClusterStorageProfile
Perfil de armazenamento para o cluster do serviço de contêiner.
| Nome | Tipo | Description |
|---|---|---|
| blobCSIDriver |
Configurações do driver CSI do AzureBlob para o perfil de storage. |
|
| diskCSIDriver |
Configurações do driver CSI do AzureDisk para o perfil de storage. |
|
| fileCSIDriver |
Configurações do driver CSI do AzureFile para o perfil de storage. |
|
| snapshotController |
Configurações do Controlador de Snapshot para o perfil de storage. |
ManagedClusterStorageProfileBlobCSIDriver
Configurações do driver CSI do AzureBlob para o perfil de storage.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Se deseja habilitar o Driver CSI do AzureBlob. O valor padrão é false. |
ManagedClusterStorageProfileDiskCSIDriver
Configurações do driver CSI do AzureDisk para o perfil de storage.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Se deseja habilitar o Driver CSI do AzureDisk. O valor padrão é true. |
ManagedClusterStorageProfileFileCSIDriver
Configurações do driver CSI do AzureFile para o perfil de storage.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Se deseja habilitar o Driver CSI do AzureFile. O valor padrão é true. |
ManagedClusterStorageProfileSnapshotController
Configurações do Controlador de Snapshot para o perfil de storage.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Se o Controlador de Instantâneo deve ser habilitado. O valor padrão é true. |
ManagedClusterWindowsProfile
Perfil para VMs do Windows no cluster gerenciado.
| Nome | Tipo | Description |
|---|---|---|
| adminPassword |
string (password) |
Especifica a senha da conta de administrador. |
| adminUsername |
string |
Especifica o nome da conta de administrador. |
| enableCSIProxy |
boolean |
Se deseja habilitar o proxy CSI. Para mais detalhes sobre proxy CSI, veja o CSI proxy GitHub repo. |
| gmsaProfile |
O perfil gMSA do Windows no Cluster Gerenciado. |
|
| licenseType |
O tipo de licença a ser usado para VMs do Windows. Veja Azure Benefícios para Usuários Híbridos para mais detalhes. |
ManagedClusterWorkloadAutoScalerProfile
Perfil de dimensionador automático de carga de trabalho para o cluster gerenciado.
| Nome | Tipo | Description |
|---|---|---|
| keda |
Configurações keda (dimensionamento automático controlado por eventos do Kubernetes) para o perfil de dimensionador automático de carga de trabalho. |
|
| verticalPodAutoscaler |
Managed |
Configurações de VPA (Dimensionador Automático de Pod Vertical) para o perfil de dimensionador automático de carga de trabalho. |
ManagedClusterWorkloadAutoScalerProfileKeda
Configurações keda (dimensionamento automático controlado por eventos do Kubernetes) para o perfil de dimensionador automático de carga de trabalho.
| Nome | Tipo | Description |
|---|---|---|
| enabled |
boolean |
Se deseja habilitar o KEDA. |
ManagedClusterWorkloadAutoScalerProfileVerticalPodAutoscaler
Configurações de VPA (Dimensionador Automático de Pod Vertical) para o perfil de dimensionador automático de carga de trabalho.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| enabled |
boolean |
False |
Se deseja habilitar a VPA. O valor padrão é falso. |
ManagedServiceIdentityUserAssignedIdentitiesValue
Propriedades de identidade atribuídas pelo usuário.
| Nome | Tipo | Description |
|---|---|---|
| clientId |
string |
A ID do cliente da identidade atribuída pelo usuário. |
| principalId |
string |
A ID principal da identidade atribuída pelo usuário. |
ManualScaleProfile
Especificações no número de computadores.
| Nome | Tipo | Description |
|---|---|---|
| count |
integer (int32) |
Número de nós. |
| size |
string |
Tamanho da VM que o AKS usará ao criar e dimensionar, por exemplo, 'Standard_E4s_v3', 'Standard_E16s_v3' ou 'Standard_D16s_v5'. |
NetworkDataplane
Plano de dados de rede usado no cluster do Kubernetes.
| Valor | Description |
|---|---|
| azure |
Use o dataplane de rede do Azure. |
| cilium |
Use o dataplane de rede do Cilium. Consulte Azure CNI Powered by Cilium para obter mais informações. |
NetworkMode
O modo de rede com o qual o Azure CNI está configurado. Isso não pode ser especificado se networkPlugin for algo além de 'azure'.
NetworkPlugin
Plug-in de rede usado para criar a rede do Kubernetes.
NetworkPluginMode
O modo que o plug-in de rede deve usar.
| Valor | Description |
|---|---|
| overlay |
Usado com networkPlugin=azure, os pods recebem IPs do espaço de endereço PodCIDR, mas usam Domínios de Roteamento do Azure em vez do método de tabelas de rotas do Kubenet. Para obter mais informações, visite https://aka.ms/aks/azure-cni-overlay. |
NetworkPolicy
Política de rede usada para criar a rede do Kubernetes.
| Valor | Description |
|---|---|
| none |
As políticas de rede não serão aplicadas. Esse é o valor padrão quando NetworkPolicy não é especificado. |
| calico |
Use políticas de rede do Calico. Confira diferenças entre as políticas do Azure e do Calico para obter mais informações. |
| azure |
Use políticas de rede do Azure. Confira diferenças entre as políticas do Azure e do Calico para obter mais informações. |
| cilium |
Use o Cilium para aplicar políticas de rede. Isso requer que networkDataplane seja 'cilium'. |
NginxIngressControllerType
Tipo de entrada para o recurso personalizado NginxIngressController padrão
| Valor | Description |
|---|---|
| AnnotationControlled |
O NginxIngressController padrão será criado. Os usuários podem editar o recurso personalizado NginxIngressController padrão para configurar anotações do balanceador de carga. |
| External |
O NginxIngressController padrão será criado e o operador provisionará um balanceador de carga externo com ele. Qualquer anotação para tornar o loadbalancer padrão interno será substituída. |
| Internal |
O NginxIngressController padrão será criado e o operador provisionará um balanceador de carga interno com ele. Qualquer anotação para tornar o loadbalancer externo padrão será substituída. |
| None |
O Controlador de Entrada padrão não será criado. Ele não será excluído pelo sistema se ele existir. Os usuários devem excluir o recurso personalizado NginxIngressController padrão manualmente, se desejado. |
NodeOSUpgradeChannel
Canal de atualização do sistema operacional do nó. Maneira como o sistema operacional em seus nós é atualizado. O padrão é NodeImage.
| Valor | Description |
|---|---|
| None |
Nenhuma tentativa de atualizar o sistema operacional de seus computadores será feita pelo sistema operacional ou por VHDs de rolagem. Isso significa que você é responsável por suas atualizações de segurança |
| Unmanaged |
As atualizações do sistema operacional serão aplicadas automaticamente por meio da infraestrutura de aplicação de patch interna do sistema operacional. A escala recém-dimensionada em computadores será inicialmente não corrigida e será corrigida em algum momento pela infraestrutura do sistema operacional. O comportamento dessa opção depende do sistema operacional em questão. O Ubuntu e o Mariner aplicam patches de segurança por meio de atualização autônoma aproximadamente uma vez por dia por volta das 06:00 UTC. O Windows não aplica patches de segurança automaticamente e, portanto, para eles, essa opção é equivalente a Nenhum até novo aviso |
| NodeImage |
O AKS atualizará os nós com um VHD recém-corrigido contendo correções de segurança e correções de bugs em uma cadência semanal. Com os computadores de atualização VHD serão reexibidos para esse VHD seguindo as janelas de manutenção e as configurações de aumento. Nenhum custo adicional de VHD é incorrido ao escolher essa opção, pois o AKS hospeda as imagens. |
| SecurityPatch |
O AKS baixa e atualiza os nós com atualizações de segurança testadas. Essas atualizações respeitam as configurações da janela de manutenção e produzem um novo VHD usado em novos nós. Em algumas ocasiões, não é possível aplicar as atualizações em vigor, nesses casos, os nós existentes também serão reexibidos para o VHD recém-produzido para aplicar as alterações. Essa opção incorre em um custo extra de hospedagem dos novos VHDs de Patch de Segurança em seu grupo de recursos para consumo just-in-time. |
NodeProvisioningDefaultNodePools
O conjunto de CRDs (Karpenter NodePools) padrão configurados para provisionamento de nós. Este campo não tem efeito, a menos que o modo seja 'Auto'. Aviso: Alterar isso de Automático para Nenhum em um cluster existente fará com que os NodePools Karpenter padrão sejam excluídos, o que drenará e excluirá os nós associados a esses pools. É altamente recomendável não fazer isso, a menos que haja nós ociosos prontos para receber os pods removidos por essa ação. Se não for especificado, o padrão será Auto. Para obter mais informações, consulte aka.ms/aks/nap#node-pools.
| Valor | Description |
|---|---|
| None |
Nenhum NodePool Karpenter é provisionado automaticamente. O dimensionamento automático não ocorrerá a menos que o usuário crie uma ou mais instâncias de CRD do NodePool. |
| Auto |
Um conjunto padrão de Karpenter NodePools é provisionado |
NodeProvisioningMode
O modo de provisionamento de nó. Se não for especificado, o padrão será Manual.
| Valor | Description |
|---|---|
| Manual |
Os nós são provisionados manualmente pelo usuário |
| Auto |
Os nós são provisionados automaticamente pelo AKS usando o Karpenter (consulte aka.ms/aks/nap para obter mais detalhes). Pools de nós de tamanho fixo ainda podem ser criados, mas não é possível dimensionar automaticamente pools de nós. (Consulte aka.ms/aks/nap para obter mais detalhes). |
OSDiskType
O tipo de disco do sistema operacional a ser usado para computadores no pool de agentes. O padrão será "Efêmero" se a VM der suporte a ela e tiver um disco de cache maior que o OSDiskSizeGB solicitado. Caso contrário, o padrão será 'Gerenciado'. Pode não ser alterado após a criação. Para mais informações, veja Ephemeral OS.
| Valor | Description |
|---|---|
| Managed |
O Azure replica o disco do sistema operacional de uma máquina virtual para o armazenamento do Azure para evitar a perda de dados caso a VM precise ser realocada para outro host. Como os contêineres não foram projetados para manter o estado local, esse comportamento oferece valor limitado, fornecendo algumas desvantagens, incluindo provisionamento de nó mais lento e latência de leitura/gravação mais alta. |
| Ephemeral |
Os discos do sistema operacional efêmero são armazenados apenas na máquina host, assim como um disco temporário. Isso fornece menor latência de leitura/gravação, juntamente com o dimensionamento de nó mais rápido e atualizações de cluster. |
OSSKU
Especifica o SKU do sistema operacional usado pelo pool de agentes. O padrão é Ubuntu se OSType for Linux. O padrão é Windows2019 quando Kubernetes <= 1,24 ou Windows2022 quando Kubernetes >= 1,25 se OSType for Windows.
| Valor | Description |
|---|---|
| Ubuntu |
Use o Ubuntu como o sistema operacional para imagens de nó. |
| AzureLinux |
Use o AzureLinux como o sistema operacional para imagens de nó. O Azure Linux é uma distribuição do Linux com otimização de contêiner criada pela Microsoft, visite https://aka.ms/azurelinux para obter mais informações. |
| AzureLinux3 |
Use AzureLinux3 como o sistema operacional para imagens de nó. O Azure Linux é uma distribuição do Linux com otimização de contêiner criada pela Microsoft, visite https://aka.ms/azurelinux para obter mais informações. Para limitações, visite https://aka.ms/aks/node-images. Para obter diretrizes de migração do sistema operacional, consulte https://aka.ms/aks/upgrade-os-version. |
| CBLMariner |
OSSKU preterido. Em vez disso, a Microsoft recomenda que novas implantações escolham "AzureLinux". |
| Windows2019 |
Use o Windows2019 como o sistema operacional para imagens de nó. Sem suporte para pools de nós do sistema. O Windows2019 só dá suporte a contêineres do Windows2019; ele não pode executar contêineres do Windows2022 e vice-versa. |
| Windows2022 |
Use o Windows2022 como o sistema operacional para imagens de nó. Sem suporte para pools de nós do sistema. O Windows2022 só dá suporte a contêineres do Windows2022; ele não pode executar contêineres do Windows2019 e vice-versa. |
| Ubuntu2204 |
Use o Ubuntu2204 como sistema operacional para imagens de nó, no entanto, o Ubuntu 22.04 pode não ser compatível com todos os pools de nós. Para limitações e versões do Kubernetes suportadas, consulte https://aka.ms/aks/supported-ubuntu-versions |
| Ubuntu2404 |
Use o Ubuntu2404 como sistema operacional para imagens de nó, no entanto, o Ubuntu 24.04 pode não ser compatível com todos os pools de nós. Para limitações e versões do Kubernetes suportadas, consulte consulte https://aka.ms/aks/supported-ubuntu-versions |
OSType
O tipo de sistema operacional. O padrão é Linux.
| Valor | Description |
|---|---|
| Linux |
Use Linux. |
| Windows |
Use Windows. |
OutboundType
O método de roteamento de saída (saída). Isso só pode ser definido no momento da criação do cluster e não pode ser alterado posteriormente. Para mais informações, veja
| Valor | Description |
|---|---|
| loadBalancer |
O balanceador de carga é usado para saída por meio de um IP público atribuído ao AKS. Isso dá suporte aos serviços kubernetes do tipo 'loadBalancer'. Para obter mais informações, consulte loadbalancer de tipo de saída. |
| userDefinedRouting |
Os caminhos de saída devem ser definidos pelo usuário. Esse é um cenário avançado e requer uma configuração de rede adequada. Para obter mais informações, consulte userDefinedRouting de tipo de saída. |
| managedNATGateway |
O gateway NAT gerenciado pelo AKS é usado para saída. |
| userAssignedNATGateway |
O gateway NAT atribuído pelo usuário associado à sub-rede do cluster é usado para saída. Esse é um cenário avançado e requer uma configuração de rede adequada. |
| none |
O cluster do AKS não está definido com nenhum tipo de saída. Todos os nós do AKS seguem o comportamento de saída padrão da VM do Azure. Consulte 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
Modo de alocação de IP do pod. O modo de alocação de IP para pods no pool de agentes. Deve ser usado com podSubnetId. O padrão é 'DynamicIndividual'.
| Valor | Description |
|---|---|
| DynamicIndividual |
Cada nó é alocado com uma lista não contígua de endereços IP atribuíveis aos pods. Isso é melhor para maximizar uma sub-rede pequena a média de tamanho /16 ou menor. O cluster CNI do Azure com alocação de IP dinâmico será padronizado para esse modo se o cliente não especificar explicitamente um podIPAllocationMode |
| StaticBlock |
Cada nó é alocado estaticamente blocos CIDR de tamanho /28 = 16 IPs por bloco para satisfazer os maxPods por nó. Número de blocos CIDR >= (maxPods/16). O bloco, em vez de um único IP, conta com o limite de IP privado da Vnet do Azure de 65K. Portanto, o modo de bloco é adequado para executar cargas de trabalho maiores com mais do que o limite atual de pods de 65K em um cluster. Esse modo é mais adequado para dimensionar com sub-redes maiores de /15 ou maior |
PortRange
O intervalo de portas.
| Nome | Tipo | Description |
|---|---|---|
| portEnd |
integer (int32) minimum: 1maximum: 65535 |
A porta máxima incluída no intervalo. Ela deve ser variada de 1 a 65535 e ser maior ou igual a portStart. |
| portStart |
integer (int32) minimum: 1maximum: 65535 |
A porta mínima incluída no intervalo. Ela deve ser variada de 1 a 65535 e ser menor ou igual a portEnd. |
| protocol |
O protocolo de rede da porta. |
PowerState
Descreve o Estado do Power do cluster
| Nome | Tipo | Description |
|---|---|---|
| code |
Informa se o cluster está em execução ou parado |
PrivateLinkResource
Um recurso de link privado
| Nome | Tipo | Description |
|---|---|---|
| groupId |
string |
A ID do grupo do recurso. |
| id |
string |
O ID do recurso private link. |
| name |
string |
O nome do recurso de link privado. Veja as regras de nomeação para mais detalhes. |
| privateLinkServiceID |
string (arm-id) |
A ID do serviço de link privado do recurso, esse campo é exposto apenas ao NRP internamente. |
| requiredMembers |
string[] |
Os RequiredMembers do recurso |
| type |
string |
O tipo de recurso. |
Protocol
O protocolo de rede da porta.
| Valor | Description |
|---|---|
| TCP |
Protocolo TCP. |
| UDP |
UDP. |
ProxyRedirectionMechanism
Modo de redirecionamento de tráfego.
| Valor | Description |
|---|---|
| InitContainers |
O Istio injetará um contêiner de inicialização em cada pod para redirecionar o tráfego (requer NET_ADMIN e NET_RAW). |
| CNIChaining |
O Istio instalará um plug-in CNI encadeado para redirecionar o tráfego (recomendado). |
PublicNetworkAccess
PublicNetworkAccess do managedCluster. Permitir ou negar acesso à rede pública para AKS
| Valor | Description |
|---|---|
| Enabled |
Entrada/saída para o managedCluster é permitido. |
| Disabled |
O tráfego de entrada para managedCluster está desabilitado, o tráfego de managedCluster é permitido. |
ResourceIdentityType
O tipo de identidade usado para o cluster gerenciado. Para mais informações, veja use identidades gerenciadas no AKS.
| Valor | Description |
|---|---|
| SystemAssigned |
Use uma identidade gerenciada atribuída pelo sistema criada implicitamente para gerenciar recursos de cluster. Os componentes mestres no painel de controle, como kube-controller-manager, usarão a identidade gerenciada atribuída pelo sistema para manipular os recursos do Azure. |
| UserAssigned |
Use uma identidade especificada pelo usuário para gerenciar recursos de cluster. Os componentes mestres no painel de controle, como kube-controller-manager, usarão a identidade gerenciada atribuída pelo usuário especificado para manipular os recursos do Azure. |
| None |
Não use uma identidade gerenciada para o Cluster Gerenciado, a entidade de serviço será usada em vez disso. |
ResourceReference
Uma referência a um recurso do Azure.
| Nome | Tipo | Description |
|---|---|---|
| id |
string (arm-id) |
O ID de recurso do Azure totalmente qualificado. |
RestrictionLevel
O nível de restrição aplicado ao grupo de recursos do nó do cluster. Se não for especificado, o padrão será 'Irrestrito'
| Valor | Description |
|---|---|
| Unrestricted |
Todas as permissões RBAC são permitidas no grupo de recursos de nó gerenciado |
| ReadOnly |
Somente permissões */read RBAC são permitidas no grupo de recursos do nó gerenciado |
ScaleDownMode
Descreve como as VMs são adicionadas ou removidas dos Pools de Agentes. Consulte estados de faturamento.
| Valor | Description |
|---|---|
| Delete |
Crie novas instâncias durante a expansão e remova instâncias durante a redução. |
| Deallocate |
Tente iniciar instâncias desalocadas (se existirem) durante a escala vertical e desalocar instâncias durante a redução. |
ScaleProfile
Especificações sobre como dimensionar um pool de agentes VirtualMachines.
| Nome | Tipo | Description |
|---|---|---|
| manual |
Especificações sobre como dimensionar o pool de agentes VirtualMachines para um tamanho fixo. |
ScaleSetEvictionPolicy
A política de remoção do Conjunto de Dimensionamento de Máquinas Virtuais. A política de despejo especifica o que to do com a VM quando ela é despejada. O padrão é Excluir. Para mais informações sobre despejo, veja
| Valor | Description |
|---|---|
| Delete |
Os nós no Conjunto de Dimensionamento subjacente do pool de nós são excluídos quando são removidos. |
| Deallocate |
Os nós no Conjunto de Dimensionamento subjacente do pool de nós são definidos como o estado parado-desalocado após a remoção. Nós na contagem de estado desalocado interrompido em relação à cota de computação e podem causar problemas com o dimensionamento ou atualização do cluster. |
ScaleSetPriority
A prioridade do Conjunto de Dimensionamento de Máquinas Virtuais.
| Valor | Description |
|---|---|
| Spot |
As VMs de prioridade spot serão usadas. Não há SLA para nós spot. Consulte local no do AKS para obter mais informações. |
| Regular |
VMs regulares serão usadas. |
ServiceMeshMode
Modo da malha de serviço.
| Valor | Description |
|---|---|
| Istio |
O Istio foi implantado como um complemento do AKS. |
| Disabled |
A malha está desativada. |
ServiceMeshProfile
Perfil de malha de serviço para um cluster gerenciado.
| Nome | Tipo | Description |
|---|---|---|
| istio |
Configuração da malha de serviço istio. |
|
| mode |
Modo da malha de serviço. |
SysctlConfig
Configurações de sysctl para nós de agente do Linux.
| Nome | Tipo | Description |
|---|---|---|
| fsAioMaxNr |
integer (int32) |
Configuração sysctl fs.aio-max-nr. |
| fsFileMax |
integer (int32) |
Configuração Sysctl fs.file-max. |
| fsInotifyMaxUserWatches |
integer (int32) |
Configuração Sysctl fs.inotify.max_user_watches. |
| fsNrOpen |
integer (int32) |
Configuração Sysctl fs.nr_open. |
| kernelThreadsMax |
integer (int32) |
Configuração Sysctl kernel.threads-max. |
| netCoreNetdevMaxBacklog |
integer (int32) |
Configuração de sysctl net.core.netdev_max_backlog. |
| netCoreOptmemMax |
integer (int32) |
Configuração de sysctl net.core.optmem_max. |
| netCoreRmemDefault |
integer (int32) |
Configuração Sysctl net.core.rmem_default. |
| netCoreRmemMax |
integer (int32) |
Configuração de sysctl net.core.rmem_max. |
| netCoreSomaxconn |
integer (int32) |
Configuração Sysctl net.core.somaxconn. |
| netCoreWmemDefault |
integer (int32) |
Configuração de sysctl net.core.wmem_default. |
| netCoreWmemMax |
integer (int32) |
Configuração de sysctl net.core.wmem_max. |
| netIpv4IpLocalPortRange |
string |
Configuração de sysctl net.ipv4.ip_local_port_range. |
| netIpv4NeighDefaultGcThresh1 |
integer (int32) |
Configuração de sysctl net.ipv4.neigh.default.gc_thresh1. |
| netIpv4NeighDefaultGcThresh2 |
integer (int32) |
Configuração de sysctl net.ipv4.neigh.default.gc_thresh2. |
| netIpv4NeighDefaultGcThresh3 |
integer (int32) |
Configuração Sysctl net.ipv4.neigh.default.gc_thresh3. |
| netIpv4TcpFinTimeout |
integer (int32) |
Configuração de sysctl net.ipv4.tcp_fin_timeout. |
| netIpv4TcpKeepaliveProbes |
integer (int32) |
Configuração Sysctl net.ipv4.tcp_keepalive_probes. |
| netIpv4TcpKeepaliveTime |
integer (int32) |
Configuração Sysctl net.ipv4.tcp_keepalive_time. |
| netIpv4TcpMaxSynBacklog |
integer (int32) |
Configuração de sysctl net.ipv4.tcp_max_syn_backlog. |
| netIpv4TcpMaxTwBuckets |
integer (int32) |
Configuração de sysctl net.ipv4.tcp_max_tw_buckets. |
| netIpv4TcpTwReuse |
boolean |
Configuração de sysctl net.ipv4.tcp_tw_reuse. |
| netIpv4TcpkeepaliveIntvl |
integer (int32) minimum: 10maximum: 90 |
Configuração de sysctl net.ipv4.tcp_keepalive_intvl. |
| netNetfilterNfConntrackBuckets |
integer (int32) minimum: 65536maximum: 524288 |
Configuração de sysctl net.netfilter.nf_conntrack_buckets. |
| netNetfilterNfConntrackMax |
integer (int32) minimum: 131072maximum: 2097152 |
Configuração Sysctl net.netfilter.nf_conntrack_max. |
| vmMaxMapCount |
integer (int32) |
Configuração Sysctl vm.max_map_count. |
| vmSwappiness |
integer (int32) |
Configuração sysctl vm.swappiness. |
| vmVfsCachePressure |
integer (int32) |
Configuração de sysctl vm.vfs_cache_pressure. |
systemData
Metadados relativos à criação e última modificação do recurso.
| Nome | Tipo | Description |
|---|---|---|
| createdAt |
string (date-time) |
O carimbo de data/hora da criação de recursos (UTC). |
| createdBy |
string |
A identidade que criou o recurso. |
| createdByType |
O tipo de identidade que criou o recurso. |
|
| lastModifiedAt |
string (date-time) |
O carimbo de data/hora da última modificação do recurso (UTC) |
| lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
| lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |
TransitEncryptionType
Configura a criptografia de pod para pod. Isso só pode ser habilitado em clusters baseados em Cilium. Se não for especificado, o valor padrão será None.
| Valor | Description |
|---|---|
| WireGuard |
Ative a criptografia WireGuard. Consulte https://docs.cilium.io/en/latest/security/network/encryption-wireguard/ os casos de uso e os detalhes de implementação |
| None |
Desativar criptografia de trânsito |
UndrainableNodeBehavior
Define o comportamento de nós não indisplicáveis durante a atualização. A causa mais comum de nós não indesaciáveis são PDBs (Orçamentos de Interrupção de Pod), mas outros problemas, como o período de carência de término do pod, excedem o tempo limite de drenagem por nó restante ou o pod ainda está em um estado de execução, também pode causar nós não indesaciáveis.
| Valor | Description |
|---|---|
| Cordon |
O AKS isolará os nós bloqueados e os substituirá por nós de pico durante a atualização. Os nós bloqueados serão isolados e substituídos por nós de surto. Os nós bloqueados terão o rótulo 'kubernetes.azure.com/upgrade-status:Quarantined'. Um nó de surto será mantido para cada nó bloqueado. Será feita uma tentativa de melhor esforço para excluir todos os outros nós de aumento. Se houver nós de pico suficientes para substituir nós bloqueados, a operação de atualização e o cluster gerenciado estarão em estado de falha. Caso contrário, a operação de atualização e o cluster gerenciado estarão em estado cancelado. |
| Schedule |
O AKS marcará os nós bloqueados como agendáveis, mas os nós bloqueados não serão atualizados. Uma tentativa de melhor esforço será feita para excluir todos os nós de aumento. A operação de atualização e o cluster gerenciado estarão em estado de falha se houver nós bloqueados. |
UpgradeChannel
O canal de atualização para atualização automática. O padrão é 'none'. Para mais informações, veja setting do canal de atualização automática do cluster AKS.
| Valor | Description |
|---|---|
| rapid |
Atualize automaticamente o cluster para a versão de patch mais recente com suporte na versão secundária mais recente com suporte. Nos casos em que o cluster está em uma versão do Kubernetes que está em uma versão secundária N-2 em que N é a versão secundária com suporte mais recente, o cluster primeiro atualiza para a versão de patch mais recente com suporte na versão secundária N-1. Por exemplo, se um cluster estiver executando a versão 1.17.7 e as versões 1.17.9, 1.18.4, 1.18.6 e 1.19.1 estiverem disponíveis, seu cluster primeiro será atualizado para 1.18.6 e, em seguida, será atualizado para 1.19.1. |
| stable |
Atualize automaticamente o cluster para a versão de patch mais recente com suporte na versão secundária N-1, em que N é a versão secundária mais recente com suporte. Por exemplo, se um cluster estiver executando a versão 1.17.7 e as versões 1.17.9, 1.18.4, 1.18.6 e 1.19.1 estiverem disponíveis, seu cluster será atualizado para 1.18.6. |
| patch |
Atualize automaticamente o cluster para a versão de patch mais recente com suporte quando ela estiver disponível, mantendo a mesma versão secundária. Por exemplo, se um cluster estiver executando a versão 1.17.7 e as versões 1.17.9, 1.18.4, 1.18.6 e 1.19.1 estiverem disponíveis, seu cluster será atualizado para 1.17.9. |
| node-image |
Atualize automaticamente a imagem do nó para a versão mais recente disponível. Considere usar nodeOSUpgradeChannel, pois isso permite que você configure a aplicação de patches do sistema operacional do nó separada da aplicação de patches de versão do Kubernetes |
| none |
Desabilita as atualizações automáticas e mantém o cluster em sua versão atual do Kubernetes. |
UpgradeOverrideSettings
Configurações para substituições ao atualizar um cluster.
| Nome | Tipo | Description |
|---|---|---|
| forceUpgrade |
boolean |
Se deve forçar a atualização do cluster. Observe que essa opção instrui a operação de atualização a ignorar proteções de atualização, como verificar o uso preterido da API. Habilite essa opção apenas com cuidado. |
| until |
string (date-time) |
Até quando as substituições forem efetivas. Observe que isso corresponde apenas à hora de início de uma atualização, e a eficácia não será alterada quando uma atualização for iniciada mesmo se a atualização expirar à medida que a |
UserAssignedIdentity
Detalhes sobre uma identidade atribuída pelo usuário.
| Nome | Tipo | Description |
|---|---|---|
| clientId |
string |
A ID do cliente da identidade atribuída pelo usuário. |
| objectId |
string |
A ID do objeto da identidade atribuída pelo usuário. |
| resourceId |
string (arm-id) |
A ID do recurso da identidade atribuída pelo usuário. |
VirtualMachineNodes
Status atual em um grupo de nós do mesmo tamanho de vm.
| Nome | Tipo | Description |
|---|---|---|
| count |
integer (int32) |
Número de nós. |
| size |
string |
O tamanho da VM dos agentes usados para hospedar esse grupo de nós. |
VirtualMachinesProfile
Especificações no pool de agentes do VirtualMachines.
| Nome | Tipo | Description |
|---|---|---|
| scale |
Especificações sobre como dimensionar um pool de agentes VirtualMachines. |
WindowsGmsaProfile
Perfil gMSA do Windows no cluster gerenciado.
| Nome | Tipo | Description |
|---|---|---|
| dnsServer |
string |
Especifica o servidor DNS para Windows gMSA. |
| enabled |
boolean |
Se deseja habilitar o Windows gMSA. Especifica se o Windows gMSA deve ser habilitado no cluster gerenciado. |
| rootDomainName |
string |
Especifica o nome de domínio raiz do Windows gMSA. |
WorkloadRuntime
Determina o tipo de carga de trabalho que um nó pode executar.
| Valor | Description |
|---|---|
| OCIContainer |
Os nós usarão o Kubelet para executar cargas de trabalho de contêiner OCI padrão. |
| WasmWasi |
Os nós usarão Krustlet para executar cargas de trabalho WASM usando o provedor WASI (versão prévia). |
| KataVmIsolation |
Os nós podem usar (Kata + Hipervisor de Nuvem + Hyper-V) para habilitar pods baseados em VM aninhada. Devido ao uso do Hyper-V, o sistema operacional do nó AKS em si é uma VM aninhada (o so raiz) do Hyper-V. Portanto, ele só pode ser usado com séries de VM que dão suporte à Virtualização Aninhada, como a série Dv3. |