Kube Environments - Get

Servicio:: App Service

Versión de la API:: 2026-07-15

Descripción de Obtener las propiedades de un entorno de Kubernetes.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
name	path	True	string	Nombre del entorno de Kubernetes.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Respuestas

Nombre	Tipo	Description
200 OK	KubeEnvironment	Operación de Azure completada con éxito.
Other Status Codes	DefaultErrorResponse	Una respuesta de error inesperada.

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	suplantar su cuenta de usuario

Ejemplos

Get kube environments by name

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.Web/kubeEnvironments/jlaw-demo1?api-version=2026-07-15

Respuesta de muestra

status code:: 200

{
  "name": "jlaw-demo1",
  "type": "Microsoft.Web/kubeEnvironments",
  "extendedLocation": {
    "name": "/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.ExtendedLocation/customLocations/testcustomlocation",
    "type": "customLocation"
  },
  "id": "/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.Web/kubeEnvironments/jlaw-demo1",
  "location": "North Central US",
  "properties": {
    "aksResourceID": "/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.ContainerService/managedClusters/jlaw-demo1",
    "appLogsConfiguration": null,
    "arcConfiguration": null,
    "defaultDomain": "jlaw-demo1.k4apps.io",
    "deploymentErrors": null,
    "internalLoadBalancerEnabled": false,
    "provisioningState": "Succeeded",
    "staticIp": "20.42.33.145"
  },
  "tags": {}
}

Definiciones

Nombre	Description
AppLogsConfiguration
ArcConfiguration
ContainerAppsConfiguration
createdByType	Tipo de identidad que creó el recurso.
DefaultErrorResponse	Respuesta de error de App Service.
DefaultErrorResponseError	Modelo de error.
DefaultErrorResponseErrorDetailsItem	Errores detallados.
ExtendedLocation	Ubicación extendida.
FrontEndConfiguration
FrontEndServiceType
KubeEnvironment	A Kubernetes cluster especializado for web workloads by Azure App Service
KubeEnvironmentProvisioningState	Estado de aprovisionamiento del entorno de Kubernetes.
LogAnalyticsConfiguration
StorageType
systemData	Metadatos relativos a la creación y última modificación del recurso.

AppLogsConfiguration

Objeto

Nombre	Tipo	Description
destination	string
logAnalyticsConfiguration	LogAnalyticsConfiguration

ArcConfiguration

Objeto

Nombre	Tipo	Description
artifactStorageAccessMode	string
artifactStorageClassName	string
artifactStorageMountPath	string
artifactStorageNodeName	string
artifactsStorageType	StorageType
frontEndServiceConfiguration	FrontEndConfiguration
kubeConfig	string (password)

ContainerAppsConfiguration

Objeto

Nombre	Tipo	Description
appSubnetResourceId	string	Identificador de recurso de una subred para los componentes de la 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 la 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 datos de telemetría de comunicación de servicio a 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.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Objeto

Respuesta de error de App Service.

Nombre	Tipo	Description
error	DefaultErrorResponseError	Modelo de error.

DefaultErrorResponseError

Objeto

Modelo de error.

Nombre	Tipo	Description
code	string	Cadena estandarizada para identificar el error mediante programación.
details	DefaultErrorResponseErrorDetailsItem[]	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.

DefaultErrorResponseErrorDetailsItem

Objeto

Errores detallados.

Nombre	Tipo	Description
code	string	Cadena estandarizada para identificar el error mediante programación.
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

Objeto

Ubicación extendida.

Nombre	Tipo	Description
name	string	Nombre de la ubicación extendida.
type	string	Tipo de ubicación extendida.

FrontEndConfiguration

Objeto

Nombre	Tipo	Description
kind	FrontEndServiceType

FrontEndServiceType

Enumeración

Valor	Description
NodePort
LoadBalancer

KubeEnvironment

Objeto

A Kubernetes cluster especializado for web workloads by Azure App Service

Nombre	Tipo	Description
extendedLocation	ExtendedLocation	Ubicación extendida.
id	string (arm-id)	Identificador completamente cualificado del recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Tipo de recurso.
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso.
properties.aksResourceID	string
properties.appLogsConfiguration	AppLogsConfiguration	Configuración del clúster que permite que el daemon de registro exporte registros de aplicaciones 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, el servicio front-end ArtifactsStorageType, 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	Cualquier error que se haya producido durante la implementación o la validación de la implementación
properties.environmentType	string	Tipo de entorno de Kubernetes. Solo se admite para entornos de aplicación de contenedor con 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 de KubeEnvironment
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

KubeEnvironmentProvisioningState

Enumeración

Estado de aprovisionamiento del entorno de Kubernetes.

Valor	Description
Succeeded
Failed
Canceled
Waiting
InitializationInProgress
InfrastructureSetupInProgress
InfrastructureSetupComplete
ScheduledForDelete
UpgradeRequested
UpgradeFailed

LogAnalyticsConfiguration

Objeto

Nombre	Tipo	Description
customerId	string
sharedKey	string (password)

StorageType

Enumeración

Valor	Description
LocalNode
NetworkFileSystem

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	La identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	La identidad que modificó el recurso por última vez.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.