Managed Environments - Get

Service:: Azure Container Apps

API-versie:: 2026-01-01

Haal de eigenschappen op van een beheerde omgeving die wordt gebruikt voor het hosten van container-apps.

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

URI-parameters

Name	In	Vereist	Type	Description
environmentName	path	True	string	Naam van de omgeving.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string minLength: 1	De id van het doelabonnement.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	ManagedEnvironment	OK
Other Status Codes	ErrorResponse	Veelvoorkomende foutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Get environments by name

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:: 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
    }
  }
}

Definities

Name	Description
AppLogsConfiguration	Configuratie van toepassingslogboeken
CertificateKeyVaultProperties	Eigenschappen voor een certificaat dat is opgeslagen in een Sleutelkluis.
createdByType	Het type identiteit waarmee de resource is gemaakt.
CustomDomainConfiguration	Configuratie-eigenschappen voor aangepast domein voor apps-omgeving
DaprConfiguration	Dapr-onderdeel configuratie-eigenschappen
Encryption	Versleutelingsinstellingen voor peerverkeer voor de beheerde omgeving
EnvironmentProvisioningState	Inrichtingsstatus van de omgeving.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
IngressConfiguration	Instellingen voor het onderdeel inkomend verkeer, waaronder workloadprofiel, schalen en verbindingsafhandeling.
KedaConfiguration	Keda-onderdeel voor configuratie-eigenschappen
LogAnalyticsConfiguration	Log Analytics-configuratie mag alleen worden opgegeven wanneer de bestemming is geconfigureerd als 'log-analytics'
ManagedEnvironment	Een omgeving voor het hosten van container-apps
ManagedServiceIdentity	Beheerde service-identiteit (door het systeem toegewezen en/of door de gebruiker toegewezen identiteiten)
ManagedServiceIdentityType	Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).
Mtls	Configuratie-eigenschappen voor wederzijdse TLS-verificatie
PeerAuthentication	Peer-verificatie-instellingen voor de beheerde omgeving
PeerTrafficConfiguration	Instellingen voor peerverkeer voor de beheerde omgeving
PrivateEndpoint	De privé-eindpuntresource.
PrivateEndpointConnection	De privé-eindpuntverbindingsresource.
PrivateEndpointConnectionProvisioningState	De huidige inrichtingsstatus.
PrivateEndpointServiceConnectionStatus	De verbindingsstatus van het privé-eindpunt.
PrivateLinkServiceConnectionState	Een verzameling informatie over de status van de verbinding tussen serviceconsumer en provider.
PublicNetworkAccess	Eigenschap om al het openbare verkeer toe te staan of te blokkeren. Toegestane waarden: Ingeschakeld, Uitgeschakeld.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
UserAssignedIdentity	Door de gebruiker toegewezen identiteitseigenschappen
VnetConfiguration	Configuratie-eigenschappen voor de omgeving van apps om lid te worden van een virtueel netwerk
WorkloadProfile	Workloadprofiel voor het bereik van de uitvoering van container-apps.

AppLogsConfiguration

Object

Configuratie van toepassingslogboeken

Name	Type	Description
destination	string	Doel van logboeken, kan 'log-analytics', 'azure-monitor' of 'none' zijn
logAnalyticsConfiguration	LogAnalyticsConfiguration	Log Analytics-configuratie mag alleen worden opgegeven wanneer de bestemming is geconfigureerd als 'log-analytics'

CertificateKeyVaultProperties

Object

Eigenschappen voor een certificaat dat is opgeslagen in een Sleutelkluis.

Name	Type	Description
identity	string	Resource-id van een beheerde identiteit voor verificatie met Azure Key Vault of systeem voor het gebruik van een door het systeem toegewezen identiteit.
keyVaultUrl	string (uri)	URL die verwijst naar het Azure Key Vault-geheim dat het certificaat bevat.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

CustomDomainConfiguration

Object

Configuratie-eigenschappen voor aangepast domein voor apps-omgeving

Name	Type	Description
certificateKeyVaultProperties	CertificateKeyVaultProperties	Certificaat dat is opgeslagen in Azure Key Vault.
certificatePassword	string	Certificaatwachtwoord
certificateValue	string (byte)	PFX- of PEM-blob
customDomainVerificationId	string	Id die wordt gebruikt om het eigendom van de domeinnaam te verifiëren
dnsSuffix	string	Dns-achtervoegsel voor het omgevingsdomein
expirationDate	string (date-time)	Vervaldatum van certificaat.
subjectName	string	Onderwerpnaam van het certificaat.
thumbprint	string	Vingerafdruk van certificaat.

DaprConfiguration

Object

Dapr-onderdeel configuratie-eigenschappen

Name	Type	Description
version	string	De versie van Dapr

Encryption

Object

