Machines - Create Or Update

Служба:: AKS

Версия API:: 2026-01-02-preview

Создает или обновляет компьютер в указанном пуле агентов.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
agentPoolName	path	True	string minLength: 1 maxLength: 12 pattern: ^[a-z][a-z0-9]{0,11}$	Имя пула агентов.
machineName	path	True	string pattern: ^[a-z][a-z0-9]{0,11}$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,39}$	Имя хоста компьютера.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя регистронезависимо.
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]$	Имя ресурса управляемого кластера.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Заголовок запроса

Имя	Обязательно	Тип	Описание
if-match		string	Запрос должен продолжаться только в том случае, если сущность соответствует этой строке.
if-none-match		string	Запрос должен продолжаться только в том случае, если сущность не соответствует этой строке.

Текст запроса

Имя	Тип	Описание
properties	MachineProperties	Свойства компьютера

Ответы

Имя	Тип	Описание
200 OK	Machine	Операция обновления ресурса 'Machine' была успешна
201 Created	Machine	Операция создания ресурса 'Machine' успешно выполнена Заголовки Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Имя

Тип

Описание

200 OK

Machine

Операция обновления ресурса 'Machine' была успешна

201 Created

Machine

Операция создания ресурса 'Machine' успешно выполнена

Заголовки

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Create/Update Machine

Образец запроса

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

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.containerservice import ContainerServiceClient

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

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


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

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


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

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

package armcontainerservice_test

import (
	"context"
	"log"

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

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

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

Пример ответа

Код состояния:: 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"
  ]
}

Код состояния:: 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"
  ]
}

Определения

Имя	Описание
AgentPoolArtifactStreamingProfile	Профиль потока артефактов для пула агентов.
AgentPoolMode	Режим пула агентов. Кластер должен иметь по крайней мере один пул агентов System. Дополнительные сведения об ограничениях пула агентов и рекомендациях см. в статье https://docs.microsoft.com/azure/aks/use-system-pools
AgentPoolSSHAccess	Метод SSH access пула агентов.
AgentPoolWindowsProfile	Конкретный профиль пула агентов Windows.
createdByType	Тип удостоверения, создавшего ресурс.
DriftAction	Дрифт действия машины. Указывает, отклонился ли компьютер от ожидаемого состояния из-за изменений в свойствах управляемого кластера, требующих корректирующих действий.
DriverType	Укажите тип драйвера GPU для установки при создании пулов агентов Windows. Если это не указано, AKS выбирает драйвер на основе совместимости системы. Это невозможно изменить после создания AgentPool. Это не может быть установлено в Linux AgentPools. Для Linux AgentPools драйвер выбирается на основе совместимости системы.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
GPUDriver	Установка драйверов GPU. Если он не указан, по умолчанию используется установка.
GPUInstanceProfile	GPUInstanceProfile для указания профиля экземпляра GPU MIG для поддерживаемого номера SKU виртуальной машины GPU.
GPUProfile	Параметры GPU для пула агентов.
IPFamily	Определение принадлежности адреса к семейству IPv4 или IPv6
IPTag	Содержит IPTag, связанный с объектом.
KubeletConfig	Конфигурации Kubelet узлов агента. Дополнительные сведения см. в конфигурации пользовательского узла AKS.
KubeletDiskType	Определяет размещение пустых томов Dir, корня данных во время выполнения контейнера и эфемерного storage Kubelet.
LinuxOSConfig	Конфигурации ОС узлов агента Linux. Дополнительные сведения см. в конфигурации пользовательского узла AKS.
LocalDNSForwardDestination	Целевой сервер для DNS-запросов, которые будут перенаправляться из localDNS.
LocalDNSForwardPolicy	Политика переадресации для выбора вышестоящего DNS-сервера. Смотрите плагин forward для получения дополнительной информации.
LocalDNSMode	Режим включения для localDNS.
LocalDNSOverride	Переопределения для профиля localDNS.
LocalDNSProfile	Настраивает локальную DNS для каждого узла с переопределениями VnetDNS и KubeDNS. LocalDNS помогает повысить производительность и надежность разрешения DNS в кластере AKS. Подробнее см. aka.ms/aks/localdns.
LocalDNSProtocol	Примените TCP или отдайте предпочтение протоколу UDP для соединений из localDNS к вышестоящему DNS-серверу.
LocalDNSQueryLogging	Уровень логирования для DNS-запросов в localDNS.
LocalDNSServeStale	Политика обслуживания устаревших данных. Смотрите плагин кэша для получения дополнительной информации.
LocalDNSState	Сгенерированное системой состояние localDNS.
Machine	Машина. Содержит сведения о базовой виртуальной машине. Компьютер может отображаться здесь, но не в kubectl get nodes; Если это может быть связано с тем, что компьютер еще не зарегистрирован в сервере API Kubernetes.
MachineBillingProfile	Имущество, связанное с машинным биллингом.
MachineHardwareProfile	Аппаратные и графические настройки машины.
MachineIpAddress	Сведения об IP-адресе компьютера.
MachineKubernetesProfile	Конфигурации Kubernetes, используемые компьютером.
MachineNetworkProperties	сетевые свойства компьютера
MachineOSProfile	Операционная система и диск, используемые машиной.
MachineOSProfileLinuxProfile	Специфический профиль компьютера с Linux.
MachineProperties	Свойства компьютера
MachineSecurityProfile	Настройки безопасности машины.
MachineStatus	Содержит информацию о машине только для чтения.
ManagementMode	Опыт управления GPU устанавливает дополнительные компоненты, такие как метрики менеджера GPU Центра (DCGM) для мониторинга, поверх драйвера GPU для вас. Для получения дополнительной информации о том, что устанавливается, смотрите aka.ms/aks/managed-gpu.
MigStrategy	Устанавливает стратегию MIG (Multi-Instance GPU), которая будет использоваться для поддержки управляемых MIG. Для получения дополнительной информации о различных стратегиях посетите aka.ms/aks/managed-gpu. Если указано не указано, по умолчанию — нет.
NvidiaGPUProfile	Настройки видеокарты, специфичные для NVIDIA,
OSDiskType	Тип диска ОС, используемый для компьютеров в пуле агентов. Значение по умолчанию — "Ephemeral", если виртуальная машина поддерживает ее и имеет диск кэша больше запрошенного OSDiskSizeGB. В противном случае значение по умолчанию — Managed. Может не быть изменено после создания. Для получения дополнительной информации см. Ephemeral OS.
OSSKU	Указывает номер SKU ОС, используемый пулом агентов. По умолчанию используется Ubuntu, если OSType — Linux. Значение по умолчанию — Windows2019, если Kubernetes = 1.24 или Windows2022, если Kubernetes <>= 1.25, если OSType — Windows.
OSType	Тип операционной системы. По умолчанию используется Linux.
ScaleSetEvictionPolicy	Политика вытеснения масштабируемого набора виртуальных машин. Политика выселения указывает, что to делать с виртуальной машиной при её выселении. Значение по умолчанию — Delete. Для получения дополнительной информации о выселении смотрите spot виртуальные машины
ScaleSetPriority	Приоритет масштабируемого набора виртуальных машин.
SeccompDefault	Указывает профиль seccomp по умолчанию, применяемый ко всем рабочим нагрузкам. Если значение не указано, параметр Unconfined будет использоваться по умолчанию.
SysctlConfig	Параметры sysctl для узлов агента Linux.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
VmState	Состояние виртуальной машины. Указывает текущее состояние базовой виртуальной машины.
WorkloadRuntime	Определяет тип рабочей нагрузки, который может выполнять узел.

