Managed Environments - List By Resource Group

Služba:: Azure Container Apps

Verze rozhraní API:: 2026-01-01

Získejte všechna prostředí ve skupině prostředků.
Získejte všechna spravovaná prostředí ve skupině prostředků.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string minLength: 1	ID cílového předplatného.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	ManagedEnvironmentsCollection	OK
Other Status Codes	ErrorResponse	Běžná chybová odpověď.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

List environments by resource group

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 200

{
  "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"
      }
    }
  ]
}

Definice

Name	Description
AppLogsConfiguration	Konfigurace protokolů aplikací
CertificateKeyVaultProperties	Vlastnosti certifikátu uloženého ve službě Key Vault
createdByType	Typ identity, která prostředek vytvořila.
CustomDomainConfiguration	Vlastnosti konfigurace pro vlastní doménu prostředí aplikací
DaprConfiguration	Komponenta Dapr vlastností konfigurace
Encryption	Nastavení šifrování provozu partnerského vztahu pro spravované prostředí
EnvironmentProvisioningState	Stav zřizování prostředí.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
IngressConfiguration	Nastavení komponenty příchozího přenosu dat, včetně profilu úloh, škálování a zpracování připojení.
KedaConfiguration	Komponenta Keda – vlastnosti konfigurace
LogAnalyticsConfiguration	Konfigurace Log Analytics musí být poskytována pouze v případě, že je cíl nakonfigurovaný jako Log-Analytics.
ManagedEnvironment	Prostředí pro hostování kontejnerových aplikací
ManagedEnvironmentsCollection	Kolekce prostředí
ManagedServiceIdentity	Identita spravované služby (identita přiřazená systémem nebo identita přiřazená uživatelem)
ManagedServiceIdentityType	Typ identity spravované služby (kde jsou povolené typy SystemAssigned i UserAssigned).
Mtls	Vlastnosti konfigurace pro vzájemné ověřování TLS
PeerAuthentication	Nastavení partnerského ověřování pro spravované prostředí
PeerTrafficConfiguration	Nastavení partnerského provozu pro spravované prostředí
PrivateEndpoint	Prostředek privátního koncového bodu.
PrivateEndpointConnection	Prostředek připojení privátního koncového bodu.
PrivateEndpointConnectionProvisioningState	Aktuální stav zřizování.
PrivateEndpointServiceConnectionStatus	Stav připojení privátního koncového bodu.
PrivateLinkServiceConnectionState	Kolekce informací o stavu připojení mezi příjemcem služeb a poskytovatelem.
PublicNetworkAccess	Vlastnost, která povolí nebo zablokuje veškerý veřejný provoz. Povolené hodnoty: Enabled( Povoleno), Disabled (Zakázáno).
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
UserAssignedIdentity	Vlastnosti identity přiřazené uživatelem
VnetConfiguration	Vlastnosti konfigurace pro prostředí aplikací pro připojení k virtuální síti
WorkloadProfile	Profil úlohy pro určení rozsahu spouštění aplikace kontejneru

AppLogsConfiguration

Objekt

Konfigurace protokolů aplikací

Name	Typ	Description
destination	string	Cíl protokolů může být log-analytics, azure-monitor nebo none.
logAnalyticsConfiguration	LogAnalyticsConfiguration	Konfigurace Log Analytics musí být poskytována pouze v případě, že je cíl nakonfigurovaný jako Log-Analytics.

CertificateKeyVaultProperties

Objekt

Vlastnosti certifikátu uloženého ve službě Key Vault

Name	Typ	Description
identity	string	ID prostředku spravované identity pro ověření pomocí Azure Key Vault nebo systému pro použití identity přiřazené systémem
keyVaultUrl	string (uri)	Adresa URL odkazující na tajný klíč služby Azure Key Vault, který obsahuje certifikát.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

CustomDomainConfiguration

Objekt

