Managed Environments - List By Resource Group
Rufen Sie alle Umgebungen in einer Ressourcengruppe ab.
Rufen Sie alle verwalteten Umgebungen in einer Ressourcengruppe ab.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/managedEnvironments?api-version=2026-01-01
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
|
subscription
|
path | True |
string minLength: 1 |
Hierbei handelt es sich um die ID des Zielabonnements. |
|
api-version
|
query | True |
string minLength: 1 |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
OKAY |
|
| Other Status Codes |
Häufige Fehlerantwort. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Fluss
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
List environments by resource group
Beispielanforderung
GET https://management.azure.com/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments?api-version=2026-01-01
Beispiel für eine Antwort
{
"value": [
{
"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",
"appLogsConfiguration": null,
"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"
}
],
"ingressConfiguration": {
"workloadProfileName": "My-GP-01",
"terminationGracePeriodSeconds": 600,
"headerCountLimit": 50,
"requestIdleTimeout": null
},
"infrastructureResourceGroup": "capp-svc-jlaw-demo1-northcentralus"
}
},
{
"id": "/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/demo1",
"name": "demo1",
"type": "Microsoft.App/managedEnvironments",
"location": "North Central US",
"tags": {},
"properties": {
"provisioningState": "Succeeded",
"deploymentErrors": null,
"defaultDomain": "demo1.k4apps.io",
"staticIp": "52.142.21.61",
"appLogsConfiguration": null,
"zoneRedundant": true,
"customDomainConfiguration": {
"customDomainVerificationId": "custom domain verification id",
"dnsSuffix": "www.my-name2.com",
"subjectName": "CN=www.my-name2.com",
"expirationDate": "2022-11-06T04:00:00Z",
"thumbprint": "CERTIFICATE_THUMBPRINT"
},
"eventStreamEndpoint": "testEndpoint",
"vnetConfiguration": {
"infrastructureSubnetId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/RGName/providers/Microsoft.Network/virtualNetworks/VNetName/subnets/subnetName1"
},
"ingressConfiguration": null,
"infrastructureResourceGroup": "capp-svc-demo1-northcentralus"
}
}
]
}
Definitionen
| Name | Beschreibung |
|---|---|
|
App |
Konfiguration von Anwendungsprotokollen |
|
Certificate |
Eigenschaften für ein Zertifikat, das in einem Key Vault gespeichert ist. |
|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
|
Custom |
Konfigurationseigenschaften für benutzerdefinierte Apps-Umgebungsdomäne |
|
Dapr |
Konfigurationseigenschaften Dapr-Komponente |
| Encryption |
Verschlüsselungseinstellungen für Peerdatenverkehr für die verwaltete Umgebung |
|
Environment |
Bereitstellungsstatus der Umgebung. |
|
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
|
Error |
Das Fehlerdetails. |
|
Error |
Fehlerantwort |
|
Ingress |
Einstellungen für die Eingangskomponente, einschließlich Arbeitslastprofil, Skalierung und Verbindungsbehandlung. |
|
Keda |
Konfigurationseigenschaften Keda-Komponente |
|
Log |
Log Analytics-Konfiguration muss nur bereitgestellt werden, wenn das Ziel als "Log-Analytics" konfiguriert ist. |
|
Managed |
Eine Umgebung für das Hosten von Container-Apps |
|
Managed |
Sammlung von Umgebungen |
|
Managed |
Verwaltete Dienstidentität (vom System zugewiesene und/oder vom Benutzer zugewiesene Identitäten) |
|
Managed |
Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). |
| Mtls |
Konfigurationseigenschaften für die gegenseitige TLS-Authentifizierung |
|
Peer |
Peerauthentifizierungseinstellungen für die verwaltete Umgebung |
|
Peer |
Peer-Datenverkehrseinstellungen für die verwaltete Umgebung |
|
Private |
Die Private Endpoint-Ressource. |
|
Private |
Die Private Endpoint Connection-Ressource. |
|
Private |
Der aktuelle Bereitstellungsstatus. |
|
Private |
Der Status der privaten Endpunktverbindung. |
|
Private |
Eine Sammlung von Informationen über den Status der Verbindung zwischen Service Consumer und Provider. |
|
Public |
Eigenschaft zum Zulassen oder Blockieren des gesamten öffentlichen Datenverkehrs. Zulässige Werte: 'Enabled', 'Disabled'. |
|
system |
Metadaten zur Erstellung und letzten Änderung der Ressource. |
|
User |
Benutzer zugewiesene Identitätseigenschaften |
|
Vnet |
Konfigurationseigenschaften für Apps-Umgebung, um einem virtuellen Netzwerk beizutreten |
|
Workload |
Workloadprofil zum Bereich der Container-App-Ausführung. |
AppLogsConfiguration
Konfiguration von Anwendungsprotokollen
| Name | Typ | Beschreibung |
|---|---|---|
| destination |
string |
Protokollziel, kann 'Log-Analytics', 'azure-monitor' oder 'none' sein. |
| logAnalyticsConfiguration |
Log Analytics-Konfiguration muss nur bereitgestellt werden, wenn das Ziel als "Log-Analytics" konfiguriert ist. |
CertificateKeyVaultProperties
Eigenschaften für ein Zertifikat, das in einem Key Vault gespeichert ist.
| Name | Typ | Beschreibung |
|---|---|---|
| identity |
string |
Ressourcen-ID einer verwalteten Identität zur Authentifizierung mit Azure Key Vault oder System zur Verwendung einer vom System zugewiesenen Identität. |
| keyVaultUrl |
string (uri) |
DIE URL, die auf den geheimen Azure Key Vault-Schlüssel zeigt, der das Zertifikat enthält. |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
| Wert | Beschreibung |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
CustomDomainConfiguration
Konfigurationseigenschaften für benutzerdefinierte Apps-Umgebungsdomäne
| Name | Typ | Beschreibung |
|---|---|---|
| certificateKeyVaultProperties |
Zertifikat, das in Azure Key Vault gespeichert ist. |
|
| certificatePassword |
string |
Zertifikatkennwort |
| certificateValue |
string (byte) |
PFX- oder PEM-Blob |
| customDomainVerificationId |
string |
ID, die zur Überprüfung der Inhaberschaft eines Domainnamens verwendet wird |
| dnsSuffix |
string |
Dns-Suffix für die Umgebungsdomäne |
| expirationDate |
string (date-time) |
Ablaufdatum des Zertifikats. |
| subjectName |
string |
Antragstellername des Zertifikats. |
| thumbprint |
string |
Zertifikatfingerabdruck. |
DaprConfiguration
Konfigurationseigenschaften Dapr-Komponente
| Name | Typ | Beschreibung |
|---|---|---|
| version |
string |
Die Version von Dapr |
Encryption
Verschlüsselungseinstellungen für Peerdatenverkehr für die verwaltete Umgebung
| Name | Typ | Beschreibung |
|---|---|---|
| enabled |
boolean |
Boolescher Wert, der angibt, ob die Peerdatenverkehrverschlüsselung aktiviert ist |
EnvironmentProvisioningState
Bereitstellungsstatus der Umgebung.
| Wert | Beschreibung |
|---|---|
| Succeeded | |
| Failed | |
| Canceled | |
| Waiting | |
| InitializationInProgress | |
| InfrastructureSetupInProgress | |
| InfrastructureSetupComplete | |
| ScheduledForDelete | |
| UpgradeRequested | |
| UpgradeFailed |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
| Name | Typ | Beschreibung |
|---|---|---|
| info |
object |
Die zusätzlichen Informationen. |
| type |
string |
Der zusätzliche Informationstyp. |
ErrorDetail
Das Fehlerdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| additionalInfo |
Die zusätzlichen Informationen des Fehlers. |
|
| code |
string |
Der Fehlercode. |
| details |
Die Fehlerdetails. |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Das Fehlerobjekt. |
IngressConfiguration
Einstellungen für die Eingangskomponente, einschließlich Arbeitslastprofil, Skalierung und Verbindungsbehandlung.
| Name | Typ | Beschreibung |
|---|---|---|
| headerCountLimit |
integer (int32) |
Maximale Anzahl von Headern pro Anforderung, die vom Eingang zugelassen wird. Die Anzahl muss mindestens 1 sein. Der Standardwert ist 100. |
| requestIdleTimeout |
integer (int32) |
Dauer (in Minuten), bevor bei Anforderungen im Leerlauf eine Zeitüberschreitung auftritt. Muss zwischen 4 und 30 Jahre alt sein. Der Standardwert ist 4 Minuten. |
| terminationGracePeriodSeconds |
integer (int32) |
Zeit (in Sekunden), die den Abschluss aktiver Verbindungen nach Beendigung zulässt. Muss zwischen 0 und 3600 liegen. Der Standardwert ist 480 Sekunden. |
| workloadProfileName |
string |
Name des Arbeitslastprofils, das von der Eingangskomponente verwendet wird. Erforderlich. |
KedaConfiguration
Konfigurationseigenschaften Keda-Komponente
| Name | Typ | Beschreibung |
|---|---|---|
| version |
string |
Die Version von Keda |
LogAnalyticsConfiguration
Log Analytics-Konfiguration muss nur bereitgestellt werden, wenn das Ziel als "Log-Analytics" konfiguriert ist.
| Name | Typ | Beschreibung |
|---|---|---|
| customerId |
string |
Protokollanalyse-Kunden-ID |
| sharedKey |
string |
Log Analytics Customer Key |
ManagedEnvironment
Eine Umgebung für das Hosten von Container-Apps
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string (arm-id) |
Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| identity |
Verwaltete Identitäten für die verwaltete Umgebung, um mit anderen Azure-Diensten zu interagieren, ohne geheime Schlüssel oder Anmeldeinformationen im Code zu verwalten. |
|
| kind |
string |
Art der Umwelt. |
| location |
string |
Der geografische Standort, an dem sich die Ressource befindet |
| name |
string |
Der Name der Ressource |
| properties.appLogsConfiguration |
Clusterkonfiguration, mit der der Protokolldaemon App-Protokolle in das konfigurierte Ziel exportieren kann. |
|
| properties.customDomainConfiguration |
Benutzerdefinierte Domänenkonfiguration für die Umgebung |
|
| properties.daprAIConnectionString |
string |
Application Insights connection string, die von Dapr zum Exportieren von Service-to-Service-Kommunikationstelemetrie verwendet werden |
| properties.daprAIInstrumentationKey |
string |
Azure Monitor Instrumentierungsschlüssel, der von Dapr verwendet wird, um Die Telemetrie der Dienst-in-Dienst-Kommunikation zu exportieren |
| properties.daprConfiguration |
Die Konfiguration der Dapr-Komponente. |
|
| properties.defaultDomain |
string |
Standarddomänenname für den Cluster |
| properties.deploymentErrors |
string |
Alle Fehler, die während der Bereitstellung oder der Bereitstellungsvalidierung aufgetreten sind |
| properties.eventStreamEndpoint |
string |
Der Endpunkt des Ereignisstreams der Umgebung. |
| properties.infrastructureResourceGroup |
string |
Name der plattformverwalteten Ressourcengruppe, die für die verwaltete Umgebung zum Hosten von Infrastrukturressourcen erstellt wurde. Wenn eine Subnetz-ID angegeben wird, wird diese Ressourcengruppe im selben Abonnement wie das Subnetz erstellt. |
| properties.ingressConfiguration |
Eingangskonfiguration für die verwaltete Umgebung. |
|
| properties.kedaConfiguration |
Die Konfiguration der Keda-Komponente. |
|
| properties.peerAuthentication |
Peerauthentifizierungseinstellungen für die verwaltete Umgebung |
|
| properties.peerTrafficConfiguration |
Peer-Datenverkehrseinstellungen für die verwaltete Umgebung |
|
| properties.privateEndpointConnections |
Private Endpunktverbindungen mit der Ressource. |
|
| properties.provisioningState |
Bereitstellungsstatus der Umgebung. |
|
| properties.publicNetworkAccess |
Eigenschaft zum Zulassen oder Blockieren des gesamten öffentlichen Datenverkehrs. Zulässige Werte: 'Enabled', 'Disabled'. |
|
| properties.staticIp |
string |
Statische IP der Umgebung |
| properties.vnetConfiguration |
Vnet-Konfiguration für die Umgebung |
|
| properties.workloadProfiles |
Workloadprofile, die für die verwaltete Umgebung konfiguriert sind. |
|
| properties.zoneRedundant |
boolean |
Gibt an, ob diese verwaltete Umgebung zonenredundant ist. |
| systemData |
Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten. |
|
| tags |
object |
Ressourcentags. |
| type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
ManagedEnvironmentsCollection
Sammlung von Umgebungen
| Name | Typ | Beschreibung |
|---|---|---|
| nextLink |
string |
Link zur nächsten Seite von Ressourcen. |
| value |
Sammlung von Ressourcen. |
ManagedServiceIdentity
Verwaltete Dienstidentität (vom System zugewiesene und/oder vom Benutzer zugewiesene Identitäten)
| Name | Typ | Beschreibung |
|---|---|---|
| principalId |
string (uuid) |
Die Dienstprinzipal-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt. |
| tenantId |
string (uuid) |
Die Mandanten-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt. |
| type |
Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). |
|
| userAssignedIdentities |
<string,
User |
User-Assigned Identitäten |
ManagedServiceIdentityType
Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).
| Wert | Beschreibung |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
Mtls
Konfigurationseigenschaften für die gegenseitige TLS-Authentifizierung
| Name | Typ | Beschreibung |
|---|---|---|
| enabled |
boolean |
Boolescher Wert, der angibt, ob die gegenseitige TLS-Authentifizierung aktiviert ist |
PeerAuthentication
Peerauthentifizierungseinstellungen für die verwaltete Umgebung
| Name | Typ | Beschreibung |
|---|---|---|
| mtls |
Einstellungen für die gegenseitige TLS-Authentifizierung für die verwaltete Umgebung |
PeerTrafficConfiguration
Peer-Datenverkehrseinstellungen für die verwaltete Umgebung
| Name | Typ | Beschreibung |
|---|---|---|
| encryption |
Verschlüsselungseinstellungen für Peerdatenverkehr für die verwaltete Umgebung |
PrivateEndpoint
Die Private Endpoint-Ressource.
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string (arm-id) |
Der ARM-Bezeichner für den privaten Endpunkt |
PrivateEndpointConnection
Die Private Endpoint Connection-Ressource.
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string (arm-id) |
Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Der Name der Ressource |
| properties.groupIds |
string[] |
Die Gruppen-IDs für die private Endpunktressource. |
| properties.privateEndpoint |
Die Ressource des privaten Endpunkts. |
|
| properties.privateLinkServiceConnectionState |
Eine Sammlung von Informationen über den Status der Verbindung zwischen Service Consumer und Provider. |
|
| properties.provisioningState |
Der Bereitstellungsstatus der privaten Endpunktverbindungsressource. |
|
| systemData |
Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten. |
|
| type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
PrivateEndpointConnectionProvisioningState
Der aktuelle Bereitstellungsstatus.
| Wert | Beschreibung |
|---|---|
| Succeeded | |
| Failed | |
| Canceled | |
| Waiting | |
| Updating | |
| Deleting | |
| Pending |
PrivateEndpointServiceConnectionStatus
Der Status der privaten Endpunktverbindung.
| Wert | Beschreibung |
|---|---|
| Pending | |
| Approved | |
| Rejected | |
| Disconnected |
PrivateLinkServiceConnectionState
Eine Sammlung von Informationen über den Status der Verbindung zwischen Service Consumer und Provider.
| Name | Typ | Beschreibung |
|---|---|---|
| actionsRequired |
string |
Eine Meldung, die angibt, ob Änderungen am Dienstanbieter Updates für den Verbraucher erfordern. |
| description |
string |
Der Grund für die Genehmigung/Ablehnung der Verbindung. |
| status |
Gibt an, ob die Verbindung vom Besitzer des Diensts genehmigt/abgelehnt/entfernt wurde. |
PublicNetworkAccess
Eigenschaft zum Zulassen oder Blockieren des gesamten öffentlichen Datenverkehrs. Zulässige Werte: 'Enabled', 'Disabled'.
| Wert | Beschreibung |
|---|---|
| Enabled | |
| Disabled |
systemData
Metadaten zur Erstellung und letzten Änderung der Ressource.
| Name | Typ | Beschreibung |
|---|---|---|
| createdAt |
string (date-time) |
Der Zeitstempel der Ressourcenerstellung (UTC). |
| createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
| createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
| lastModifiedAt |
string (date-time) |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
| lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
| lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
UserAssignedIdentity
Benutzer zugewiesene Identitätseigenschaften
| Name | Typ | Beschreibung |
|---|---|---|
| clientId |
string (uuid) |
Die Client-ID der zugewiesenen Identität. |
| principalId |
string (uuid) |
Die Prinzipal-ID der zugewiesenen Identität. |
VnetConfiguration
Konfigurationseigenschaften für Apps-Umgebung, um einem virtuellen Netzwerk beizutreten
| Name | Typ | Beschreibung |
|---|---|---|
| dockerBridgeCidr |
string |
CIDR-Notation-IP-Bereich, der der Docker-Brücke, Netzwerk zugewiesen ist. Darf nicht mit anderen bereitgestellten IP-Bereichen überlappen. |
| infrastructureSubnetId |
string |
Ressourcen-ID eines Subnetzes für Infrastrukturkomponenten. Darf nicht mit anderen bereitgestellten IP-Bereichen überlappen. |
| internal |
boolean |
Boolescher Wert, der angibt, dass die Umgebung nur über einen internen Lastenausgleich verfügt. Diese Umgebungen verfügen nicht über eine öffentliche statische IP-Ressource. Sie müssen "infrastructureSubnetId" bereitstellen, wenn diese Eigenschaft aktiviert wird. |
| platformReservedCidr |
string |
IP-Bereich in CIDR-Notation, der für IP-Adressen der Umgebungsinfrastruktur reserviert werden kann. Darf nicht mit anderen bereitgestellten IP-Bereichen überlappen. |
| platformReservedDnsIP |
string |
Eine IP-Adresse aus dem durch platformReservedCidr definierten IP-Bereich, der für den internen DNS-Server reserviert wird. |
WorkloadProfile
Workloadprofil zum Bereich der Container-App-Ausführung.
| Name | Typ | Beschreibung |
|---|---|---|
| maximumCount |
integer (int32) |
Die maximale Kapazität. |
| minimumCount |
integer (int32) |
Die Mindestkapazität. |
| name |
string |
Workload-Profiltyp für die Workloads, auf denen ausgeführt werden soll. |
| workloadProfileType |
string |
Workload-Profiltyp für die Workloads, auf denen ausgeführt werden soll. |