Freigeben über


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
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
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

ManagedEnvironmentsCollection

OKAY

Other Status Codes

ErrorResponse

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
AppLogsConfiguration

Konfiguration von Anwendungsprotokollen

CertificateKeyVaultProperties

Eigenschaften für ein Zertifikat, das in einem Key Vault gespeichert ist.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

CustomDomainConfiguration

Konfigurationseigenschaften für benutzerdefinierte Apps-Umgebungsdomäne

DaprConfiguration

Konfigurationseigenschaften Dapr-Komponente

Encryption

Verschlüsselungseinstellungen für Peerdatenverkehr für die verwaltete Umgebung

EnvironmentProvisioningState

Bereitstellungsstatus der Umgebung.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

IngressConfiguration

Einstellungen für die Eingangskomponente, einschließlich Arbeitslastprofil, Skalierung und Verbindungsbehandlung.

KedaConfiguration

Konfigurationseigenschaften Keda-Komponente

LogAnalyticsConfiguration

Log Analytics-Konfiguration muss nur bereitgestellt werden, wenn das Ziel als "Log-Analytics" konfiguriert ist.

ManagedEnvironment

Eine Umgebung für das Hosten von Container-Apps

ManagedEnvironmentsCollection

Sammlung von Umgebungen

ManagedServiceIdentity

Verwaltete Dienstidentität (vom System zugewiesene und/oder vom Benutzer zugewiesene Identitäten)

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).

Mtls

Konfigurationseigenschaften für die gegenseitige TLS-Authentifizierung

PeerAuthentication

Peerauthentifizierungseinstellungen für die verwaltete Umgebung

PeerTrafficConfiguration

Peer-Datenverkehrseinstellungen für die verwaltete Umgebung

PrivateEndpoint

Die Private Endpoint-Ressource.

PrivateEndpointConnection

Die Private Endpoint Connection-Ressource.

PrivateEndpointConnectionProvisioningState

Der aktuelle Bereitstellungsstatus.

PrivateEndpointServiceConnectionStatus

Der Status der privaten Endpunktverbindung.

PrivateLinkServiceConnectionState

Eine Sammlung von Informationen über den Status der Verbindung zwischen Service Consumer und Provider.

PublicNetworkAccess

Eigenschaft zum Zulassen oder Blockieren des gesamten öffentlichen Datenverkehrs. Zulässige Werte: 'Enabled', 'Disabled'.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

UserAssignedIdentity

Benutzer zugewiesene Identitätseigenschaften

VnetConfiguration

Konfigurationseigenschaften für Apps-Umgebung, um einem virtuellen Netzwerk beizutreten

WorkloadProfile

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

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

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

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

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

ManagedServiceIdentity

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

AppLogsConfiguration

Clusterkonfiguration, mit der der Protokolldaemon App-Protokolle in das konfigurierte Ziel exportieren kann.

properties.customDomainConfiguration

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

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

IngressConfiguration

Eingangskonfiguration für die verwaltete Umgebung.

properties.kedaConfiguration

KedaConfiguration

Die Konfiguration der Keda-Komponente.

properties.peerAuthentication

PeerAuthentication

Peerauthentifizierungseinstellungen für die verwaltete Umgebung

properties.peerTrafficConfiguration

PeerTrafficConfiguration

Peer-Datenverkehrseinstellungen für die verwaltete Umgebung

properties.privateEndpointConnections

PrivateEndpointConnection[]

Private Endpunktverbindungen mit der Ressource.

properties.provisioningState

EnvironmentProvisioningState

Bereitstellungsstatus der Umgebung.

properties.publicNetworkAccess

PublicNetworkAccess

Eigenschaft zum Zulassen oder Blockieren des gesamten öffentlichen Datenverkehrs. Zulässige Werte: 'Enabled', 'Disabled'.

properties.staticIp

string

Statische IP der Umgebung

properties.vnetConfiguration

VnetConfiguration

Vnet-Konfiguration für die Umgebung

properties.workloadProfiles

WorkloadProfile[]

Workloadprofile, die für die verwaltete Umgebung konfiguriert sind.

properties.zoneRedundant

boolean

Gibt an, ob diese verwaltete Umgebung zonenredundant ist.

systemData

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

ManagedEnvironment[]

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

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned Identitäten
Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein.

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

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

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

PrivateEndpoint

Die Ressource des privaten Endpunkts.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Eine Sammlung von Informationen über den Status der Verbindung zwischen Service Consumer und Provider.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

Der Bereitstellungsstatus der privaten Endpunktverbindungsressource.

systemData

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

PrivateEndpointServiceConnectionStatus

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

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

createdByType

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.