AgentPoolArtifactStreamingProfile

Объект

Профиль потока артефактов для пула агентов.

Имя	Тип	Описание
enabled	boolean	Потоковая передача артефактов ускоряет холодный запуск контейнеров на узле с помощью загрузки образа по запросу. Чтобы использовать эту функцию, образы контейнеров также должны включать потоковую передачу артефактов в ACR. Если значение не указано, значение по умолчанию равно false.

AgentPoolMode

Перечисление

Режим пула агентов. Кластер должен иметь по крайней мере один пул агентов System. Дополнительные сведения об ограничениях пула агентов и рекомендациях см. в статье https://docs.microsoft.com/azure/aks/use-system-pools

Значение	Описание
System	Пулы системных агентов в основном предназначены для размещения критически важных системных модулей pod, таких как CoreDNS и metrics-server. Пулы системных агентов osType должны быть Linux. Номер SKU пулов агентов системы должен содержать не менее 2vCP и 4 ГБ памяти.
User	Пулы агентов пользователей в основном предназначены для размещения модулей pod приложений.
Gateway	Пулы агентов шлюза предназначены для предоставления статических исходящих IP-адресов модулям pod. Дополнительные сведения см. в статье https://aka.ms/aks/static-egress-gateway.
ManagedSystem	ManagedSystem — это системный пул, управляемый AKS. Пул динамически масштабируется в соответствии с использованием кластера и имеет дополнительные возможности автоматического мониторинга и восстановления. Пул ManagedSystem может быть только один, и для оптимальной работы рекомендуется удалить все остальные системные пулы.
Machines	Пулы агентов компьютеров выделяются для размещения компьютеров. На уровне пула разрешены только ограниченные операции, такие как создание и удаление. Пожалуйста, используйте API машины для управления полным жизненным циклом машины.

AgentPoolSSHAccess

Перечисление

Метод SSH access пула агентов.

Значение	Описание
LocalUser	Может подключаться по SSH к узлу как локальный пользователь с помощью закрытого ключа.
Disabled	Служба SSH будет отключена на узле.
EntraId	SSH на узел с интеграцией EntraId. Более подробную информацию можно найти в разделе https://aka.ms/aks/ssh/aad

AgentPoolWindowsProfile

Объект

Конкретный профиль пула агентов Windows.

Имя	Тип	Описание
disableOutboundNat	boolean	Следует ли отключать OutboundNAT в узлах Windows. По умолчанию используется значение false. Исходящий NAT можно отключить только в том случае, если исходящий тип кластера является шлюзом NAT, а пул агентов Windows не включает общедоступный IP-адрес узла.

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

DriftAction

Перечисление

Дрифт действия машины. Указывает, отклонился ли компьютер от ожидаемого состояния из-за изменений в свойствах управляемого кластера, требующих корректирующих действий.

Значение	Описание
Synced	Машина соответствует современным требованиям.
Recreate	Машина вышла из строя и ее необходимо удалить и создать заново.

DriverType

Перечисление

Укажите тип драйвера GPU для установки при создании пулов агентов Windows. Если это не указано, AKS выбирает драйвер на основе совместимости системы. Это невозможно изменить после создания AgentPool. Это не может быть установлено в Linux AgentPools. Для Linux AgentPools драйвер выбирается на основе совместимости системы.

Значение	Описание
GRID	Установите драйвер GRID для графического процессора, подходящий для приложений, требующих поддержки виртуализации.
CUDA	Установите драйвер CUDA для графического процессора, оптимизированный для вычислительных задач в научных вычислениях и приложениях, интенсивно использующих данные.

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Объект

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

GPUDriver

Перечисление

Установка драйверов GPU. Если он не указан, по умолчанию используется установка.

Значение	Описание
Install	Установите драйвер.
None	Пропустите установку драйвера.

GPUInstanceProfile

Перечисление

GPUInstanceProfile для указания профиля экземпляра GPU MIG для поддерживаемого номера SKU виртуальной машины GPU.

Значение	Описание
MIG1g	Профиль экземпляра видеокарты MIG 1G.
MIG2g	Профиль экземпляра видеокарты MIG 2G.
MIG3g	Профиль экземпляра видеокарты MIG 3G.
MIG4g	Профиль инстанции видеокарты MIG 4G.
MIG7g	Профиль экземпляра видеокарты MIG 7G.

