az aks nodepool

Note

Эта группа команд содержит команды, определенные как в Azure CLI, так и в одном расширении. Установите каждое расширение, чтобы воспользоваться расширенными возможностями. Подробнее о расширениях.

Команды для управления пулами узлов в кластере Kubernetes kubernetes.

Команды

Имя	Описание	Тип	Состояние
az aks nodepool add	Добавьте пул узлов в управляемый кластер Kubernetes.	Core	GA
az aks nodepool add (aks-preview Расширение)	Добавьте пул узлов в управляемый кластер Kubernetes.	Extension	GA
az aks nodepool delete	Удалите пул агентов в управляемом кластере Kubernetes.	Core	GA
az aks nodepool delete (aks-preview Расширение)	Удалите пул агентов в управляемом кластере Kubernetes.	Extension	GA
az aks nodepool delete-machines	Удалите определенные компьютеры в агентпуле для управляемого кластера.	Core	GA
az aks nodepool delete-machines (aks-preview Расширение)	Удалите определенные компьютеры в агентпуле для управляемого кластера.	Extension	GA
az aks nodepool get-rollback-versions	Получите доступные версии отката для пула агентов управляемого кластера Kubernetes.	Extension	GA
az aks nodepool get-upgrades	Получите доступные версии обновления для пула агентов управляемого кластера Kubernetes.	Core	GA
az aks nodepool get-upgrades (aks-preview Расширение)	Получите доступные версии обновления для пула агентов управляемого кластера Kubernetes.	Extension	GA
az aks nodepool list	Вывод списка пулов узлов в управляемом кластере Kubernetes. Чтобы получить список узлов в команде запуска `kubectl get nodes` кластера.	Core	GA
az aks nodepool list (aks-preview Расширение)	Вывод списка пулов узлов в управляемом кластере Kubernetes.	Extension	GA
az aks nodepool manual-scale	Команды для управления nodepool virtualMachineProfile.scale.manual.	Ядро и расширение	GA
az aks nodepool manual-scale add	Добавьте новое руководство в агенту VirtualMachines в управляемом кластере Kubernetes.	Core	GA
az aks nodepool manual-scale add (aks-preview Расширение)	Добавьте новое руководство в агенту VirtualMachines в управляемом кластере Kubernetes.	Extension	GA
az aks nodepool manual-scale delete	Удалите существующее руководство в агенту VirtualMachines в управляемом кластере Kubernetes.	Core	GA
az aks nodepool manual-scale delete (aks-preview Расширение)	Удалите существующее руководство в агенту VirtualMachines в управляемом кластере Kubernetes.	Extension	GA
az aks nodepool manual-scale update	Обновите существующее руководство агента VirtualMachines в управляемом кластере Kubernetes.	Core	GA
az aks nodepool manual-scale update (aks-preview Расширение)	Обновите существующее руководство агента VirtualMachines в управляемом кластере Kubernetes.	Extension	GA
az aks nodepool operation-abort	Прервать последнюю операцию выполнения в nodepool.	Core	GA
az aks nodepool operation-abort (aks-preview Расширение)	Прервать последнюю операцию выполнения в nodepool.	Extension	GA
az aks nodepool rollback	Откат пула агентов к последней используемой конфигурации (N-1).	Extension	GA
az aks nodepool scale	Масштабирование пула узлов в управляемом кластере Kubernetes.	Core	GA
az aks nodepool scale (aks-preview Расширение)	Масштабирование пула узлов в управляемом кластере Kubernetes.	Extension	GA
az aks nodepool show	Отображение сведений о пуле узлов в управляемом кластере Kubernetes.	Core	GA
az aks nodepool show (aks-preview Расширение)	Отображение сведений о пуле узлов в управляемом кластере Kubernetes.	Extension	GA
az aks nodepool snapshot	Команды для управления моментальными снимками nodepool.	Ядро и расширение	GA
az aks nodepool snapshot create	Создание моментального снимка nodepool.	Core	GA
az aks nodepool snapshot create (aks-preview Расширение)	Создание моментального снимка nodepool.	Extension	GA
az aks nodepool snapshot delete	Удаление моментального снимка nodepool.	Core	GA
az aks nodepool snapshot delete (aks-preview Расширение)	Удаление моментального снимка nodepool.	Extension	GA
az aks nodepool snapshot list	Вывод списка моментальных снимков nodepool.	Core	GA
az aks nodepool snapshot list (aks-preview Расширение)	Вывод списка моментальных снимков nodepool.	Extension	GA
az aks nodepool snapshot show	Отображение сведений о моментальном снимке nodepool.	Core	GA
az aks nodepool snapshot show (aks-preview Расширение)	Отображение сведений о моментальном снимке nodepool.	Extension	GA
az aks nodepool snapshot update	Обновите теги на моментальном снимке узла.	Core	GA
az aks nodepool snapshot update (aks-preview Расширение)	Обновите теги на моментальном снимке узла.	Extension	GA
az aks nodepool snapshot wait	Подождите, пока моментальный снимок nodepool достигнет требуемого состояния.	Core	GA
az aks nodepool start	Запуск остановленного пула агентов в управляемом кластере Kubernetes.	Core	GA
az aks nodepool start (aks-preview Расширение)	Запуск остановленного пула агентов в управляемом кластере Kubernetes.	Extension	GA
az aks nodepool stop	Остановите запуск пула агентов в управляемом кластере Kubernetes.	Core	GA
az aks nodepool stop (aks-preview Расширение)	Остановите запуск пула агентов в управляемом кластере Kubernetes.	Extension	GA
az aks nodepool update	Обновление свойств пула узлов.	Core	GA
az aks nodepool update (aks-preview Расширение)	Обновление свойств пула узлов.	Extension	GA
az aks nodepool upgrade	Обновите пул узлов в управляемом кластере Kubernetes.	Core	GA
az aks nodepool upgrade (aks-preview Расширение)	Обновите пул узлов в управляемом кластере Kubernetes.	Extension	GA
az aks nodepool wait	Подождите, пока пул узлов достигнет требуемого состояния.	Core	GA

az aks nodepool add

Изменить

Добавьте пул узлов в управляемый кластер Kubernetes.

az aks nodepool add --cluster-name
                    --name --nodepool-name
                    --resource-group
                    [--aks-custom-headers]
                    [--allowed-host-ports]
                    [--asg-ids]
                    [--crg-id]
                    [--disable-windows-outbound-nat]
                    [--drain-timeout]
                    [--enable-cluster-autoscaler]
                    [--enable-encryption-at-host]
                    [--enable-fips-image]
                    [--enable-node-public-ip]
                    [--enable-secure-boot]
                    [--enable-ultra-ssd]
                    [--enable-vtpm]
                    [--eviction-policy {Deallocate, Delete}]
                    [--gateway-prefix-size]
                    [--gpu-driver {Install, None}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--if-match]
                    [--if-none-match]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--localdns-config]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--max-unavailable]
                    [--message-of-the-day]
                    [--min-count]
                    [--mode {Gateway, System, User}]
                    [--no-wait]
                    [--node-count]
                    [--node-osdisk-size]
                    [--node-osdisk-type {Ephemeral, Managed}]
                    [--node-public-ip-prefix-id]
                    [--node-public-ip-tags]
                    [--node-soak-duration]
                    [--node-taints]
                    [--node-vm-size]
                    [--os-sku {AzureLinux, AzureLinux3, CBLMariner, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022}]
                    [--os-type]
                    [--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--tags]
                    [--undrainable-node-behavior]
                    [--vm-set-type]
                    [--vm-sizes]
                    [--vnet-subnet-id]
                    [--workload-runtime {KataVmIsolation}]
                    [--zones]

