Managed Environments - List By Resource Group

Layanan:: Azure Container Apps

Versi API:: 2026-01-01

Dapatkan semua Lingkungan dalam grup sumber daya.
Dapatkan semua Lingkungan Terkelola dalam grup sumber daya.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string minLength: 1	ID langganan target.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Respons

Nama	Jenis	Deskripsi
200 OK	ManagedEnvironmentsCollection	OK
Other Status Codes	ErrorResponse	Respons kesalahan umum.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

List environments by resource group

Permintaan sampel

HTTP

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

Respon sampel

Kode status:: 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"
      }
    }
  ]
}

Definisi

Nama	Deskripsi
AppLogsConfiguration	Konfigurasi log aplikasi
CertificateKeyVaultProperties	Properti untuk sertifikat yang disimpan di Key Vault.
createdByType	Jenis identitas yang membuat sumber daya.
CustomDomainConfiguration	Properti konfigurasi untuk domain kustom lingkungan aplikasi
DaprConfiguration	Komponen Dapr properti konfigurasi
Encryption	Pengaturan enkripsi lalu lintas serekan untuk Lingkungan Terkelola
EnvironmentProvisioningState	Status provisi Lingkungan.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
IngressConfiguration	Pengaturan untuk komponen masuk, termasuk profil beban kerja, penskalaan, dan penanganan koneksi.
KedaConfiguration	Komponen Keda properti konfigurasi
LogAnalyticsConfiguration	Konfigurasi Analitik Log, hanya boleh disediakan saat tujuan dikonfigurasi sebagai 'log-analytics'
ManagedEnvironment	Lingkungan untuk menghosting aplikasi kontainer
ManagedEnvironmentsCollection	Pengumpulan Lingkungan
ManagedServiceIdentity	Identitas layanan terkelola (identitas yang ditetapkan sistem dan/atau pengguna)
ManagedServiceIdentityType	Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan).
Mtls	Properti konfigurasi untuk autentikasi TLS bersama
PeerAuthentication	Pengaturan autentikasi serekan untuk Lingkungan Terkelola
PeerTrafficConfiguration	Pengaturan lalu lintas serekan untuk Lingkungan Terkelola
PrivateEndpoint	Sumber daya Titik Akhir Privat.
PrivateEndpointConnection	Sumber daya Koneksi Titik Akhir Privat.
PrivateEndpointConnectionProvisioningState	Status provisi saat ini.
PrivateEndpointServiceConnectionStatus	Status koneksi titik akhir privat.
PrivateLinkServiceConnectionState	Kumpulan informasi tentang status koneksi antara konsumen layanan dan penyedia.
PublicNetworkAccess	Properti untuk mengizinkan atau memblokir semua lalu lintas publik. Nilai yang diizinkan: 'Diaktifkan', 'Dinonaktifkan'.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
UserAssignedIdentity	Properti identitas yang ditetapkan pengguna
VnetConfiguration	Properti konfigurasi untuk lingkungan aplikasi untuk bergabung dengan Virtual Network
WorkloadProfile	Profil beban kerja untuk mencakup eksekusi aplikasi kontainer.

AppLogsConfiguration

Objek

Konfigurasi log aplikasi

Nama	Jenis	Deskripsi
destination	string	Tujuan log, dapat berupa 'log-analytics', 'azure-monitor' atau 'none'
logAnalyticsConfiguration	LogAnalyticsConfiguration	Konfigurasi Analitik Log, hanya boleh disediakan saat tujuan dikonfigurasi sebagai 'log-analytics'

CertificateKeyVaultProperties

Objek

Properti untuk sertifikat yang disimpan di Key Vault.

Nama	Jenis	Deskripsi
identity	string	ID sumber daya identitas terkelola untuk diautentikasi dengan Azure Key Vault, atau Sistem untuk menggunakan identitas yang ditetapkan sistem.
keyVaultUrl	string (uri)	URL yang menunjuk ke rahasia Azure Key Vault yang menyimpan sertifikat.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