GPUProfile

Объект

Параметры GPU для пула агентов.

Имя	Тип	Описание
driver	GPUDriver	Установка драйверов GPU. Если он не указан, по умолчанию используется установка.
driverType	DriverType	Укажите тип драйвера GPU для установки при создании пулов агентов Windows. Если это не указано, AKS выбирает драйвер на основе совместимости системы. Это невозможно изменить после создания AgentPool. Это не может быть установлено в Linux AgentPools. Для Linux AgentPools драйвер выбирается на основе совместимости системы.
nvidia	NvidiaGPUProfile	Настройки видеокарты, специфичные для NVIDIA.

IPFamily

Перечисление

Определение принадлежности адреса к семейству IPv4 или IPv6

Значение	Описание
IPv4	Семейство IPv4
IPv6	Семейство IPv6

IPTag

Объект

Содержит IPTag, связанный с объектом.

Имя	Тип	Описание
ipTagType	string	Тип тега IP. Пример: RoutingPreference.
tag	string	Значение тега IP, связанного с общедоступным IP-адресом. Пример: Интернет.

KubeletConfig

Объект

Конфигурации Kubelet узлов агента. Дополнительные сведения см. в конфигурации пользовательского узла AKS.

Имя	Тип	Описание
allowedUnsafeSysctls	string[]	Разрешенный список небезопасных системных шаблонов или небезопасных шаблонов sysctl (заканчивается на `*`).
containerLogMaxFiles	integer (int32) minimum: 2	Максимальное количество файлов журнала контейнера, которое может присутствовать для контейнера. Число должно быть ≥ 2.
containerLogMaxSizeMB	integer (int32)	Максимальный размер (например, 10Mi) файла журнала контейнера перед его поворотом.
cpuCfsQuota	boolean	Если принудительное применение квот ЦП CFS включено для контейнеров, указывающих ограничения ЦП. Значение по умолчанию: true.
cpuCfsQuotaPeriod	string	Значение квоты ЦП CFS. Значение по умолчанию — "100 мс". Допустимые значения — это последовательность десятичных чисел с необязательной дроби и суффиксом единицы. Например: "300 мс", "2h45m". Поддерживаемые единицы: "ns", "us", "ms", "s", "m" и "h".
cpuManagerPolicy	string	Политика диспетчера ЦП, используемая. Значение по умолчанию — none. Дополнительные сведения см. в политиках управления ЦП Kubernetes . Допустимые значения : none и static.
failSwapOn	boolean	Если задано значение true, это приведет к сбою запуска Kubelet, если переключение включено на узле.
imageGcHighThreshold	integer (int32)	Процент использования дискового пространства, после достижения которого всегда выполняется очистка ненужных данных образов. Для отключения автоматического удаления изображений установите 100. Значение по умолчанию — 85%
imageGcLowThreshold	integer (int32)	Процент дискового пространства, до достижения которого сборка ненужных образов никогда не выполняется. Это не может быть задано выше, чем imageGcHighThreshold. Значение по умолчанию — 80%
podMaxPids	integer (int32)	Максимальное количество процессов на модуль pod.
seccompDefault	SeccompDefault	Указывает профиль seccomp по умолчанию, применяемый ко всем рабочим нагрузкам. Если значение не указано, параметр Unconfined будет использоваться по умолчанию.
topologyManagerPolicy	string	Политика диспетчера топологий, используемая. Дополнительные сведения см. в диспетчере топологий Kubernetes. Значение по умолчанию — none. Допустимые значения : none, best-effort, "restricted" и "single-numa-node".

KubeletDiskType

Перечисление

Определяет размещение пустых томов Dir, корня данных во время выполнения контейнера и эфемерного storage Kubelet.

Значение	Описание
OS	Kubelet будет использовать диск ОС для своих данных.
Temporary	Kubelet будет использовать временный диск для своих данных.

LinuxOSConfig

Объект

Конфигурации ОС узлов агента Linux. Дополнительные сведения см. в конфигурации пользовательского узла AKS.

Имя	Тип	Описание
swapFileSizeMB	integer (int32)	Размер файла буфера в МБ, который будет создан на каждом узле.
sysctls	SysctlConfig	Параметры sysctl для узлов агента Linux.
transparentHugePageDefrag	string	Следует ли ядро использовать агрессивное использование сжатия памяти для повышения доступности огромных страниц. Допустимые значения: "always", "defer", "defer+madvise", "madvise" и "никогда". Значение по умолчанию — madvise. Дополнительные сведения см. в прозрачных огромных.
transparentHugePageEnabled	string	Включены ли прозрачные огромные страницы. Допустимые значения: "always", "madvise" и "никогда". Значение по умолчанию — always. Дополнительные сведения см. в прозрачных огромных.

LocalDNSForwardDestination

Перечисление

Целевой сервер для DNS-запросов, которые будут перенаправляться из localDNS.

Значение	Описание
ClusterCoreDNS	Перенаправляйте DNS-запросы из localDNS в кластер CoreDNS.
VnetDNS	Переадресация DNS-запросов из localDNS на DNS-сервер, настроенный в виртуальной сети. В виртуальной сети может быть настроено несколько DNS-серверов.

LocalDNSForwardPolicy

Перечисление

Политика переадресации для выбора вышестоящего DNS-сервера. Смотрите плагин forward для получения дополнительной информации.

Значение	Описание
Sequential	Реализует последовательный выбор вышестоящего DNS-сервера. Смотрите плагин forward для получения дополнительной информации.
RoundRobin	Реализует циклический отбор вышестоящего DNS-сервера. Смотрите плагин forward для получения дополнительной информации.
Random	Реализует случайный выбор вышестоящего DNS-сервера. Смотрите плагин forward для получения дополнительной информации.

LocalDNSMode

Перечисление

Режим включения для localDNS.