Примеры

Создайте узел в существующем кластере AKS с включенным эфемерным ос.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48

Создайте узел с включенной функцией EncryptionAtHost.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host

Создайте узел с поддержкой UltraSSD.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-ultra-ssd

Создание кластера nodepool с определенным номером SKU ОС

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku Ubuntu

Создание узла с ос с поддержкой FIPS

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-fips-image

создайте кластер Kubernetes с идентификатором моментального снимка.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --kubernetes-version 1.20.9 --snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/snapshots/mysnapshot1"

создание узла в существующем кластере AKS с идентификатором группы узлов

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --host-group-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/hostGroups/myHostGroup --node-vm-size VMSize

создайте nodepool с идентификатором группы резервирования емкости (CRG).

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --node-vm-size VMSize --crg-id "/subscriptions/SubID/resourceGroups/ResourceGroupName/providers/Microsoft.ContainerService/CapacityReservationGroups/MyCRGID"

Создание узла с режимом выделения IP-адресов с параметром StaticBlock и использованием идентификатора подсети pod

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --os-sku Ubuntu --pod-subnet-id /subscriptions/SubID/resourceGroups/AnotherResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet --pod-ip-allocation-mode StaticBlock

создание узла типа VirtualMachines

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --vm-set-type VirtualMachines --vm-sizes "VMSize1,VMSize2" --node-count 3

Создайте узел с включенной функцией KataVmIsolation.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku AzureLinux --vm-size Standard_D4s_v3 --workload-runtime KataVmIsolation --node-count 1

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

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

--aks-custom-headers

Пары "ключ-значение", разделенные запятыми, чтобы указать пользовательские заголовки.

--allowed-host-ports

Предоставление портов узла в пуле узлов. При указании формат должен быть разделенным пробелом список диапазонов с протоколом, например. 80/TCP 443/TCP 4000-5000/TCP.

--asg-ids

Идентификаторы групп безопасности приложений, к которым должен принадлежать сетевой интерфейс пула узлов. При указании формат должен быть разделенным пробелом список идентификаторов.

--crg-id

Идентификатор crg, используемый для связывания нового узла с существующим ресурсом группы резервирования емкости.

--disable-windows-outbound-nat

Отключите Windows OutboundNAT в пуле узлов агента Windows.

Свойство	Значение
Default value:	False

--drain-timeout

Когда узлы вытеснены, сколько минут, чтобы дождаться вытеснения всех модулей pod.

--enable-cluster-autoscaler -e

Включите автомасштабирование кластера.

Свойство	Значение
Default value:	False

--enable-encryption-at-host

Включите EncryptionAtHost, значение по умолчанию равно false.

Свойство	Значение
Default value:	False

--enable-fips-image

Используйте ОС с поддержкой FIPS на узлах агента.

Свойство	Значение
Default value:	False

--enable-node-public-ip

Включите общедоступный IP-адрес узла VMSS или виртуальных машин.

Свойство	Значение
Default value:	False

--enable-secure-boot

Включите безопасную загрузку в пуле узлов агента. Должен использовать тип пула агентов vmSS или виртуальных машин.

Свойство	Значение
Default value:	False

--enable-ultra-ssd

Включите UltraSSD, значение по умолчанию равно false.

Свойство	Значение
Default value:	False

--enable-vtpm

Включите vTPM в пуле узлов агента. Должен использовать тип пула агентов vmSS или виртуальных машин.

Свойство	Значение
Default value:	False

--eviction-policy

Политика вытеснения пула точечных узлов. Его можно задать только в том случае, если значение --priority — Spot.

Свойство	Значение
Default value:	Delete
Допустимые значения:	Deallocate, Delete

--gateway-prefix-size

Размер общедоступного IP-адреса, присоединенного к пулу узлов в режиме шлюза. Пул узлов должен находиться в режиме шлюза.

--gpu-driver

Нужно ли устанавливать драйвер для пула узлов GPU. Возможные значения: "Install" или "None". Значение по умолчанию — «Установить».

Свойство	Значение
Допустимые значения:	Install, None

--gpu-instance-profile

Профиль экземпляра GPU для секционирования графических процессоров Nvidia gpu.

Свойство	Значение
Допустимые значения:	MIG1g, MIG2g, MIG3g, MIG4g, MIG7g

--host-group-id

Полный идентификатор выделенной группы узлов, используемый для подготовки пула узлов агента.

--if-match

Указанное значение будет сравниваться с ETag агентаpool, если оно соответствует операции, будет продолжаться. Если оно не соответствует, запрос будет отклонен, чтобы предотвратить случайные перезаписи. Это не должно быть указано при создании нового агента.

--if-none-match

Установите значение "*", чтобы разрешить создание нового агента, но для предотвращения обновления существующего агента. Другие значения будут игнорироваться.

--kubelet-config

Путь к JSON-файлу с конфигурацией Kubelet для узлов агента. https://aka.ms/aks/custom-node-config.

--kubernetes-version -k

Версия Kubernetes, используемая для создания кластера, например "1.16.9".

Свойство	Значение
Значение из:	`az aks get-versions`

--labels

Метки узлов для пула узлов. См https://aka.ms/node-labels . синтаксис меток.

--linux-os-config

Путь к JSON-файлу с конфигурациями ОС для узлов агента Linux. https://aka.ms/aks/custom-node-config.

--localdns-config

Задайте профиль localDNS для узла с файлом конфигурации JSON.

--max-count

Максимальное число узлов, используемых для автомасштабирования, если указан параметр --enable-cluster-autoscaler. Укажите значение в диапазоне [0, 1000] для пользовательского узла и [11000] для системного узла.

--max-pods -m

Максимальное число контейнеров pod, развертываемых на узле.

Если значение не указано, по умолчанию используется сетевой подключаемый модуль. 30 для "azure", 110 для kubenet или 250 для "none".

--max-surge

Дополнительные узлы, используемые для ускорения обновления. При указании он представляет используемое число или процент, например. 5 или 33%.

--max-unavailable

Максимальное число или процент узлов, которые могут быть одновременно недоступны во время обновления. При указании он представляет используемое число или процент, например. 1 или 5%.

--message-of-the-day

Путь к файлу с нужным сообщением дня. Допустимо только для узлов Linux. Будет записано в /etc/motd.

--min-count

Минимальное количество узлов, используемых для автомасштабирования, если указан параметр --enable-cluster-autoscaler. Укажите значение в диапазоне [0, 1000] для пользовательского узла и [11000] для системного узла.

--mode

Свойство	Значение
Default value:	User
Допустимые значения:	Gateway, System, User

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

--node-count -c

Количество узлов в пуле агентов Kubernetes. После создания кластера можно изменить размер пула узлов с az aks scaleпомощью .

Свойство	Значение
Default value:	3

--node-osdisk-size

Размер в ГиБ диска ОС для каждого узла в пуле агентов. Минимум 30 ГиБ.

--node-osdisk-type

Тип диска ОС, используемый для компьютеров в заданном пуле агентов. По умолчанию значение "Ephemeral" по возможности в сочетании с размером виртуальной машины и размером диска ОС. Может не быть изменено для этого пула после создания. ("Эфемеральный" или "Управляемый").

Свойство	Значение
Допустимые значения:	Ephemeral, Managed

