Kube Environments - Create Or Update

Opis tworzenia lub aktualizowania środowiska Kubernetes.

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

Parametry identyfikatora URI

Name In Required Type Description
name
path True
  • string

Nazwa środowiska Kubernetes.

resourceGroupName
path True
  • string

Nazwa grupy zasobów, do której należy zasób.

Regex pattern: ^[-\w\._\(\)]+[^\.]$

subscriptionId
path True
  • string

Identyfikator subskrypcji platformy Azure. Jest to ciąg w formacie GUID (np. 00000000-0000-0000-0000-0000-0000000000000).

api-version
query True
  • string

Wersja interfejsu API

Treść żądania

Name Required Type Description
location True
  • string

Lokalizacja zasobu.

extendedLocation

Lokalizacja rozszerzona.

kind
  • string

Rodzaj zasobu.

properties.aksResourceID
  • string
properties.appLogsConfiguration

Konfiguracja klastra, która umożliwia demonowi dziennika eksportowanie dzienników do miejsca docelowego. Obecnie obsługiwane są tylko "log-analytics"

properties.arcConfiguration

Konfiguracja klastra, która określa typy składników klastra ARC. Na przykład: wybór między rodzajem buildService, artefaktami usługi FrontEndStorageType itp.

properties.containerAppsConfiguration

Konfiguracja klastra dla środowisk usługi Container Apps w celu skonfigurowania klucza instrumentacji Dapr i konfiguracji sieci wirtualnej

properties.environmentType
  • string

Typ środowiska Kubernetes. Obsługiwane tylko w środowiskach aplikacji kontenera z wartością zarządzaną

properties.internalLoadBalancerEnabled
  • boolean

Widoczne tylko w sieci wirtualnej/podsieci

properties.staticIp
  • string

Statyczny adres IP platformy KubeEnvironment

tags
  • object

Tagi zasobów.

Odpowiedzi

Name Type Description
200 OK

OK

201 Created

Utworzone

Other Status Codes

App Service odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Scopes

Name Description
user_impersonation personifikacja konta użytkownika

Przykłady

Create kube environments

Sample Request

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

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

Sample Response

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

Definicje

AppLogsConfiguration
ArcConfiguration
ContainerAppsConfiguration
DefaultErrorResponse

App Service odpowiedź na błąd.

Details
Error

Model błędu.

ExtendedLocation

Lokalizacja rozszerzona.

FrontEndConfiguration
FrontEndServiceType
KubeEnvironment

Klaster Kubernetes przeznaczony dla obciążeń internetowych przez Azure App Service

KubeEnvironmentProvisioningState

Stan aprowizacji środowiska Kubernetes.

LogAnalyticsConfiguration
StorageType

AppLogsConfiguration

Name Type Description
destination
  • string
logAnalyticsConfiguration

ArcConfiguration

Name Type Description
artifactStorageAccessMode
  • string
artifactStorageClassName
  • string
artifactStorageMountPath
  • string
artifactStorageNodeName
  • string
artifactsStorageType
frontEndServiceConfiguration
kubeConfig
  • string

ContainerAppsConfiguration

Name Type Description
appSubnetResourceId
  • string

Identyfikator zasobu podsieci dla składników infrastruktury płaszczyzny sterowania. Ta podsieć musi znajdować się w tej samej sieci wirtualnej co podsieć zdefiniowana w parametrze appSubnetResourceId. Nie może nakładać się na zakres adresów IP zdefiniowany w polu PlatformReservedCidr, jeśli jest zdefiniowany.

controlPlaneSubnetResourceId
  • string

Identyfikator zasobu podsieci dla składników infrastruktury płaszczyzny sterowania. Ta podsieć musi znajdować się w tej samej sieci wirtualnej co podsieć zdefiniowana w parametrze appSubnetResourceId. Nie może nakładać się na zakres adresów IP zdefiniowany w polu PlatformReservedCidr, jeśli jest zdefiniowany.

daprAIInstrumentationKey
  • string

