Machines - Create Or Update

Serviço:

AKS

Versão da API:

2026-01-02-preview

Cria ou atualiza um computador no pool de agentes especificado.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	O nome do pool de agentes.
machineName	path	True	string pattern: ^[a-z][a-z0-9]{0,11}$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,39}$	Nome do host da máquina.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
resourceName	path	True	string minLength: 1 maxLength: 63 pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$	O nome do recurso de cluster gerenciado.
subscriptionId	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	Tipo	Description
properties	MachineProperties	As propriedades do computador

Respostas

Nome	Tipo	Description
200 OK	Machine	Operação de atualização do recurso 'Máquina' bem-sucedida
201 Created	Machine	Recurso 'Máquina' criar operação bem-sucedida Cabeçalhos Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	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/Update Machine

Solicitação de exemplo

HTTP

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

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

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.containerservice import ContainerServiceClient

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

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


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

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


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

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

Go

package armcontainerservice_test

import (
	"context"
	"log"

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

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

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

Resposta de exemplo

Código de status:

200

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

Código de status:

201

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

Definições

Nome	Description
AgentPoolArtifactStreamingProfile	Perfil de streaming de artefatos para o pool de agentes.
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
AgentPoolSSHAccess	Método de acesso SSH de um pool de agentes.
AgentPoolWindowsProfile	O perfil específico do pool de agentes do Windows.
createdByType	O tipo de identidade que criou o recurso.
DriftAction	A ação de deriva da máquina. Indica se uma máquina se desviou de seu estado esperado devido a alterações nas propriedades do cluster gerenciado, exigindo ação corretiva.
DriverType	Especifique o tipo de driver de GPU a ser instalado ao criar pools de agentes do Windows. Se não for fornecido, o AKS selecionará o driver com base na compatibilidade do sistema. Isso não pode ser alterado após a criação do AgentPool. Isso não pode ser definido em AgentPools do Linux. Para o Linux AgentPools, o driver é selecionado com base na compatibilidade do sistema.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
GPUDriver	Se os drivers de GPU devem ser instalados. Quando não for especificado, o padrão é Instalar.
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.
IPFamily	Para determinar se o endereço pertence à família IPv4 ou IPv6
IPTag	Contém a IPTag associada ao objeto.
KubeletConfig	Configurações do Kubelet de nós de agente. Consulte de configuração de nó personalizado do AKS para obter mais detalhes.
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	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.
LocalDNSForwardDestination	Servidor de destino para consultas DNS a serem encaminhadas do localDNS.
LocalDNSForwardPolicy	Política de encaminhamento para selecionar o servidor DNS upstream. Consulte o plug-in de encaminhamento para obter mais informações.
LocalDNSMode	Modo de ativação para localDNS.
LocalDNSOverride	Substituições para o perfil localDNS.
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.
LocalDNSProtocol	Imponha o TCP ou prefira o protocolo UDP para conexões do localDNS ao servidor DNS upstream.
LocalDNSQueryLogging	Nível de log para consultas DNS no localDNS.
LocalDNSServeStale	Política para veiculação de dados obsoletos. Consulte o plug-in de cache para obter mais informações.
LocalDNSState	Estado gerado pelo sistema de localDNS.
Machine	Uma máquina. Contém detalhes sobre a máquina virtual subjacente. Um computador pode estar visível aqui, mas não em nós de obtenção de kubectl; se assim for, pode ser porque o computador ainda não foi registrado com o Servidor de API do Kubernetes.
MachineBillingProfile	As propriedades têm a ver com faturamento de máquinas.
MachineHardwareProfile	As configurações de hardware e GPU da máquina.
MachineIpAddress	Os detalhes do endereço IP do computador.
MachineKubernetesProfile	As configurações do Kubernetes usadas pela máquina.
MachineNetworkProperties	propriedades de rede do computador
MachineOSProfile	O sistema operacional e o disco usados pela máquina.
MachineOSProfileLinuxProfile	O perfil específico da máquina Linux.
MachineProperties	As propriedades do computador
MachineSecurityProfile	As configurações de segurança da máquina.
MachineStatus	Contém informações somente leitura sobre a máquina.
ManagementMode	A experiência de GPU Gerenciada instala componentes adicionais, como as métricas de Data Center GPU Manager (DCGM) para monitoramento, além do driver da GPU para você. Para mais detalhes sobre o que está instalado, confira aka.ms/aks/managed-gpu.
MigStrategy	Define a estratégia MIG (GPU Multi-Instância) que será usada para suporte gerenciado a MIG. Para mais informações sobre as diferentes estratégias, visite aka.ms/aks/managed-gpu. Quando não especificado, o padrão é Nenhum.
NvidiaGPUProfile	Configurações específicas da GPU NVIDIA
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	O tipo de sistema operacional. O padrão é Linux.
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 c0
ScaleSetPriority	A prioridade do Conjunto de Dimensionamento de Máquinas Virtuais.
SeccompDefault	Especifica o perfil de seccomp padrão aplicado a todas as cargas de trabalho. Se não for especificado, 'Unconfined' será usado por padrão.
SysctlConfig	Configurações de sysctl para nós de agente do Linux.
systemData	Metadados relativos à criação e última modificação do recurso.
VmState	Estado da máquina virtual. Indica o estado atual da máquina virtual subjacente.
WorkloadRuntime	Determina o tipo de carga de trabalho que um nó pode executar.

AgentPoolArtifactStreamingProfile

Objeto

Perfil de streaming de artefatos para o pool de agentes.

Nome	Tipo	Description
enabled	boolean	O streaming de artefato acelera o início frio de contêineres em um nó por meio do carregamento de imagem sob demanda. Para usar esse recurso, as imagens de contêiner também devem habilitar o streaming de artefatos no ACR. Se não for especificado, o padrão será false.

AgentPoolMode

Enumeração

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.
ManagedSystem	ManagedSystem é um pool de sistemas gerenciado pelo AKS. O pool é dimensionado dinamicamente de acordo com o uso do cluster e tem recursos adicionais de monitoramento e recuperação automatizados. Só pode haver um pool ManagedSystem e é recomendável excluir todos os outros pools do sistema para obter a melhor experiência.
Machines	Os pools de agentes de computadores são dedicados a hospedar computadores. Somente operações limitadas, como criação e exclusão, são permitidas no nível do pool. Use as APIs da máquina para gerenciar todo o ciclo de vida da máquina.

AgentPoolSSHAccess

Enumeração

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ó.
EntraId	SSH para nó com integração EntraId. Mais informações podem ser encontradas em https://aka.ms/aks/ssh/aad

AgentPoolWindowsProfile

Objeto

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.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DriftAction

Enumeração

A ação de deriva da máquina. Indica se uma máquina se desviou de seu estado esperado devido a alterações nas propriedades do cluster gerenciado, exigindo ação corretiva.

Valor	Description
Synced	A máquina está atualizada.
Recreate	A máquina se desviou e precisa ser excluída e recriada.

DriverType

Enumeração

Especifique o tipo de driver de GPU a ser instalado ao criar pools de agentes do Windows. Se não for fornecido, o AKS selecionará o driver com base na compatibilidade do sistema. Isso não pode ser alterado após a criação do AgentPool. Isso não pode ser definido em AgentPools do Linux. Para o Linux AgentPools, o driver é selecionado com base na compatibilidade do sistema.

Valor	Description
GRID	Instale o driver GRID para a GPU, adequado para aplicativos que exigem suporte à virtualização.
CUDA	Instale o driver CUDA para a GPU, otimizado para tarefas computacionais em computação científica e aplicativos com uso intensivo de dados.

ErrorAdditionalInfo

Objeto

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

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

GPUDriver

Enumeração

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

Enumeração

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

Objeto

Configurações de GPU para o Pool de Agentes.

Nome	Tipo	Description
driver	GPUDriver	Se os drivers de GPU devem ser instalados. Quando não for especificado, o padrão é Instalar.
driverType	DriverType	Especifique o tipo de driver de GPU a ser instalado ao criar pools de agentes do Windows. Se não for fornecido, o AKS selecionará o driver com base na compatibilidade do sistema. Isso não pode ser alterado após a criação do AgentPool. Isso não pode ser definido em AgentPools do Linux. Para o Linux AgentPools, o driver é selecionado com base na compatibilidade do sistema.
nvidia	NvidiaGPUProfile	Configurações específicas da GPU NVIDIA.

IPFamily

Enumeração

Para determinar se o endereço pertence à família IPv4 ou IPv6

Valor	Description
IPv4	Família IPv4
IPv6	Família IPv6

IPTag

Objeto

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.

KubeletConfig

Objeto

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.
seccompDefault	SeccompDefault	Especifica o perfil de seccomp padrão aplicado a todas as cargas de trabalho. Se não for especificado, 'Unconfined' será usado por padrão.
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

Enumeração

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.

LinuxOSConfig

Objeto

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

LocalDNSForwardDestination

Enumeração

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

Enumeração

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

Enumeração

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

Objeto

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	LocalDNSForwardDestination	ClusterCoreDNS	Servidor de destino para consultas DNS a serem encaminhadas do localDNS.
forwardPolicy	LocalDNSForwardPolicy	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	LocalDNSProtocol	PreferUDP	Imponha o TCP ou prefira o protocolo UDP para conexões do localDNS ao servidor DNS upstream.
queryLogging	LocalDNSQueryLogging	Error	Nível de log para consultas DNS no localDNS.
serveStale	LocalDNSServeStale	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

Objeto

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,  LocalDNSOverride>		As substituições do KubeDNS se aplicam ao tráfego DNS de pods com dnsPolicy:ClusterFirst (conhecido como tráfego KubeDNS).
mode	LocalDNSMode	Preferred	Modo de ativação para localDNS.
state	LocalDNSState		Estado gerado pelo sistema de localDNS.
vnetDNSOverrides	<string,  LocalDNSOverride>		As substituições de VnetDNS se aplicam ao tráfego DNS de pods com dnsPolicy:default ou kubelet (conhecido como tráfego VnetDNS).

LocalDNSProtocol

Enumeração

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

Enumeração

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

Enumeração

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

Enumeração

Estado gerado pelo sistema de localDNS.

Valor	Description
Enabled	localDNS está habilitado.
Disabled	localDNS está desabilitado.

Machine

Objeto

Uma máquina. Contém detalhes sobre a máquina virtual subjacente. Um computador pode estar visível aqui, mas não em nós de obtenção de kubectl; se assim for, pode ser porque o computador ainda não foi registrado com o Servidor de API do Kubernetes.

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties	MachineProperties	As propriedades do computador
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"
zones	string[]	A zona de disponibilidade na qual a máquina está localizada.

MachineBillingProfile

Objeto

As propriedades têm a ver com faturamento de máquinas.

Nome	Tipo	Valor padrão	Description
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. Para mais detalhes sobre preços à vista, veja VMs c0

MachineHardwareProfile

Objeto

As configurações de hardware e GPU da máquina.

Nome	Tipo	Description
gpuInstanceProfile	GPUInstanceProfile	GPUInstanceProfile a ser usado para especificar o perfil de instância de GPU MIG para SKU de VM de GPU com suporte.
gpuProfile	GPUProfile	As configurações de GPU da máquina.
ultraSsdEnabled	boolean	Se deseja habilitar o UltraSSD
vmSize	string	O tamanho da VM. 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

MachineIpAddress

Objeto

Os detalhes do endereço IP do computador.

Nome	Tipo	Description
family	IPFamily	Para determinar se o endereço pertence à família IPv4 ou IPv6
ip	string	Endereço IPv4 ou IPv6 da máquina

MachineKubernetesProfile

Objeto

As configurações do Kubernetes usadas pela máquina.

Nome	Tipo	Description
artifactStreamingProfile	AgentPoolArtifactStreamingProfile	Configuração para usar o streaming de artefatos no AKS.
currentOrchestratorVersion	string	A versão do Kubernetes em execução na máquina. 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 completa <de major.minor.patch> que está sendo usada.
kubeletConfig	KubeletConfig	A configuração do Kubelet na máquina.
kubeletDiskType	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.
maxPods	integer (int32)	O número máximo de pods que podem ser executados em um nó.
nodeInitializationTaints	string[]	Taints adicionados ao nó durante a criação que não serão reconciliados pelo AKS. Esses taints não serão reconciliados pelo AKS e podem ser removidos com uma chamada kubectl. Esses taints permitem que a configuração necessária seja executada antes que o nó esteja pronto para aceitar cargas de trabalho, por exemplo, 'key1=value1:NoSchedule' que, em seguida, pode ser removido com kubectl taint nodes node1 key1=value1:NoSchedule-
nodeLabels	object	Os rótulos do nó na máquina.
nodeName	string	O nome do nó no cluster do Kubernetes.
nodeTaints	string[]	Os taints adicionados ao novo nó durante a criação da máquina. Por exemplo, key=value:NoSchedule.
orchestratorVersion	string	A versão do Kubernetes especificada pelo usuário. Há suporte para a versão <do patch major.minor.patch> e <major.minor> . Quando <major.minor> é especificado, a versão mais recente do patch com suporte é escolhida automaticamente.
workloadRuntime	WorkloadRuntime	Determina o tipo de carga de trabalho que um nó pode executar.

MachineNetworkProperties

Objeto

propriedades de rede do computador

Nome	Tipo	Description
enableNodePublicIP	boolean	Se o computador recebe seu próprio IP público. Alguns cenários podem exigir que a máquina receba 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. O valor padrão é falso.
ipAddresses	MachineIpAddress[]	IPv4, endereços IPv6 da máquina
nodePublicIPPrefixID	string (arm-id)	A ID do prefixo IP público do qual o nó da VM deve usar IPs. Isso é do formulário: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
nodePublicIPTags	IPTag[]	IPTags de IPs públicos no nível da instância.
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}
vnetSubnetID	string (arm-id)	O ID da sub-rede em qual nó 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}