Vlastnosti konfigurace pro vlastní doménu prostředí aplikací

Name	Typ	Description
certificateKeyVaultProperties	CertificateKeyVaultProperties	Certifikát uložený ve službě Azure Key Vault
certificatePassword	string	Heslo certifikátu
certificateValue	string (byte)	Objekt blob PFX nebo PEM
customDomainVerificationId	string	Identifikátor používaný k ověření vlastnictví názvu domény
dnsSuffix	string	Přípona DNS pro doménu prostředí
expirationDate	string (date-time)	Datum vypršení platnosti certifikátu
subjectName	string	Název subjektu certifikátu.
thumbprint	string	Kryptografický otisk certifikátu

DaprConfiguration

Objekt

Komponenta Dapr vlastností konfigurace

Name	Typ	Description
version	string	Verze Dapr

Encryption

Objekt

Nastavení šifrování provozu partnerského vztahu pro spravované prostředí

Name	Typ	Description
enabled	boolean	Logická hodnota označující, jestli je povolené šifrování partnerského provozu

EnvironmentProvisioningState

Výčet

Stav zřizování prostředí.

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

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

IngressConfiguration

Objekt

Nastavení komponenty příchozího přenosu dat, včetně profilu úloh, škálování a zpracování připojení.

Name	Typ	Description
headerCountLimit	integer (int32)	Maximální počet hlaviček na požadavek povolený příchozím přenosem. Musí být alespoň 1. Výchozí hodnota je 100.
requestIdleTimeout	integer (int32)	Doba trvání (v minutách) před vypršením časového limitu nečinných požadavků. Musí být v rozmezí od 4 do 30 včetně. Výchozí hodnota je 4 minuty.
terminationGracePeriodSeconds	integer (int32)	Čas (v sekundách), který umožňuje dokončení aktivních připojení při ukončení. Musí být v rozmezí od 0 do 3600. Výchozí hodnota je 480 sekund.
workloadProfileName	string	Název profilu úlohy používaného komponentou příchozího přenosu dat. Povinné.

KedaConfiguration

Objekt

Komponenta Keda – vlastnosti konfigurace

Name	Typ	Description
version	string	Verze Kedy

LogAnalyticsConfiguration

Objekt

Konfigurace Log Analytics musí být poskytována pouze v případě, že je cíl nakonfigurovaný jako Log-Analytics.

Name	Typ	Description
customerId	string	ID zákazníka Log Analytics
sharedKey	string	Klíč zákazníka Log Analytics

ManagedEnvironment

Objekt

Prostředí pro hostování kontejnerových aplikací

