Managed Environments - Get

Hizmet:: Azure Container Apps

API Sürümü:: 2026-01-01

Kapsayıcı uygulamalarını barındırmak için kullanılan Yönetilen Ortamın özelliklerini alın.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
environmentName	path	True	string	Ortamın adı.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.
subscriptionId	path	True	string minLength: 1	Hedef aboneliğin kimliği.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	ManagedEnvironment	Tamam
Other Status Codes	ErrorResponse	Yaygın hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Get environments by name

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:: 200

{
  "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",
    "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"
      }
    ],
    "kedaConfiguration": {
      "version": "2.8.1"
    },
    "daprConfiguration": {
      "version": "1.9"
    },
    "infrastructureResourceGroup": "capp-svc-jlaw-demo1-northcentralus",
    "peerAuthentication": {
      "mtls": {
        "enabled": true
      }
    },
    "peerTrafficConfiguration": {
      "encryption": {
        "enabled": true
      }
    },
    "ingressConfiguration": {
      "workloadProfileName": "My-CO-01",
      "terminationGracePeriodSeconds": 3600,
      "headerCountLimit": 30,
      "requestIdleTimeout": 5
    }
  }
}

Tanımlar

Name	Description
AppLogsConfiguration	Uygulama günlüklerinin yapılandırması
CertificateKeyVaultProperties	Key Vault'ta depolanan bir sertifikanın özellikleri.
createdByType	Kaynağı oluşturan kimliğin türü.
CustomDomainConfiguration	Uygulamalar ortamı özel etki alanı için yapılandırma özellikleri
DaprConfiguration	Yapılandırma özellikleri Dapr bileşeni
Encryption	Yönetilen Ortam için eş trafik şifreleme ayarları
EnvironmentProvisioningState	Ortamın sağlama durumu.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
IngressConfiguration	İş yükü profili, ölçeklendirme ve bağlantı işleme dahil olmak üzere giriş bileşeninin ayarları.
KedaConfiguration	Yapılandırma özellikleri Keda bileşeni
LogAnalyticsConfiguration	Log Analytics yapılandırması, yalnızca hedef 'log-analytics' olarak yapılandırıldığında sağlanmalıdır
ManagedEnvironment	Kapsayıcı uygulamalarını barındırmak için bir ortam
ManagedServiceIdentity	Yönetilen hizmet kimliği (sistem tarafından atanan ve/veya kullanıcı tarafından atanan kimlikler)
ManagedServiceIdentityType	Yönetilen hizmet kimliği türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir).
Mtls	Karşılıklı TLS kimlik doğrulaması için yapılandırma özellikleri
PeerAuthentication	Yönetilen Ortam için eş kimlik doğrulama ayarları
PeerTrafficConfiguration	Yönetilen Ortam için eş trafik ayarları
PrivateEndpoint	Özel Uç Nokta kaynağı.
PrivateEndpointConnection	Özel Uç Nokta Bağlantısı kaynağı.
PrivateEndpointConnectionProvisioningState	Geçerli sağlama durumu.
PrivateEndpointServiceConnectionStatus	Özel uç nokta bağlantı durumu.
PrivateLinkServiceConnectionState	Hizmet tüketicisi ile sağlayıcı arasındaki bağlantının durumu hakkında bilgi koleksiyonu.
PublicNetworkAccess	Tüm genel trafiğe izin vermek veya trafiği engellemek için özellik. İzin Verilen Değerler: 'Etkin', 'Devre Dışı'.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
UserAssignedIdentity	Kullanıcı tarafından atanan kimlik özellikleri
VnetConfiguration	Sanal Ağa katılmak için uygulama ortamının yapılandırma özellikleri
WorkloadProfile	Kapsayıcı uygulamasının yürütülmesini kapsamak için iş yükü profili.

AppLogsConfiguration

Nesne

Uygulama günlüklerinin yapılandırması

Name	Tür	Description
destination	string	Günlük hedefi, 'log-analytics', 'azure-monitor' veya 'none' olabilir
logAnalyticsConfiguration	LogAnalyticsConfiguration	Log Analytics yapılandırması, yalnızca hedef 'log-analytics' olarak yapılandırıldığında sağlanmalıdır

CertificateKeyVaultProperties

Nesne

