Managed Environments - List By Resource Group

Servizio:: Azure Container Apps

Versione API:: 2026-01-01

Ottenere tutti gli ambienti in un gruppo di risorse.
Ottenere tutti gli ambienti gestiti in un gruppo di risorse.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	ManagedEnvironmentsCollection	Va bene
Other Status Codes	ErrorResponse	Risposta di errore comune.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

List environments by resource group

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 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"
      }
    }
  ]
}

Definizioni

Nome	Descrizione
AppLogsConfiguration	Configurazione dei log dell'applicazione
CertificateKeyVaultProperties	Proprietà per un certificato archiviato in un insieme di credenziali delle chiavi.
createdByType	Tipo di identità che ha creato la risorsa.
CustomDomainConfiguration	Proprietà di configurazione per il dominio personalizzato dell'ambiente delle app
DaprConfiguration	Componente Dapr delle proprietà di configurazione
Encryption	Impostazioni di crittografia del traffico peer per l'ambiente gestito
EnvironmentProvisioningState	Stato di provisioning dell'ambiente.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
IngressConfiguration	Impostazioni per il componente in entrata, inclusi il profilo del carico di lavoro, il ridimensionamento e la gestione delle connessioni.
KedaConfiguration	Componente Keda delle proprietà di configurazione
LogAnalyticsConfiguration	La configurazione Analitica log deve essere specificata solo quando la destinazione è configurata come "log-analitica"
ManagedEnvironment	Un ambiente per l'hosting di app contenitore
ManagedEnvironmentsCollection	Raccolta di ambienti
ManagedServiceIdentity	Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)
ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
Mtls	Proprietà di configurazione per l'autenticazione TLS reciproca
PeerAuthentication	Impostazioni di autenticazione peer per l'ambiente gestito
PeerTrafficConfiguration	Impostazioni del traffico peer per l'ambiente gestito
PrivateEndpoint	Risorsa endpoint privato.
PrivateEndpointConnection	Risorsa connessione endpoint privato.
PrivateEndpointConnectionProvisioningState	Stato di provisioning corrente.
PrivateEndpointServiceConnectionStatus	Stato della connessione dell'endpoint privato.
PrivateLinkServiceConnectionState	Raccolta di informazioni sullo stato della connessione tra consumer di servizi e provider.
PublicNetworkAccess	Proprietà per consentire o bloccare tutto il traffico pubblico. Valori consentiti: 'Enabled', 'Disabled'.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserAssignedIdentity	Proprietà di identità assegnate dall'utente
VnetConfiguration	Proprietà di configurazione per l'ambiente delle app per l'aggiunta a una rete virtuale
WorkloadProfile	Profilo del carico di lavoro per definire l'ambito dell'esecuzione dell'app contenitore.

AppLogsConfiguration

Oggetto

Configurazione dei log dell'applicazione

Nome	Tipo	Descrizione
destination	string	La destinazione dei log può essere "log-analytics", "azure-monitor" o "none"
logAnalyticsConfiguration	LogAnalyticsConfiguration	La configurazione Analitica log deve essere specificata solo quando la destinazione è configurata come "log-analitica"

CertificateKeyVaultProperties

Oggetto

Proprietà per un certificato archiviato in un insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
identity	string	ID risorsa di un'identità gestita da autenticare con Azure Key Vault o Sistema per usare un'identità assegnata dal sistema.
keyVaultUrl	string (uri)	URL che punta al segreto di Azure Key Vault che contiene il certificato.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

CustomDomainConfiguration

Oggetto

Proprietà di configurazione per il dominio personalizzato dell'ambiente delle app

Nome	Tipo	Descrizione
certificateKeyVaultProperties	CertificateKeyVaultProperties	Certificato archiviato in Azure Key Vault.
certificatePassword	string	Password del certificato
certificateValue	string (byte)	BLOB PFX o PEM
customDomainVerificationId	string	ID utilizzato per verificare la proprietà del nome di dominio
dnsSuffix	string	Suffisso DNS per il dominio dell'ambiente
expirationDate	string (date-time)	Data di scadenza del certificato.
subjectName	string	Nome soggetto del certificato.
thumbprint	string	Identificazione personale del certificato.

DaprConfiguration

Oggetto

Componente Dapr delle proprietà di configurazione

Nome	Tipo	Descrizione
version	string	La versione di Dapr

Encryption

Oggetto

Impostazioni di crittografia del traffico peer per l'ambiente gestito

Nome	Tipo	Descrizione
enabled	boolean	Valore booleano che indica se la crittografia del traffico peer è abilitata

EnvironmentProvisioningState

Enumerazione

Stato di provisioning dell'ambiente.

