Kube Environments - Create Or Update

Reference

Service:: App Service

API Version:: 2023-12-01

Popis pro Vytvoření nebo aktualizace prostředí Kubernetes.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
name	path	True	string	Název prostředí Kubernetes.
resourceGroupName	path	True	string	Název skupiny prostředků, do které prostředek patří. Regex pattern: `^[-\w\._]+[^\.]$`
subscriptionId	path	True	string	ID vašeho předplatného Azure Jedná se o řetězec ve formátu GUID (např. 00000000-0000-0000-0000-00000000000000000).
api-version	query	True	string	Verze rozhraní API

Text požadavku

Name	Vyžadováno	Typ	Description
location	True	string	Umístění prostředku.
extendedLocation		ExtendedLocation	Rozšířené umístění.
kind		string	Druh prostředku.
properties.aksResourceID		string
properties.appLogsConfiguration		AppLogsConfiguration	Konfigurace clusteru, která umožňuje démonovi protokolu exportovat protokoly aplikace do cíle. V současné době se podporuje jenom log-analytics.
properties.arcConfiguration		ArcConfiguration	Konfigurace clusteru, která určuje typy komponent clusteru ARC. Například: Volba mezi typem BuildService, FrontEnd Service ArtifactsStorageType atd.
properties.containerAppsConfiguration		ContainerAppsConfiguration	Konfigurace clusteru pro prostředí aplikací kontejneru pro konfiguraci instrumentačního klíče Dapr a konfigurace virtuální sítě
properties.environmentType		string	Typ prostředí Kubernetes. Podporováno pouze pro prostředí aplikací kontejneru s hodnotou Spravované
properties.internalLoadBalancerEnabled		boolean	Viditelné pouze v rámci virtuální sítě nebo podsítě
properties.staticIp		string	Statická IP adresa prostředí KubeEnvironment
tags		object	Značky prostředků.

Odpovědi

Name	Typ	Description
200 OK	KubeEnvironment	OK
201 Created	KubeEnvironment	Vytvořeno
Other Status Codes	DefaultErrorResponse	App Service odpověď na chybu.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Create kube environments

Sample Request

HTTP

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

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

Sample Response

Status code:: 200

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

Status code:: 201

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

Definice

Name	Description
AppLogsConfiguration
ArcConfiguration
ContainerAppsConfiguration
DefaultErrorResponse	App Service odpověď na chybu.
Details
Error	Model chyb.
ExtendedLocation	Rozšířené umístění.
FrontEndConfiguration
FrontEndServiceType
KubeEnvironment	Cluster Kubernetes specializovaný na webové úlohy Azure App Service
KubeEnvironmentProvisioningState	Stav zřizování prostředí Kubernetes
LogAnalyticsConfiguration
StorageType

AppLogsConfiguration

Name	Typ	Description
destination	string
logAnalyticsConfiguration	LogAnalyticsConfiguration

ArcConfiguration

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

ContainerAppsConfiguration

Name	Typ	Description
appSubnetResourceId	string	ID prostředku podsítě pro komponenty infrastruktury řídicí roviny Tato podsíť musí být ve stejné virtuální síti jako podsíť definovaná v appSubnetResourceId. Nesmí se překrývat s rozsahem IP adres definovaným v platformReservedCidr, pokud je definován.
controlPlaneSubnetResourceId	string	ID prostředku podsítě pro komponenty infrastruktury řídicí roviny Tato podsíť musí být ve stejné virtuální síti jako podsíť definovaná v appSubnetResourceId. Nesmí se překrývat s rozsahem IP adres definovaným v platformReservedCidr, pokud je definován.
daprAIInstrumentationKey	string	Instrumentační klíč služby Azure Monitor používaný nástrojem Dapr k exportu telemetrie komunikace mezi službami
dockerBridgeCidr	string	Rozsah IP adres notace CIDR přiřazený síti mostu Docker. Nesmí se překrývat s žádnými rozsahy IP adres podsítě nebo rozsahem IP adres definovaným v platformReservedCidr, pokud je definován.
platformReservedCidr	string	Rozsah IP adres v zápisu CIDR, který může být vyhrazen pro IP adresy infrastruktury prostředí. Nesmí se překrývat s jinými rozsahy IP adres podsítě.
platformReservedDnsIP	string	IP adresa z rozsahu IP adres definovaného platformReservedCidr, která bude vyhrazena pro interní server DNS.

DefaultErrorResponse

App Service odpověď na chybu.

Name	Typ	Description
error	Error	Model chyb.

Details

Name	Typ	Description
code	string	Standardizovaný řetězec pro programovou identifikaci chyby
message	string	Podrobný popis chyby a informace o ladění
target	string	Podrobný popis chyby a informace o ladění

Error

Model chyb.

Name	Typ	Description
code	string	Standardizovaný řetězec pro programovou identifikaci chyby
details	Details[]	Podrobné chyby.
innererror	string	Další informace o chybě ladění
message	string	Podrobný popis chyby a informace o ladění
target	string	Podrobný popis chyby a informace o ladění

ExtendedLocation

Rozšířené umístění.

Name	Typ	Description
name	string	Název rozšířeného umístění
type	string	Typ rozšířeného umístění

FrontEndConfiguration

Name	Typ	Description
kind	FrontEndServiceType

FrontEndServiceType

Name	Typ	Description
LoadBalancer	string
NodePort	string

KubeEnvironment

Cluster Kubernetes specializovaný na webové úlohy Azure App Service

Name	Typ	Description
extendedLocation	ExtendedLocation	Rozšířené umístění.
id	string	ID prostředku.
kind	string	Druh prostředku.
location	string	Umístění prostředku.
name	string	Název prostředku.
properties.aksResourceID	string
properties.appLogsConfiguration	AppLogsConfiguration	Konfigurace clusteru, která umožňuje démonovi protokolu exportovat protokoly aplikace do cíle. V současné době se podporuje jenom log-analytics.
properties.arcConfiguration	ArcConfiguration	Konfigurace clusteru, která určuje typy komponent clusteru ARC. Například: Volba mezi typem BuildService, FrontEnd Service ArtifactsStorageType atd.
properties.containerAppsConfiguration	ContainerAppsConfiguration	Konfigurace clusteru pro prostředí aplikací kontejneru pro konfiguraci instrumentačního klíče Dapr a konfigurace virtuální sítě
properties.defaultDomain	string	Výchozí název domény pro cluster
properties.deploymentErrors	string	Všechny chyby, ke kterým došlo během nasazení nebo ověřování nasazení
properties.environmentType	string	Typ prostředí Kubernetes. Podporováno pouze pro prostředí aplikací kontejneru s hodnotou Spravované
properties.internalLoadBalancerEnabled	boolean	Viditelné pouze v rámci virtuální sítě nebo podsítě
properties.provisioningState	KubeEnvironmentProvisioningState	Stav zřizování prostředí Kubernetes
properties.staticIp	string	Statická IP adresa prostředí KubeEnvironment
tags	object	Značky prostředků.
type	string	Typ prostředku.

KubeEnvironmentProvisioningState

Stav zřizování prostředí Kubernetes

Name	Typ	Description
Canceled	string
Failed	string
InfrastructureSetupComplete	string
InfrastructureSetupInProgress	string
InitializationInProgress	string
ScheduledForDelete	string
Succeeded	string
UpgradeFailed	string
UpgradeRequested	string
Waiting	string

LogAnalyticsConfiguration

Name	Typ	Description
customerId	string
sharedKey	string

StorageType

Name	Typ	Description
LocalNode	string
NetworkFileSystem	string