Condividi tramite


Kube Environments - Create Or Update

Descrizione per Crea o aggiorna un ambiente Kubernetes.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
name
path True

string

Nome dell'ambiente Kubernetes.

resourceGroupName
path True

string

Nome del gruppo di risorse a cui appartiene la risorsa.

Criterio di espressione regolare: ^[-\w\._\(\)]+[^\.]$

subscriptionId
path True

string

L'ID sottoscrizione di Azure. Si tratta di una stringa con formato GUID (ad esempio 00000000000-0000-0000-0000-000000000000000000000).

api-version
query True

string

Versione API

Corpo della richiesta

Nome Necessario Tipo Descrizione
location True

string

Posizione risorsa.

extendedLocation

ExtendedLocation

Posizione estesa.

kind

string

Tipo di risorsa.

properties.aksResourceID

string

properties.appLogsConfiguration

AppLogsConfiguration

Configurazione del cluster che consente al daemon di log di esportare i log delle app in una destinazione. Attualmente è supportato solo "log-analytics"

properties.arcConfiguration

ArcConfiguration

Configurazione del cluster che determina i tipi di componenti del cluster ARC. Eg: scelta tra tipo BuildService, FrontEnd Service ArtifactsStorageType e così via.

properties.containerAppsConfiguration

ContainerAppsConfiguration

Configurazione del cluster per gli ambienti delle app contenitore per configurare la chiave di strumentazione Dapr e la configurazione della rete virtuale

properties.environmentType

string

Tipo di ambiente Kubernetes. Supportato solo per gli ambienti dell'app contenitore con valore gestito

properties.internalLoadBalancerEnabled

boolean

Solo visibile all'interno della rete virtuale/subnet

properties.staticIp

string

IP statico dell'oggetto KubeEnvironment

tags

object

Tag di risorse.

Risposte

Nome Tipo Descrizione
200 OK

KubeEnvironment

OK

201 Created

KubeEnvironment

Data di creazione

Other Status Codes

DefaultErrorResponse

servizio app risposta di errore.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Create kube environments

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
AppLogsConfiguration
ArcConfiguration
ContainerAppsConfiguration
DefaultErrorResponse

servizio app risposta di errore.

Details
Error

Modello di errore.

ExtendedLocation

Posizione estesa.

FrontEndConfiguration
FrontEndServiceType
KubeEnvironment

Un cluster Kubernetes specializzato per i carichi di lavoro Web Servizio app di Azure

KubeEnvironmentProvisioningState

Stato di provisioning dell'ambiente Kubernetes.

LogAnalyticsConfiguration
StorageType

AppLogsConfiguration

Nome Tipo Descrizione
destination

string

logAnalyticsConfiguration

LogAnalyticsConfiguration

ArcConfiguration

Nome Tipo Descrizione
artifactStorageAccessMode

string

artifactStorageClassName

string

artifactStorageMountPath

string

artifactStorageNodeName

string

artifactsStorageType

StorageType

frontEndServiceConfiguration

FrontEndConfiguration

kubeConfig

string

ContainerAppsConfiguration

Nome Tipo Descrizione
appSubnetResourceId

string

ID risorsa di una subnet per i componenti dell'infrastruttura del piano di controllo. Questa subnet deve trovarsi nella stessa rete virtuale della subnet definita in appSubnetResourceId. Non deve sovrapporsi all'intervallo IP definito nella piattaformaReservedCidr, se definito.

controlPlaneSubnetResourceId

string

ID risorsa di una subnet per i componenti dell'infrastruttura del piano di controllo. Questa subnet deve trovarsi nella stessa rete virtuale della subnet definita in appSubnetResourceId. Non deve sovrapporsi all'intervallo IP definito nella piattaformaReservedCidr, se definito.

daprAIInstrumentationKey

string

Chiave di strumentazione di Monitoraggio di Azure usata da Dapr per esportare il servizio nei dati di telemetria delle comunicazioni del servizio

dockerBridgeCidr

string