MachineOSProfile

Objeto

O sistema operacional e o disco usados pela máquina.

Nome	Tipo	Valor padrão	Description
enableFIPS	boolean		Se deve usar um sistema operacional habilitado para FIPS.
linuxProfile	MachineOSProfileLinuxProfile		O perfil específico da máquina Linux.
osDiskSizeGB	integer (int32) minimum: 0 maximum: 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	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	OSSKU		Especifica o SKU do sistema operacional usado pelo pool de agentes. Se não for especificado, o padrão será Ubuntu se OSType=Linux ou Windows2019 se OSType=Windows. E o OSSKU do Windows padrão será alterado para Windows2022 depois que o Windows2019 for preterido.
osType	OSType	Linux	O tipo de sistema operacional. O padrão é Linux.
windowsProfile	AgentPoolWindowsProfile		O perfil específico do computador Windows.

MachineOSProfileLinuxProfile

Objeto

O perfil específico da máquina Linux.

Nome	Tipo	Description
linuxOSConfig	LinuxOSConfig	A configuração do sistema operacional da máquina Linux.
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).

MachineProperties

Objeto

As propriedades do computador

Nome	Tipo	Valor padrão	Description
billing	MachineBillingProfile		As propriedades têm a ver com faturamento de máquinas.
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.
evictionPolicy	ScaleSetEvictionPolicy	Delete	A política de despejo para máquina. Isso não pode ser especificado a menos que a prioridade seja 'Spot'. Se não for especificado, o padrão será 'Delete'.
hardware	MachineHardwareProfile		As configurações de hardware e GPU da máquina.
kubernetes	MachineKubernetesProfile		As configurações do Kubernetes usadas pela máquina.
localDNSProfile	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.
mode	AgentPoolMode		A máquina permite apenas o modo 'Sistema' e 'Usuário'.
network	MachineNetworkProperties		propriedades de rede do computador
nodeImageVersion	string		A versão da imagem do nó.
operatingSystem	MachineOSProfile		O sistema operacional e o disco usados pela máquina.
priority	ScaleSetPriority	Regular	A prioridade para a máquina. Se não for especificado, o padrão será 'Regular'.
provisioningState	string		O estado atual de implantação ou provisionamento.
resourceId	string (arm-id)		ID de recurso do Azure do computador. Ele pode ser usado para GET subjacente
security	MachineSecurityProfile		As configurações de segurança da máquina.
status	MachineStatus		Contém informações somente leitura sobre a máquina.
tags	object		As tags a serem persistidas na máquina.

