Managed Environments - Get

Servicio:: Azure Container Apps

Versión de la API:: 2026-01-01

Obtenga las propiedades de un entorno administrado que se usa para hospedar aplicaciones de contenedor.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/managedEnvironments/{environmentName}?api-version=2026-01-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
environmentName	path	True	string	Nombre del entorno.
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 minLength: 1	Identificador de la suscripción de destino.
api-version	query	True	string minLength: 1	Versión de API que se usará para esta operación.

Respuestas

Nombre	Tipo	Description
200 OK	ManagedEnvironment	OK
Other Status Codes	ErrorResponse	Respuesta de error común.

Seguridad

azure_auth

Flujo de 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 la cuenta de usuario

Ejemplos

Get environments by name

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/jlaw-demo1",
  "name": "jlaw-demo1",
  "type": "Microsoft.App/managedEnvironments",
  "location": "North Central US",
  "tags": {},
  "properties": {
    "provisioningState": "Succeeded",
    "deploymentErrors": null,
    "defaultDomain": "jlaw-demo1.k4apps.io",
    "staticIp": "20.42.33.145",
    "zoneRedundant": true,
    "vnetConfiguration": {
      "infrastructureSubnetId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/RGName/providers/Microsoft.Network/virtualNetworks/VNetName/subnets/subnetName1"
    },
    "customDomainConfiguration": {
      "customDomainVerificationId": "custom domain verification id",
      "dnsSuffix": "www.my-name.com",
      "subjectName": "CN=www.my-name.com",
      "expirationDate": "2022-11-06T04:00:00Z",
      "thumbprint": "CERTIFICATE_THUMBPRINT"
    },
    "eventStreamEndpoint": "testEndpoint",
    "workloadProfiles": [
      {
        "name": "My-GP-01",
        "workloadProfileType": "GeneralPurpose",
        "minimumCount": 3,
        "maximumCount": 12
      },
      {
        "name": "My-MO-01",
        "workloadProfileType": "MemoryOptimized",
        "minimumCount": 3,
        "maximumCount": 6
      },
      {
        "name": "My-CO-01",
        "workloadProfileType": "ComputeOptimized",
        "minimumCount": 3,
        "maximumCount": 6
      },
      {
        "name": "My-consumption-01",
        "workloadProfileType": "Consumption"
      }
    ],
    "kedaConfiguration": {
      "version": "2.8.1"
    },
    "daprConfiguration": {
      "version": "1.9"
    },
    "infrastructureResourceGroup": "capp-svc-jlaw-demo1-northcentralus",
    "peerAuthentication": {
      "mtls": {
        "enabled": true
      }
    },
    "peerTrafficConfiguration": {
      "encryption": {
        "enabled": true
      }
    },
    "ingressConfiguration": {
      "workloadProfileName": "My-CO-01",
      "terminationGracePeriodSeconds": 3600,
      "headerCountLimit": 30,
      "requestIdleTimeout": 5
    }
  }
}

Definiciones