Key Vault'ta depolanan bir sertifikanın özellikleri.

Name	Tür	Description
identity	string	Azure Key Vault ile kimlik doğrulaması için yönetilen kimliğin kaynak kimliği veya sistem tarafından atanan bir kimlik kullanmak için Sistem.
keyVaultUrl	string (uri)	Sertifikayı barındıran Azure Key Vault gizli dizisine işaret eden URL.

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

CustomDomainConfiguration

Nesne

Uygulamalar ortamı özel etki alanı için yapılandırma özellikleri

Name	Tür	Description
certificateKeyVaultProperties	CertificateKeyVaultProperties	Azure Key Vault'ta depolanan sertifika.
certificatePassword	string	Sertifika parolası
certificateValue	string (byte)	PFX veya PEM blobu
customDomainVerificationId	string	Alan adı sahipliğini doğrulamak için kullanılan kimlik
dnsSuffix	string	Ortam etki alanı için Dns soneki
expirationDate	string (date-time)	Sertifika son kullanma tarihi.
subjectName	string	Sertifikanın konu adı.
thumbprint	string	Sertifika parmak izi.

DaprConfiguration

Nesne

Yapılandırma özellikleri Dapr bileşeni

Name	Tür	Description
version	string	Dapr sürümü

Encryption

Nesne

Yönetilen Ortam için eş trafik şifreleme ayarları

Name	Tür	Description
enabled	boolean	Eş trafik şifrelemesinin etkinleştirilip etkinleştirilmediğini gösteren Boole değeri

EnvironmentProvisioningState

Numaralandırma

Ortamın sağlama durumu.

Değer	Description
Succeeded
Failed
Canceled
Waiting
InitializationInProgress
InfrastructureSetupInProgress
InfrastructureSetupComplete
ScheduledForDelete
UpgradeRequested
UpgradeFailed

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

IngressConfiguration

Nesne

İş yükü profili, ölçeklendirme ve bağlantı işleme dahil olmak üzere giriş bileşeninin ayarları.

Name	Tür	Description
headerCountLimit	integer (int32)	Giriş tarafından izin verilen istek başına en fazla üst bilgi sayısı. En az 1 olmalıdır. Varsayılan değer 100'dır.
requestIdleTimeout	integer (int32)	Boşta kalan istekler zaman aşımına uğramadan önceki süre (dakika cinsinden). 4 ile 30 arasında olmalıdır. Varsayılan olarak 4 dakikadır.
terminationGracePeriodSeconds	integer (int32)	Etkin bağlantıların sonlandırma sırasında tamamlanmasına izin vermek için gereken süre (saniye cinsinden). 0 ile 3600 arasında olmalıdır. Varsayılan olarak 480 saniyedir.
workloadProfileName	string	Giriş bileşeni tarafından kullanılan iş yükü profilinin adı. Gerekli.

KedaConfiguration

Nesne

Yapılandırma özellikleri Keda bileşeni

Name	Tür	Description
version	string	Keda'nın versiyonu

LogAnalyticsConfiguration

Nesne

Log Analytics yapılandırması, yalnızca hedef 'log-analytics' olarak yapılandırıldığında sağlanmalıdır

Name	Tür	Description
customerId	string	Log Analytics müşteri kimliği
sharedKey	string	Log Analytics müşteri anahtarı

ManagedEnvironment

Nesne

Kapsayıcı uygulamalarını barındırmak için bir ortam