Intervallo IP di notazione CIDR assegnato alla rete del bridge Docker. Non deve sovrapporsi a intervalli IP subnet o all'intervallo IP definito in platformReservedCidr, se definito.

platformReservedCidr

string

Intervallo IP nella notazione CIDR che può essere riservato agli indirizzi IP dell'infrastruttura dell'ambiente. Non deve sovrapporsi ad altri intervalli IP subnet.

platformReservedDnsIP

string

Indirizzo IP dall'intervallo IP definito dalla piattaformaReservedCidr che verrà riservato per il server DNS interno

DefaultErrorResponse

servizio app risposta di errore.

Nome Tipo Descrizione
error

Error

Modello di errore.

Details

Nome Tipo Descrizione
code

string

Stringa standardizzata per identificare a livello di codice l'errore.

message

string

Descrizione dettagliata dell'errore e informazioni di debug.

target

string

Descrizione dettagliata dell'errore e informazioni di debug.

Error

Modello di errore.

Nome Tipo Descrizione
code

string

Stringa standardizzata per identificare a livello di codice l'errore.

details

Details[]

Errori dettagliati.

innererror

string

Altre informazioni per eseguire il debug dell'errore.

message

string

Descrizione dettagliata dell'errore e informazioni di debug.

target

string

Descrizione dettagliata dell'errore e informazioni di debug.

ExtendedLocation

Posizione estesa.

Nome Tipo Descrizione
name

string

Nome della posizione estesa.

type

string

Tipo di posizione estesa.

FrontEndConfiguration

Nome Tipo Descrizione
kind

FrontEndServiceType

FrontEndServiceType

Nome Tipo Descrizione
LoadBalancer

string

NodePort

string

KubeEnvironment

Un cluster Kubernetes specializzato per i carichi di lavoro Web Servizio app di Azure

Nome Tipo Descrizione
extendedLocation

ExtendedLocation

Posizione estesa.

id

string

ID risorsa.

kind

string

Tipo di risorsa.

location

string

Posizione risorsa.

name

string

Nome risorsa.

properties.aksResourceID

string

properties.appLogsConfiguration

AppLogsConfiguration

Configurazione del cluster che consente al daemon di log di esportare i log delle app in una destinazione. Attualmente è supportato solo "log-analytics"

properties.arcConfiguration

ArcConfiguration

Configurazione del cluster che determina i tipi di componenti del cluster ARC. Eg: scelta tra tipo BuildService, FrontEnd Service ArtifactsStorageType e così via.

properties.containerAppsConfiguration

ContainerAppsConfiguration

Configurazione del cluster per gli ambienti delle app contenitore per configurare la chiave di strumentazione Dapr e la configurazione della rete virtuale

properties.defaultDomain

string

Nome di dominio predefinito per il cluster

properties.deploymentErrors

string

Eventuali errori che si sono verificati durante la distribuzione o la convalida della distribuzione

properties.environmentType

string

Tipo di ambiente Kubernetes. Supportato solo per gli ambienti dell'app contenitore con valore gestito

properties.internalLoadBalancerEnabled

boolean

Solo visibile all'interno della rete virtuale/subnet

properties.provisioningState

KubeEnvironmentProvisioningState

Stato di provisioning dell'ambiente Kubernetes.

properties.staticIp

string

IP statico dell'oggetto KubeEnvironment

tags

object

Tag di risorse.

type

string

Tipo di risorsa.

KubeEnvironmentProvisioningState

Stato di provisioning dell'ambiente Kubernetes.

Nome Tipo Descrizione
Canceled

string

Failed

string

InfrastructureSetupComplete

string

InfrastructureSetupInProgress

string

InitializationInProgress

string

ScheduledForDelete

string

Succeeded

string

UpgradeFailed

string

UpgradeRequested

string

Waiting

string

LogAnalyticsConfiguration

Nome Tipo Descrizione
customerId

string

sharedKey

string

StorageType

Nome Tipo Descrizione
LocalNode

string

NetworkFileSystem

string