CustomDomainConfiguration

Objek

Properti konfigurasi untuk domain kustom lingkungan aplikasi

Nama	Jenis	Deskripsi
certificateKeyVaultProperties	CertificateKeyVaultProperties	Sertifikat disimpan di Azure Key Vault.
certificatePassword	string	Kata sandi sertifikat
certificateValue	string (byte)	Blob PFX atau PEM
customDomainVerificationId	string	ID yang digunakan untuk memverifikasi kepemilikan nama domain
dnsSuffix	string	Akhiran dns untuk domain lingkungan
expirationDate	string (date-time)	Tanggal kedaluwarsa sertifikat.
subjectName	string	Nama subjek sertifikat.
thumbprint	string	Thumbprint sertifikat.

DaprConfiguration

Objek

Komponen Dapr properti konfigurasi

Nama	Jenis	Deskripsi
version	string	Versi Dapr

Encryption

Objek

Pengaturan enkripsi lalu lintas serekan untuk Lingkungan Terkelola

Nama	Jenis	Deskripsi
enabled	boolean	Boolean menunjukkan apakah enkripsi lalu lintas serekan diaktifkan

EnvironmentProvisioningState

Enumerasi

Status provisi Lingkungan.

Nilai	Deskripsi
Succeeded
Failed
Canceled
Waiting
InitializationInProgress
InfrastructureSetupInProgress
InfrastructureSetupComplete
ScheduledForDelete
UpgradeRequested
UpgradeFailed

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Rincian kesalahan.
message	string	Pesan kesalahan.
target	string	Sasaran kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

IngressConfiguration

Objek

Pengaturan untuk komponen masuk, termasuk profil beban kerja, penskalaan, dan penanganan koneksi.

Nama	Jenis	Deskripsi
headerCountLimit	integer (int32)	Jumlah maksimum header per permintaan yang diizinkan oleh masuk. Harus minimal 1. Default ke 100.
requestIdleTimeout	integer (int32)	Durasi (dalam menit) sebelum permintaan menganggur habis waktunya. Harus antara 4 dan 30 inklusif. Default ke 4 menit.
terminationGracePeriodSeconds	integer (int32)	Waktu (dalam detik) untuk memungkinkan koneksi aktif selesai saat penghentian. Harus antara 0 dan 3600. Default ke 480 detik.
workloadProfileName	string	Nama profil beban kerja yang digunakan oleh komponen masuk. Dibutuhkan.

KedaConfiguration

Objek

Komponen Keda properti konfigurasi

Nama	Jenis	Deskripsi
version	string	Versi Keda

LogAnalyticsConfiguration

Objek

Konfigurasi Analitik Log, hanya boleh disediakan saat tujuan dikonfigurasi sebagai 'log-analytics'

Nama	Jenis	Deskripsi
customerId	string	Id pelanggan analitik log
sharedKey	string	Kunci pelanggan analitik log

ManagedEnvironment

Objek