Name	Tür	Description
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Yönetilen Ortam'ın kodda gizli dizileri veya kimlik bilgilerini korumadan diğer Azure hizmetleriyle etkileşim kurması için yönetilen kimlikler.
kind	string	Ortam türü.
location	string	Kaynağın bulunduğu coğrafi konum
name	string	Kaynağın adı
properties.appLogsConfiguration	AppLogsConfiguration	Günlük daemon'unun uygulama günlüklerini yapılandırılmış hedefe dışarı aktarmasını sağlayan küme yapılandırması.
properties.customDomainConfiguration	CustomDomainConfiguration	Ortam için özel etki alanı yapılandırması
properties.daprAIConnectionString	string	Application Insights connection string Dapr tarafından Service'i Hizmete aktarma iletişim telemetrisini dışarı aktarmak için kullanılır
properties.daprAIInstrumentationKey	string	Dapr tarafından Hizmeti Hizmete aktarma iletişim telemetrisini dışarı aktarmak için kullanılan Azure Monitor izleme anahtarı
properties.daprConfiguration	DaprConfiguration	Dapr bileşeninin yapılandırması.
properties.defaultDomain	string	Küme için Varsayılan Etki Alanı Adı
properties.deploymentErrors	string	Dağıtım veya dağıtım doğrulaması sırasında oluşan hatalar
properties.eventStreamEndpoint	string	Ortamın olay akışının uç noktası.
properties.infrastructureResourceGroup	string	Altyapı kaynaklarını barındırmak için Yönetilen Ortam için oluşturulan platform tarafından yönetilen kaynak grubunun adı. Bir alt ağ kimliği sağlanırsa, bu kaynak grubu alt ağ ile aynı abonelikte oluşturulur.
properties.ingressConfiguration	IngressConfiguration	Yönetilen Ortam için giriş yapılandırması.
properties.kedaConfiguration	KedaConfiguration	Keda bileşeninin yapılandırması.
properties.peerAuthentication	PeerAuthentication	Yönetilen Ortam için eş kimlik doğrulama ayarları
properties.peerTrafficConfiguration	PeerTrafficConfiguration	Yönetilen Ortam için eş trafik ayarları
properties.privateEndpointConnections	PrivateEndpointConnection[]	Kaynağa özel uç nokta bağlantıları.
properties.provisioningState	EnvironmentProvisioningState	Ortamın sağlama durumu.
properties.publicNetworkAccess	PublicNetworkAccess	Tüm genel trafiğe izin vermek veya trafiği engellemek için özellik. İzin Verilen Değerler: 'Etkin', 'Devre Dışı'.
properties.staticIp	string	Ortamın Statik IP'si
properties.vnetConfiguration	VnetConfiguration	Ortam için sanal ağ yapılandırması
properties.workloadProfiles	WorkloadProfile[]	Yönetilen Ortam için yapılandırılan iş yükü profilleri.
properties.zoneRedundant	boolean	Bu Yönetilen Ortamın alanlar arası yedekli olup olmadığı.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
tags	object	Kaynak etiketleri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

ManagedServiceIdentity

Nesne

Yönetilen hizmet kimliği (sistem tarafından atanan ve/veya kullanıcı tarafından atanan kimlikler)

Name	Tür	Description
principalId	string (uuid)	Sistem tarafından atanan kimliğin hizmet sorumlusu kimliği. Bu özellik yalnızca sistem tarafından atanan kimlik için sağlanacaktır.
tenantId	string (uuid)	Sistem tarafından atanan kimliğin kiracı kimliği. Bu özellik yalnızca sistem tarafından atanan kimlik için sağlanacaktır.
type	ManagedServiceIdentityType	Yönetilen hizmet kimliği türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir).
userAssignedIdentities	<string, UserAssignedIdentity>	kimlikleri User-Assigned Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi. userAssignedIdentities sözlük anahtarları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Sözlük değerleri, isteklerdeki boş nesneler ({}) olabilir.

ManagedServiceIdentityType

Numaralandırma

Yönetilen hizmet kimliği türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir).

Değer	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

Mtls

Nesne

Karşılıklı TLS kimlik doğrulaması için yapılandırma özellikleri

Name	Tür	Description
enabled	boolean	Karşılıklı TLS kimlik doğrulamasının etkinleştirilip etkinleştirilmediğini gösteren Boole değeri

PeerAuthentication

Nesne

Yönetilen Ortam için eş kimlik doğrulama ayarları

Name	Tür	Description
mtls	Mtls	Yönetilen Ortam için karşılıklı TLS kimlik doğrulama ayarları

PeerTrafficConfiguration

Nesne

Yönetilen Ortam için eş trafik ayarları

Name	Tür	Description
encryption	Encryption	Yönetilen Ortam için eş trafik şifreleme ayarları

PrivateEndpoint

Nesne

Özel Uç Nokta kaynağı.

Name	Tür	Description
id	string (arm-id)	Özel Uç Nokta için ARM tanımlayıcısı

PrivateEndpointConnection

Nesne

Özel Uç Nokta Bağlantısı kaynağı.

