Load Balancers - Create Or Update

Служба:
AKS
Версия API:
2026-03-02-preview

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

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/loadBalancers/{loadBalancerName}?api-version=2026-03-02-preview

Параметры URI

Имя В Обязательно Тип Описание
loadBalancerName
 path True

string

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

Имя подсистемы балансировки нагрузки.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя регистронезависимо.
resourceName
 path True

string

minLength: 1
maxLength: 63
pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$

Имя ресурса управляемого кластера.
subscriptionId
 path True

string (uuid)

Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version
 query True

string

minLength: 1

Версия API, используемая для данной операции.

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

Имя Обязательно Тип Описание
properties.primaryAgentPoolName True

string

Обязательное поле. Строковое значение, которое должно указывать идентификатор существующего пула агентов. Все узлы в данном пуле всегда будут добавлены в этот подсистему балансировки нагрузки. Этот пул агентов должен иметь по крайней мере один узел и minCount>=1 для операций автомасштабирования. Пул агентов может быть только основным пулом для одной подсистемы балансировки нагрузки.
properties.allowServicePlacement

boolean

Следует ли автоматически размещать службы в подсистеме балансировки нагрузки. Если он не указан, значение по умолчанию имеет значение true. Если задано значение false вручную, внешний и внутренний подсистемы балансировки нагрузки не будут выбраны для служб, если они явно не нацелены на него.
properties.nodeSelector

LabelSelector

Узлы, соответствующие этому селектору, будут возможными членами этой подсистемы балансировки нагрузки.
properties.serviceLabelSelector

LabelSelector

На этом балансировщике нагрузки можно поместить только службы, которые должны соответствовать этому селектору.
properties.serviceNamespaceSelector

LabelSelector

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

Ответы

Имя Тип Описание
200 OK

LoadBalancer

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

LoadBalancer

Операция создания ресурса 'LoadBalancer' успешно выполнена
Other Status Codes

ErrorResponse

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

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

azure_auth

Поток OAuth2 в Azure Active Directory.

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

Области

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

Примеры

Create or update a Load Balancer

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

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/loadBalancers/kubernetes?api-version=2026-03-02-preview

{
  "properties": {
    "allowServicePlacement": true,
    "primaryAgentPoolName": "agentpool1"
  }
}

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

Код состояния:
200 
{
  "name": "kubernetes",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/loadBalancers/kubernetes",
  "properties": {
    "allowServicePlacement": true,
    "primaryAgentPoolName": "agentpool1",
    "provisioningState": "Succeeded"
  }
}
Код состояния:
201 
{
  "name": "kubernetes",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/loadBalancers/kubernetes",
  "properties": {
    "allowServicePlacement": true,
    "primaryAgentPoolName": "agentpool1",
    "provisioningState": "Succeeded"
  }
}

Определения

Имя Описание
createdByType

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

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

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

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

Селектор меток — это запрос меток по набору ресурсов. Результат сопоставленияLabels и matchExpressions — ANDed. Пустой селектор меток соответствует всем объектам. Селектор меток NULL не соответствует объектам.
LabelSelectorRequirement

Требование селектора меток — это селектор, содержащий значения, ключ и оператор, связанный с ключом и значениями.
LoadBalancer

Конфигурации, касающиеся нескольких стандартных подсистем балансировки нагрузки. Если он не указан, будет использоваться режим единого балансировщика нагрузки. При аренде одной конфигурации будет использоваться несколько стандартных режимов балансировки нагрузки. Должна быть конфигурация с именем kubernetes. Поле имени будет именем соответствующего общедоступного балансировщика нагрузки. При необходимости будет создана внутренняя подсистема балансировки нагрузки, а имя будет <name>-internal. Внутренняя балансировка нагрузки использует те же конфигурации, что и внешний. Внутренние lbs не требуются для включения в список LoadBalancer.
Operator

оператор представляет связь ключа с набором значений. Допустимые операторы In и NotIn
systemData

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