--node-public-ip-prefix-id

Идентификатор префикса общедоступного IP-адреса, используемый для назначения общедоступных IP-адресов узлам VMSS или виртуальным машинам.

--node-public-ip-tags

IpTags общедоступных IP-адресов узла.

--node-soak-duration

Время ожидания (в минутах) после очистки узла и перед повторной подготовкой к нему и переход к следующему узлу.

--node-taints

Узел затухает пул узлов.

--node-vm-size -s

Размер Виртуальные машины для создания как узлов Kubernetes. Если пользователь не указывает его, сервер выберет размер виртуальной машины по умолчанию для нее или его.

--os-sku

Номер SKU ОС пула узлов агента. Ubuntu, Ubuntu2204, Ubuntu2404, AzureLinux или AzureLinux3 для Linux. Windows2019 или Windows2022 для Windows.

Свойство	Значение
Допустимые значения:	AzureLinux, AzureLinux3, CBLMariner, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022

--os-type

Тип ОС. Linux или Windows.

--pod-ip-allocation-mode

Задайте режим выделения IP-адресов для того, как IP-адреса pod из подсети Pod Azure выделяются узлам в кластере AKS. Выбор состоит из динамических пакетов отдельных IP-адресов или статического выделения набора блоков CIDR. Допустимые значения: DynamicIndividual или StaticBlock.

Используется вместе с подключаемым модулем сети Azure. Требуется идентификатор --pod-subnet-id.

Свойство	Значение
Допустимые значения:	DynamicIndividual, StaticBlock

--pod-subnet-id

Идентификатор ресурса подсети в существующей виртуальной сети, в которой необходимо назначить модули pod в кластере (требуется сетевой подключаемый модуль Azure).

--ppg

Идентификатор PPG.

--priority

Приоритет пула узлов.

Свойство	Значение
Default value:	Regular
Допустимые значения:	Regular, Spot

--scale-down-mode

Описать, как виртуальные машины добавляются в узлы или удаляются из них.

Свойство	Значение
Default value:	Delete
Допустимые значения:	Deallocate, Delete

--snapshot-id

Исходный идентификатор моментального снимка, используемый для создания этого узла.

--spot-max-price

Его можно задать только в том случае, если значение --priority — Spot. Укажите максимальную цену, которую вы готовы платить в долларах США. Возможные значения — это любое десятичное значение больше нуля или -1, указывающее, что цена по умолчанию up-to по запросу. Он может включать только до 5 десятичных разрядов.

Свойство	Значение
Default value:	nan

--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

--undrainable-node-behavior

Определите поведение для неуправляемых узлов во время обновления. Значение должно быть "Cordon" или "Schedule". Значением по умолчанию является "Schedule".

Свойство	Значение
Default value:	Schedule

--vm-set-type

Тип набора виртуальных машин пула агентов. VirtualMachineScaleSets или AvailabilitySet или VirtualMachines. По умолчанию используется значение VirtualMachineScaleSets.

--vm-sizes

Разделенный запятыми список размеров виртуальных машин. Допустимо только для пула узлов VirtualMachines. Если --vm-sizes значение не указано, но --node-vm-size не указано, будет использоваться значение --node-vm-size . Если ни из них не указано, по умолчанию Standard_DS2_v2 для Linux или Standard_D2s_v3 для Windows.

--vnet-subnet-id

Идентификатор ресурса подсети в существующей виртуальной сети, в которой необходимо развернуть кластер.

--workload-runtime

Задайте среду выполнения рабочей нагрузки.

Azure предоставляет другую среду выполнения рабочей нагрузки для включения поддерживаемых рабочих нагрузок Kata в узлах. Можно указать следующие значения:

"KataVmIsolation" для Каты.

Свойство	Значение
Допустимые значения:	KataVmIsolation

--zones -z

Зоны доступности, в которых будут размещены узлы агента. Кроме того, чтобы установить узлы агента в несколько зон, необходимо передать номера зон, разделенные пустыми. Например, чтобы иметь все 3 зоны, необходимо ввести --zones 1 2 3.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False

az aks nodepool add (aks-preview Расширение)

Добавьте пул узлов в управляемый кластер Kubernetes.

az aks nodepool add --cluster-name
                    --name --nodepool-name
                    --resource-group
                    [--aks-custom-headers]
                    [--allowed-host-ports]
                    [--asg-ids]
                    [--batch-soak-duration]
                    [--crg-id]
                    [--disable-windows-outbound-nat]
                    [--drain-batch-size]
                    [--drain-timeout]
                    [--drain-timeout-bg]
                    [--driver-type {CUDA, GRID}]
                    [--enable-artifact-streaming]
                    [--enable-cluster-autoscaler]
                    [--enable-encryption-at-host]
                    [--enable-fips-image]
                    [--enable-node-public-ip]
                    [--enable-secure-boot]
                    [--enable-ultra-ssd]
                    [--enable-vtpm]
                    [--eviction-policy {Deallocate, Delete}]
                    [--final-soak-duration]
                    [--gateway-prefix-size]
                    [--gpu-driver {Install, None}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--if-match]
                    [--if-none-match]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--localdns-config]
                    [--max-blocked-nodes]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--max-unavailable]
                    [--message-of-the-day]
                    [--min-count]
                    [--mode {Gateway, Machines, ManagedSystem, System, User}]
                    [--no-wait]
                    [--node-count]
                    [--node-osdisk-size]
                    [--node-osdisk-type {Ephemeral, Managed}]
                    [--node-public-ip-prefix-id]
                    [--node-public-ip-tags]
                    [--node-soak-duration]
                    [--node-taints]
                    [--node-vm-size]
                    [--os-sku {AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual}]
                    [--os-type]
                    [--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--ssh-access {disabled, entraid, localuser}]
                    [--tags]
                    [--undrainable-node-behavior]
                    [--upgrade-strategy {BlueGreen, Rolling}]
                    [--vm-set-type]
                    [--vm-sizes]
                    [--vnet-subnet-id]
                    [--workload-runtime {KataCcIsolation, KataMshvVmIsolation, KataVmIsolation, OCIContainer, WasmWasi}]
                    [--zones]

Примеры

Создайте узел в существующем кластере AKS с включенным эфемерным ос.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48

Создайте узел с включенной функцией EncryptionAtHost.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host

Создание узла с помощью определенного os-sku

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --os-sku Ubuntu

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

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --workload-runtime WasmWasi

создайте кластер Kubernetes с идентификатором моментального снимка.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --kubernetes-version 1.20.9 --snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/snapshots/mysnapshot1"

создайте nodepool с идентификатором группы резервирования емкости (CRG).

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --node-vm-size VMSize --crg-id "/subscriptions/SubID/resourceGroups/ResourceGroupName/providers/Microsoft.ContainerService/CapacityReservationGroups/MyCRGID"

создание узла в существующем кластере AKS с идентификатором группы узлов

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --host-group-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/hostGroups/myHostGroup --node-vm-size VMSize

Создание узла с режимом выделения IP-адресов с параметром StaticBlock и использованием идентификатора подсети pod

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --os-sku Ubuntu --pod-subnet-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet --pod-ip-allocation-mode StaticBlock

Создание узла типа VirtualMachines

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --vm-set-type VirtualMachines --vm-sizes "Standard_D4s_v3,Standard_D8s_v3" --node-count 3

Создание узла с помощью режима ManagedSystem