Valore	Descrizione
Succeeded
Failed
Canceled
Waiting
InitializationInProgress
InfrastructureSetupInProgress
InfrastructureSetupComplete
ScheduledForDelete
UpgradeRequested
UpgradeFailed

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

IngressConfiguration

Oggetto

Impostazioni per il componente in entrata, inclusi il profilo del carico di lavoro, il ridimensionamento e la gestione delle connessioni.

Nome	Tipo	Descrizione
headerCountLimit	integer (int32)	Numero massimo di intestazioni per richiesta consentite dall'ingresso. Deve essere almeno 1. L’impostazione predefinita è 100.
requestIdleTimeout	integer (int32)	Durata (in minuti) prima del timeout delle richieste di inattività. Deve avere un'età compresa tra 4 e 30 inclusi. Il valore predefinito è 4 minuti.
terminationGracePeriodSeconds	integer (int32)	Tempo (in secondi) per consentire il completamento delle connessioni attive al termine. Deve essere compreso tra 0 e 3600. Il valore predefinito è 480 secondi.
workloadProfileName	string	Nome del profilo del carico di lavoro utilizzato dal componente in entrata. Obbligatorio.

KedaConfiguration

Oggetto

Componente Keda delle proprietà di configurazione

Nome	Tipo	Descrizione
version	string	La versione di Keda

LogAnalyticsConfiguration

Oggetto

La configurazione Analitica log deve essere specificata solo quando la destinazione è configurata come "log-analitica"

Nome	Tipo	Descrizione
customerId	string	ID cliente di Log Analytics
sharedKey	string	Chiave del cliente di Log Analytics

ManagedEnvironment

Oggetto

Un ambiente per l'hosting di app contenitore

Nome	Tipo	Descrizione
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Identità gestite per l'ambiente gestito per interagire con altri servizi di Azure senza mantenere segreti o credenziali nel codice.
kind	string	Tipo di ambiente.
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties.appLogsConfiguration	AppLogsConfiguration	Configurazione del cluster che consente al daemon di log di esportare i log delle app nella destinazione configurata.
properties.customDomainConfiguration	CustomDomainConfiguration	Configurazione del dominio personalizzato per l'ambiente
properties.daprAIConnectionString	string	Application Insights connection string usato da Dapr per esportare i dati di telemetria di comunicazione dal servizio al servizio
properties.daprAIInstrumentationKey	string	Azure Monitor chiave di strumentazione usata da Dapr per esportare i dati di telemetria di comunicazione da servizio a servizio
properties.daprConfiguration	DaprConfiguration	Configurazione del componente Dapr.
properties.defaultDomain	string	Nome di dominio predefinito per il cluster
properties.deploymentErrors	string	Eventuali errori che si sono verificati durante la distribuzione o la convalida della distribuzione
properties.eventStreamEndpoint	string	Endpoint del flusso di eventi dell'ambiente.
properties.infrastructureResourceGroup	string	Nome del gruppo di risorse gestito dalla piattaforma creato per l'ambiente gestito per ospitare le risorse dell'infrastruttura. Se viene specificato un ID subnet, questo gruppo di risorse verrà creato nella stessa sottoscrizione della subnet.
properties.ingressConfiguration	IngressConfiguration	Configurazione in ingresso per l'ambiente gestito.
properties.kedaConfiguration	KedaConfiguration	Configurazione del componente Keda.
properties.peerAuthentication	PeerAuthentication	Impostazioni di autenticazione peer per l'ambiente gestito
properties.peerTrafficConfiguration	PeerTrafficConfiguration	Impostazioni del traffico peer per l'ambiente gestito
properties.privateEndpointConnections	PrivateEndpointConnection[]	Connessioni endpoint privato alla risorsa.
properties.provisioningState	EnvironmentProvisioningState	Stato di provisioning dell'ambiente.
properties.publicNetworkAccess	PublicNetworkAccess	Proprietà per consentire o bloccare tutto il traffico pubblico. Valori consentiti: 'Enabled', 'Disabled'.
properties.staticIp	string	IP statico dell'ambiente
properties.vnetConfiguration	VnetConfiguration	Configurazione della rete virtuale per l'ambiente
properties.workloadProfiles	WorkloadProfile[]	Profili di carico di lavoro configurati per l'ambiente gestito.
properties.zoneRedundant	boolean	Indica se questo ambiente gestito è con ridondanza della zona.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ManagedEnvironmentsCollection

Oggetto

Raccolta di ambienti

Nome	Tipo	Descrizione
nextLink	string	Collegarsi alla pagina successiva delle risorse.
value	ManagedEnvironment[]	Raccolta di risorse.

ManagedServiceIdentity

Oggetto

Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)