Versleutelingsinstellingen voor peerverkeer voor de beheerde omgeving

Name	Type	Description
enabled	boolean	Booleaanse waarde die aangeeft of de versleuteling van peerverkeer is ingeschakeld

EnvironmentProvisioningState

Opsomming

Inrichtingsstatus van de omgeving.

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

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoelwit.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

IngressConfiguration

Object

Instellingen voor het onderdeel inkomend verkeer, waaronder workloadprofiel, schalen en verbindingsafhandeling.

Name	Type	Description
headerCountLimit	integer (int32)	Maximum aantal headers per aanvraag dat is toegestaan door de ingang. Moet ten minste 1 zijn. De standaardwaarde is 100.
requestIdleTimeout	integer (int32)	Duur (in minuten) voordat er een time-out optreedt voor inactieve aanvragen. Moet tussen 4 en 30 jaar oud zijn. Standaard ingesteld op 4 minuten.
terminationGracePeriodSeconds	integer (int32)	Tijd (in seconden) om actieve verbindingen te voltooien bij beëindiging. Moet tussen 0 en 3600 zijn. Standaard ingesteld op 480 seconden.
workloadProfileName	string	Naam van het workloadprofiel dat wordt gebruikt door de component ingress. Verplicht.

KedaConfiguration

Object

Keda-onderdeel voor configuratie-eigenschappen

Name	Type	Description
version	string	De versie van Keda

LogAnalyticsConfiguration

Object

Log Analytics-configuratie mag alleen worden opgegeven wanneer de bestemming is geconfigureerd als 'log-analytics'

Name	Type	Description
customerId	string	Log Analytics-klant-id
sharedKey	string	Log Analytics-klantsleutel

ManagedEnvironment

Object

Een omgeving voor het hosten van container-apps

Name	Type	Description
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Beheerde identiteiten voor de beheerde omgeving om te communiceren met andere Azure-services zonder dat er geheimen of referenties in code worden onderhouden.
kind	string	Soort omgeving.
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties.appLogsConfiguration	AppLogsConfiguration	Clusterconfiguratie waarmee de logboekdaemon app-logboeken naar de geconfigureerde bestemming kan exporteren.
properties.customDomainConfiguration	CustomDomainConfiguration	Aangepaste domeinconfiguratie voor de omgeving
properties.daprAIConnectionString	string	Application Insights-connection string gebruikt door Dapr om telemetrie van service-naar-service-communicatie te exporteren
properties.daprAIInstrumentationKey	string	Azure Monitor instrumentatiesleutel die door Dapr wordt gebruikt voor het exporteren van service-naar-service-communicatietelemetrie
properties.daprConfiguration	DaprConfiguration	De configuratie van het Dapr-onderdeel.
properties.defaultDomain	string	Standaarddomeinnaam voor het cluster
properties.deploymentErrors	string	Eventuele fouten die zijn opgetreden tijdens de implementatie of validatie van de implementatie
properties.eventStreamEndpoint	string	Het eindpunt van de gebeurtenisstroom van de omgeving.
properties.infrastructureResourceGroup	string	Naam van de door het platform beheerde resourcegroep die is gemaakt voor de beheerde omgeving voor het hosten van infrastructuurresources. Als er een subnet-id is opgegeven, wordt deze resourcegroep gemaakt in hetzelfde abonnement als het subnet.
properties.ingressConfiguration	IngressConfiguration	Inkomende configuratie voor de beheerde omgeving.
properties.kedaConfiguration	KedaConfiguration	De configuratie van Keda-onderdeel.
properties.peerAuthentication	PeerAuthentication	Peer-verificatie-instellingen voor de beheerde omgeving
properties.peerTrafficConfiguration	PeerTrafficConfiguration	Instellingen voor peerverkeer voor de beheerde omgeving
properties.privateEndpointConnections	PrivateEndpointConnection[]	Privé-eindpuntverbindingen met de resource.
properties.provisioningState	EnvironmentProvisioningState	Inrichtingsstatus van de omgeving.
properties.publicNetworkAccess	PublicNetworkAccess	Eigenschap om al het openbare verkeer toe te staan of te blokkeren. Toegestane waarden: Ingeschakeld, Uitgeschakeld.
properties.staticIp	string	Statische IP van de omgeving
properties.vnetConfiguration	VnetConfiguration	VNet-configuratie voor de omgeving
properties.workloadProfiles	WorkloadProfile[]	Workloadprofielen die zijn geconfigureerd voor de beheerde omgeving.
properties.zoneRedundant	boolean	Of deze beheerde omgeving al dan niet zone-redundant is.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags	object	Resourcetags.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ManagedServiceIdentity

Object

Beheerde service-identiteit (door het systeem toegewezen en/of door de gebruiker toegewezen identiteiten)