Lingkungan untuk menghosting aplikasi kontainer

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Identitas terkelola untuk Lingkungan Terkelola untuk berinteraksi dengan layanan Azure lainnya tanpa mempertahankan rahasia atau kredensial apa pun dalam kode.
kind	string	Jenis Lingkungan.
location	string	Lokasi geografis tempat sumber daya berada
name	string	Nama sumber daya
properties.appLogsConfiguration	AppLogsConfiguration	Konfigurasi kluster yang memungkinkan daemon log mengekspor log aplikasi ke tujuan yang dikonfigurasi.
properties.customDomainConfiguration	CustomDomainConfiguration	Konfigurasi domain kustom untuk lingkungan
properties.daprAIConnectionString	string	Application Insights connection string digunakan oleh Dapr untuk mengekspor telemetri komunikasi Layanan ke Layanan
properties.daprAIInstrumentationKey	string	Azure Monitor kunci instrumentasi yang digunakan oleh Dapr untuk mengekspor telemetri komunikasi Layanan ke Layanan
properties.daprConfiguration	DaprConfiguration	Konfigurasi komponen Dapr.
properties.defaultDomain	string	Nama Domain Default untuk kluster
properties.deploymentErrors	string	Setiap kesalahan yang terjadi selama penyebaran atau validasi penyebaran
properties.eventStreamEndpoint	string	Titik akhir eventstream Lingkungan.
properties.infrastructureResourceGroup	string	Nama grup sumber daya yang dikelola platform yang dibuat untuk Lingkungan Terkelola untuk menghosting sumber daya infrastruktur. Jika ID subnet disediakan, grup sumber daya ini akan dibuat dalam langganan yang sama dengan subnet.
properties.ingressConfiguration	IngressConfiguration	Konfigurasi ingress untuk Lingkungan Terkelola.
properties.kedaConfiguration	KedaConfiguration	Konfigurasi komponen Keda.
properties.peerAuthentication	PeerAuthentication	Pengaturan autentikasi serekan untuk Lingkungan Terkelola
properties.peerTrafficConfiguration	PeerTrafficConfiguration	Pengaturan lalu lintas serekan untuk Lingkungan Terkelola
properties.privateEndpointConnections	PrivateEndpointConnection[]	Koneksi titik akhir privat ke sumber daya.
properties.provisioningState	EnvironmentProvisioningState	Status provisi Lingkungan.
properties.publicNetworkAccess	PublicNetworkAccess	Properti untuk mengizinkan atau memblokir semua lalu lintas publik. Nilai yang diizinkan: 'Diaktifkan', 'Dinonaktifkan'.
properties.staticIp	string	IP Statis Lingkungan
properties.vnetConfiguration	VnetConfiguration	Konfigurasi Vnet untuk lingkungan
properties.workloadProfiles	WorkloadProfile[]	Profil beban kerja yang dikonfigurasi untuk Lingkungan Terkelola.
properties.zoneRedundant	boolean	Apakah Lingkungan Terkelola ini berlebihan secara zona atau tidak.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

ManagedEnvironmentsCollection

Objek

Pengumpulan Lingkungan

Nama	Jenis	Deskripsi
nextLink	string	Tautkan ke halaman sumber daya berikutnya.
value	ManagedEnvironment[]	Koleksi sumber daya.

ManagedServiceIdentity

Objek

Identitas layanan terkelola (identitas yang ditetapkan sistem dan/atau pengguna)

Nama	Jenis	Deskripsi
principalId	string (uuid)	ID perwakilan layanan dari identitas yang ditetapkan sistem. Properti ini hanya akan disediakan untuk identitas yang ditetapkan sistem.
tenantId	string (uuid)	ID penyewa dari identitas yang ditetapkan sistem. Properti ini hanya akan disediakan untuk identitas yang ditetapkan sistem.
type	ManagedServiceIdentityType	Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan).
userAssignedIdentities	<string, UserAssignedIdentity>	Identitas User-Assigned Kumpulan identitas yang ditetapkan pengguna yang terkait dengan sumber daya. Kunci kamus userAssignedIdentities akan menjadi id sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Nilai kamus dapat berupa objek kosong ({}) dalam permintaan.

ManagedServiceIdentityType

Enumerasi

Jenis identitas layanan terkelola (di mana jenis SystemAssigned dan UserAssigned diizinkan).

Nilai	Deskripsi
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

Mtls

Objek

Properti konfigurasi untuk autentikasi TLS bersama

Nama	Jenis	Deskripsi
enabled	boolean	Boolean menunjukkan apakah autentikasi TLS bersama diaktifkan

PeerAuthentication

Objek

Pengaturan autentikasi serekan untuk Lingkungan Terkelola

Nama	Jenis	Deskripsi
mtls	Mtls	Pengaturan autentikasi TLS timbul untuk Lingkungan Terkelola

PeerTrafficConfiguration

Objek

Pengaturan lalu lintas serekan untuk Lingkungan Terkelola

Nama	Jenis	Deskripsi
encryption	Encryption	Pengaturan enkripsi lalu lintas serekan untuk Lingkungan Terkelola