Значение	Описание
Preferred	Если текущая версия оркестратора поддерживает эту функцию, лучше включить localDNS.
Required	Включите localDNS.
Disabled	Отключите localDNS.

LocalDNSOverride

Объект

Переопределения для профиля localDNS.

Имя	Тип	Default value	Описание
cacheDurationInSeconds	integer (int32)	3600	Кэш максимального TTL в секундах. Смотрите плагин кэша для получения дополнительной информации.
forwardDestination	LocalDNSForwardDestination	ClusterCoreDNS	Целевой сервер для DNS-запросов, которые будут перенаправляться из localDNS.
forwardPolicy	LocalDNSForwardPolicy	Sequential	Политика переадресации для выбора вышестоящего DNS-сервера. Смотрите плагин forward для получения дополнительной информации.
maxConcurrent	integer (int32)	1000	Максимальное количество одновременных запросов. Смотрите плагин forward для получения дополнительной информации.
protocol	LocalDNSProtocol	PreferUDP	Примените TCP или отдайте предпочтение протоколу UDP для соединений из localDNS к вышестоящему DNS-серверу.
queryLogging	LocalDNSQueryLogging	Error	Уровень логирования для DNS-запросов в localDNS.
serveStale	LocalDNSServeStale	Immediate	Политика обслуживания устаревших данных. Смотрите плагин кэша для получения дополнительной информации.
serveStaleDurationInSeconds	integer (int32)	3600	Срок подачи за слежалость в секундах. Смотрите плагин кэша для получения дополнительной информации.

LocalDNSProfile

Объект

Настраивает локальную DNS для каждого узла с переопределениями VnetDNS и KubeDNS. LocalDNS помогает повысить производительность и надежность разрешения DNS в кластере AKS. Подробнее см. aka.ms/aks/localdns.

Имя	Тип	Default value	Описание
kubeDNSOverrides	<string, LocalDNSOverride>		Переопределения KubeDNS применяются к DNS-трафику из подов с dnsPolicy:ClusterFirst (так называемый трафик KubeDNS).
mode	LocalDNSMode	Preferred	Режим включения для localDNS.
state	LocalDNSState		Сгенерированное системой состояние localDNS.
vnetDNSOverrides	<string, LocalDNSOverride>		Переопределения VnetDNS применяются к DNS-трафику из подов с dnsPolicy:default или kubelet (называемый трафиком VnetDNS).

LocalDNSProtocol

Перечисление

Примените TCP или отдайте предпочтение протоколу UDP для соединений из localDNS к вышестоящему DNS-серверу.

Значение	Описание
PreferUDP	Отдайте предпочтение протоколу UDP для соединений из localDNS к вышестоящему DNS-серверу.
ForceTCP	Принудительное применение протокола TCP для соединений из localDNS к вышестоящему DNS-серверу.

LocalDNSQueryLogging

Перечисление

Уровень логирования для DNS-запросов в localDNS.

Значение	Описание
Error	Включает ведение журнала ошибок в localDNS. Смотрите плагин ошибок для получения дополнительной информации.
Log	Включает ведение журнала запросов в localDNS. Смотрите плагин логов для получения дополнительной информации.

LocalDNSServeStale

Перечисление

Политика обслуживания устаревших данных. Смотрите плагин кэша для получения дополнительной информации.

Значение	Описание
Verify	Выдавайте устаревшие данные с проверкой. Сначала убедитесь, что запись по-прежнему недоступна из источника, прежде чем отправлять запись с истекшим сроком действия клиенту. Смотрите плагин кэша для получения дополнительной информации.
Immediate	Немедленное обслуживание устаревших данных. Отправьте запись с истекшим сроком действия клиенту, прежде чем проверять, доступна ли запись из источника. Смотрите плагин кэша для получения дополнительной информации.
Disable	Отключите показ устаревших данных.

LocalDNSState

Перечисление

Сгенерированное системой состояние localDNS.

Значение	Описание
Enabled	localDNS включен.
Disabled	localDNS отключен.

Machine

Объект

Машина. Содержит сведения о базовой виртуальной машине. Компьютер может отображаться здесь, но не в kubectl get nodes; Если это может быть связано с тем, что компьютер еще не зарегистрирован в сервере API Kubernetes.

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Имя ресурса
properties	MachineProperties	Свойства компьютера
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"
zones	string[]	Зона доступности, в которой находится машина.

MachineBillingProfile

Объект

Имущество, связанное с машинным биллингом.

Имя	Тип	Default value	Описание
spotMaxPrice	number (float)	-1	Максимальная цена (в долларах США) вы готовы платить за точечные экземпляры. Возможные значения — это любое десятичное значение больше нуля или -1, указывающее, что цена по умолчанию up-to по запросу. Для получения дополнительной информации о спотовом ценообразовании см. spot цены на виртуальные машины

MachineHardwareProfile

Объект

Аппаратные и графические настройки машины.

Имя	Тип	Описание
gpuInstanceProfile	GPUInstanceProfile	GPUInstanceProfile для указания профиля экземпляра GPU MIG для поддерживаемого номера SKU виртуальной машины GPU.
gpuProfile	GPUProfile	Настройки графического процессора компьютера.
ultraSsdEnabled	boolean	Включение UltraSSD
vmSize	string	Размер виртуальной машины. Доступность размера виртуальной машины зависит от региона. Если узел содержит недостаточные вычислительные ресурсы (память, ЦП и т. д.), модули pod могут не выполняться правильно. Дополнительные сведения об ограниченных размерах виртуальных машин см. в статье https://docs.microsoft.com/azure/aks/quotas-skus-regions

MachineIpAddress

Объект

Сведения об IP-адресе компьютера.

Имя	Тип	Описание
family	IPFamily	Определение принадлежности адреса к семейству IPv4 или IPv6
ip	string	IPv4 или IPv6 адрес машины

MachineKubernetesProfile

Объект

Конфигурации Kubernetes, используемые компьютером.