Name	Typ	Description
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Spravované identity pro spravované prostředí pro interakci s jinými službami Azure bez zachování tajných kódů nebo přihlašovacích údajů v kódu.
kind	string	Druh prostředí.
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
properties.appLogsConfiguration	AppLogsConfiguration	Konfigurace clusteru, která umožňuje démonu protokolu exportovat protokoly aplikace do nakonfigurovaného cíle.
properties.customDomainConfiguration	CustomDomainConfiguration	Konfigurace vlastní domény pro prostředí
properties.daprAIConnectionString	string	Application Insights connection string používaný dapr k exportu telemetrie komunikace služby do služby
properties.daprAIInstrumentationKey	string	Azure Monitor instrumentační klíč používaný dapr k exportu telemetrie komunikace služby do služby
properties.daprConfiguration	DaprConfiguration	Konfigurace komponenty Dapr.
properties.defaultDomain	string	Výchozí název domény pro cluster
properties.deploymentErrors	string	Jakékoli chyby, ke kterým došlo během nasazení nebo ověření nasazení
properties.eventStreamEndpoint	string	Koncový bod eventstreamu prostředí.
properties.infrastructureResourceGroup	string	Název skupiny prostředků spravované platformou vytvořenou pro spravované prostředí pro hostování prostředků infrastruktury Pokud je zadané ID podsítě, vytvoří se tato skupina prostředků ve stejném předplatném jako podsíť.
properties.ingressConfiguration	IngressConfiguration	Konfigurace příchozího přenosu dat pro spravované prostředí.
properties.kedaConfiguration	KedaConfiguration	Konfigurace komponenty Keda.
properties.peerAuthentication	PeerAuthentication	Nastavení partnerského ověřování pro spravované prostředí
properties.peerTrafficConfiguration	PeerTrafficConfiguration	Nastavení partnerského provozu pro spravované prostředí
properties.privateEndpointConnections	PrivateEndpointConnection[]	Připojení privátního koncového bodu k prostředku.
properties.provisioningState	EnvironmentProvisioningState	Stav zřizování prostředí.
properties.publicNetworkAccess	PublicNetworkAccess	Vlastnost, která povolí nebo zablokuje veškerý veřejný provoz. Povolené hodnoty: Enabled( Povoleno), Disabled (Zakázáno).
properties.staticIp	string	Statická IP adresa prostředí
properties.vnetConfiguration	VnetConfiguration	Konfigurace virtuální sítě pro prostředí
properties.workloadProfiles	WorkloadProfile[]	Profily úloh nakonfigurované pro spravované prostředí
properties.zoneRedundant	boolean	Bez ohledu na to, jestli je toto spravované prostředí zónově redundantní.
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object	Značky prostředků
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

ManagedEnvironmentsCollection

Objekt

Kolekce prostředí

Name	Typ	Description
nextLink	string	Odkaz na další stránku prostředků
value	ManagedEnvironment[]	Sbírka zdrojů.

ManagedServiceIdentity

Objekt

Identita spravované služby (identita přiřazená systémem nebo identita přiřazená uživatelem)