Nombre	Description
AppLogsConfiguration	Configuración de registros de aplicaciones
CertificateKeyVaultProperties	Propiedades de un certificado almacenado en un almacén de claves.
createdByType	Tipo de identidad que creó el recurso.
CustomDomainConfiguration	Propiedades de configuración para el dominio personalizado del entorno de aplicaciones
DaprConfiguration	Componente Dapr de propiedades de configuración
Encryption	Configuración de cifrado del tráfico del mismo nivel para el entorno administrado
EnvironmentProvisioningState	Estado de aprovisionamiento del entorno.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
IngressConfiguration	Configuración del componente de entrada, incluido el perfil de carga de trabajo, el escalado y el manejo de conexiones.
KedaConfiguration	Componente Keda de propiedades de configuración
LogAnalyticsConfiguration	La configuración de Log Analytics solo se debe proporcionar cuando el destino está configurado como "log-analytics".
ManagedEnvironment	Un entorno para hospedar aplicaciones de contenedor
ManagedServiceIdentity	Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario)
ManagedServiceIdentityType	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
Mtls	Propiedades de configuración para la autenticación TLS mutua
PeerAuthentication	Configuración de autenticación del mismo nivel para el entorno administrado
PeerTrafficConfiguration	Configuración del tráfico del mismo nivel para el entorno administrado
PrivateEndpoint	El recurso Punto de conexión privado.
PrivateEndpointConnection	El recurso Conexión de punto de conexión privado.
PrivateEndpointConnectionProvisioningState	Estado de aprovisionamiento actual.
PrivateEndpointServiceConnectionStatus	Estado de conexión del punto de conexión privado.
PrivateLinkServiceConnectionState	Colección de información sobre el estado de la conexión entre el consumidor del servicio y el proveedor.
PublicNetworkAccess	Propiedad para permitir o bloquear todo el tráfico público. Valores permitidos: 'Enabled', 'Disabled'.
systemData	Metadatos relativos a la creación y última modificación del recurso.
UserAssignedIdentity	Propiedades de identidad asignadas por el usuario
VnetConfiguration	Propiedades de configuración para que el entorno de aplicaciones se una a una red virtual
WorkloadProfile	Perfil de carga de trabajo para definir el ámbito de la ejecución de la aplicación contenedora.

AppLogsConfiguration

Objeto

Configuración de registros de aplicaciones

Nombre	Tipo	Description
destination	string	Destino de registros, puede ser "log-analytics", "azure-monitor" o "none"
logAnalyticsConfiguration	LogAnalyticsConfiguration	La configuración de Log Analytics solo se debe proporcionar cuando el destino está configurado como "log-analytics".

CertificateKeyVaultProperties

Objeto

Propiedades de un certificado almacenado en un almacén de claves.

Nombre	Tipo	Description
identity	string	Identificador de recurso de una identidad administrada para autenticarse con Azure Key Vault o sistema para usar una identidad asignada por el sistema.
keyVaultUrl	string (uri)	Dirección URL que apunta al secreto de Azure Key Vault que contiene el certificado.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

CustomDomainConfiguration

Objeto

Propiedades de configuración para el dominio personalizado del entorno de aplicaciones

Nombre	Tipo	Description
certificateKeyVaultProperties	CertificateKeyVaultProperties	Certificado almacenado en Azure Key Vault.
certificatePassword	string	Contraseña de certificado
certificateValue	string (byte)	Blob PFX o PEM
customDomainVerificationId	string	Identificación utilizada para verificar la propiedad del nombre de dominio
dnsSuffix	string	Sufijo DNS para el dominio de entorno
expirationDate	string (date-time)	Fecha de expiración del certificado.
subjectName	string	Nombre del firmante del certificado.
thumbprint	string	Huella digital del certificado.

DaprConfiguration

Objeto

Componente Dapr de propiedades de configuración

Nombre	Tipo	Description
version	string	La versión de Dapr

Encryption

Objeto

Configuración de cifrado del tráfico del mismo nivel para el entorno administrado

Nombre	Tipo	Description
enabled	boolean	Boolean que indica si el cifrado de tráfico del mismo nivel está habilitado

EnvironmentProvisioningState

Enumeración

Estado de aprovisionamiento del entorno.

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

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Objeto

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

IngressConfiguration

Objeto

Configuración del componente de entrada, incluido el perfil de carga de trabajo, el escalado y el manejo de conexiones.

Nombre	Tipo	Description
headerCountLimit	integer (int32)	Número máximo de encabezados por solicitud permitidos por la entrada. Debe ser 1 como mínimo. El valor predeterminado es 100.
requestIdleTimeout	integer (int32)	Duración (en minutos) antes de que se agote el tiempo de espera de las solicitudes inactivas. Debe estar entre 4 y 30 inclusive. El valor predeterminado es 4 minutos.
terminationGracePeriodSeconds	integer (int32)	Tiempo (en segundos) para permitir que las conexiones activas se completen en la terminación. Debe estar entre 0 y 3600. El valor predeterminado es 480 segundos.
workloadProfileName	string	Nombre del perfil de carga de trabajo utilizado por el componente de entrada. Obligatorio.

