Managed Environments - List By Resource Group
Pobierz wszystkie środowiska w grupie zasobów.
Pobierz wszystkie środowiska zarządzane w grupie zasobów.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/managedEnvironments?api-version=2026-01-01
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
subscription
|
path | True |
string minLength: 1 |
Identyfikator subskrypcji docelowej. |
|
api-version
|
query | True |
string minLength: 1 |
Wersja interfejsu API do użycia dla tej operacji. |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
OK |
|
| Other Status Codes |
Typowa odpowiedź na błąd. |
Zabezpieczenia
azure_auth
Przepływ protokołu OAuth2 usługi Azure Active Directory
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
| Nazwa | Opis |
|---|---|
| user_impersonation | personifikacja konta użytkownika |
Przykłady
List environments by resource group
Przykładowe żądanie
GET https://management.azure.com/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments?api-version=2026-01-01
Przykładowa odpowiedź
{
"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"
}
}
]
}
Definicje
| Nazwa | Opis |
|---|---|
|
App |
Konfiguracja dzienników aplikacji |
|
Certificate |
Właściwości certyfikatu przechowywanego w usłudze Key Vault. |
|
created |
Typ tożsamości, która utworzyła zasób. |
|
Custom |
Właściwości konfiguracji dla domeny niestandardowej środowiska aplikacji |
|
Dapr |
Właściwości konfiguracji— składnik języka Dapr |
| Encryption |
Ustawienia szyfrowania ruchu równorzędnego dla środowiska zarządzanego |
|
Environment |
Stan aprowizacji środowiska. |
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
Odpowiedź na błąd |
|
Ingress |
Ustawienia składnika ruchu przychodzącego, w tym profil obciążenia, skalowanie i obsługa połączeń. |
|
Keda |
Właściwości konfiguracji składnika Keda |
|
Log |
Konfiguracja usługi Log Analytics musi być podana tylko wtedy, gdy lokalizacja docelowa jest skonfigurowana jako "log-analytics" |
|
Managed |
Środowisko do hostowania aplikacji kontenerów |
|
Managed |
Kolekcja środowisk |
|
Managed |
Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub tożsamości przypisane przez użytkownika) |
|
Managed |
Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). |
| Mtls |
Właściwości konfiguracji na potrzeby wzajemnego uwierzytelniania TLS |
|
Peer |
Ustawienia uwierzytelniania równorzędnego dla środowiska zarządzanego |
|
Peer |
Ustawienia ruchu równorzędnego dla środowiska zarządzanego |
|
Private |
Zasób prywatnego punktu końcowego. |
|
Private |
Zasób połączenia prywatnego punktu końcowego. |
|
Private |
Bieżący stan aprowizacji. |
|
Private |
Stan połączenia prywatnego punktu końcowego. |
|
Private |
Zbiór informacji o stanie połączenia między użytkownikiem usługi a dostawcą. |
|
Public |
Właściwość zezwala na cały ruch publiczny lub blokuje go. Dozwolone wartości: "Włączone", "Wyłączone". |
|
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
|
User |
Właściwości tożsamości przypisanej przez użytkownika |
|
Vnet |
Właściwości konfiguracji środowiska aplikacji w celu dołączenia do sieci wirtualnej |
|
Workload |
Profil obciążenia umożliwiający określanie zakresu wykonywania aplikacji kontenera. |
AppLogsConfiguration
Konfiguracja dzienników aplikacji
| Nazwa | Typ | Opis |
|---|---|---|
| destination |
string |
Miejsce docelowe dzienników może być "log-analytics", "azure-monitor" lub "none" |
| logAnalyticsConfiguration |
Konfiguracja usługi Log Analytics musi być podana tylko wtedy, gdy lokalizacja docelowa jest skonfigurowana jako "log-analytics" |
CertificateKeyVaultProperties
Właściwości certyfikatu przechowywanego w usłudze Key Vault.
| Nazwa | Typ | Opis |
|---|---|---|
| identity |
string |
Identyfikator zasobu tożsamości zarządzanej do uwierzytelniania przy użyciu Azure Key Vault lub system do używania tożsamości przypisanej przez system. |
| keyVaultUrl |
string (uri) |
Adres URL wskazujący wpis tajny usługi Azure Key Vault, który przechowuje certyfikat. |
createdByType
Typ tożsamości, która utworzyła zasób.
| Wartość | Opis |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
CustomDomainConfiguration
Właściwości konfiguracji dla domeny niestandardowej środowiska aplikacji
| Nazwa | Typ | Opis |
|---|---|---|
| certificateKeyVaultProperties |
Certyfikat przechowywany w usłudze Azure Key Vault. |
|
| certificatePassword |
string |
Hasło certyfikatu |
| certificateValue |
string (byte) |
Obiekt blob PFX lub PEM |
| customDomainVerificationId |
string |
Identyfikator używany do weryfikacji własności nazwy domeny |
| dnsSuffix |
string |
Sufiks DNS dla domeny środowiska |
| expirationDate |
string (date-time) |
Data wygaśnięcia certyfikatu. |
| subjectName |
string |
Nazwa podmiotu certyfikatu. |
| thumbprint |
string |
Odcisk palca certyfikatu. |
DaprConfiguration
Właściwości konfiguracji— składnik języka Dapr
| Nazwa | Typ | Opis |
|---|---|---|
| version |
string |
Wersja języka Dapr |
Encryption
Ustawienia szyfrowania ruchu równorzędnego dla środowiska zarządzanego
| Nazwa | Typ | Opis |
|---|---|---|
| enabled |
boolean |
Wartość logiczna wskazująca, czy szyfrowanie ruchu równorzędnego jest włączone |
EnvironmentProvisioningState
Stan aprowizacji środowiska.
| Wartość | Opis |
|---|---|
| Succeeded | |
| Failed | |
| Canceled | |
| Waiting | |
| InitializationInProgress | |
| InfrastructureSetupInProgress | |
| InfrastructureSetupComplete | |
| ScheduledForDelete | |
| UpgradeRequested | |
| UpgradeFailed |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
| Nazwa | Typ | Opis |
|---|---|---|
| info |
object |
Dodatkowe informacje. |
| type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
| Nazwa | Typ | Opis |
|---|---|---|
| additionalInfo |
Dodatkowe informacje o błędzie. |
|
| code |
string |
Kod błędu. |
| details |
Szczegóły błędu. |
|
| message |
string |
Komunikat o błędzie. |
| target |
string |
Cel błędu. |
ErrorResponse
Odpowiedź na błąd
| Nazwa | Typ | Opis |
|---|---|---|
| error |
Obiekt błędu. |
IngressConfiguration
Ustawienia składnika ruchu przychodzącego, w tym profil obciążenia, skalowanie i obsługa połączeń.
| Nazwa | Typ | Opis |
|---|---|---|
| headerCountLimit |
integer (int32) |
Maksymalna liczba nagłówków na żądanie dozwolona przez ruch przychodzący. Musi być co najmniej 1. Wartość domyślna to 100. |
| requestIdleTimeout |
integer (int32) |
Czas trwania (w minutach) przed upływem limitu czasu bezczynnych żądań. Musi należeć do przedziału od 4 do 30 włącznie. Wartość domyślna to 4 minuty. |
| terminationGracePeriodSeconds |
integer (int32) |
Czas (w sekundach) umożliwiający zakończenie aktywnych połączeń. Musi należeć do zakresu od 0 do 3600. Wartość domyślna to 480 sekund. |
| workloadProfileName |
string |
Nazwa profilu obciążenia używanego przez składnik ruchu przychodzącego. To jest wymagane. |
KedaConfiguration
Właściwości konfiguracji składnika Keda
| Nazwa | Typ | Opis |
|---|---|---|
| version |
string |
Wersja Kedy |
LogAnalyticsConfiguration
Konfiguracja usługi Log Analytics musi być podana tylko wtedy, gdy lokalizacja docelowa jest skonfigurowana jako "log-analytics"
| Nazwa | Typ | Opis |
|---|---|---|
| customerId |
string |
Identyfikator klienta usługi Log Analytics |
| sharedKey |
string |
Klucz klienta usługi Log Analytics |
ManagedEnvironment
Środowisko do hostowania aplikacji kontenerów
| Nazwa | Typ | Opis |
|---|---|---|
| id |
string (arm-id) |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| identity |
Tożsamości zarządzane dla środowiska zarządzanego umożliwiające interakcję z innymi usługami platformy Azure bez obsługi wpisów tajnych ani poświadczeń w kodzie. |
|
| kind |
string |
Rodzaj środowiska. |
| location |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
| name |
string |
Nazwa zasobu |
| properties.appLogsConfiguration |
Konfiguracja klastra umożliwiająca demonowi dziennika eksportowanie dzienników dzienników do skonfigurowanego miejsca docelowego. |
|
| properties.customDomainConfiguration |
Konfiguracja domeny niestandardowej dla środowiska |
|
| properties.daprAIConnectionString |
string |
Usługa Application Insights connection string używana przez dapr do eksportowania danych telemetrycznych komunikacji między usługami |
| properties.daprAIInstrumentationKey |
string |
Azure Monitor klucz instrumentacji używany przez dapr do eksportowania telemetrii komunikacji z usługą |
| properties.daprConfiguration |
Konfiguracja składnika Dapr. |
|
| properties.defaultDomain |
string |
Domyślna nazwa domeny dla klastra |
| properties.deploymentErrors |
string |
Wszelkie błędy, które wystąpiły podczas wdrażania lub walidacji wdrożenia |
| properties.eventStreamEndpoint |
string |
Punkt końcowy strumienia zdarzeń środowiska. |
| properties.infrastructureResourceGroup |
string |
Nazwa zarządzanej przez platformę grupy zasobów utworzonej dla środowiska zarządzanego do hostowania zasobów infrastruktury. Jeśli zostanie podany identyfikator podsieci, ta grupa zasobów zostanie utworzona w tej samej subskrypcji co podsieć. |
| properties.ingressConfiguration |
Konfiguracja ruchu przychodzącego dla środowiska zarządzanego. |
|
| properties.kedaConfiguration |
Konfiguracja składnika Keda. |
|
| properties.peerAuthentication |
Ustawienia uwierzytelniania równorzędnego dla środowiska zarządzanego |
|
| properties.peerTrafficConfiguration |
Ustawienia ruchu równorzędnego dla środowiska zarządzanego |
|
| properties.privateEndpointConnections |
Połączenia prywatnego punktu końcowego z zasobem. |
|
| properties.provisioningState |
Stan aprowizacji środowiska. |
|
| properties.publicNetworkAccess |
Właściwość zezwala na cały ruch publiczny lub blokuje go. Dozwolone wartości: "Włączone", "Wyłączone". |
|
| properties.staticIp |
string |
Statyczny adres IP środowiska |
| properties.vnetConfiguration |
Konfiguracja sieci wirtualnej dla środowiska |
|
| properties.workloadProfiles |
Profile obciążeń skonfigurowane dla środowiska zarządzanego. |
|
| properties.zoneRedundant |
boolean |
Bez względu na to, czy to środowisko zarządzane jest strefowo nadmiarowe. |
| systemData |
Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”. |
|
| tags |
object |
Tagi zasobów. |
| type |
string |
Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts" |
ManagedEnvironmentsCollection
Kolekcja środowisk
| Nazwa | Typ | Opis |
|---|---|---|
| nextLink |
string |
Łącze do następnej strony zasobów. |
| value |
Gromadzenie zasobów. |
ManagedServiceIdentity
Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub tożsamości przypisane przez użytkownika)
| Nazwa | Typ | Opis |
|---|---|---|
| principalId |
string (uuid) |
Identyfikator jednostki usługi tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system. |
| tenantId |
string (uuid) |
Identyfikator dzierżawy tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system. |
| type |
Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). |
|
| userAssignedIdentities |
<string,
User |
tożsamości User-Assigned |
ManagedServiceIdentityType
Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).
| Wartość | Opis |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
Mtls
Właściwości konfiguracji na potrzeby wzajemnego uwierzytelniania TLS
| Nazwa | Typ | Opis |
|---|---|---|
| enabled |
boolean |
Wartość logiczna wskazująca, czy wzajemne uwierzytelnianie TLS jest włączone |
PeerAuthentication
Ustawienia uwierzytelniania równorzędnego dla środowiska zarządzanego
| Nazwa | Typ | Opis |
|---|---|---|
| mtls |
Wzajemne ustawienia uwierzytelniania TLS dla środowiska zarządzanego |
PeerTrafficConfiguration
Ustawienia ruchu równorzędnego dla środowiska zarządzanego
| Nazwa | Typ | Opis |
|---|---|---|
| encryption |
Ustawienia szyfrowania ruchu równorzędnego dla środowiska zarządzanego |
PrivateEndpoint
Zasób prywatnego punktu końcowego.
| Nazwa | Typ | Opis |
|---|---|---|
| id |
string (arm-id) |
Identyfikator usługi ARM dla prywatnego punktu końcowego |
PrivateEndpointConnection
Zasób połączenia prywatnego punktu końcowego.
| Nazwa | Typ | Opis |
|---|---|---|
| id |
string (arm-id) |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Nazwa zasobu |
| properties.groupIds |
string[] |
Identyfikatory grupy dla zasobu prywatnego punktu końcowego. |
| properties.privateEndpoint |
Zasób prywatnego punktu końcowego. |
|
| properties.privateLinkServiceConnectionState |
Zbiór informacji o stanie połączenia między użytkownikiem usługi a dostawcą. |
|
| properties.provisioningState |
Stan aprowizacji zasobu połączenia prywatnego punktu końcowego. |
|
| systemData |
Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”. |
|
| type |
string |
Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts" |
PrivateEndpointConnectionProvisioningState
Bieżący stan aprowizacji.
| Wartość | Opis |
|---|---|
| Succeeded | |
| Failed | |
| Canceled | |
| Waiting | |
| Updating | |
| Deleting | |
| Pending |
PrivateEndpointServiceConnectionStatus
Stan połączenia prywatnego punktu końcowego.
| Wartość | Opis |
|---|---|
| Pending | |
| Approved | |
| Rejected | |
| Disconnected |
PrivateLinkServiceConnectionState
Zbiór informacji o stanie połączenia między użytkownikiem usługi a dostawcą.
| Nazwa | Typ | Opis |
|---|---|---|
| actionsRequired |
string |
Komunikat wskazujący, czy zmiany u dostawcy usług wymagają aktualizacji odbiorcy. |
| description |
string |
Przyczyna zatwierdzenia/odrzucenia połączenia. |
| status |
Wskazuje, czy połączenie zostało zatwierdzone/odrzucone/usunięte przez właściciela usługi. |
PublicNetworkAccess
Właściwość zezwala na cały ruch publiczny lub blokuje go. Dozwolone wartości: "Włączone", "Wyłączone".
| Wartość | Opis |
|---|---|
| Enabled | |
| Disabled |
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
| Nazwa | Typ | Opis |
|---|---|---|
| createdAt |
string (date-time) |
Sygnatura czasowa tworzenia zasobu (UTC). |
| createdBy |
string |
Tożsamość, która utworzyła zasób. |
| createdByType |
Typ tożsamości, która utworzyła zasób. |
|
| lastModifiedAt |
string (date-time) |
Znacznik czasu ostatniej modyfikacji zasobu (UTC) |
| lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
| lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |
UserAssignedIdentity
Właściwości tożsamości przypisanej przez użytkownika
| Nazwa | Typ | Opis |
|---|---|---|
| clientId |
string (uuid) |
Identyfikator klienta przypisanej tożsamości. |
| principalId |
string (uuid) |
Identyfikator podmiotu zabezpieczeń przypisanej tożsamości. |
VnetConfiguration
Właściwości konfiguracji środowiska aplikacji w celu dołączenia do sieci wirtualnej
| Nazwa | Typ | Opis |
|---|---|---|
| dockerBridgeCidr |
string |
Zakres adresów IP notacji CIDR przypisany do mostka platformy Docker, sieci. Nie może pokrywać się z żadnymi innymi podanymi zakresami adresów IP. |
| infrastructureSubnetId |
string |
Identyfikator zasobu podsieci dla składników infrastruktury. Nie może pokrywać się z żadnymi innymi podanymi zakresami adresów IP. |
| internal |
boolean |
Wartość logiczna wskazująca, że środowisko ma tylko wewnętrzny moduł równoważenia obciążenia. Te środowiska nie mają publicznego zasobu statycznego adresu IP. W przypadku włączenia tej właściwości muszą podać identyfikator infrastructureSubnetId |
| platformReservedCidr |
string |
Zakres adresów IP w notacji CIDR, który może być zarezerwowany dla adresów IP infrastruktury środowiska. Nie może pokrywać się z żadnymi innymi podanymi zakresami adresów IP. |
| platformReservedDnsIP |
string |
Adres IP z zakresu adresów IP zdefiniowany przez platformęReservedCidr, który będzie zarezerwowany dla wewnętrznego serwera DNS. |
WorkloadProfile
Profil obciążenia umożliwiający określanie zakresu wykonywania aplikacji kontenera.
| Nazwa | Typ | Opis |
|---|---|---|
| maximumCount |
integer (int32) |
Maksymalna pojemność. |
| minimumCount |
integer (int32) |
Minimalna pojemność. |
| name |
string |
Typ profilu obciążenia dla obciążeń do uruchomienia. |
| workloadProfileType |
string |
Typ profilu obciążenia dla obciążeń do uruchomienia. |