az aks nodepool add -g MyResourceGroup -n managedsystem1 --cluster-name MyManagedCluster --mode ManagedSystem

Создание пула узлов с сине-зеленой стратегией обновления и параметрами по умолчанию

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --upgrade-strategy BlueGreen

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--aks-custom-headers

Отправка пользовательских заголовков. При указании формат должен иметь значение Key1=Value1,Key2=Value2.

--allowed-host-ports

Предварительный просмотр

Предоставление портов узла в пуле узлов. При указании формат должен быть разделен запятыми список диапазонов с протоколом, например. 80/TCP,443/TCP,4000-5000/TCP. Должен использовать тип пула агентов VMSS.

--asg-ids

Предварительный просмотр

Идентификаторы групп безопасности приложений, к которым должен принадлежать сетевой интерфейс пула узлов. При указании формат должен быть разделен запятыми списком идентификаторов. Должен использовать тип пула агентов VMSS.

--batch-soak-duration

Время ожидания (в минутах) после очистки пакета узлов перед переходом к следующему пакету. Значение по умолчанию — 15 минут. Только для синих зеленых обновлений.

--crg-id

Предварительный просмотр

Crg-id, используемый для связывания нового узла с существующим ресурсом группы резервирования емкости. Должен использовать тип пула агентов VMSS.

--disable-windows-outbound-nat

Отключите Windows OutboundNAT в пуле узлов агента Windows. Должен использовать тип пула агентов VMSS.

Свойство	Значение
Default value:	False

--drain-batch-size

Число или процент узлов для очистки каждого пакета во время обновления сине-зеленого цвета. Принимает целое число (например, 5) или процент (например, 50%). Значение по умолчанию — 10%.