MachineSecurityProfile

Objeto

As configurações de segurança da máquina.

Nome	Tipo	Description
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
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	AgentPoolSSHAccess	Método de acesso SSH de um pool de agentes.

MachineStatus

Objeto

Contém informações somente leitura sobre a máquina.

Nome	Tipo	Description
creationTimestamp	string (date-time)	Especifica a hora em que a máquina foi criada.
driftAction	DriftAction	A ação de deriva da máquina. Indica se uma máquina se desviou de seu estado esperado devido a alterações nas propriedades do cluster gerenciado, exigindo ação corretiva.
driftReason	string	Razão para o desvio da máquina. Fornece informações detalhadas sobre o motivo pelo qual a máquina se desviou. Este campo será omitido se a máquina estiver atualizada.
provisioningError	ErrorDetail	O erro detalha as informações da máquina. Preserva as informações detalhadas da falha. Se não houver erro, esse campo será omitido.
vmState	VmState	Estado da máquina virtual. Indica o estado atual da máquina virtual subjacente.

ManagementMode

Enumeração

A experiência de GPU Gerenciada instala componentes adicionais, como as métricas de Data Center GPU Manager (DCGM) para monitoramento, além do driver da GPU para você. Para mais detalhes sobre o que está instalado, confira aka.ms/aks/managed-gpu.