Имя	Тип	Описание
artifactStreamingProfile	AgentPoolArtifactStreamingProfile	Конфигурация для использования потоковой передачи артефактов в AKS.
currentOrchestratorVersion	string	Версия Kubernetes, запущенная на компьютере. Если orchestratorVersion была полностью указанной версией <major.minor.patch>, это поле будет точно равно ему. Если orchestratorVersion был <основным.minor, это поле будет содержать полную >версию major.minor.patch<>, используемую.
kubeletConfig	KubeletConfig	Конфигурация Kubelet на машине.
kubeletDiskType	KubeletDiskType	Определяет размещение пустых томов Dir, корня данных во время выполнения контейнера и эфемерного storage Kubelet.
maxPods	integer (int32)	Максимальное количество модулей pod, которые могут выполняться на узле.
nodeInitializationTaints	string[]	Во время создания на узел добавляются заразности, которые не будут согласованы AKS. Эти оттенки не будут согласованы AKS и могут быть удалены с помощью вызова kubectl. Эти фрагменты позволяют выполнять необходимую конфигурацию, прежде чем узел готов принять рабочие нагрузки, например key1=value1:NoSchedule, которые затем можно удалить с помощью `kubectl taint nodes node1 key1=value1:NoSchedule-`
nodeLabels	object	Метки узлов на аппарате.
nodeName	string	Имя узла в кластере Kubernetes.
nodeTaints	string[]	Отметки, добавленные в новый узел во время создания машины. Например, key=value:NoSchedule.
orchestratorVersion	string	Версия Kubernetes, указанная пользователем. Поддерживаются оба исправления версии <major.minor.patch> и <major.minor> . При <указании major.minor> последняя поддерживаемая версия исправления выбирается автоматически.
workloadRuntime	WorkloadRuntime	Определяет тип рабочей нагрузки, который может выполнять узел.

MachineNetworkProperties

Объект

сетевые свойства компьютера

Имя	Тип	Описание
enableNodePublicIP	boolean	Выделен ли машине собственный публичный IP. В некоторых сценариях может потребоваться получение компьютером собственных выделенных общедоступных IP-адресов. Типичный сценарий состоит в том, что для игровых задач консоль должна установить прямое подключение к облачной виртуальной машине для сокращения числа промежуточных узлов. Значение по умолчанию — false.
ipAddresses	MachineIpAddress[]	IPv4, IPv6 адреса машины
nodePublicIPPrefixID	string (arm-id)	Идентификатор префикса общедоступного IP-адреса, с которого узел виртуальной машины должен использовать IP-адреса. Это форма: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
nodePublicIPTags	IPTag[]	IPTags общедоступных IP-адресов уровня экземпляра.
podSubnetID	string (arm-id)	Идентификатор подсети, к которой будут присоединяться модули pod при запуске. Если не указано, IP-адреса pod статически назначаются в подсети узла (дополнительные сведения см. в статье vnetSubnetID). Эта форма: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
vnetSubnetID	string (arm-id)	Идентификатор подсети, к которой узел и, при необходимости, модули pod будут присоединяться при запуске. Если это не указано, будет создана и используется виртуальная сеть и подсеть. Если параметр podSubnetID не указан, это относится к узлам и модулям pod, в противном случае оно применяется только к узлам. Эта форма: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

MachineOSProfile

Объект

Операционная система и диск, используемые машиной.

Имя	Тип	Default value	Описание
enableFIPS	boolean		Следует ли использовать ОС с поддержкой FIPS.
linuxProfile	MachineOSProfileLinuxProfile		Специфический профиль компьютера с Linux.
osDiskSizeGB	integer (int32) minimum: 0 maximum: 2048		Размер диска ОС в ГБ, используемый для указания размера диска для каждого компьютера в пуле главных и агентов. Если указать значение 0, он будет применять размер osDisk по умолчанию в соответствии с указанным vmSize.
osDiskType	OSDiskType		Тип диска ОС, используемый для компьютеров в пуле агентов. Значение по умолчанию — "Ephemeral", если виртуальная машина поддерживает ее и имеет диск кэша больше запрошенного OSDiskSizeGB. В противном случае значение по умолчанию — Managed. Может не быть изменено после создания. Для получения дополнительной информации см. Ephemeral OS.
osSKU	OSSKU		Указывает номер SKU ОС, используемый пулом агентов. Если не указано, по умолчанию используется Ubuntu, если OSType=Linux или Windows2019, если OSType=Windows. И windows OSSKU по умолчанию будет изменен на Windows2022 после того, как Windows2019 не рекомендуется.
osType	OSType	Linux	Тип операционной системы. По умолчанию используется Linux.
windowsProfile	AgentPoolWindowsProfile		Определенный профиль компьютера с Windows.

MachineOSProfileLinuxProfile

Объект

Специфический профиль компьютера с Linux.

Имя	Тип	Описание
linuxOSConfig	LinuxOSConfig	Конфигурация ОС машины с Linux.
messageOfTheDay	string	Сообщение дня для узлов Linux в кодировке Base64. Строка в кодировке Base64, которая будет записана в /etc/motd после декодирования. Это позволяет настроить сообщение дня для узлов Linux. Он не должен быть указан для узлов Windows. Она должна быть статической строкой (т. е. будет напечатана необработанная и не выполняется как скрипт).

MachineProperties

Объект

Свойства компьютера