Указывает количество узлов для очистки каждого пакета во время сине-зеленого обновления. Должно быть ненулевым значением либо в виде целого числа (например, "5"), либо процента (например, "50%" общего числа синих узлов в начале обновления. Дробные узлы округляются вверх. Дополнительные сведения и рекомендации см. в статье https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster.

--drain-timeout

Когда узлы вытеснены, сколько минут, чтобы дождаться вытеснения всех модулей pod.

--drain-timeout-bg

Время ожидания (в минутах) для вытеснения модулей pod и корректное завершение каждого узла во время обновления сине-зеленого цвета. Значение по умолчанию — 30 минут.

Максимальное время (в минутах) для ожидания вытеснения pod и корректного завершения на узел во время обновления сине-зеленого цвета. Учитывает бюджеты нарушений pod. При превышении обновление завершается ошибкой. Значение по умолчанию — 30 минут.

--driver-type

Предварительный просмотр

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

Свойство	Значение
Допустимые значения:	CUDA, GRID

--enable-artifact-streaming

Предварительный просмотр

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

Свойство	Значение
Default value:	False

--enable-cluster-autoscaler -e

Включите автомасштабирование кластера. Должен использовать тип пула агентов VMSS.

Свойство	Значение
Default value:	False

--enable-encryption-at-host

Включите EncryptionAtHost в пуле узлов агента.

Свойство	Значение
Default value:	False

--enable-fips-image

Используйте ОС с поддержкой FIPS на узлах агента.

Свойство	Значение
Default value:	False

--enable-node-public-ip

Включите общедоступный IP-адрес узла VMSS. Должен использовать тип пула агентов VMSS.

Свойство	Значение
Default value:	False

--enable-secure-boot

Предварительный просмотр

Включите безопасную загрузку в пуле узлов агента. Должен использовать тип пула агентов VMSS.

Свойство	Значение
Default value:	False

--enable-ultra-ssd

Включите UltraSSD в пуле узлов агента. Должен использовать тип пула агентов VMSS.

Свойство	Значение
Default value:	False

--enable-vtpm

Предварительный просмотр

Включите vTPM в пуле узлов агента. Должен использовать тип пула агентов VMSS.

Свойство	Значение
Default value:	False

--eviction-policy

Политика вытеснения пула точечных узлов. Его можно задать только в том случае, если значение --priority — Spot.

Свойство	Значение
Default value:	Delete
Допустимые значения:	Deallocate, Delete

--final-soak-duration

Время ожидания (в минутах) после очистки всех старых узлов перед их удалением. Значение по умолчанию — 60 минут. Только для синих зеленых обновлений.

--gateway-prefix-size

Предварительный просмотр

--gpu-driver

Свойство	Значение
Допустимые значения:	Install, None

--gpu-instance-profile

Профиль экземпляра GPU для секционирования графических процессоров Nvidia gpu.

Свойство	Значение
Допустимые значения:	MIG1g, MIG2g, MIG3g, MIG4g, MIG7g

--host-group-id

(предварительная версия) Полный идентификатор выделенной группы узлов, используемый для подготовки пула узлов агента. Должен использовать тип пула агентов VMSS.

--if-match

--if-none-match

--kubelet-config

Конфигурации Kubelet для узлов агента.

--kubernetes-version -k

Версия Kubernetes, используемая для создания кластера, например "1.7.12" или "1.8.7".

Свойство	Значение
Значение из:	`az aks get-versions`

--labels

Метки узлов для пула узлов. См https://aka.ms/node-labels . синтаксис меток.

--linux-os-config

Конфигурации ОС для узлов агента Linux.

--localdns-config

Задайте профиль localDNS для узла с файлом конфигурации JSON.

--max-blocked-nodes

Максимальное число или процент дополнительных узлов, которые могут быть заблокированы в пуле агентов во время обновления, если поведение узла, неуправляемого, — Cordon. При указании он представляет используемое число или процент, например. 1 или 5%.

--max-count

--max-pods -m

Максимальное число контейнеров pod, развертываемых на узле.

Свойство	Значение
Default value:	0

--max-surge

--max-unavailable

--message-of-the-day

Путь к файлу с нужным сообщением дня. Допустимо только для узлов Linux. Будет записано в /etc/motd.

--min-count

Число узлов Минимун, используемых для автомасштабирования, если указано значение "--enable-cluster-autoscaler". Укажите значение в диапазоне [0, 1000] для пользовательского узла и [11000] для системного узла.

--mode

Режим пула узлов, который определяет основную функцию пула узлов. Если задано значение System, AKS предпочитает системные модули pod планирования пулов узлов с режимом System. Если задано значение ManagedSystem, все остальные свойства, кроме имени и режима, будут сбрасываться и управляться AKS. Узнайте больше на сайте https://aka.ms/aks/nodepool/mode.

Свойство	Значение
Default value:	User
Допустимые значения:	Gateway, Machines, ManagedSystem, System, User

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

--node-count -c

Свойство	Значение
Default value:	3

--node-osdisk-size

Размер в ГиБ диска ОС для каждого узла в пуле агентов. Минимум 30 ГиБ.

Свойство	Значение
Default value:	0

--node-osdisk-type

Свойство	Значение
Допустимые значения:	Ephemeral, Managed

--node-public-ip-prefix-id

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

--node-public-ip-tags

IpTags общедоступных IP-адресов узла. Должен использовать тип пула агентов VMSS.

--node-soak-duration

--node-taints

Узел затухает пул узлов.

--node-vm-size -s

--os-sku

SKU ос пула узлов агента. Ubuntu, Ubuntu2204, Ubuntu2404, CBLMariner, AzureLinux, AzureLinux3, AzureLinuxOSGuard, AzureLinuxOSGuard, AzureLinux3OSGuard или Flatcar, если ос типа Linux, по умолчанию — Ubuntu, если он не задан; Windows2019, Windows2022, Windows2025 или WindowsAnnual, если ос используется Windows, текущее значение по умолчанию — Windows2022, если оно не задано.

Свойство	Значение
Допустимые значения:	AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual

--os-type

Тип ОС. Linux или Windows. Windows еще не поддерживается для типа набора виртуальных машин VirtualMachines.

--pod-ip-allocation-mode

Используется вместе с подключаемым модулем сети Azure. Требуется идентификатор --pod-subnet-id.

Свойство	Значение
Допустимые значения:	DynamicIndividual, StaticBlock

--pod-subnet-id

Идентификатор подсети в существующей виртуальной сети, в которой назначаются модули pod в кластере (требуется сетевой подключаемый модуль Azure).

--ppg

Идентификатор PPG. Должен использовать тип пула агентов VMSS.

--priority

Приоритет пула узлов.

Свойство	Значение
Default value:	Regular
Допустимые значения:	Regular, Spot

--scale-down-mode

Описывает, как виртуальные машины добавляются в узлы или удаляются из них.

Свойство	Значение
Default value:	Delete
Допустимые значения:	Deallocate, Delete

--snapshot-id

Исходный идентификатор моментального снимка, используемый для создания этого узла. Должен использовать тип пула агентов VMSS.

--spot-max-price

Свойство	Значение
Default value:	nan

--ssh-access

Предварительный просмотр

Настройте параметр SSH для пула узлов. Используйте "отключено", чтобы отключить доступ SSH, localuser, чтобы включить доступ SSH с помощью закрытого ключа.

Свойство	Значение
Default value:	localuser
Допустимые значения:	disabled, entraid, localuser

--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

--undrainable-node-behavior

--upgrade-strategy

Стратегия обновления пула узлов. Допустимые значения: "Rolling" или "BlueGreen". Значение по умолчанию — "Rolling".

Свойство	Значение
Допустимые значения:	BlueGreen, Rolling

--vm-set-type

Тип набора виртуальных машин пула агентов. VirtualMachineScaleSets, AvailabilitySet или VirtualMachines(preview).

--vm-sizes

Предварительный просмотр

Разделенный запятыми список размеров. Должен использовать тип пула агентов VirtualMachines.

--vnet-subnet-id

Идентификатор подсети в существующей виртуальной сети, где требуется развернуть кластер.

--workload-runtime

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

Свойство	Значение
Default value:	OCIContainer
Допустимые значения:	KataCcIsolation, KataMshvVmIsolation, KataVmIsolation, OCIContainer, WasmWasi

--zones -z

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

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool delete

Изменить

Удалите пул агентов в управляемом кластере Kubernetes.

az aks nodepool delete --cluster-name
                       --name --nodepool-name
                       --resource-group
                       [--if-match]
                       [--ignore-pdb]
                       [--no-wait]

Примеры

Удаление пула агентов с помощью ignore-pdb

az aks nodepool delete --resource-group MyResourceGroup --cluster-name MyManagedCluster --name nodepool1 --if-match etag --ignore-pdb

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--if-match

Указанное значение будет сравниваться с ETag пула узлов, если оно соответствует операции, будет продолжаться. Если оно не соответствует, запрос будет отклонен, чтобы предотвратить случайные перезаписи. Это не должно быть указано при создании нового агента.

--ignore-pdb -i

Удалите существующий узел, не учитывая бюджет прерывания pod.

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool delete (aks-preview Расширение)

Удалите пул агентов в управляемом кластере Kubernetes.

az aks nodepool delete --cluster-name
                       --name --nodepool-name
                       --resource-group
                       [--if-match]
                       [--ignore-pod-disruption-budget]
                       [--no-wait]

Примеры

Удаление пула агентов с помощью ignore-pod-disruption-budget

az aks nodepool delete --resource-group MyResourceGroup --cluster-name MyManagedCluster --name nodepool1 --ignore-pod-disruption-budget=true

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--if-match

--ignore-pod-disruption-budget -i

Предварительный просмотр

(ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ) ignore-pod-нарушение бюджета удаляет существующий узел, не учитывая бюджет прерывания pod.

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool delete-machines

Изменить

Удалите определенные компьютеры в агентпуле для управляемого кластера.

az aks nodepool delete-machines --cluster-name
                                --machine-names
                                --name --nodepool-name
                                --resource-group
                                [--no-wait]

Примеры

Удаление определенных компьютеров в пуле агентов

az aks nodepool delete-machines -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster --machine-names machine1

Обязательные параметры

--cluster-name

Имя кластера.

--machine-names

Разделенный пробелом список имен компьютеров из пула агентов, которые необходимо удалить.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool delete-machines (aks-preview Расширение)

Удалите определенные компьютеры в агентпуле для управляемого кластера.

az aks nodepool delete-machines --cluster-name
                                --machine-names
                                --name --nodepool-name
                                --resource-group
                                [--no-wait]

Примеры

Удаление определенных компьютеров в пуле агентов

az aks nodepool delete-machines -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster --machine-names machine1

Обязательные параметры

--cluster-name

Имя кластера.

--machine-names

Разделенный пробелом список имен компьютеров из пула агентов, которые необходимо удалить.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool get-rollback-versions

Получите доступные версии отката для пула агентов управляемого кластера Kubernetes.

Получите список исторически используемых версий kubernetes и образов узла, которые можно использовать для операций отката.

az aks nodepool get-rollback-versions --cluster-name
                                      --name --nodepool-name
                                      --resource-group

Примеры

Получите доступные версии отката для пула агентов.

az aks nodepool get-rollback-versions --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool get-upgrades

Изменить

Получите доступные версии обновления для пула агентов управляемого кластера Kubernetes.

az aks nodepool get-upgrades --cluster-name
                             --name --nodepool-name
                             --resource-group

Примеры

Получите доступные версии обновления для пула агентов управляемого кластера Kubernetes.

az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool get-upgrades (aks-preview Расширение)

Получите доступные версии обновления для пула агентов управляемого кластера Kubernetes.

az aks nodepool get-upgrades --cluster-name
                             --name --nodepool-name
                             --resource-group

Примеры

Получите доступные версии обновления для пула агентов управляемого кластера Kubernetes.

az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool list

Изменить

Вывод списка пулов узлов в управляемом кластере Kubernetes. Чтобы получить список узлов в команде запуска kubectl get nodes кластера.

az aks nodepool list --cluster-name
                     --resource-group

Обязательные параметры

--cluster-name

Имя кластера.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool list (aks-preview Расширение)

Вывод списка пулов узлов в управляемом кластере Kubernetes.

az aks nodepool list --cluster-name
                     --resource-group

Обязательные параметры

--cluster-name

Имя кластера.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool operation-abort

Изменить

Прервать последнюю операцию выполнения в nodepool.

az aks nodepool operation-abort --cluster-name
                                --name --nodepool-name
                                --resource-group
                                [--no-wait]

Примеры

Прерывание операции в пуле агентов

az aks nodepool operation-abort -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool operation-abort (aks-preview Расширение)

Прервать последнюю операцию выполнения в nodepool.

az aks nodepool operation-abort --cluster-name
                                --name --nodepool-name
                                --resource-group
                                [--aks-custom-headers]
                                [--no-wait]

Примеры

Прерывание операции в пуле агентов

az aks nodepool operation-abort -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--aks-custom-headers

Отправка пользовательских заголовков. При указании формат должен иметь значение Key1=Value1,Key2=Value2.

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool rollback

Откат пула агентов к последней используемой конфигурации (N-1).

Откат пула агентов к последней используемой версии на основе журнала отката. Это приведет к откату версии Kubernetes и версии образа узла до последнего предыдущего состояния. Для более ранних версий (N-2 или более ранних версий) используйте отдельную операцию понижения.

az aks nodepool rollback --cluster-name
                         --name --nodepool-name
                         --resource-group
                         [--aks-custom-headers]
                         [--if-match]
                         [--if-none-match]
                         [--no-wait]

Примеры

Откат узла до последней используемой версии.

az aks nodepool rollback --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--aks-custom-headers

Отправка пользовательских заголовков. При указании формат должен иметь значение Key1=Value1,Key2=Value2.

--if-match

Редакция обновляемого ресурса. Это должно соответствовать текущей редакции.

--if-none-match

Установите значение "*", чтобы разрешить создание нового ресурса, но для предотвращения обновления существующего ресурса.

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool scale

Изменить

Масштабирование пула узлов в управляемом кластере Kubernetes.

az aks nodepool scale --cluster-name
                      --name --nodepool-name
                      --resource-group
                      [--no-wait]
                      [--node-count]

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

--node-count -c

Количество узлов в пуле узлов Kubernetes.

Свойство	Значение
Default value:	3

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool scale (aks-preview Расширение)

Масштабирование пула узлов в управляемом кластере Kubernetes.

az aks nodepool scale --cluster-name
                      --name --nodepool-name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]
                      [--node-count]

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--aks-custom-headers