Valor	Description
Unmanaged	A experiência gerenciada da GPU está desativada para GPUs NVIDIA.
Managed	A experiência gerenciada da GPU está habilitada para GPUs NVIDIA.

MigStrategy

Enumeração

Define a estratégia MIG (GPU Multi-Instância) que será usada para suporte gerenciado a MIG. Para mais informações sobre as diferentes estratégias, visite aka.ms/aks/managed-gpu. Quando não especificado, o padrão é Nenhum.

Valor	Description
None	Não defina uma estratégia MIG. Se você já tinha um configurado, isso vai sobrepor e remover a estratégia MIG.
Single	Defina a estratégia do MIG para MIG gerenciado como simples.
Mixed	Defina a estratégia do MIG para MIG gerenciado como mista.

NvidiaGPUProfile

Objeto

Configurações específicas da GPU NVIDIA

Nome	Tipo	Description
managementMode	ManagementMode	A experiência de GPU Gerenciada instala componentes adicionais, como as métricas de Data Center GPU Manager (DCGM) para monitoramento, além do driver da GPU para você. Para mais detalhes sobre o que está instalado, confira aka.ms/aks/managed-gpu.
migStrategy	MigStrategy	Define a estratégia MIG (GPU Multi-Instância) que será usada para suporte gerenciado a MIG. Para mais informações sobre as diferentes estratégias, visite aka.ms/aks/managed-gpu. Quando não especificado, o padrão é Nenhum.