Name	Typ	Description
principalId	string (uuid)	ID instančního objektu identity přiřazené systémem. Tato vlastnost bude poskytována pouze pro identitu přiřazenou systémem.
tenantId	string (uuid)	ID tenanta přiřazené identity systému. Tato vlastnost bude poskytována pouze pro identitu přiřazenou systémem.
type	ManagedServiceIdentityType	Typ identity spravované služby (kde jsou povolené typy SystemAssigned i UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	identity User-Assigned Sada identit přiřazených uživatelem přidružená k prostředku. Klíče slovníku userAssignedIdentities budou ID prostředků ARM ve formuláři: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Hodnoty slovníku můžou být prázdné objekty ({}) v požadavcích.

ManagedServiceIdentityType

Výčet

Typ identity spravované služby (kde jsou povolené typy SystemAssigned i UserAssigned).

Hodnota	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

Mtls

Objekt

Vlastnosti konfigurace pro vzájemné ověřování TLS

Name	Typ	Description
enabled	boolean	Logická hodnota označující, jestli je povolené vzájemné ověřování TLS

PeerAuthentication

Objekt

Nastavení partnerského ověřování pro spravované prostředí

Name	Typ	Description
mtls	Mtls	Nastavení vzájemného ověřování TLS pro spravované prostředí

PeerTrafficConfiguration

Objekt

Nastavení partnerského provozu pro spravované prostředí

Name	Typ	Description
encryption	Encryption	Nastavení šifrování provozu partnerského vztahu pro spravované prostředí

PrivateEndpoint

Objekt

Prostředek privátního koncového bodu.

Name	Typ	Description
id	string (arm-id)	Identifikátor ARM pro privátní koncový bod

PrivateEndpointConnection

Objekt

Prostředek připojení privátního koncového bodu.

Name	Typ	Description
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Název prostředku
properties.groupIds	string[]	ID skupiny pro prostředek privátního koncového bodu.
properties.privateEndpoint	PrivateEndpoint	Prostředek privátního koncového bodu.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Kolekce informací o stavu připojení mezi příjemcem služeb a poskytovatelem.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	Stav zřizování prostředku připojení privátního koncového bodu.
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

PrivateEndpointConnectionProvisioningState

Výčet

Aktuální stav zřizování.

Hodnota	Description
Succeeded
Failed
Canceled
Waiting
Updating
Deleting
Pending

PrivateEndpointServiceConnectionStatus

Výčet

Stav připojení privátního koncového bodu.

Hodnota	Description
Pending
Approved
Rejected
Disconnected

PrivateLinkServiceConnectionState

Objekt

Kolekce informací o stavu připojení mezi příjemcem služeb a poskytovatelem.

Name	Typ	Description
actionsRequired	string	Zpráva, která indikuje, jestli změny poskytovatele služeb vyžadují aktualizace příjemce.
description	string	Důvod schválení nebo zamítnutí připojení.
status	PrivateEndpointServiceConnectionStatus	Určuje, jestli bylo připojení schváleno, odmítnuto nebo odebráno vlastníkem služby.

PublicNetworkAccess

Výčet

Vlastnost, která povolí nebo zablokuje veškerý veřejný provoz. Povolené hodnoty: Enabled( Povoleno), Disabled (Zakázáno).

Hodnota	Description
Enabled
Disabled

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

UserAssignedIdentity

Objekt

Vlastnosti identity přiřazené uživatelem

Name	Typ	Description
clientId	string (uuid)	ID klienta přiřazené identity.
principalId	string (uuid)	ID objektu zabezpečení přiřazené identity.

VnetConfiguration

Objekt

Vlastnosti konfigurace pro prostředí aplikací pro připojení k virtuální síti

Name	Typ	Description
dockerBridgeCidr	string	Rozsah IP adres zápisu CIDR přiřazený k mostu Dockeru, síti. Nesmí se překrývat s žádnými dalšími poskytnutými rozsahy IP adres.
infrastructureSubnetId	string	ID prostředku podsítě pro komponenty infrastruktury Nesmí se překrývat s žádnými dalšími poskytnutými rozsahy IP adres.
internal	boolean	Logická hodnota označující, že prostředí má pouze interní nástroj pro vyrovnávání zatížení. Tato prostředí nemají veřejný statický prostředek IP adresy. Pokud povolíte tuto vlastnost, musí poskytnout parametr infrastructureSubnetId.
platformReservedCidr	string	Rozsah IP adres v zápisu CIDR, který je možné rezervovat pro IP adresy infrastruktury prostředí. Nesmí se překrývat s žádnými dalšími poskytnutými rozsahy IP adres.
platformReservedDnsIP	string	IP adresa z rozsahu IP adres definovaných platformReservedCidr, která bude vyhrazena pro interní server DNS.

WorkloadProfile

Objekt

Profil úlohy pro určení rozsahu spouštění aplikace kontejneru

Name	Typ	Description
maximumCount	integer (int32)	Maximální kapacita.
minimumCount	integer (int32)	Minimální kapacita.
name	string	Typ profilu úlohy pro úlohy, na kterých se mají spouštět.
workloadProfileType	string	Typ profilu úlohy pro úlohy, na kterých se mají spouštět.

Sdílet prostřednictvím

Managed Environments - List By Resource Group

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

List environments by resource group

Ukázkový požadavek

Ukázková odpověď

Definice

AppLogsConfiguration

CertificateKeyVaultProperties

createdByType

CustomDomainConfiguration

DaprConfiguration

Encryption

EnvironmentProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IngressConfiguration

KedaConfiguration

LogAnalyticsConfiguration

ManagedEnvironment

ManagedEnvironmentsCollection

ManagedServiceIdentity

ManagedServiceIdentityType

Mtls

PeerAuthentication

PeerTrafficConfiguration

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProvisioningState

PrivateEndpointServiceConnectionStatus

PrivateLinkServiceConnectionState

PublicNetworkAccess

systemData

UserAssignedIdentity

VnetConfiguration

WorkloadProfile