Compartir a través de


Kube Environments - Create Or Update

Descripción de Crea o actualiza un entorno de Kubernetes.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
name
path True

string

Nombre del entorno de Kubernetes.

resourceGroupName
path True

string

Nombre del grupo de recursos al que pertenece el recurso.

Patrón de Regex: ^[-\w\._\(\)]+[^\.]$

subscriptionId
path True

string

Su identificador de suscripción de Azure. Se trata de una cadena con formato GUID (por ejemplo, 000000000-0000-0000-0000-000000000000000).

api-version
query True

string

Versión de la API

Cuerpo de la solicitud

Nombre Requerido Tipo Description
location True

string

Ubicación del recurso.

extendedLocation

ExtendedLocation

Ubicación extendida.

kind

string

Tipo de recurso.

properties.aksResourceID

string

properties.appLogsConfiguration

AppLogsConfiguration

Configuración del clúster que permite que el demonio de registro exporte los registros de la aplicación a un destino. Actualmente solo se admite "log-analytics"

properties.arcConfiguration

ArcConfiguration

Configuración del clúster que determina los tipos de componentes del clúster de ARC. Por ejemplo: Elegir entre el tipo BuildService, los artefactos del servicio FrontEndStorageType, etc.

properties.containerAppsConfiguration

ContainerAppsConfiguration

Configuración del clúster para entornos de Container Apps para configurar la clave de instrumentación de Dapr y la configuración de red virtual

properties.environmentType

string

Tipo de entorno de Kubernetes. Solo se admite para los entornos de aplicación de contenedor con el valor como administrado

properties.internalLoadBalancerEnabled

boolean

Solo visible dentro de la red virtual o subred

properties.staticIp

string

Dirección IP estática del entorno de KubeEnvironment

tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

KubeEnvironment

Aceptar

201 Created

KubeEnvironment

Creado

Other Status Codes

DefaultErrorResponse

App Service respuesta de error.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

Create kube environments

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
AppLogsConfiguration
ArcConfiguration
ContainerAppsConfiguration
DefaultErrorResponse

App Service respuesta de error.

Details
Error

Modelo de error.

ExtendedLocation

Ubicación extendida.

FrontEndConfiguration
FrontEndServiceType
KubeEnvironment

Un clúster de Kubernetes especializado para cargas de trabajo web mediante Azure App Service

KubeEnvironmentProvisioningState

Estado de aprovisionamiento del entorno de Kubernetes.

LogAnalyticsConfiguration
StorageType

AppLogsConfiguration

Nombre Tipo Description
destination

string

logAnalyticsConfiguration

LogAnalyticsConfiguration

ArcConfiguration

Nombre Tipo Description
artifactStorageAccessMode

string

artifactStorageClassName

string

artifactStorageMountPath

string

artifactStorageNodeName

string

artifactsStorageType

StorageType

frontEndServiceConfiguration

FrontEndConfiguration

kubeConfig

string

ContainerAppsConfiguration

Nombre Tipo Description
appSubnetResourceId

string

Identificador de recurso de una subred para los componentes de infraestructura del plano de control. Esta subred debe estar en la misma red virtual que la subred definida en appSubnetResourceId. No debe superponerse con el intervalo IP definido en platformReservedCidr, si se define.

controlPlaneSubnetResourceId

string

Identificador de recurso de una subred para los componentes de infraestructura del plano de control. Esta subred debe estar en la misma red virtual que la subred definida en appSubnetResourceId. No debe superponerse con el intervalo IP definido en platformReservedCidr, si se define.

daprAIInstrumentationKey

string

Clave de instrumentación de Azure Monitor usada por Dapr para exportar la telemetría de comunicación del servicio al servicio

dockerBridgeCidr

string

Intervalo IP de notación CIDR asignado a la red del puente de Docker. No debe superponerse con ningún intervalo IP de subred o el intervalo IP definido en platformReservedCidr, si se define.

platformReservedCidr

string

Intervalo IP en notación CIDR que se puede reservar para direcciones IP de infraestructura de entorno. No debe superponerse con ningún otro intervalo IP de subred.

platformReservedDnsIP

string

Una dirección IP del intervalo IP definido por platformReservedCidr que se reservará para el servidor DNS interno.

DefaultErrorResponse

App Service respuesta de error.

Nombre Tipo Description
error

Error

Modelo de error.

Details

Nombre Tipo Description
code

string

Cadena estandarizada para identificar mediante programación el error.

message

string

Descripción detallada del error e información de depuración.

target

string

Descripción detallada del error e información de depuración.

Error

Modelo de error.

Nombre Tipo Description
code

string

Cadena estandarizada para identificar mediante programación el error.

details

Details[]

Errores detallados.

innererror

string

Más información para depurar el error.

message

string

Descripción detallada del error e información de depuración.

target

string

Descripción detallada del error e información de depuración.

ExtendedLocation

Ubicación extendida.

Nombre Tipo Description
name

string

Nombre de la ubicación extendida.

type

string

Tipo de ubicación extendida.

FrontEndConfiguration

Nombre Tipo Description
kind

FrontEndServiceType

FrontEndServiceType

Nombre Tipo Description
LoadBalancer

string

NodePort

string

KubeEnvironment

Un clúster de Kubernetes especializado para cargas de trabajo web mediante Azure App Service

Nombre Tipo Description
extendedLocation

ExtendedLocation

Ubicación extendida.

id

string

Identificador de recurso.

kind

string

Tipo de recurso.

location

string

Ubicación del recurso.

name

string

Nombre del recurso.

properties.aksResourceID

string

properties.appLogsConfiguration

AppLogsConfiguration

Configuración del clúster que permite que el demonio de registro exporte los registros de la aplicación a un destino. Actualmente solo se admite "log-analytics"

properties.arcConfiguration

ArcConfiguration

Configuración del clúster que determina los tipos de componentes del clúster de ARC. Por ejemplo: Elegir entre el tipo BuildService, los artefactos del servicio FrontEndStorageType, etc.

properties.containerAppsConfiguration

ContainerAppsConfiguration

Configuración del clúster para entornos de Container Apps para configurar la clave de instrumentación de Dapr y la configuración de red virtual

properties.defaultDomain

string

Nombre de dominio predeterminado para el clúster

properties.deploymentErrors

string

Errores que se produjeron durante la implementación o validación de la implementación

properties.environmentType

string

Tipo de entorno de Kubernetes. Solo se admite para los entornos de aplicación de contenedor con el valor como administrado

properties.internalLoadBalancerEnabled

boolean

Solo visible dentro de la red virtual o subred

properties.provisioningState

KubeEnvironmentProvisioningState

Estado de aprovisionamiento del entorno de Kubernetes.

properties.staticIp

string

Dirección IP estática del entorno de KubeEnvironment

tags

object

Etiquetas del recurso.

type

string

Tipo de recurso.

KubeEnvironmentProvisioningState

Estado de aprovisionamiento del entorno de Kubernetes.

Nombre Tipo Description
Canceled

string

Failed

string

InfrastructureSetupComplete

string

InfrastructureSetupInProgress

string

InitializationInProgress

string

ScheduledForDelete

string

Succeeded

string

UpgradeFailed

string

UpgradeRequested

string

Waiting

string

LogAnalyticsConfiguration

Nombre Tipo Description
customerId

string

sharedKey

string

StorageType

Nombre Tipo Description
LocalNode

string

NetworkFileSystem

string