PrivateEndpoint

Objek

Sumber daya Titik Akhir Privat.

Nama	Jenis	Deskripsi
id	string (arm-id)	Pengidentifikasi ARM untuk Titik Akhir Privat

PrivateEndpointConnection

Objek

Sumber daya Koneksi Titik Akhir Privat.

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nama sumber daya
properties.groupIds	string[]	Id grup untuk sumber daya titik akhir privat.
properties.privateEndpoint	PrivateEndpoint	Sumber daya titik akhir privat.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Kumpulan informasi tentang status koneksi antara konsumen layanan dan penyedia.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	Status provisi sumber daya koneksi titik akhir privat.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

Enumerasi

Status provisi saat ini.

Nilai	Deskripsi
Succeeded
Failed
Canceled
Waiting
Updating
Deleting
Pending

PrivateEndpointServiceConnectionStatus

Enumerasi

Status koneksi titik akhir privat.

Nilai	Deskripsi
Pending
Approved
Rejected
Disconnected

PrivateLinkServiceConnectionState

Objek

Kumpulan informasi tentang status koneksi antara konsumen layanan dan penyedia.

Nama	Jenis	Deskripsi
actionsRequired	string	Pesan yang menunjukkan apakah perubahan pada penyedia layanan memerlukan pembaruan pada konsumen.
description	string	Alasan persetujuan/penolakan koneksi.
status	PrivateEndpointServiceConnectionStatus	Menunjukkan apakah koneksi telah Disetujui/Ditolak/Dihapus oleh pemilik layanan.

PublicNetworkAccess

Enumerasi

Properti untuk mengizinkan atau memblokir semua lalu lintas publik. Nilai yang diizinkan: 'Diaktifkan', 'Dinonaktifkan'.

Nilai	Deskripsi
Enabled
Disabled

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

UserAssignedIdentity

Objek

Properti identitas yang ditetapkan pengguna

Nama	Jenis	Deskripsi
clientId	string (uuid)	ID klien dari identitas yang ditetapkan.
principalId	string (uuid)	ID utama identitas yang ditetapkan.

VnetConfiguration

Objek

Properti konfigurasi untuk lingkungan aplikasi untuk bergabung dengan Virtual Network

Nama	Jenis	Deskripsi
dockerBridgeCidr	string	Rentang IP notasi CIDR yang ditetapkan ke jembatan Docker, jaringan. Tidak boleh tumpang tindih dengan rentang IP lain yang disediakan.
infrastructureSubnetId	string	ID sumber daya subnet untuk komponen infrastruktur. Tidak boleh tumpang tindih dengan rentang IP lain yang disediakan.
internal	boolean	Boolean menunjukkan lingkungan hanya memiliki penyeimbang beban internal. Lingkungan ini tidak memiliki sumber daya IP statis publik. Mereka harus menyediakan infrastructureSubnetId jika mengaktifkan properti ini
platformReservedCidr	string	Rentang IP dalam notasi CIDR yang dapat dicadangkan untuk alamat IP infrastruktur lingkungan. Tidak boleh tumpang tindih dengan rentang IP lain yang disediakan.
platformReservedDnsIP	string	Alamat IP dari rentang IP yang ditentukan oleh platformReservedCidr yang akan dicadangkan untuk server DNS internal.

WorkloadProfile

Objek

Profil beban kerja untuk mencakup eksekusi aplikasi kontainer.

Nama	Jenis	Deskripsi
maximumCount	integer (int32)	Kapasitas maksimum.
minimumCount	integer (int32)	Kapasitas minimum.
name	string	Jenis profil beban kerja untuk menjalankan beban kerja.
workloadProfileType	string	Jenis profil beban kerja untuk menjalankan beban kerja.

Bagikan melalui

Managed Environments - List By Resource Group

Parameter URI

Respons

Keamanan

azure_auth

Cakupan

Contoh

List environments by resource group

Permintaan sampel

Respon sampel

Definisi

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