Name	Type	Description
principalId	string (uuid)	De service-principal-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.
tenantId	string (uuid)	De tenant-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.
type	ManagedServiceIdentityType	Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned identiteiten De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen.

ManagedServiceIdentityType

Opsomming

Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).

Waarde	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

Mtls

Object

Configuratie-eigenschappen voor wederzijdse TLS-verificatie

Name	Type	Description
enabled	boolean	Booleaanse waarde die aangeeft of wederzijdse TLS-verificatie is ingeschakeld

PeerAuthentication

Object

Peer-verificatie-instellingen voor de beheerde omgeving

Name	Type	Description
mtls	Mtls	Wederzijdse TLS-verificatie-instellingen voor de beheerde omgeving

PeerTrafficConfiguration

Object

Instellingen voor peerverkeer voor de beheerde omgeving

Name	Type	Description
encryption	Encryption	Versleutelingsinstellingen voor peerverkeer voor de beheerde omgeving

PrivateEndpoint

Object

De privé-eindpuntresource.

Name	Type	Description
id	string (arm-id)	De ARM-id voor privé-eindpunt

PrivateEndpointConnection

Object

De privé-eindpuntverbindingsresource.

Name	Type	Description
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
name	string	De naam van de resource
properties.groupIds	string[]	De groeps-id's voor de privé-eindpuntresource.
properties.privateEndpoint	PrivateEndpoint	De resource van het privé-eindpunt.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Een verzameling informatie over de status van de verbinding tussen serviceconsumer en provider.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	De inrichtingsstatus van de privé-eindpuntverbindingsresource.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

PrivateEndpointConnectionProvisioningState

Opsomming

De huidige inrichtingsstatus.

Waarde	Description
Succeeded
Failed
Canceled
Waiting
Updating
Deleting
Pending

PrivateEndpointServiceConnectionStatus

Opsomming

De verbindingsstatus van het privé-eindpunt.

Waarde	Description
Pending
Approved
Rejected
Disconnected

PrivateLinkServiceConnectionState

Object

Een verzameling informatie over de status van de verbinding tussen serviceconsumer en provider.

Name	Type	Description
actionsRequired	string	Een bericht dat aangeeft of wijzigingen in de serviceprovider updates voor de consument vereisen.
description	string	De reden voor goedkeuring/afwijzing van de verbinding.
status	PrivateEndpointServiceConnectionStatus	Geeft aan of de verbinding is goedgekeurd/geweigerd/verwijderd door de eigenaar van de service.

PublicNetworkAccess

Opsomming

Eigenschap om al het openbare verkeer toe te staan of te blokkeren. Toegestane waarden: Ingeschakeld, Uitgeschakeld.

Waarde	Description
Enabled
Disabled

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

UserAssignedIdentity

Object

Door de gebruiker toegewezen identiteitseigenschappen

Name	Type	Description
clientId	string (uuid)	De client-id van de toegewezen identiteit.
principalId	string (uuid)	De principal-id van de toegewezen identiteit.

VnetConfiguration

Object

Configuratie-eigenschappen voor de omgeving van apps om lid te worden van een virtueel netwerk

Name	Type	Description
dockerBridgeCidr	string	CIDR-notatie-IP-bereik dat is toegewezen aan de Docker-brug, het netwerk. Mag niet overlappen met andere opgegeven IP-bereiken.
infrastructureSubnetId	string	Resource-id van een subnet voor infrastructuuronderdelen. Mag niet overlappen met andere opgegeven IP-bereiken.
internal	boolean	Booleaanse waarde die aangeeft dat de omgeving alleen een interne load balancer heeft. Deze omgevingen hebben geen openbare statische IP-resource. Ze moeten infrastructureSubnetId opgeven als deze eigenschap is ingeschakeld
platformReservedCidr	string	IP-bereik in CIDR-notatie die kan worden gereserveerd voor IP-adressen van de omgevingsinfrastructuur. Mag niet overlappen met andere opgegeven IP-bereiken.
platformReservedDnsIP	string	Een IP-adres uit het IP-bereik dat is gedefinieerd door platformReservedCidr die wordt gereserveerd voor de interne DNS-server.

WorkloadProfile

Object

Workloadprofiel voor het bereik van de uitvoering van container-apps.

Name	Type	Description
maximumCount	integer (int32)	De maximale capaciteit.
minimumCount	integer (int32)	De minimale capaciteit.
name	string	Het type workloadprofiel waarop de workloads moeten worden uitgevoerd.
workloadProfileType	string	Het type workloadprofiel waarop de workloads moeten worden uitgevoerd.

Delen via

Managed Environments - Get

URI-parameters

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

Get environments by name

Voorbeeldaanvraag

Voorbeeldrespons

Definities

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