Udostępnij za pośrednictwem


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
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

subscriptionId
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

ManagedEnvironmentsCollection

OK

Other Status Codes

ErrorResponse

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
AppLogsConfiguration

Konfiguracja dzienników aplikacji

CertificateKeyVaultProperties

Właściwości certyfikatu przechowywanego w usłudze Key Vault.

createdByType

Typ tożsamości, która utworzyła zasób.

CustomDomainConfiguration

Właściwości konfiguracji dla domeny niestandardowej środowiska aplikacji

DaprConfiguration

Właściwości konfiguracji— składnik języka Dapr

Encryption

Ustawienia szyfrowania ruchu równorzędnego dla środowiska zarządzanego

EnvironmentProvisioningState

Stan aprowizacji środowiska.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

IngressConfiguration

Ustawienia składnika ruchu przychodzącego, w tym profil obciążenia, skalowanie i obsługa połączeń.

KedaConfiguration

Właściwości konfiguracji składnika Keda

LogAnalyticsConfiguration

Konfiguracja usługi Log Analytics musi być podana tylko wtedy, gdy lokalizacja docelowa jest skonfigurowana jako "log-analytics"

ManagedEnvironment

Środowisko do hostowania aplikacji kontenerów

ManagedEnvironmentsCollection

Kolekcja środowisk

ManagedServiceIdentity

Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub tożsamości przypisane przez użytkownika)

ManagedServiceIdentityType

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

PeerAuthentication

Ustawienia uwierzytelniania równorzędnego dla środowiska zarządzanego

PeerTrafficConfiguration

Ustawienia ruchu równorzędnego dla środowiska zarządzanego

PrivateEndpoint

Zasób prywatnego punktu końcowego.

PrivateEndpointConnection

Zasób połączenia prywatnego punktu końcowego.

PrivateEndpointConnectionProvisioningState

Bieżący stan aprowizacji.

PrivateEndpointServiceConnectionStatus

Stan połączenia prywatnego punktu końcowego.

PrivateLinkServiceConnectionState

Zbiór informacji o stanie połączenia między użytkownikiem usługi a dostawcą.

PublicNetworkAccess

Właściwość zezwala na cały ruch publiczny lub blokuje go. Dozwolone wartości: "Włączone", "Wyłączone".

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

UserAssignedIdentity

Właściwości tożsamości przypisanej przez użytkownika

VnetConfiguration

Właściwości konfiguracji środowiska aplikacji w celu dołączenia do sieci wirtualnej

WorkloadProfile

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

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

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

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Cel błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

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

ManagedServiceIdentity

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

AppLogsConfiguration

Konfiguracja klastra umożliwiająca demonowi dziennika eksportowanie dzienników dzienników do skonfigurowanego miejsca docelowego.

properties.customDomainConfiguration

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

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

IngressConfiguration

Konfiguracja ruchu przychodzącego dla środowiska zarządzanego.

properties.kedaConfiguration

KedaConfiguration

Konfiguracja składnika Keda.

properties.peerAuthentication

PeerAuthentication

Ustawienia uwierzytelniania równorzędnego dla środowiska zarządzanego

properties.peerTrafficConfiguration

PeerTrafficConfiguration

Ustawienia ruchu równorzędnego dla środowiska zarządzanego

properties.privateEndpointConnections

PrivateEndpointConnection[]

Połączenia prywatnego punktu końcowego z zasobem.

properties.provisioningState

EnvironmentProvisioningState

Stan aprowizacji środowiska.

properties.publicNetworkAccess

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

VnetConfiguration

Konfiguracja sieci wirtualnej dla środowiska

properties.workloadProfiles

WorkloadProfile[]

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

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

ManagedEnvironment[]

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

ManagedServiceIdentityType

Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).

userAssignedIdentities

<string,  UserAssignedIdentity>

tożsamości User-Assigned
Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach.

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

Mtls

Wzajemne ustawienia uwierzytelniania TLS dla środowiska zarządzanego

PeerTrafficConfiguration

Ustawienia ruchu równorzędnego dla środowiska zarządzanego

Nazwa Typ Opis
encryption

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

PrivateEndpoint

Zasób prywatnego punktu końcowego.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Zbiór informacji o stanie połączenia między użytkownikiem usługi a dostawcą.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

Stan aprowizacji zasobu połączenia prywatnego punktu końcowego.

systemData

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

PrivateEndpointServiceConnectionStatus

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

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

createdByType

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.