createdByType

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

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

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

ErrorAdditionalInfo

Объект

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

Имя Тип Описание
info

object

Дополнительные сведения.
type

string

Дополнительный тип сведений.

ErrorDetail

Объект

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

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.
code

string

Код ошибки.
details

ErrorDetail[]

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

string

Сообщение об ошибке.
target

string

Целевой объект ошибки.

ErrorResponse

Объект

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

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

LabelSelector

Объект

Селектор меток — это запрос меток по набору ресурсов. Результат сопоставленияLabels и matchExpressions — ANDed. Пустой селектор меток соответствует всем объектам. Селектор меток NULL не соответствует объектам.

Имя Тип Описание
matchExpressions

LabelSelectorRequirement[]

matchExpressions — это список требований селектора меток. Требования являются ANDed.
matchLabels

string[]

matchLabels — это массив пар {key=value}. Один объект {key=value} в карте matchLabels эквивалентен элементу matchExpressions, поле ключа которого key, оператор In, а массив значений содержит только value. Требования являются ANDed.

LabelSelectorRequirement

Объект

Требование селектора меток — это селектор, содержащий значения, ключ и оператор, связанный с ключом и значениями.

Имя Тип Описание
key

string

ключ метки, к которому применяется селектор.
operator

Operator

оператор представляет связь ключа с набором значений. Допустимые операторы In и NotIn
values

string[]

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

LoadBalancer

Объект

Конфигурации, касающиеся нескольких стандартных подсистем балансировки нагрузки. Если он не указан, будет использоваться режим единого балансировщика нагрузки. При аренде одной конфигурации будет использоваться несколько стандартных режимов балансировки нагрузки. Должна быть конфигурация с именем kubernetes. Поле имени будет именем соответствующего общедоступного балансировщика нагрузки. При необходимости будет создана внутренняя подсистема балансировки нагрузки, а имя будет <name>-internal. Внутренняя балансировка нагрузки использует те же конфигурации, что и внешний. Внутренние lbs не требуются для включения в список LoadBalancer.

Имя Тип Описание
id

string (arm-id)

Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name

string

Имя ресурса
properties.allowServicePlacement

boolean

Следует ли автоматически размещать службы в подсистеме балансировки нагрузки. Если он не указан, значение по умолчанию имеет значение true. Если задано значение false вручную, внешний и внутренний подсистемы балансировки нагрузки не будут выбраны для служб, если они явно не нацелены на него.
properties.nodeSelector

LabelSelector

Узлы, соответствующие этому селектору, будут возможными членами этой подсистемы балансировки нагрузки.
properties.primaryAgentPoolName

string

Обязательное поле. Строковое значение, которое должно указывать идентификатор существующего пула агентов. Все узлы в данном пуле всегда будут добавлены в этот подсистему балансировки нагрузки. Этот пул агентов должен иметь по крайней мере один узел и minCount>=1 для операций автомасштабирования. Пул агентов может быть только основным пулом для одной подсистемы балансировки нагрузки.
properties.provisioningState

string

Текущее состояние подготовки.
properties.serviceLabelSelector

LabelSelector

На этом балансировщике нагрузки можно поместить только службы, которые должны соответствовать этому селектору.
properties.serviceNamespaceSelector

LabelSelector

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

systemData

Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
type

string

Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

Operator

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

оператор представляет связь ключа с набором значений. Допустимые операторы In и NotIn

Значение Описание
In

Значение ключа должно находиться в указанном списке.
NotIn

Значение ключа не должно находиться в указанном списке.
Exists

Значение ключа должно существовать.
DoesNotExist

Значение ключа не должно существовать.

systemData

Объект

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

Имя Тип Описание
createdAt

string (date-time)

Метка времени создания ресурса (UTC).
createdBy

string

Удостоверение, создающее ресурс.
createdByType

createdByType

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

string (date-time)

Метка времени последнего изменения ресурса (UTC)
lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.
lastModifiedByType

createdByType

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