Kube Environments - Create Or Update

Tjänst:: App Service

API-version:: 2026-07-15

Beskrivning för Skapar eller uppdaterar en Kubernetes-miljö.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
name	path	True	string	Namnet på Kubernetes-miljön.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Obligatorisk	Typ	Description
location	True	string	Den geo-plats där resursen finns
extendedLocation		ExtendedLocation	Utökad plats.
kind		string	Typ av resurs.
properties.aksResourceID		string
properties.appLogsConfiguration		AppLogsConfiguration	Klusterkonfiguration som gör det möjligt för loggdaemonen att exportera apploggar till ett mål. För närvarande stöds endast "log-analytics"
properties.arcConfiguration		ArcConfiguration	Klusterkonfiguration som avgör typerna av ARC-klusterkomponenter. T.ex.: Välja mellan BuildService-typ, FrontEnd-tjänst, ArtifactsStorageType, etc.
properties.containerAppsConfiguration		ContainerAppsConfiguration	Klusterkonfiguration för Container Apps-miljöer för att konfigurera Dapr Instrumentation Key och VNET-konfiguration
properties.environmentType		string	Typ av Kubernetes-miljö. Stöds endast för containerappmiljöer med värdet Hanterad
properties.internalLoadBalancerEnabled		boolean	Endast synligt i Vnet/undernät
properties.staticIp		string	Statisk IP för KubeEnvironment
tags		object	Resursetiketter.

Svar

Name	Typ	Description
200 OK	KubeEnvironment	Resursens 'KubeEnvironment'-uppdateringsoperation lyckades
201 Created	KubeEnvironment	Resursen 'KubeEnvironment' skapade en framgångsrik operation Sidhuvuden Location: string Retry-After: integer
Other Status Codes	DefaultErrorResponse	Ett oväntat felsvar.

Name

Typ

Description

200 OK

KubeEnvironment

Resursens 'KubeEnvironment'-uppdateringsoperation lyckades

201 Created

KubeEnvironment

Resursen 'KubeEnvironment' skapade en framgångsrik operation

Sidhuvuden

Location: string
Retry-After: integer

Other Status Codes

DefaultErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Create kube environments

Exempelbegäran

HTTP

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

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

Exempelsvar

Statuskod:: 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": {}
}

Statuskod:: 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": {}
}

Definitioner

Name	Description
AppLogsConfiguration
ArcConfiguration
ContainerAppsConfiguration
createdByType	Den typ av identitet som skapade resursen.
DefaultErrorResponse	App Service-felsvar.
DefaultErrorResponseError	Felmodell.
DefaultErrorResponseErrorDetailsItem	Detaljerade fel.
ExtendedLocation	Utökad plats.
FrontEndConfiguration
FrontEndServiceType
KubeEnvironment	Ett Kubernetes-kluster specialiserat för webbarbetsbelastningar av Azure App Service
KubeEnvironmentProvisioningState	Etableringstillstånd för Kubernetes-miljön.
LogAnalyticsConfiguration
StorageType
systemData	Metadata som rör skapande och senaste ändring av resursen.

AppLogsConfiguration

Objekt

Name	Typ	Description
destination	string
logAnalyticsConfiguration	LogAnalyticsConfiguration

ArcConfiguration

Objekt

Name	Typ	Description
artifactStorageAccessMode	string
artifactStorageClassName	string
artifactStorageMountPath	string
artifactStorageNodeName	string
artifactsStorageType	StorageType
frontEndServiceConfiguration	FrontEndConfiguration
kubeConfig	string (password)

ContainerAppsConfiguration

Objekt

Name	Typ	Description
appSubnetResourceId	string	Resurs-ID för ett undernät för kontrollplansinfrastrukturkomponenter. Det här undernätet måste finnas i samma VNET som det undernät som definierats i appSubnetResourceId. Får inte överlappa med DET IP-intervall som definierats i platformReservedCidr, om det definieras.
controlPlaneSubnetResourceId	string	Resurs-ID för ett undernät för kontrollplansinfrastrukturkomponenter. Det här undernätet måste finnas i samma VNET som det undernät som definierats i appSubnetResourceId. Får inte överlappa med DET IP-intervall som definierats i platformReservedCidr, om det definieras.
daprAIInstrumentationKey	string	Azure Monitor-instrumentationsnyckel som används av Dapr för att exportera telemetri för tjänst-till-tjänstkommunikation
dockerBridgeCidr	string	IP-intervall för CIDR-notation som tilldelats Docker-bryggnätverket. Den får inte överlappa med några IP-intervall för undernätet eller det IP-intervall som definierats i platformReservedCidr, om det definieras.
platformReservedCidr	string	IP-intervall i CIDR-notation som kan reserveras för IP-adresser för miljöinfrastruktur. Den får inte överlappa andra IP-intervall för undernätet.
platformReservedDnsIP	string	En IP-adress från IP-intervallet som definieras av platformReservedCidr som kommer att reserveras för den interna DNS-servern

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Objekt

App Service-felsvar.

Name	Typ	Description
error	DefaultErrorResponseError	Felmodell.

DefaultErrorResponseError

Objekt

Felmodell.

Name	Typ	Description
code	string	Standardiserad sträng för att programmatiskt identifiera felet.
details	DefaultErrorResponseErrorDetailsItem[]	Detaljerade fel.
innererror	string	Mer information för att felsöka fel.
message	string	Detaljerad felbeskrivning och felsökningsinformation.
target	string	Detaljerad felbeskrivning och felsökningsinformation.

DefaultErrorResponseErrorDetailsItem

Objekt

Detaljerade fel.

Name	Typ	Description
code	string	Standardiserad sträng för att programmatiskt identifiera felet.
message	string	Detaljerad felbeskrivning och felsökningsinformation.
target	string	Detaljerad felbeskrivning och felsökningsinformation.

ExtendedLocation

Objekt

Utökad plats.

Name	Typ	Description
name	string	Namn på utökad plats.
type	string	Typ av utökad plats.

FrontEndConfiguration

Objekt

Name	Typ	Description
kind	FrontEndServiceType

FrontEndServiceType

Uppräkning

Värde	Description
NodePort
LoadBalancer