Managed Environments - List By Resource Group

Service:: Azure Container Apps

Version d'API:: 2026-01-01

Obtenez tous les environnements d’un groupe de ressources.
Obtenez tous les environnements gérés dans un groupe de ressources.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string minLength: 1	ID de l’abonnement cible.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	ManagedEnvironmentsCollection	Ok
Other Status Codes	ErrorResponse	Réponse d’erreur courante.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

List environments by resource group

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:: 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"
      }
    }
  ]
}

Définitions

Nom	Description
AppLogsConfiguration	Configuration des journaux d’application
CertificateKeyVaultProperties	Propriétés d’un certificat stocké dans un coffre de clés.
createdByType	Type d’identité qui a créé la ressource.
CustomDomainConfiguration	Propriétés de configuration pour le domaine personnalisé de l’environnement d’applications
DaprConfiguration	Composant Dapr des propriétés de configuration
Encryption	Paramètres de chiffrement du trafic homologue pour l’environnement managé
EnvironmentProvisioningState	État d’approvisionnement de l’environnement.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
IngressConfiguration	Paramètres du composant d’entrée, y compris le profil de charge de travail, la mise à l’échelle et la gestion des connexions.
KedaConfiguration	Composant Keda des propriétés de configuration
LogAnalyticsConfiguration	La configuration de Log Analytics ne doit être fournie que lorsque la destination est configurée en tant que « log-analytics »
ManagedEnvironment	Un environnement pour l’hébergement d’applications conteneur
ManagedEnvironmentsCollection	Collection d’environnements
ManagedServiceIdentity	Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)
ManagedServiceIdentityType	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).
Mtls	Propriétés de configuration pour l’authentification TLS mutuelle
PeerAuthentication	Paramètres d’authentification d’homologue pour l’environnement managé
PeerTrafficConfiguration	Paramètres de trafic homologue pour l’environnement managé
PrivateEndpoint	Ressource de point de terminaison privé.
PrivateEndpointConnection	Ressource de connexion de point de terminaison privé.
PrivateEndpointConnectionProvisioningState	État d’approvisionnement actuel.
PrivateEndpointServiceConnectionStatus	État de la connexion de point de terminaison privé.
PrivateLinkServiceConnectionState	Collection d’informations sur l’état de la connexion entre le consommateur de services et le fournisseur.
PublicNetworkAccess	Propriété permettant d’autoriser ou de bloquer tout le trafic public. Valeurs autorisées : « Activé », « Désactivé ».
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
UserAssignedIdentity	Propriétés d’identité attribuées par l’utilisateur
VnetConfiguration	Propriétés de configuration pour l’environnement d’applications à joindre un réseau virtuel
WorkloadProfile	Profil de charge de travail pour étendre l’exécution de l’application conteneur.

AppLogsConfiguration

Objet

Configuration des journaux d’application

Nom	Type	Description
destination	string	Destination des journaux, peut être « log-analytics », « azure-monitor » ou « none »
logAnalyticsConfiguration	LogAnalyticsConfiguration	La configuration de Log Analytics ne doit être fournie que lorsque la destination est configurée en tant que « log-analytics »

CertificateKeyVaultProperties

Objet

Propriétés d’un certificat stocké dans un coffre de clés.

Nom	Type	Description
identity	string	ID de ressource d’une identité managée pour s’authentifier auprès de Azure Key Vault ou système pour utiliser une identité affectée par le système.
keyVaultUrl	string (uri)	URL pointant vers le secret Azure Key Vault qui contient le certificat.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

CustomDomainConfiguration

Objet

Propriétés de configuration pour le domaine personnalisé de l’environnement d’applications

Nom	Type	Description
certificateKeyVaultProperties	CertificateKeyVaultProperties	Certificat stocké dans Azure Key Vault.
certificatePassword	string	Mot de passe du certificat
certificateValue	string (byte)	Objet blob PFX ou PEM
customDomainVerificationId	string	Identifiant utilisé pour vérifier la propriété du nom de domaine
dnsSuffix	string	Suffixe DNS pour le domaine d’environnement
expirationDate	string (date-time)	Date d’expiration du certificat.
subjectName	string	Nom de l’objet du certificat.
thumbprint	string	Empreinte numérique du certificat.

DaprConfiguration

Objet

Composant Dapr des propriétés de configuration

Nom	Type	Description
version	string	La version de Dapr

Encryption

Objet

Paramètres de chiffrement du trafic homologue pour l’environnement managé

Nom	Type	Description
enabled	boolean	Boolean indiquant si le chiffrement du trafic homologue est activé

EnvironmentProvisioningState

