Kube Environments - Create Or Update

Служба:: App Service

Версия API:: 2026-03-15

Описание для Создание или обновление среды Kubernetes.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/kubeEnvironments/{name}?api-version=2026-03-15

Параметры URI

Имя	В	Обязательно	Тип	Описание
name	path	True	string	Имя среды Kubernetes.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя регистронезависимо.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

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

Имя	Обязательно	Тип	Описание
location	True	string	Географическое расположение, в котором находится ресурс
extendedLocation		ExtendedLocation	Расширенное расположение.
kind		string	Тип ресурса.
properties.aksResourceID		string
properties.appLogsConfiguration		AppLogsConfiguration	Конфигурация кластера, которая позволяет управляющей программе журнала экспортировать журналы приложений в место назначения. В настоящее время поддерживается только "log-analytics"
properties.arcConfiguration		ArcConfiguration	Конфигурация кластера, определяющая типы компонентов кластера ARC. Например: выбор между типом BuildService, FrontEnd Service ArtifactsStorageType и т.д.
properties.containerAppsConfiguration		ContainerAppsConfiguration	Конфигурация кластера для сред контейнеров для настройки ключа инструментирования Dapr и конфигурации виртуальной сети
properties.environmentType		string	Тип среды Kubernetes. Поддерживается только для сред приложений-контейнеров со значением как Управляемое
properties.internalLoadBalancerEnabled		boolean	Только видимые в виртуальной сети или подсети
properties.staticIp		string	Статический IP-адрес KubeEnvironment
tags		object	Теги ресурсов.

Ответы

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

Имя

Тип

Описание

200 OK

KubeEnvironment

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

201 Created

KubeEnvironment

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

Заголовки

Location: string
Retry-After: integer

Other Status Codes

DefaultErrorResponse

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

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

azure_auth

Поток OAuth2 в Azure Active Directory.

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

Области

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

Примеры

Create kube environments

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

HTTP

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.Web/kubeEnvironments/testkubeenv?api-version=2026-03-15

{
  "location": "East US",
  "properties": {
    "staticIp": "1.2.3.4"
  }
}

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

Код состояния:: 200

{
  "name": "testkubeenv",
  "type": "Microsoft.Web/kubeEnvironments",
  "extendedLocation": {
    "name": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.ExtendedLocation/customLocations/testcustomlocation",
    "type": "customLocation"
  },
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.Web/kubeEnvironments/testkubeenv",
  "location": "East US",
  "properties": {
    "aksResourceID": "test",
    "appLogsConfiguration": null,
    "arcConfiguration": null,
    "defaultDomain": "testkubeenv.k4apps.io",
    "deploymentErrors": null,
    "internalLoadBalancerEnabled": false,
    "provisioningState": "Succeeded",
    "staticIp": "1.2.3.4"
  },
  "tags": {}
}

Код состояния:: 201

{
  "name": "testkubeenv",
  "type": "Microsoft.Web/kubeEnvironments",
  "extendedLocation": {
    "name": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.ExtendedLocation/customLocations/testcustomlocation",
    "type": "customLocation"
  },
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.Web/kubeEnvironments/testkubeenv",
  "location": "East US",
  "properties": {
    "aksResourceID": "test",
    "appLogsConfiguration": null,
    "arcConfiguration": null,
    "defaultDomain": "testkubeenv.k4apps.io",
    "deploymentErrors": null,
    "internalLoadBalancerEnabled": false,
    "provisioningState": "InitializationInProgress",
    "staticIp": "1.2.3.4"
  },
  "tags": {}
}

Определения

Имя	Описание
AppLogsConfiguration
ArcConfiguration
ContainerAppsConfiguration
createdByType	Тип удостоверения, создавшего ресурс.
DefaultErrorResponse	Ответ об ошибке службы приложений.
DefaultErrorResponseError	Модель ошибок.
DefaultErrorResponseErrorDetailsItem	Подробные ошибки.
ExtendedLocation	Расширенное расположение.
FrontEndConfiguration
FrontEndServiceType
KubeEnvironment	A Kubernetes cluster specialized for web workloads by Служба приложений Azure
KubeEnvironmentProvisioningState	Состояние подготовки среды Kubernetes.
LogAnalyticsConfiguration
StorageType
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

AppLogsConfiguration

Объект

Имя	Тип	Описание
destination	string
logAnalyticsConfiguration	LogAnalyticsConfiguration

ArcConfiguration

Объект

Имя	Тип	Описание
artifactStorageAccessMode	string
artifactStorageClassName	string
artifactStorageMountPath	string
artifactStorageNodeName	string
artifactsStorageType	StorageType
frontEndServiceConfiguration	FrontEndConfiguration
kubeConfig	string (password)

ContainerAppsConfiguration

Объект

Имя	Тип	Описание
appSubnetResourceId	string	Идентификатор ресурса подсети для компонентов инфраструктуры плоскости управления. Эта подсеть должна находиться в той же виртуальной сети, что и подсеть, определенная в appSubnetResourceId. Не должно перекрываться с диапазоном IP-адресов, определенным в platformReservedCidr, если определено.
controlPlaneSubnetResourceId	string	Идентификатор ресурса подсети для компонентов инфраструктуры плоскости управления. Эта подсеть должна находиться в той же виртуальной сети, что и подсеть, определенная в appSubnetResourceId. Не должно перекрываться с диапазоном IP-адресов, определенным в platformReservedCidr, если определено.
daprAIInstrumentationKey	string	Ключ инструментирования Azure Monitor, используемый Dapr для экспорта службы в телеметрию связи службы
dockerBridgeCidr	string	Диапазон IP-адресов нотации CIDR, назначенный сети моста Docker. При определении он не должен перекрываться с диапазонами IP-адресов подсети или диапазоном IP-адресов, определенным в platformReservedCidr.
platformReservedCidr	string	Диапазон IP-адресов в нотации CIDR, который можно зарезервировать для IP-адресов инфраструктуры среды. Он не должен перекрываться с другими диапазонами IP-адресов подсети.
platformReservedDnsIP	string	IP-адрес из диапазона IP-адресов, определенный платформойReservedCidr, который будет зарезервирован для внутреннего DNS-сервера.

createdByType

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

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

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

DefaultErrorResponse

Объект

Ответ об ошибке службы приложений.

Имя	Тип	Описание
error	DefaultErrorResponseError	Модель ошибок.

DefaultErrorResponseError

Объект

Модель ошибок.

Имя	Тип	Описание
code	string	Стандартизированная строка для программной идентификации ошибки.
details	DefaultErrorResponseErrorDetailsItem[]	Подробные ошибки.
innererror	string	Дополнительная информация об ошибке отладки.
message	string	Подробное описание ошибки и информация об отладке.
target	string	Подробное описание ошибки и информация об отладке.

DefaultErrorResponseErrorDetailsItem

Объект

Подробные ошибки.

Имя	Тип	Описание
code	string	Стандартизированная строка для программной идентификации ошибки.
message	string	Подробное описание ошибки и информация об отладке.
target	string	Подробное описание ошибки и информация об отладке.

ExtendedLocation

Объект

Расширенное расположение.

Имя	Тип	Описание
name	string	Имя расширенного расположения.
type	string	Тип расширенной локации.

FrontEndConfiguration

Объект

Имя	Тип	Описание
kind	FrontEndServiceType

FrontEndServiceType

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

Значение	Описание
NodePort
LoadBalancer