Nome	Tipo	Descrizione
principalId	string (uuid)	ID entità servizio dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
tenantId	string (uuid)	ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
type	ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	identità User-Assigned Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

ManagedServiceIdentityType

Enumerazione

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).

Valore	Descrizione
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

Mtls

Oggetto

Proprietà di configurazione per l'autenticazione TLS reciproca

Nome	Tipo	Descrizione
enabled	boolean	Valore booleano che indica se l'autenticazione TLS reciproca è abilitata

PeerAuthentication

Oggetto

Impostazioni di autenticazione peer per l'ambiente gestito

Nome	Tipo	Descrizione
mtls	Mtls	Impostazioni di autenticazione TLS reciproca per l'ambiente gestito

PeerTrafficConfiguration

Oggetto

Impostazioni del traffico peer per l'ambiente gestito

Nome	Tipo	Descrizione
encryption	Encryption	Impostazioni di crittografia del traffico peer per l'ambiente gestito

PrivateEndpoint

Oggetto

Risorsa endpoint privato.

Nome	Tipo	Descrizione
id	string (arm-id)	Identificatore arm per endpoint privato

PrivateEndpointConnection

Oggetto

Risorsa connessione endpoint privato.

Nome	Tipo	Descrizione
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nome della risorsa
properties.groupIds	string[]	ID gruppo per la risorsa endpoint privato.
properties.privateEndpoint	PrivateEndpoint	Risorsa dell'endpoint privato.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Raccolta di informazioni sullo stato della connessione tra consumer di servizi e provider.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	Stato di provisioning della risorsa di connessione dell'endpoint privato.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

Enumerazione

Stato di provisioning corrente.

Valore	Descrizione
Succeeded
Failed
Canceled
Waiting
Updating
Deleting
Pending

PrivateEndpointServiceConnectionStatus

Enumerazione

Stato della connessione dell'endpoint privato.

Valore	Descrizione
Pending
Approved
Rejected
Disconnected

PrivateLinkServiceConnectionState

Oggetto

Raccolta di informazioni sullo stato della connessione tra consumer di servizi e provider.

Nome	Tipo	Descrizione
actionsRequired	string	Messaggio che indica se le modifiche apportate al provider di servizi richiedono aggiornamenti sul consumer.
description	string	Motivo dell'approvazione/rifiuto della connessione.
status	PrivateEndpointServiceConnectionStatus	Indica se la connessione è stata approvata/rifiutata/rimossa dal proprietario del servizio.

PublicNetworkAccess

Enumerazione

Proprietà per consentire o bloccare tutto il traffico pubblico. Valori consentiti: 'Enabled', 'Disabled'.

Valore	Descrizione
Enabled
Disabled

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

UserAssignedIdentity

Oggetto

Proprietà di identità assegnate dall'utente

Nome	Tipo	Descrizione
clientId	string (uuid)	ID client dell'identità assegnata.
principalId	string (uuid)	ID entità dell'identità assegnata.

VnetConfiguration

Oggetto

Proprietà di configurazione per l'ambiente delle app per l'aggiunta a una rete virtuale

Nome	Tipo	Descrizione
dockerBridgeCidr	string	Intervallo IP di notazione CIDR assegnato al bridge Docker, rete. Non deve sovrapporsi ad altri intervalli IP forniti.
infrastructureSubnetId	string	ID risorsa di una subnet per i componenti dell'infrastruttura. Non deve sovrapporsi ad altri intervalli IP forniti.
internal	boolean	Valore booleano che indica che l'ambiente dispone solo di un servizio di bilanciamento del carico interno. Questi ambienti non hanno una risorsa IP statica pubblica. Devono fornire infrastructureSubnetId se si abilita questa proprietà
platformReservedCidr	string	Intervallo IP nella notazione CIDR che può essere riservato per gli indirizzi IP dell'infrastruttura dell'ambiente. Non deve sovrapporsi ad altri intervalli IP forniti.
platformReservedDnsIP	string	Indirizzo IP dall'intervallo IP definito da platformReservedCidr che verrà riservato per il server DNS interno.

WorkloadProfile

Oggetto

Profilo del carico di lavoro per definire l'ambito dell'esecuzione dell'app contenitore.

Nome	Tipo	Descrizione
maximumCount	integer (int32)	Capacità massima.
minimumCount	integer (int32)	Capacità minima.
name	string	Tipo di profilo del carico di lavoro in cui eseguire i carichi di lavoro.
workloadProfileType	string	Tipo di profilo del carico di lavoro in cui eseguire i carichi di lavoro.

Condividi tramite

Managed Environments - List By Resource Group

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

List environments by resource group

Esempio di richiesta

Risposta di esempio

Definizioni

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