Énumération

État d’approvisionnement de l’environnement.

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

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

IngressConfiguration

Objet

Paramètres du composant d’entrée, y compris le profil de charge de travail, la mise à l’échelle et la gestion des connexions.

Nom	Type	Description
headerCountLimit	integer (int32)	Nombre maximal d’en-têtes par requête autorisé par l’entrée. Doit être au moins égal à 1. La valeur par défaut est 100.
requestIdleTimeout	integer (int32)	Durée (en minutes) avant que les demandes inactives ne soient dépassées. Doit être compris entre 4 et 30 inclus. La valeur par défaut est de 4 minutes.
terminationGracePeriodSeconds	integer (int32)	Temps (en secondes) nécessaire pour permettre aux connexions actives de se terminer à la fin. Doit être compris entre 0 et 3600. La valeur par défaut est de 480 secondes.
workloadProfileName	string	Nom du profil de charge de travail utilisé par le composant d’entrée. Obligatoire.

KedaConfiguration

Objet

Composant Keda des propriétés de configuration

Nom	Type	Description
version	string	La version de Keda

LogAnalyticsConfiguration

Objet

La configuration de Log Analytics ne doit être fournie que lorsque la destination est configurée en tant que « log-analytics »

Nom	Type	Description
customerId	string	ID client Log Analytics
sharedKey	string	Clé client Log Analytics

ManagedEnvironment

Objet

Un environnement pour l’hébergement d’applications conteneur

Nom	Type	Description
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
identity	ManagedServiceIdentity	Identités managées pour l’environnement managé pour interagir avec d’autres services Azure sans conserver de secrets ou d’informations d’identification dans le code.
kind	string	Type d’environnement.
location	string	Emplacement géographique où réside la ressource
name	string	Nom de la ressource
properties.appLogsConfiguration	AppLogsConfiguration	Configuration du cluster qui permet au démon de journal d’exporter les journaux d’activité d’application vers la destination configurée.
properties.customDomainConfiguration	CustomDomainConfiguration	Configuration de domaine personnalisé pour l’environnement
properties.daprAIConnectionString	string	Application Insights connection string utilisé par Dapr pour exporter les données de télémétrie de communication du service vers le service
properties.daprAIInstrumentationKey	string	Azure Monitor clé d’instrumentation utilisée par Dapr pour exporter les données de télémétrie de communication service vers service
properties.daprConfiguration	DaprConfiguration	Configuration du composant Dapr.
properties.defaultDomain	string	Nom de domaine par défaut pour le cluster
properties.deploymentErrors	string	Toutes les erreurs survenues lors du déploiement ou de la validation du déploiement
properties.eventStreamEndpoint	string	Point de terminaison du flux d’événements de l’environnement.
properties.infrastructureResourceGroup	string	Nom du groupe de ressources géré par la plateforme créé pour que l’environnement managé héberge les ressources d’infrastructure. Si un ID de sous-réseau est fourni, ce groupe de ressources est créé dans le même abonnement que le sous-réseau.
properties.ingressConfiguration	IngressConfiguration	Configuration d’entrée pour l’environnement géré.
properties.kedaConfiguration	KedaConfiguration	Configuration du composant Keda.
properties.peerAuthentication	PeerAuthentication	Paramètres d’authentification d’homologue pour l’environnement managé
properties.peerTrafficConfiguration	PeerTrafficConfiguration	Paramètres de trafic homologue pour l’environnement managé
properties.privateEndpointConnections	PrivateEndpointConnection[]	Connexions de point de terminaison privé à la ressource.
properties.provisioningState	EnvironmentProvisioningState	État d’approvisionnement de l’environnement.
properties.publicNetworkAccess	PublicNetworkAccess	Propriété permettant d’autoriser ou de bloquer tout le trafic public. Valeurs autorisées : « Activé », « Désactivé ».
properties.staticIp	string	IP statique de l’environnement
properties.vnetConfiguration	VnetConfiguration	Configuration du réseau virtuel pour l’environnement
properties.workloadProfiles	WorkloadProfile[]	Profils de charge de travail configurés pour l’environnement managé.
properties.zoneRedundant	boolean	Indique si cet environnement managé est redondant interzone ou non.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object	Balises de ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

ManagedEnvironmentsCollection

Objet

Collection d’environnements

Nom	Type	Description
nextLink	string	Lien vers la page suivante des ressources.
value	ManagedEnvironment[]	Collecte de ressources.

ManagedServiceIdentity

Objet

Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)