Name	Tür	Description
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Kaynağın adı
properties.groupIds	string[]	Özel uç nokta kaynağının grup kimlikleri.
properties.privateEndpoint	PrivateEndpoint	Özel uç noktanın kaynağı.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Hizmet tüketicisi ile sağlayıcı arasındaki bağlantının durumu hakkında bilgi koleksiyonu.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	Özel uç nokta bağlantı kaynağının sağlama durumu.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

Numaralandırma

Geçerli sağlama durumu.

Değer	Description
Succeeded
Failed
Canceled
Waiting
Updating
Deleting
Pending

PrivateEndpointServiceConnectionStatus

Numaralandırma

Özel uç nokta bağlantı durumu.

Değer	Description
Pending
Approved
Rejected
Disconnected

PrivateLinkServiceConnectionState

Nesne

Hizmet tüketicisi ile sağlayıcı arasındaki bağlantının durumu hakkında bilgi koleksiyonu.

Name	Tür	Description
actionsRequired	string	Hizmet sağlayıcısındaki değişikliklerin tüketicide herhangi bir güncelleştirme gerektirip gerektirmediğini belirten bir ileti.
description	string	Bağlantının onaylanması/reddedilmesinin nedeni.
status	PrivateEndpointServiceConnectionStatus	Bağlantının hizmet sahibi tarafından Onaylanıp Reddedildiğini/Kaldırıldığını gösterir.

PublicNetworkAccess

Numaralandırma

Tüm genel trafiğe izin vermek veya trafiği engellemek için özellik. İzin Verilen Değerler: 'Etkin', 'Devre Dışı'.

Değer	Description
Enabled
Disabled

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

UserAssignedIdentity

Nesne

Kullanıcı tarafından atanan kimlik özellikleri

Name	Tür	Description
clientId	string (uuid)	Atanan kimliğin istemci kimliği.
principalId	string (uuid)	Atanan kimliğin asıl kimliği.

VnetConfiguration

Nesne

Sanal Ağa katılmak için uygulama ortamının yapılandırma özellikleri

Name	Tür	Description
dockerBridgeCidr	string	Docker köprüsüne, ağa atanan CIDR gösterimi IP aralığı. Sağlanan diğer IP aralıklarıyla çakışmamalıdır.
infrastructureSubnetId	string	Altyapı bileşenleri için bir alt ağın kaynak kimliği. Sağlanan diğer IP aralıklarıyla çakışmamalıdır.
internal	boolean	Ortamın yalnızca iç yük dengeleyiciye sahip olduğunu gösteren Boole değeri. Bu ortamların genel statik IP kaynağı yoktur. Bu özellik etkinleştirildiğinde infrastructureSubnetId sağlamaları gerekir
platformReservedCidr	string	CIDR gösteriminde ortam altyapısı IP adresleri için ayrılabilen IP aralığı. Sağlanan diğer IP aralıklarıyla çakışmamalıdır.
platformReservedDnsIP	string	platformReservedCidr tarafından tanımlanan IP aralığından iç DNS sunucusu için ayrılacak bir IP adresi.

WorkloadProfile

Nesne

Kapsayıcı uygulamasının yürütülmesini kapsamak için iş yükü profili.

Name	Tür	Description
maximumCount	integer (int32)	Maksimum kapasite.
minimumCount	integer (int32)	En düşük kapasite.
name	string	Üzerinde çalıştırılacak iş yükleri için iş yükü profili türü.
workloadProfileType	string	Üzerinde çalıştırılacak iş yükleri için iş yükü profili türü.

Aracılığıyla paylaş

Managed Environments - Get

URI Parametreleri

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

Get environments by name

Örnek isteği

Örnek yanıt

Tanımlar

AppLogsConfiguration

CertificateKeyVaultProperties

createdByType

CustomDomainConfiguration

DaprConfiguration

Encryption

EnvironmentProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IngressConfiguration

KedaConfiguration

LogAnalyticsConfiguration

ManagedEnvironment

ManagedServiceIdentity

ManagedServiceIdentityType

Mtls

PeerAuthentication

PeerTrafficConfiguration

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProvisioningState

PrivateEndpointServiceConnectionStatus

PrivateLinkServiceConnectionState

PublicNetworkAccess

systemData

UserAssignedIdentity

VnetConfiguration

WorkloadProfile