KedaConfiguration

Objeto

Componente Keda de propiedades de configuración

Nombre	Tipo	Description
version	string	La versión de Keda

LogAnalyticsConfiguration

Objeto

La configuración de Log Analytics solo se debe proporcionar cuando el destino está configurado como "log-analytics".

Nombre	Tipo	Description
customerId	string	Identificador de cliente de Log Analytics
sharedKey	string	Clave de cliente de Log Analytics

ManagedEnvironment

Objeto

Un entorno para hospedar aplicaciones de contenedor

Nombre	Tipo	Description
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Identidades administradas para que el entorno administrado interactúe con otros servicios de Azure sin mantener secretos ni credenciales en el código.
kind	string	Tipo de entorno.
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso
properties.appLogsConfiguration	AppLogsConfiguration	Configuración del clúster que permite al demonio de registro exportar los registros de la aplicación al destino configurado.
properties.customDomainConfiguration	CustomDomainConfiguration	Configuración de dominio personalizada para el entorno
properties.daprAIConnectionString	string	Application Insights connection string usa Dapr para exportar datos de telemetría de comunicación de servicio a servicio
properties.daprAIInstrumentationKey	string	Azure Monitor clave de instrumentación usada por Dapr para exportar la telemetría de comunicación del servicio al servicio
properties.daprConfiguration	DaprConfiguration	Configuración del componente Dapr.
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.eventStreamEndpoint	string	Punto de conexión de la secuencia de eventos del entorno.
properties.infrastructureResourceGroup	string	Nombre del grupo de recursos administrados por la plataforma creado para el entorno administrado para hospedar recursos de infraestructura. Si se proporciona un identificador de subred, este grupo de recursos se creará en la misma suscripción que la subred.
properties.ingressConfiguration	IngressConfiguration	Configuración de entrada para el entorno administrado.
properties.kedaConfiguration	KedaConfiguration	Configuración del componente Keda.
properties.peerAuthentication	PeerAuthentication	Configuración de autenticación del mismo nivel para el entorno administrado
properties.peerTrafficConfiguration	PeerTrafficConfiguration	Configuración del tráfico del mismo nivel para el entorno administrado
properties.privateEndpointConnections	PrivateEndpointConnection[]	Conexiones de punto de conexión privado al recurso.
properties.provisioningState	EnvironmentProvisioningState	Estado de aprovisionamiento del entorno.
properties.publicNetworkAccess	PublicNetworkAccess	Propiedad para permitir o bloquear todo el tráfico público. Valores permitidos: 'Enabled', 'Disabled'.
properties.staticIp	string	IP estática del entorno
properties.vnetConfiguration	VnetConfiguration	Configuración de red virtual para el entorno
properties.workloadProfiles	WorkloadProfile[]	Perfiles de carga de trabajo configurados para el entorno administrado.
properties.zoneRedundant	boolean	Si este entorno administrado es o no con redundancia de zona.
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"

ManagedServiceIdentity

Objeto

Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario)

Nombre	Tipo	Description
principalId	string (uuid)	Identificador de entidad de servicio de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
tenantId	string (uuid)	Identificador de inquilino de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
type	ManagedServiceIdentityType	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	identidades de User-Assigned Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes.

ManagedServiceIdentityType

Enumeración

Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).

Valor	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

Mtls

Objeto

Propiedades de configuración para la autenticación TLS mutua

Nombre	Tipo	Description
enabled	boolean	Boolean que indica si la autenticación TLS mutua está habilitada

PeerAuthentication

Objeto

Configuración de autenticación del mismo nivel para el entorno administrado

Nombre	Tipo	Description
mtls	Mtls	Configuración de autenticación TLS mutua para el entorno administrado

PeerTrafficConfiguration

Objeto

Configuración del tráfico del mismo nivel para el entorno administrado

Nombre	Tipo	Description
encryption	Encryption	Configuración de cifrado del tráfico del mismo nivel para el entorno administrado

PrivateEndpoint

Objeto

