Managed Environments - Get

서비스:: Azure Container Apps

API 버전:: 2026-01-01

컨테이너 앱을 호스트하는 데 사용되는 관리되는 환경의 속성을 가져옵니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
environmentName	path	True	string	환경의 이름입니다.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string minLength: 1	대상 구독의 ID입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	ManagedEnvironment	그래
Other Status Codes	ErrorResponse	일반적인 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Get environments by name

샘플 요청

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

샘플 응답

상태 코드:: 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
    }
  }
}

정의

Name	Description
AppLogsConfiguration	애플리케이션 로그 구성
CertificateKeyVaultProperties	Key Vault에 저장된 인증서의 속성입니다.
createdByType	리소스를 만든 ID의 형식입니다.
CustomDomainConfiguration	앱 환경 사용자 지정 도메인에 대한 구성 속성
DaprConfiguration	구성 속성 Dapr 구성 요소
Encryption	관리 환경에 대한 피어 트래픽 암호화 설정
EnvironmentProvisioningState	환경의 프로비전 상태입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
IngressConfiguration	워크로드 프로필, 크기 조정 및 연결 처리를 포함한 수신 구성 요소에 대한 설정입니다.
KedaConfiguration	구성 속성 Keda 구성 요소
LogAnalyticsConfiguration	Log Analytics 구성은 대상이 'log-analytics'로 구성된 경우에만 제공해야 합니다.
ManagedEnvironment	컨테이너 앱을 호스팅하기 위한 환경
ManagedServiceIdentity	관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID)
ManagedServiceIdentityType	관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).
Mtls	상호 TLS 인증을 위한 구성 속성
PeerAuthentication	관리되는 환경에 대한 피어 인증 설정
PeerTrafficConfiguration	관리되는 환경에 대한 피어 트래픽 설정
PrivateEndpoint	프라이빗 엔드포인트 리소스입니다.
PrivateEndpointConnection	프라이빗 엔드포인트 연결 리소스입니다.
PrivateEndpointConnectionProvisioningState	현재 프로비저닝 상태입니다.
PrivateEndpointServiceConnectionStatus	프라이빗 엔드포인트 연결 상태입니다.
PrivateLinkServiceConnectionState	서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.
PublicNetworkAccess	모든 공용 트래픽을 허용하거나 차단하는 속성입니다. 허용되는 값: 'Enabled', 'Disabled'.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
UserAssignedIdentity	사용자 할당 ID 속성
VnetConfiguration	Virtual Network를 조인하는 앱 환경의 구성 속성
WorkloadProfile	컨테이너 앱 실행 범위를 지정하는 워크로드 프로필입니다.

AppLogsConfiguration

Object

애플리케이션 로그 구성

Name	형식	Description
destination	string	로그 대상은 'log-analytics', 'azure-monitor' 또는 'none'일 수 있습니다.
logAnalyticsConfiguration	LogAnalyticsConfiguration	Log Analytics 구성은 대상이 'log-analytics'로 구성된 경우에만 제공해야 합니다.

CertificateKeyVaultProperties

Object

Key Vault에 저장된 인증서의 속성입니다.

Name	형식	Description
identity	string	Azure Key Vault 인증할 관리 ID의 리소스 ID이거나 시스템 할당 ID를 사용하는 시스템 ID입니다.
keyVaultUrl	string (uri)	인증서를 보유하는 Azure Key Vault 비밀을 가리키는 URL입니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

CustomDomainConfiguration

Object

앱 환경 사용자 지정 도메인에 대한 구성 속성

Name	형식	Description
certificateKeyVaultProperties	CertificateKeyVaultProperties	Azure Key Vault에 저장된 인증서입니다.
certificatePassword	string	인증서 암호
certificateValue	string (byte)	PFX 또는 PEM Blob
customDomainVerificationId	string	도메인 이름 소유권을 확인하는 데 사용되는 ID
dnsSuffix	string	환경 도메인에 대한 Dns 접미사
expirationDate	string (date-time)	인증서 만료 날짜입니다.
subjectName	string	인증서의 주체 이름입니다.
thumbprint	string	인증서 지문.

DaprConfiguration

Object

구성 속성 Dapr 구성 요소

Name	형식	Description
version	string	Dapr 버전

Encryption

Object

관리 환경에 대한 피어 트래픽 암호화 설정

Name	형식	Description
enabled	boolean	피어 트래픽 암호화를 사용할 수 있는지 여부를 나타내는 부울

EnvironmentProvisioningState

열거형

환경의 프로비전 상태입니다.

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

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

IngressConfiguration

Object

워크로드 프로필, 크기 조정 및 연결 처리를 포함한 수신 구성 요소에 대한 설정입니다.

Name	형식	Description
headerCountLimit	integer (int32)	수신에서 허용하는 요청당 최대 헤더 수입니다. 최소한 1 이상이어야 합니다. 기본값은 100입니다.
requestIdleTimeout	integer (int32)	유휴 요청 시간이 초과되기 전의 기간(분)입니다. 4에서 30 사이여야 합니다. 기본값은 4분입니다.
terminationGracePeriodSeconds	integer (int32)	종료 시 활성 연결이 완료될 수 있는 시간(초)입니다. 0에서 3600 사이여야 합니다. 기본값은 480초입니다.
workloadProfileName	string	ingress 구성 요소에서 사용하는 워크로드 프로필의 이름입니다. 필수입니다.

KedaConfiguration

Object

구성 속성 Keda 구성 요소

Name	형식	Description
version	string	Keda의 버전

LogAnalyticsConfiguration

Object

Log Analytics 구성은 대상이 'log-analytics'로 구성된 경우에만 제공해야 합니다.

Name	형식	Description
customerId	string	Log Analytics 고객 ID
sharedKey	string	Log Analytics 고객 키