Отправка пользовательских заголовков. При указании формат должен иметь значение Key1=Value1,Key2=Value2.

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

--node-count -c

Количество узлов в пуле узлов Kubernetes.

Свойство	Значение
Default value:	3

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool show

Изменить

Отображение сведений о пуле узлов в управляемом кластере Kubernetes.

az aks nodepool show --cluster-name
                     --name --nodepool-name
                     --resource-group

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool show (aks-preview Расширение)

Отображение сведений о пуле узлов в управляемом кластере Kubernetes.

az aks nodepool show --cluster-name
                     --name --nodepool-name
                     --resource-group

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool start

Изменить

Запуск остановленного пула агентов в управляемом кластере Kubernetes.

az aks nodepool start --cluster-name
                      --name --nodepool-name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]

Примеры

Запуск пула агентов в управляемом кластере

az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--aks-custom-headers

Отправка пользовательских заголовков. При указании формат должен иметь значение Key1=Value1,Key2=Value2.

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool start (aks-preview Расширение)

Запуск остановленного пула агентов в управляемом кластере Kubernetes.

az aks nodepool start --cluster-name
                      --name --nodepool-name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]

Примеры

Запуск пула агентов в управляемом кластере

az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--aks-custom-headers

Отправка пользовательских заголовков. При указании формат должен иметь значение Key1=Value1,Key2=Value2.

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool stop

Изменить

Остановите запуск пула агентов в управляемом кластере Kubernetes.

az aks nodepool stop --cluster-name
                     --name --nodepool-name
                     --resource-group
                     [--aks-custom-headers]
                     [--no-wait]

Примеры

Остановка пула агентов в управляемом кластере

az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--aks-custom-headers

Отправка пользовательских заголовков. При указании формат должен иметь значение Key1=Value1,Key2=Value2.

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool stop (aks-preview Расширение)

Остановите запуск пула агентов в управляемом кластере Kubernetes.

az aks nodepool stop --cluster-name
                     --name --nodepool-name
                     --resource-group
                     [--aks-custom-headers]
                     [--no-wait]

Примеры

Остановка пула агентов в управляемом кластере

az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--aks-custom-headers

Отправка пользовательских заголовков. При указании формат должен иметь значение Key1=Value1,Key2=Value2.

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool update

Изменить

Обновление свойств пула узлов.

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