Имя	Тип	Default value	Описание
billing	MachineBillingProfile		Имущество, связанное с машинным биллингом.
eTag	string		Уникальная строка только для чтения, используемая для реализации оптимистического параллелизма. Значение eTag изменится при обновлении ресурса. Укажите заголовок if-match или if-none-match со значением eTag для последующего запроса, чтобы включить оптимистичный параллелизм в соответствии с обычным соглашением eTag.
evictionPolicy	ScaleSetEvictionPolicy	Delete	Политика выселения для машины. Это нельзя уточнить, если приоритет не является «Spot». Если значение не указано, значение по умолчанию — "Удалить".
hardware	MachineHardwareProfile		Аппаратные и графические настройки машины.
kubernetes	MachineKubernetesProfile		Конфигурации Kubernetes, используемые компьютером.
localDNSProfile	LocalDNSProfile		Настраивает локальную DNS для каждого узла с переопределениями VnetDNS и KubeDNS. LocalDNS помогает повысить производительность и надежность разрешения DNS в кластере AKS. Подробнее см. aka.ms/aks/localdns.
mode	AgentPoolMode		Автомат поддерживает только режимы «Система» и «Пользователь».
network	MachineNetworkProperties		сетевые свойства компьютера
nodeImageVersion	string		Версия образа узла.
operatingSystem	MachineOSProfile		Операционная система и диск, используемые машиной.
priority	ScaleSetPriority	Regular	Приоритет для машины. Если значение не указано, значение по умолчанию — "Regular".
provisioningState	string		Текущее состояние развертывания или подготовки.
resourceId	string (arm-id)		Идентификатор ресурса Azure компьютера. Его можно использовать для GET базового экземпляра виртуальной машины
security	MachineSecurityProfile		Настройки безопасности машины.
status	MachineStatus		Содержит информацию о машине только для чтения.
tags	object		Теги, которые должны быть сохранены на компьютере.

MachineSecurityProfile

Объект

Настройки безопасности машины.

Имя	Тип	Описание
enableEncryptionAtHost	boolean	Следует ли включить шифрование дисков на основе узла и ОС. Это поддерживается только на определённых размерах виртуальных машин и в некоторых регионах Azure. Дополнительные сведения см. в разделе: https://docs.microsoft.com/azure/aks/enable-host-encryption
enableSecureBoot	boolean	Безопасная загрузка — это функция доверенного запуска, которая гарантирует загрузку только подписанных операционных систем и драйверов. Дополнительные сведения см. в aka.ms/aks/trustedlaunch. Если значение не указано, значение по умолчанию равно false.
enableVTPM	boolean	VTPM — это функция доверенного запуска для настройки выделенного безопасного хранилища для ключей и измерений, которые хранятся локально на узле. Дополнительные сведения см. в aka.ms/aks/trustedlaunch. Если значение не указано, значение по умолчанию равно false.
sshAccess	AgentPoolSSHAccess	Метод SSH access пула агентов.

MachineStatus

Объект

Содержит информацию о машине только для чтения.

Имя	Тип	Описание
creationTimestamp	string (date-time)	Указывает время создания компьютера.
driftAction	DriftAction	Дрифт действия машины. Указывает, отклонился ли компьютер от ожидаемого состояния из-за изменений в свойствах управляемого кластера, требующих корректирующих действий.
driftReason	string	Причина сноса машины. Предоставляет подробную информацию о том, почему машина занесло в дрифт. Это поле опускается, если машина обновлена.
provisioningError	ErrorDetail	Ошибка содержит подробную информацию о машине. Сохраняет подробную информацию о неисправности. Если ошибки не было, то это поле опускается.
vmState	VmState	Состояние виртуальной машины. Указывает текущее состояние базовой виртуальной машины.

ManagementMode

Перечисление

Опыт управления GPU устанавливает дополнительные компоненты, такие как метрики менеджера GPU Центра (DCGM) для мониторинга, поверх драйвера GPU для вас. Для получения дополнительной информации о том, что устанавливается, смотрите aka.ms/aks/managed-gpu.

Значение	Описание
Unmanaged	Управляемый опыт GPU отключён для видеокарт NVIDIA.
Managed	Для NVIDIA GPU активирован управляемый GPU.

MigStrategy

Перечисление

Устанавливает стратегию MIG (Multi-Instance GPU), которая будет использоваться для поддержки управляемых MIG. Для получения дополнительной информации о различных стратегиях посетите aka.ms/aks/managed-gpu. Если указано не указано, по умолчанию — нет.

Значение	Описание
None	Не устанавливайте стратегию MIG. Если раньше был один набор, это переопределит его и удалит стратегию MIG.
Single	Установить стратегию MIG для управляемого MIG как единичную.
Mixed	Установить стратегию MIG для управляемого MIG как смешанную.

NvidiaGPUProfile

Объект

Настройки видеокарты, специфичные для NVIDIA,

Имя	Тип	Описание
managementMode	ManagementMode	Опыт управления GPU устанавливает дополнительные компоненты, такие как метрики менеджера GPU Центра (DCGM) для мониторинга, поверх драйвера GPU для вас. Для получения дополнительной информации о том, что устанавливается, смотрите aka.ms/aks/managed-gpu.
migStrategy	MigStrategy	Устанавливает стратегию MIG (Multi-Instance GPU), которая будет использоваться для поддержки управляемых MIG. Для получения дополнительной информации о различных стратегиях посетите aka.ms/aks/managed-gpu. Если указано не указано, по умолчанию — нет.

OSDiskType

Перечисление

Тип диска ОС, используемый для компьютеров в пуле агентов. Значение по умолчанию — "Ephemeral", если виртуальная машина поддерживает ее и имеет диск кэша больше запрошенного OSDiskSizeGB. В противном случае значение по умолчанию — Managed. Может не быть изменено после создания. Для получения дополнительной информации см. Ephemeral OS.

Значение	Описание
Managed	Azure реплицирует диск операционной системы для виртуальной машины в хранилище Azure, чтобы избежать потери данных в случае необходимости перемещения виртуальной машины на другой узел. Так как контейнеры не предназначены для сохранения локального состояния, это поведение обеспечивает ограниченное значение, предоставляя некоторые недостатки, включая более низкую подготовку узлов и более высокую задержку чтения и записи.
Ephemeral	Временные диски ОС хранятся только на хост-машине, как и временный диск. Это обеспечивает более низкую задержку чтения и записи, а также более быстрое масштабирование узлов и обновление кластера.

Значение

Описание

Managed