El recurso Punto de conexión privado.

Nombre	Tipo	Description
id	string (arm-id)	El identificador de ARM para el punto de conexión privado

PrivateEndpointConnection

Objeto

El recurso Conexión de punto de conexión privado.

Nombre	Tipo	Description
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nombre del recurso
properties.groupIds	string[]	Identificadores de grupo para el recurso de punto de conexión privado.
properties.privateEndpoint	PrivateEndpoint	Recurso del punto de conexión privado.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Colección de información sobre el estado de la conexión entre el consumidor del servicio y el proveedor.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	Estado de aprovisionamiento del recurso de conexión de punto de conexión privado.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

Enumeración

Estado de aprovisionamiento actual.

Valor	Description
Succeeded
Failed
Canceled
Waiting
Updating
Deleting
Pending

PrivateEndpointServiceConnectionStatus

Enumeración

Estado de conexión del punto de conexión privado.

Valor	Description
Pending
Approved
Rejected
Disconnected

PrivateLinkServiceConnectionState

Objeto

Colección de información sobre el estado de la conexión entre el consumidor del servicio y el proveedor.

Nombre	Tipo	Description
actionsRequired	string	Mensaje que indica si los cambios en el proveedor de servicios requieren actualizaciones en el consumidor.
description	string	Motivo de aprobación o rechazo de la conexión.
status	PrivateEndpointServiceConnectionStatus	Indica si el propietario del servicio ha aprobado o rechazado o eliminado la conexión.

PublicNetworkAccess

Enumeración

Propiedad para permitir o bloquear todo el tráfico público. Valores permitidos: 'Enabled', 'Disabled'.

Valor	Description
Enabled
Disabled

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	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	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

UserAssignedIdentity

Objeto

Propiedades de identidad asignadas por el usuario

Nombre	Tipo	Description
clientId	string (uuid)	Identificador de cliente de la identidad asignada.
principalId	string (uuid)	Identificador de entidad de seguridad de la identidad asignada.

VnetConfiguration

Objeto

Propiedades de configuración para que el entorno de aplicaciones se una a una red virtual

Nombre	Tipo	Description
dockerBridgeCidr	string	Intervalo IP de notación CIDR asignado al puente de Docker, red. No debe superponerse con ningún otro intervalo IP proporcionado.
infrastructureSubnetId	string	Identificador de recurso de una subred para los componentes de infraestructura. No debe superponerse con ningún otro intervalo IP proporcionado.
internal	boolean	Boolean que indica que el entorno solo tiene un equilibrador de carga interno. Estos entornos no tienen un recurso de DIRECCIÓN IP estática pública. Deben proporcionar infrastructureSubnetId si habilita esta propiedad.
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 proporcionado.
platformReservedDnsIP	string	Una dirección IP del intervalo IP definido por platformReservedCidr que se reservará para el servidor DNS interno.

WorkloadProfile

Objeto

Perfil de carga de trabajo para definir el ámbito de la ejecución de la aplicación contenedora.

Nombre	Tipo	Description
maximumCount	integer (int32)	Capacidad máxima.
minimumCount	integer (int32)	Capacidad mínima.
name	string	Tipo de perfil de carga de trabajo para que se ejecuten las cargas de trabajo.
workloadProfileType	string	Tipo de perfil de carga de trabajo para que se ejecuten las cargas de trabajo.

Compartir a través de

Managed Environments - Get

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

Get environments by name

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AppLogsConfiguration

CertificateKeyVaultProperties

createdByType

CustomDomainConfiguration

DaprConfiguration

Encryption

EnvironmentProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IngressConfiguration

KedaConfiguration

LogAnalyticsConfiguration

ManagedEnvironment

ManagedServiceIdentity

ManagedServiceIdentityType

Mtls

PeerAuthentication

PeerTrafficConfiguration

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProvisioningState

PrivateEndpointServiceConnectionStatus

PrivateLinkServiceConnectionState

PublicNetworkAccess

systemData

UserAssignedIdentity

VnetConfiguration

WorkloadProfile