Nom	Type	Description
principalId	string (uuid)	ID du principal de service de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.
tenantId	string (uuid)	ID de locataire de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.
type	ManagedServiceIdentityType	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).
userAssignedIdentities	<string, UserAssignedIdentity>	identités User-Assigned Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.

ManagedServiceIdentityType

Énumération

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

Valeur	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

Mtls

Objet

Propriétés de configuration pour l’authentification TLS mutuelle

Nom	Type	Description
enabled	boolean	Boolean indiquant si l’authentification TLS mutuelle est activée

PeerAuthentication

Objet

Paramètres d’authentification d’homologue pour l’environnement managé

Nom	Type	Description
mtls	Mtls	Paramètres d’authentification TLS mutuelle pour l’environnement managé

PeerTrafficConfiguration

Objet

Paramètres de trafic homologue pour l’environnement managé

Nom	Type	Description
encryption	Encryption	Paramètres de chiffrement du trafic homologue pour l’environnement managé

PrivateEndpoint

Objet

Ressource de point de terminaison privé.

Nom	Type	Description
id	string (arm-id)	L’identifiant ARM pour le point de terminaison privé

PrivateEndpointConnection

Objet

Ressource de connexion de point de terminaison privé.

Nom	Type	Description
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
name	string	Nom de la ressource
properties.groupIds	string[]	ID de groupe pour la ressource de point de terminaison privé.
properties.privateEndpoint	PrivateEndpoint	Ressource du point de terminaison privé.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Collection d’informations sur l’état de la connexion entre le consommateur de services et le fournisseur.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	État d’approvisionnement de la ressource de connexion de point de terminaison privé.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

PrivateEndpointConnectionProvisioningState

Énumération

État d’approvisionnement actuel.

Valeur	Description
Succeeded
Failed
Canceled
Waiting
Updating
Deleting
Pending

PrivateEndpointServiceConnectionStatus

Énumération

État de la connexion de point de terminaison privé.

Valeur	Description
Pending
Approved
Rejected
Disconnected

PrivateLinkServiceConnectionState

Objet

Collection d’informations sur l’état de la connexion entre le consommateur de services et le fournisseur.

Nom	Type	Description
actionsRequired	string	Message indiquant si les modifications apportées au fournisseur de services nécessitent des mises à jour sur le consommateur.
description	string	Raison de l’approbation/rejet de la connexion.
status	PrivateEndpointServiceConnectionStatus	Indique si la connexion a été approuvée/rejetée/supprimée par le propriétaire du service.

PublicNetworkAccess

Énumération

Propriété permettant d’autoriser ou de bloquer tout le trafic public. Valeurs autorisées : « Activé », « Désactivé ».

Valeur	Description
Enabled
Disabled

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

UserAssignedIdentity

Objet

Propriétés d’identité attribuées par l’utilisateur

Nom	Type	Description
clientId	string (uuid)	ID client de l’identité affectée.
principalId	string (uuid)	ID principal de l’identité affectée.

VnetConfiguration

Objet

Propriétés de configuration pour l’environnement d’applications à joindre un réseau virtuel

Nom	Type	Description
dockerBridgeCidr	string	Plage IP de notation CIDR affectée au pont Docker, réseau. Ne doit pas chevaucher d’autres plages d’adresses IP fournies.
infrastructureSubnetId	string	ID de ressource d’un sous-réseau pour les composants d’infrastructure. Ne doit pas chevaucher d’autres plages d’adresses IP fournies.
internal	boolean	Boolean indiquant que l’environnement possède uniquement un équilibreur de charge interne. Ces environnements n’ont pas de ressource IP statique publique. Ils doivent fournir l’infrastructureSubnetId si cette propriété est activée
platformReservedCidr	string	Plage d’adresses IP en notation CIDR qui peut être réservée pour les adresses IP de l’infrastructure d’environnement. Ne doit pas chevaucher d’autres plages d’adresses IP fournies.
platformReservedDnsIP	string	Adresse IP de la plage d’adresses IP définie par platformReservedCidr qui sera réservée au serveur DNS interne.

WorkloadProfile

Objet

Profil de charge de travail pour étendre l’exécution de l’application conteneur.

Nom	Type	Description
maximumCount	integer (int32)	Capacité maximale.
minimumCount	integer (int32)	Capacité minimale.
name	string	Type de profil de charge de travail pour les charges de travail à exécuter.
workloadProfileType	string	Type de profil de charge de travail pour les charges de travail à exécuter.

Partager via

Managed Environments - List By Resource Group

Paramètres URI

Réponses

Sécurité

azure_auth

Étendues

Exemples

List environments by resource group

Exemple de requête

Exemple de réponse

Définitions

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