Azure реплицирует диск операционной системы для виртуальной машины в хранилище Azure, чтобы избежать потери данных в случае необходимости перемещения виртуальной машины на другой узел. Так как контейнеры не предназначены для сохранения локального состояния, это поведение обеспечивает ограниченное значение, предоставляя некоторые недостатки, включая более низкую подготовку узлов и более высокую задержку чтения и записи.

Ephemeral

Временные диски ОС хранятся только на хост-машине, как и временный диск. Это обеспечивает более низкую задержку чтения и записи, а также более быстрое масштабирование узлов и обновление кластера.

OSSKU

Перечисление

Указывает номер SKU ОС, используемый пулом агентов. По умолчанию используется Ubuntu, если OSType — Linux. Значение по умолчанию — Windows2019, если Kubernetes = 1.24 или Windows2022, если Kubernetes <>= 1.25, если OSType — Windows.

Значение	Описание
Ubuntu	Используйте Ubuntu в качестве ОС для образов узлов.
AzureLinux	Используйте AzureLinux в качестве ОС для образов узлов. Azure Linux — это дистрибутив Linux, оптимизированный для контейнеров, созданный корпорацией Майкрософт, и дополнительные сведения см. в https://aka.ms/azurelinux.
AzureLinux3	Используйте AzureLinux3 в качестве ОС для образов узлов. Azure Linux — это дистрибутив Linux, оптимизированный для контейнеров, созданный корпорацией Майкрософт, и дополнительные сведения см. в https://aka.ms/azurelinux. Для ознакомления с ограничениями посетите веб-сайт https://aka.ms/aks/node-images. Рекомендации по миграции ОС см. в разделе https://aka.ms/aks/upgrade-os-version.
Mariner	Устаревший OSSKU. Корпорация Майкрософт рекомендует вместо этого выбрать azureLinux для новых развертываний.
Flatcar	Используйте Flatcar Container Linux в качестве ОС для образов узлов. Flatcar — это оптимизированная для контейнеров, ориентированная на безопасность операционная система Linux с неизменяемой файловой системой и являющаяся частью Cloud Native Computing Foundation (CNCF). Дополнительные сведения о контейнере Flatcar Linux для AKS см. в разделе aka.ms/aks/flatcar-container-linux-for-aks
CBLMariner	Устаревший OSSKU. Корпорация Майкрософт рекомендует вместо этого выбрать azureLinux для новых развертываний.
Windows2019	Используйте Windows2019 в качестве ОС для образов узлов. Неподдерживаемый для пулов системных узлов. Windows2019 поддерживает только контейнеры Windows2019; Он не может запускать контейнеры Windows2022 и наоборот.
Windows2022	Используйте Windows2022 в качестве ОС для образов узлов. Неподдерживаемый для пулов системных узлов. Windows2022 поддерживает только контейнеры Windows2022; Он не может запускать контейнеры Windows2019 и наоборот.
Ubuntu2204	Используйте Ubuntu2204 в качестве ОС для образов узлов, однако Ubuntu 22.04 может поддерживаться не для всех пулов узлов. Сведения об ограничениях и поддерживаемых версиях Kubernetes см. в статье https://aka.ms/aks/supported-ubuntu-versions
Windows2025	Используйте Windows2025 в качестве ОС для образов узлов. Неподдерживаемый для пулов системных узлов. Windows2025 поддерживает контейнеры Windows2022 и Windows 2025; он не может запускать контейнеры Windows2019 и наоборот.
WindowsAnnual	Используйте версию Ежегодного канала Windows в качестве ОС для образов узлов. Неподдерживаемый для пулов системных узлов. Сведения о поддерживаемых образах контейнеров и версиях kubernetes в разных версиях Ежегодного канала AKS можно увидеть в https://aka.ms/aks/windows-annual-channel-details.
Ubuntu2404	Используйте Ubuntu2404 в качестве ОС для образов узлов, однако Ubuntu 24.04 может поддерживаться не для всех пулов узлов. Ограничения и поддерживаемые версии Kubernetes см. в статье https://aka.ms/aks/supported-ubuntu-versions

OSType

Перечисление

Тип операционной системы. По умолчанию используется Linux.

Значение	Описание
Linux	Используйте Linux.
Windows	Используйте Windows.

ScaleSetEvictionPolicy

Перечисление

Политика вытеснения масштабируемого набора виртуальных машин. Политика выселения указывает, что to делать с виртуальной машиной при её выселении. Значение по умолчанию — Delete. Для получения дополнительной информации о выселении смотрите spot виртуальные машины

Значение

Описание

Delete

Узлы в базовом масштабируемом наборе пула узлов удаляются при вытеснении.

Deallocate

Узлы в базовом масштабируемом наборе пула узлов переводятся в состояние остановлено и освобождено после вытеснения. Узлы в счетчике остановленного состояния в квоте вычислений и могут вызвать проблемы с масштабированием кластера или обновлением.

ScaleSetPriority

Перечисление

Приоритет масштабируемого набора виртуальных машин.

Значение	Описание
Spot	Будут использоваться виртуальные машины с приоритетом точечного доступа. Соглашение об уровне обслуживания для точечных узлов отсутствует. Дополнительные сведения см. в месте AKS.
Regular	Будут использоваться обычные виртуальные машины.

SeccompDefault

Перечисление

Указывает профиль seccomp по умолчанию, применяемый ко всем рабочим нагрузкам. Если значение не указано, параметр Unconfined будет использоваться по умолчанию.

Значение	Описание
Unconfined	Профиль seccomp не применяется, что разрешает все системные вызовы.
RuntimeDefault	По умолчанию применяется профиль seccomp для среды выполнения контейнера, который ограничивает определенные системные вызовы для повышения безопасности.

SysctlConfig

Объект

Параметры sysctl для узлов агента Linux.