az aks nodepool update --cluster-name
                       --name --nodepool-name
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--disable-cluster-autoscaler]
                       [--disable-fips-image]
                       [--disable-secure-boot]
                       [--disable-vtpm]
                       [--drain-timeout]
                       [--enable-cluster-autoscaler]
                       [--enable-fips-image]
                       [--enable-secure-boot]
                       [--enable-vtpm]
                       [--gpu-driver {Install, None}]
                       [--if-match]
                       [--if-none-match]
                       [--labels]
                       [--localdns-config]
                       [--max-count]
                       [--max-surge]
                       [--max-unavailable]
                       [--min-count]
                       [--mode {Gateway, System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--os-sku {AzureLinux, AzureLinux3, Ubuntu, Ubuntu2204, Ubuntu2404}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--tags]
                       [--undrainable-node-behavior]
                       [--update-cluster-autoscaler]

Примеры

Примирите узел с текущим состоянием.

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Включение автомасштабирования кластера в диапазоне счетчиков узлов [1,5]

az aks nodepool update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Отключение автомасштабирования кластера для существующего кластера

az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Обновите минимальное число или максимальное число для автомасштабирования кластера.

az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--aks-custom-headers

Пары "ключ-значение", разделенные запятыми, чтобы указать пользовательские заголовки.

--allowed-host-ports

--asg-ids

--disable-cluster-autoscaler -d

Отключите автомасштабирование кластера.

Свойство	Значение
Default value:	False

--disable-fips-image

Переключитесь на использование ОС с поддержкой FIPS на узлах агента.

Свойство	Значение
Default value:	False

--disable-secure-boot

Отключите безопасную загрузку в существующем пуле узлов агента с поддержкой доверенного запуска.

Свойство	Значение
Default value:	False

--disable-vtpm

Отключите vTPM в существующем пуле узлов агента с поддержкой доверенного запуска.

Свойство	Значение
Default value:	False

--drain-timeout

Когда узлы вытеснены, сколько минут, чтобы дождаться вытеснения всех модулей pod.

--enable-cluster-autoscaler -e

Включите автомасштабирование кластера.

Свойство	Значение
Default value:	False

--enable-fips-image

Переключитесь на использование ОС с поддержкой FIPS на узлах агента.

Свойство	Значение
Default value:	False

--enable-secure-boot

Включите безопасную загрузку в существующем пуле узлов агента с поддержкой доверенного запуска. Должен использовать тип пула агентов vmSS или виртуальных машин.

Свойство	Значение
Default value:	False

--enable-vtpm

Включите vTPM в существующем пуле узлов агента с поддержкой доверенного запуска. Должен использовать тип пула агентов vmSS или виртуальных машин.

Свойство	Значение
Default value:	False

--gpu-driver

Нужно ли устанавливать драйвер для пула узлов GPU. Возможные значения: "Install" или "None".

Свойство	Значение
Допустимые значения:	Install, None

--if-match

--if-none-match

Установите значение "*", чтобы разрешить создание нового пула узлов, но для предотвращения обновления существующего пула узлов. Другие значения будут игнорироваться.

--labels

Метки узлов для пула узлов. См https://aka.ms/node-labels . синтаксис меток.

--localdns-config

Задайте профиль localDNS для узла с файлом конфигурации JSON.

--max-count

--max-surge

--max-unavailable

--min-count

--mode

Свойство	Значение
Допустимые значения:	Gateway, System, User

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

--node-soak-duration

--node-taints

Узел затухает пул узлов. Можно обновить существующий идентификатор узла узла или создать новый идентификатор узла для узла. Передайте пустую строку "" , чтобы удалить все признаки.

--os-sku

SKU ос пула узлов агента.

Свойство	Значение
Допустимые значения:	AzureLinux, AzureLinux3, Ubuntu, Ubuntu2204, Ubuntu2404

--scale-down-mode

Описать, как виртуальные машины добавляются в узлы или удаляются из них.

Свойство	Значение
Допустимые значения:	Deallocate, Delete

--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

--undrainable-node-behavior

--update-cluster-autoscaler -u

Обновите минимальное число или максимальное число для автомасштабирования кластера.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool update (aks-preview Расширение)

Обновление свойств пула узлов.

az aks nodepool update --cluster-name
                       --name --nodepool-name
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--batch-soak-duration]
                       [--disable-cluster-autoscaler]
                       [--disable-fips-image]
                       [--disable-secure-boot]
                       [--disable-vtpm]
                       [--drain-batch-size]
                       [--drain-timeout]
                       [--drain-timeout-bg]
                       [--enable-artifact-streaming]
                       [--enable-cluster-autoscaler]
                       [--enable-fips-image]
                       [--enable-secure-boot]
                       [--enable-vtpm]
                       [--final-soak-duration]
                       [--gpu-driver {Install, None}]
                       [--if-match]
                       [--if-none-match]
                       [--labels]
                       [--localdns-config]
                       [--max-blocked-nodes]
                       [--max-count]
                       [--max-surge]
                       [--max-unavailable]
                       [--min-count]
                       [--mode {Gateway, Machines, ManagedSystem, System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--node-vm-size]
                       [--os-sku {AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, Flatcar, Ubuntu, Ubuntu2204, Ubuntu2404}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--ssh-access {disabled, entraid, localuser}]
                       [--tags]
                       [--undrainable-node-behavior]
                       [--update-cluster-autoscaler]
                       [--upgrade-strategy {BlueGreen, Rolling}]
                       [--yes]

Примеры

Примирите узел с текущим состоянием.

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Включение автомасштабирования кластера в диапазоне счетчиков узлов [1,5]

az aks nodepool update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Отключение автомасштабирования кластера для существующего кластера

az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Обновите минимальное число или максимальное число для автомасштабирования кластера.

az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Изменение пула узлов на системный режим

az aks nodepool update --mode System -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

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

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --update-cluster-autoscaler --node-vm-size "Standard_D2s_v3" --min-count 2 --max-count 4

Обновление пула узлов с помощью параметров обновления с сине-зеленым цветом

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --drain-batch-size 50% --drain-timeout-bg 5 --batch-soak-duration 10 --final-soak-duration 10

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--aks-custom-headers

Отправка пользовательских заголовков. При указании формат должен иметь значение Key1=Value1,Key2=Value2.

--allowed-host-ports

Предварительный просмотр

--asg-ids

Предварительный просмотр

--batch-soak-duration

--disable-cluster-autoscaler -d

Отключите автомасштабирование кластера.

Свойство	Значение
Default value:	False

--disable-fips-image

Переключитесь на использование ОС с поддержкой FIPS на узлах агента.

Свойство	Значение
Default value:	False

--disable-secure-boot

Предварительный просмотр

Отключите безопасную загрузку в существующем пуле узлов агента с поддержкой доверенного запуска.

Свойство	Значение
Default value:	False

--disable-vtpm

Предварительный просмотр

Отключите vTPM в существующем пуле узлов агента с поддержкой доверенного запуска.

Свойство	Значение
Default value:	False

--drain-batch-size

Указывает количество узлов для очистки каждого пакета во время сине-зеленого обновления. Должно быть ненулевым значением либо в виде целого числа (например, "5"), либо процента (например, "50%" общего числа синих узлов в начале обновления. Дробные узлы округляются вверх. Дополнительные сведения и рекомендации см. в следующем разделе https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster.

--drain-timeout

Когда узлы вытеснены, сколько минут, чтобы дождаться вытеснения всех модулей pod.

--drain-timeout-bg

--enable-artifact-streaming

Предварительный просмотр

Свойство	Значение
Default value:	False

--enable-cluster-autoscaler -e

Включите автомасштабирование кластера. Должен использовать тип пула агентов VMSS.

Свойство	Значение
Default value:	False

--enable-fips-image

Переключитесь на использование ОС с поддержкой FIPS на узлах агента.

Свойство	Значение
Default value:	False

--enable-secure-boot

Предварительный просмотр

Включите безопасную загрузку в существующем пуле узлов агента с поддержкой доверенного запуска. Должен использовать тип пула агентов VMSS.

Свойство	Значение
Default value:	False

--enable-vtpm

Предварительный просмотр

Включите vTPM в существующем пуле узлов агента с поддержкой доверенного запуска. Должен использовать тип пула агентов VMSS.

Свойство	Значение
Default value:	False

--final-soak-duration

--gpu-driver

Нужно ли устанавливать драйвер для пула узлов GPU. Возможные значения: "Install" или "None".

Свойство	Значение
Допустимые значения:	Install, None

--if-match

--if-none-match

--labels

Метки узлов для пула узлов. См https://aka.ms/node-labels . синтаксис меток.

--localdns-config

Задайте профиль localDNS для узла с файлом конфигурации JSON.

--max-blocked-nodes

--max-count

--max-surge

--max-unavailable

--min-count

--mode

Режим пула узлов, который определяет основную функцию пула узлов. Если задано значение System, AKS предпочитает системные модули pod планирования пулов узлов с режимом System. Если задано значение ManagedSystem, все остальные свойства, кроме имени и режима, будут отклонены и управляются AKS. Узнайте больше на сайте https://aka.ms/aks/nodepool/mode.

Свойство	Значение
Допустимые значения:	Gateway, Machines, ManagedSystem, System, User

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

--node-soak-duration

--node-taints

Узел затухает пул узлов.

--node-vm-size -s

Размер виртуальной машины для узлов Kubernetes. Можно настроить только при обновлении параметров автомасштабирования пула узлов VirtualMachines.

--os-sku

SKU ос пула узлов агента.

Свойство	Значение
Допустимые значения:	AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, Flatcar, Ubuntu, Ubuntu2204, Ubuntu2404

--scale-down-mode

Описывает, как виртуальные машины добавляются в узлы или удаляются из них.

Свойство	Значение
Допустимые значения:	Deallocate, Delete

--ssh-access

Предварительный просмотр

Обновление параметра SSH для пула узлов. Используйте "отключено", чтобы отключить доступ SSH, localuser, чтобы включить доступ SSH с помощью закрытого ключа.

Свойство	Значение
Допустимые значения:	disabled, entraid, localuser

--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

--undrainable-node-behavior

--update-cluster-autoscaler -u

Обновите минимальное число или максимальное число для автомасштабирования кластера.

Свойство	Значение
Default value:	False

--upgrade-strategy

Стратегия обновления пула узлов. Допустимые значения: "Rolling" или "BlueGreen". Значение по умолчанию — "Rolling".

Свойство	Значение
Допустимые значения:	BlueGreen, Rolling

--yes -y

Не запрашивать подтверждение.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool upgrade

Изменить

Обновите пул узлов в управляемом кластере Kubernetes.

az aks nodepool upgrade --cluster-name
                        --name --nodepool-name
                        --resource-group
                        [--aks-custom-headers]
                        [--drain-timeout]
                        [--if-match]
                        [--if-none-match]
                        [--kubernetes-version]
                        [--max-surge]
                        [--max-unavailable]
                        [--no-wait]
                        [--node-image-only]
                        [--node-soak-duration]
                        [--snapshot-id]
                        [--undrainable-node-behavior]
                        [--yes]

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--aks-custom-headers

Пары "ключ-значение", разделенные запятыми, чтобы указать пользовательские заголовки.

--drain-timeout

Когда узлы вытеснены, как долго ждать вытеснения всех модулей pod.

--if-match

--if-none-match

--kubernetes-version -k

Версия Kubernetes для обновления пула узлов до версии 1.16.9.

--max-surge

Дополнительные узлы, используемые для ускорения обновления. При указании он представляет используемое число или процент, например. 5 или 33 % (взаимоисключающее с "--node-image-only". См. статью az aks nodepool update --max-surge, чтобы обновить максимальный всплеск перед обновлением с помощью "--node-image-only").

--max-unavailable

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

--node-image-only

Только образ узла пула агентов обновления.

Свойство	Значение
Default value:	False

--node-soak-duration

--snapshot-id

Исходный идентификатор моментального снимка, используемый для обновления этого узла.

--undrainable-node-behavior

--yes -y

Не запрашивать подтверждение.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool upgrade (aks-preview Расширение)

Обновите пул узлов в управляемом кластере Kubernetes.

az aks nodepool upgrade --cluster-name
                        --name --nodepool-name
                        --resource-group
                        [--aks-custom-headers]
                        [--batch-soak-duration]
                        [--drain-batch-size]
                        [--drain-timeout]
                        [--drain-timeout-bg]
                        [--final-soak-duration]
                        [--if-match]
                        [--if-none-match]
                        [--kubernetes-version]
                        [--max-blocked-nodes]
                        [--max-surge]
                        [--max-unavailable]
                        [--no-wait]
                        [--node-image-only]
                        [--node-soak-duration]
                        [--snapshot-id]
                        [--undrainable-node-behavior]
                        [--upgrade-strategy {BlueGreen, Rolling}]
                        [--yes]

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--aks-custom-headers

Отправка пользовательских заголовков. При указании формат должен иметь значение Key1=Value1,Key2=Value2.

--batch-soak-duration

--drain-batch-size

Указывает количество узлов для очистки каждого пакета во время сине-зеленого обновления. Должно быть ненулевым значением либо в виде целого числа (например, "5"), либо процента (например, "50%" общего числа синих узлов в начале обновления. Дробные узлы округляются вверх. Дополнительные сведения и рекомендации см. в следующем разделе https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster.

--drain-timeout

Когда узлы вытеснены, сколько минут, чтобы дождаться вытеснения всех модулей pod.

--drain-timeout-bg

--final-soak-duration

--if-match

--if-none-match

--kubernetes-version -k

Версия Kubernetes для обновления пула узлов, например "1.11.12".

--max-blocked-nodes

--max-surge

--max-unavailable

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

--node-image-only

Только образ узла пула агентов обновления.

Свойство	Значение
Default value:	False

--node-soak-duration

--snapshot-id

Исходный идентификатор моментального снимка, используемый для обновления этого узла. Должен использовать тип пула агентов VMSS.

--undrainable-node-behavior

--upgrade-strategy

Стратегия обновления пула узлов. Допустимые значения: "Rolling" или "BlueGreen". Значение по умолчанию — "Rolling".

Свойство	Значение
Допустимые значения:	BlueGreen, Rolling

--yes -y

Не запрашивать подтверждение.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

az aks nodepool wait

Изменить

Подождите, пока пул узлов достигнет требуемого состояния.

Если операция в пуле узлов была прервана или запущена --no-wait, используйте эту команду, чтобы дождаться завершения.

az aks nodepool wait --cluster-name
                     --name --nodepool-name
                     --resource-group
                     [--created]
                     [--custom]
                     [--deleted]
                     [--exists]
                     [--interval]
                     [--timeout]
                     [--updated]

Примеры

Подождите, пока пул узлов достигнет требуемого состояния, опрашив каждую минуту до тридцати минут.

az aks nodepool wait --created --interval 60 --cluster-name MyManagedCluster --resource-group MyResourceGroup --nodepool-name MyNodePool --timeout 1800

Обязательные параметры

--cluster-name

Имя кластера.

--name --nodepool-name -n

Имя пула узлов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--created

Подождите, пока не будет создано с помощью provisioningState по адресу "Успешно".

Свойство	Значение
Группа параметров:	Wait Condition Arguments
Default value:	False

--custom

Подождите, пока условие не будет удовлетворено пользовательским запросом JMESPath. Например, provisioningState!='InProgress', instanceView.statuses[?code='PowerState/running'].

Свойство	Значение
Группа параметров:	Wait Condition Arguments

--deleted

Дождитесь удаления.

Свойство	Значение
Группа параметров:	Wait Condition Arguments
Default value:	False

--exists

Подождите, пока ресурс не существует.

Свойство	Значение
Группа параметров:	Wait Condition Arguments
Default value:	False

--interval

Интервал опроса в секундах.

Свойство	Значение
Группа параметров:	Wait Condition Arguments
Default value:	30

--timeout

Максимальное ожидание в секундах.

Свойство	Значение
Группа параметров:	Wait Condition Arguments
Default value:	3600

--updated

Подождите, пока не будет обновлено с помощью provisioningState по адресу "Успешно".

Свойство	Значение
Группа параметров:	Wait Condition Arguments
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Свойство	Значение
Default value:	False

Обратная связь

Были ли сведения на этой странице полезными?

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

az aks nodepool

Команды

az aks nodepool add

Примеры

Обязательные параметры

Необязательные параметры

az aks nodepool add (aks-preview Расширение)

Примеры

Обязательные параметры

Необязательные параметры

az aks nodepool delete

Примеры

Обязательные параметры

Необязательные параметры

az aks nodepool delete (aks-preview Расширение)

Примеры

Обязательные параметры

Необязательные параметры

az aks nodepool delete-machines

Примеры

Обязательные параметры

Необязательные параметры

az aks nodepool delete-machines (aks-preview Расширение)

Примеры

Обязательные параметры

Необязательные параметры

az aks nodepool get-rollback-versions

Примеры

Обязательные параметры

az aks nodepool get-upgrades

Примеры

Обязательные параметры

az aks nodepool get-upgrades (aks-preview Расширение)

Примеры

Обязательные параметры

az aks nodepool list

Обязательные параметры

az aks nodepool list (aks-preview Расширение)

Обязательные параметры

az aks nodepool operation-abort

Примеры

Обязательные параметры

Необязательные параметры

az aks nodepool operation-abort (aks-preview Расширение)

Примеры

Обязательные параметры

Необязательные параметры

az aks nodepool rollback

Примеры

Обязательные параметры

Необязательные параметры

az aks nodepool scale

Обязательные параметры

Необязательные параметры

az aks nodepool scale (aks-preview Расширение)

Обязательные параметры

Необязательные параметры

az aks nodepool show

Обязательные параметры

az aks nodepool show (aks-preview Расширение)

Обязательные параметры

az aks nodepool start

Примеры

Обязательные параметры

Необязательные параметры

az aks nodepool start (aks-preview Расширение)

Примеры

Обязательные параметры

Необязательные параметры

az aks nodepool stop

Примеры

Обязательные параметры

Необязательные параметры

az aks nodepool stop (aks-preview Расширение)

Примеры

Обязательные параметры

Необязательные параметры

az aks nodepool update

Примеры