OSDiskType

Enumeração

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

Enumeração

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.
Mariner	OSSKU preterido. Em vez disso, a Microsoft recomenda que novas implantações escolham "AzureLinux".
Flatcar	Use o Flatcar Container Linux como o sistema operacional para imagens de nó. O Flatcar é um sistema operacional Linux otimizado para contêiner e focado em segurança, com um sistema de arquivos imutável e parte da Cloud Native Computing Foundation (CNCF). Para obter mais informações sobre o Flatcar Container Linux para AKS, consulte aka.ms/aks/flatcar-container-linux-for-aks
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
Windows2025	Use Windows2025 como o sistema operacional para imagens de nó. Sem suporte para pools de nós do sistema. O Windows2025 dá suporte a contêineres Windows2022 e Windows 2025; ele não pode executar contêineres do Windows2019 e vice-versa.
WindowsAnnual	Use a versão do Canal Anual do Windows como o sistema operacional para imagens de nó. Sem suporte para pools de nós do sistema. Detalhes sobre imagens de contêiner com suporte e versões do kubernetes em diferentes versões do Canal Anual do AKS podem ser vistos em https://aka.ms/aks/windows-annual-channel-details.
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

Enumeração

O tipo de sistema operacional. O padrão é Linux.

Valor	Description
Linux	Use Linux.
Windows	Use Windows.

ScaleSetEvictionPolicy

Enumeração

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 c0

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

Enumeração

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.

SeccompDefault

Enumeração

Especifica o perfil de seccomp padrão aplicado a todas as cargas de trabalho. Se não for especificado, 'Unconfined' será usado por padrão.

Valor	Description
Unconfined	Nenhum perfil seccomp é aplicado, permitindo todas as chamadas do sistema.
RuntimeDefault	O perfil seccomp padrão para o tempo de execução do contêiner é aplicado, o que restringe determinadas chamadas do sistema para segurança aprimorada.

SysctlConfig

Objeto

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: 10 maximum: 90	Configuração de sysctl net.ipv4.tcp_keepalive_intvl.
netNetfilterNfConntrackBuckets	integer (int32) minimum: 65536 maximum: 524288	Configuração de sysctl net.netfilter.nf_conntrack_buckets.
netNetfilterNfConntrackMax	integer (int32) minimum: 131072 maximum: 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

Objeto

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	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	createdByType	O tipo de identidade que modificou o recurso pela última vez.

VmState

Enumeração

Estado da máquina virtual. Indica o estado atual da máquina virtual subjacente.

Valor	Description
Running	A máquina virtual está em execução no momento.
Deleted	A máquina virtual foi excluída pelo usuário ou devido a remoção local.

WorkloadRuntime

Enumeração

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).
KataMshvVmIsolation	Nós podem usar (Kata + Cloud Hypervisor + Hyper-V) para habilitar pods aninhados baseados em VM (versão prévia). 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. Essa convenção de nomenclatura será preterida em versões futuras em favor de KataVmIsolation.
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.