Имя	Тип	Описание
fsAioMaxNr	integer (int32)	Настройка sysctl fs.aio-max-nr.
fsFileMax	integer (int32)	Настройка sysctl fs.file-max.
fsInotifyMaxUserWatches	integer (int32)	Параметр sysctl fs.inotify.max_user_watches.
fsNrOpen	integer (int32)	Параметр sysctl fs.nr_open.
kernelThreadsMax	integer (int32)	Sysctl устанавливает kernel.threads-max.
netCoreNetdevMaxBacklog	integer (int32)	Параметр sysctl net.core.netdev_max_backlog.
netCoreOptmemMax	integer (int32)	Параметр sysctl net.core.optmem_max.
netCoreRmemDefault	integer (int32)	Параметр sysctl net.core.rmem_default.
netCoreRmemMax	integer (int32)	Параметр sysctl net.core.rmem_max.
netCoreSomaxconn	integer (int32)	Настройка sysctl net.core.somaxconn.
netCoreWmemDefault	integer (int32)	Параметр sysctl net.core.wmem_default.
netCoreWmemMax	integer (int32)	Параметр sysctl net.core.wmem_max.
netIpv4IpLocalPortRange	string	Параметр sysctl net.ipv4.ip_local_port_range.
netIpv4NeighDefaultGcThresh1	integer (int32)	Параметр sysctl net.ipv4.neigh.default.gc_thresh1.
netIpv4NeighDefaultGcThresh2	integer (int32)	Параметр sysctl net.ipv4.neigh.default.gc_thresh2.
netIpv4NeighDefaultGcThresh3	integer (int32)	Параметр sysctl net.ipv4.neigh.default.gc_thresh3.
netIpv4TcpFinTimeout	integer (int32)	Параметр sysctl net.ipv4.tcp_fin_timeout.
netIpv4TcpKeepaliveProbes	integer (int32)	Параметр sysctl net.ipv4.tcp_keepalive_probes.
netIpv4TcpKeepaliveTime	integer (int32)	Параметр sysctl net.ipv4.tcp_keepalive_time.
netIpv4TcpMaxSynBacklog	integer (int32)	Параметр sysctl net.ipv4.tcp_max_syn_backlog.
netIpv4TcpMaxTwBuckets	integer (int32)	Параметр sysctl net.ipv4.tcp_max_tw_buckets.
netIpv4TcpTwReuse	boolean	Параметр sysctl net.ipv4.tcp_tw_reuse.
netIpv4TcpkeepaliveIntvl	integer (int32) minimum: 10 maximum: 90	Параметр sysctl net.ipv4.tcp_keepalive_intvl.
netNetfilterNfConntrackBuckets	integer (int32) minimum: 65536 maximum: 524288	Параметр sysctl net.netfilter.nf_conntrack_buckets.
netNetfilterNfConntrackMax	integer (int32) minimum: 131072 maximum: 2097152	Параметр sysctl net.netfilter.nf_conntrack_max.
vmMaxMapCount	integer (int32)	Параметр sysctl vm.max_map_count.
vmSwappiness	integer (int32)	Параметр sysctl vm.swappiness.
vmVfsCachePressure	integer (int32)	Параметр sysctl vm.vfs_cache_pressure.

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

VmState

Перечисление

Состояние виртуальной машины. Указывает текущее состояние базовой виртуальной машины.

Значение	Описание
Running	Виртуальная машина в данный момент работает.
Deleted	Виртуальная машина была удалена пользователем или в связи с точечным вытеснением.

WorkloadRuntime

Перечисление

Определяет тип рабочей нагрузки, который может выполнять узел.

Значение	Описание
OCIContainer	Узлы будут использовать Kubelet для выполнения стандартных рабочих нагрузок контейнеров OCI.
WasmWasi	Узлы будут использовать Krustlet для запуска рабочих нагрузок WASM с помощью поставщика WASI (предварительная версия).
KataMshvVmIsolation	Узлы могут использовать (Kata + Cloud Hypervisor + Hyper-V) для включения вложенных модулей pod на основе виртуальных машин (предварительная версия). Из-за использования Hyper-V сама ОС узла AKS — это вложенная виртуальная машина (корневая ОС) Hyper-V. Таким образом, его можно использовать только с рядами виртуальных машин, поддерживающими вложенную виртуализацию, например серии Dv3. В будущих выпусках это соглашение об именовании будет заменено на KataVmIsolation.
KataVmIsolation	Узлы могут использовать (Kata + Cloud Hypervisor + Hyper-V) для включения модулей pod на основе вложенных виртуальных машин. Из-за использования Hyper-V сама ОС узла AKS — это вложенная виртуальная машина (корневая ОС) Hyper-V. Таким образом, его можно использовать только с рядами виртуальных машин, поддерживающими вложенную виртуализацию, например серии Dv3.

Поделиться через

Machines - Create Or Update

Параметры URI

Заголовок запроса

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

Create/Update Machine

Образец запроса

Пример ответа

Определения

AgentPoolArtifactStreamingProfile

AgentPoolMode

AgentPoolSSHAccess

AgentPoolWindowsProfile

createdByType

DriftAction

DriverType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GPUDriver

GPUInstanceProfile

GPUProfile

IPFamily

IPTag

KubeletConfig

KubeletDiskType

LinuxOSConfig

LocalDNSForwardDestination

LocalDNSForwardPolicy

LocalDNSMode

LocalDNSOverride

LocalDNSProfile

LocalDNSProtocol

LocalDNSQueryLogging

LocalDNSServeStale

LocalDNSState

Machine

MachineBillingProfile

MachineHardwareProfile

MachineIpAddress

MachineKubernetesProfile

MachineNetworkProperties

MachineOSProfile

MachineOSProfileLinuxProfile

MachineProperties

MachineSecurityProfile

MachineStatus

ManagementMode

MigStrategy

NvidiaGPUProfile

OSDiskType

OSSKU

OSType

ScaleSetEvictionPolicy

ScaleSetPriority

SeccompDefault

SysctlConfig

systemData

VmState

WorkloadRuntime