Klucz instrumentacji usługi Azure Monitor używany przez dapr do eksportowania danych telemetrycznych komunikacji między usługami

dockerBridgeCidr
  • string

Zakres adresów IP notacji CIDR przypisany do sieci mostka platformy Docker. Nie może pokrywać się z żadnymi zakresami adresów IP podsieci ani zakresem adresów IP zdefiniowanymi w polu PlatformReservedCidr, jeśli jest zdefiniowana.

platformReservedCidr
  • string

Zakres adresów IP w notacji CIDR, który można zarezerwować dla adresów IP infrastruktury środowiska. Nie może pokrywać się z żadnymi innymi zakresami adresów IP podsieci.

platformReservedDnsIP
  • string

Adres IP z zakresu adresów IP zdefiniowany przez platformęReservedCidr, który będzie zarezerwowany dla wewnętrznego serwera DNS

DefaultErrorResponse

App Service odpowiedź na błąd.

Name Type Description
error

Model błędu.

Details

Name Type Description
code
  • string

Ustandaryzowany ciąg w celu programowego identyfikowania błędu.

message
  • string

Szczegółowy opis błędu i informacje o debugowaniu.

target
  • string

Szczegółowy opis błędu i informacje o debugowaniu.

Error

Model błędu.

Name Type Description
code
  • string

Ustandaryzowany ciąg w celu programowego identyfikowania błędu.

details

Szczegółowe błędy.

innererror
  • string

Więcej informacji na temat debugowania błędu.

message
  • string

Szczegółowy opis błędu i informacje o debugowaniu.

target
  • string

Szczegółowy opis błędu i informacje o debugowaniu.

ExtendedLocation

Lokalizacja rozszerzona.

Name Type Description
name
  • string

Nazwa lokalizacji rozszerzonej.

type
  • string

Typ lokalizacji rozszerzonej.

FrontEndConfiguration

Name Type Description
kind

FrontEndServiceType

Name Type Description
LoadBalancer
  • string
NodePort
  • string

KubeEnvironment

Klaster Kubernetes przeznaczony dla obciążeń internetowych przez Azure App Service

Name Type Description
extendedLocation

Lokalizacja rozszerzona.

id
  • string

Identyfikator zasobu.

kind
  • string

Rodzaj zasobu.

location
  • string

Lokalizacja zasobu.

name
  • string

Nazwa zasobu.

properties.aksResourceID
  • string
properties.appLogsConfiguration

Konfiguracja klastra, która umożliwia demonowi dziennika eksportowanie dzienników do miejsca docelowego. Obecnie obsługiwane są tylko "log-analytics"

properties.arcConfiguration

Konfiguracja klastra, która określa typy składników klastra ARC. Na przykład: wybór między rodzajem buildService, artefaktami usługi FrontEndStorageType itp.

properties.containerAppsConfiguration

Konfiguracja klastra dla środowisk usługi Container Apps w celu skonfigurowania klucza instrumentacji Dapr i konfiguracji sieci wirtualnej

properties.defaultDomain
  • string

Domyślna nazwa domeny klastra

properties.deploymentErrors
  • string

Wszelkie błędy, które wystąpiły podczas wdrażania lub walidacji wdrożenia

properties.environmentType
  • string

Typ środowiska Kubernetes. Obsługiwane tylko w środowiskach aplikacji kontenera z wartością zarządzaną

properties.internalLoadBalancerEnabled
  • boolean

Widoczne tylko w sieci wirtualnej/podsieci

properties.provisioningState

Stan aprowizacji środowiska Kubernetes.

properties.staticIp
  • string

Statyczny adres IP platformy KubeEnvironment

tags
  • object

Tagi zasobów.

type
  • string

Typ zasobu.

KubeEnvironmentProvisioningState

Stan aprowizacji środowiska Kubernetes.

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

LogAnalyticsConfiguration

Name Type Description
customerId
  • string
sharedKey
  • string

StorageType

Name Type Description
LocalNode
  • string
NetworkFileSystem
  • string