통합 문서 리소스 매개 변수

아티클
11/05/2024

리소스 매개 변수를 사용하여 통합 문서에서 리소스를 선택할 수 있습니다. 이 기능은 데이터를 가져올 범위를 설정하는 데 유용합니다. 사용자가 나중에 데이터를 표시할 때 차트에서 사용할 VM 세트를 선택할 수 있도록 허용하는 경우를 예로 들 수 있습니다.

리소스 선택기의 값은 통합 문서 컨텍스트, 정적 목록 또는 Azure Resource Graph 쿼리에서 가져올 수 있습니다.

참고 항목

리소스 매개 변수 목록의 각 리소스에 대한 레이블은 리소스 ID를 기반으로 합니다. 해당 이름은 다른 값으로 바꿀 수 없습니다. 다시 한번 말하지만 이 문서의 예제에서는 ID로 설정된 레이블 필드를 사용하지만 해당 값은 실제 매개 변수에 사용되지 않습니다.

리소스 매개 변수 만들기(통합 문서 리소스)

편집 모드에서 빈 통합 문서로 시작합니다.
매개 변수 추가>매개 변수 추가를 선택합니다.
열리는 새 매개 변수 창에서 다음을 입력합니다.
1. 매개 변수 이름: Applications
2. 매개 변수 형식: Resource picker
3. 필수: checked
4. 복수 선택 허용: checked
5. 데이터 출처: Workbook Resources
6. 리소스 종류만 포함: Application Insights
저장을 선택하여 매개 변수를 만듭니다.

Azure Resource Graph 리소스 매개 변수 만들기

편집 모드에서 빈 통합 문서로 시작합니다.
매개 변수 추가>매개 변수 추가를 선택합니다.
열리는 새 매개 변수 창에서 다음을 입력합니다.
1. 매개 변수 이름: Applications
2. 매개 변수 형식: Resource picker
3. 필수: checked
4. 복수 선택 허용: checked
5. 데이터 출처: Query
6. 쿼리 유형: Azure Resource Graph
7. 구독: Use default subscriptions
8. 쿼리 컨트롤에서 다음 코드 조각을 추가합니다.
```
where type == 'microsoft.insights/components'
| project value = id, label = id, selected = false, group = resourceGroup
```
저장을 선택하여 매개 변수를 만듭니다.

Azure Resource Graph 대한 자세한 내용은 Azure Resource Graph란?을 참조하세요.

JSON 목록 리소스 매개 변수 만들기

편집 모드에서 빈 통합 문서로 시작합니다.
매개 변수 추가>매개 변수 추가를 선택합니다.

열리는 새 매개 변수 창에서 다음을 입력합니다.

매개 변수 이름: Applications
매개 변수 형식: Resource picker
필수: checked
복수 선택 허용: checked
데이터 출처: JSON

콘텐츠 컨트롤에서 다음 JSON 코드 조각을 추가합니다.

[
    { "value":"/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication", "selected":true, "group":"Acme Backend" },
    { "value":"/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeweb", "selected":false, "group":"Acme Frontend" }
]

업데이트를 선택합니다.

필요에 따라 Include only resource types를 Application Insights로 설정합니다.
저장을 선택하여 매개 변수를 만듭니다.

리소스 매개 변수 참조

쿼리 추가를 선택하여 쿼리 제어를 추가한 다음 Application Insights 리소스를 선택합니다.
Application Insights 드롭다운 목록을 사용하여 매개 변수를 컨트롤에 바인딩합니다. 이 단계를 수행하면 쿼리 범위가 런타임에 매개 변수에 의해 반환되는 리소스로 설정됩니다.

KQL 컨트롤에서 다음 코드 조각을 추가합니다.

requests
| summarize Requests = count() by appName, name
| order by Requests desc

쿼리를 실행하여 결과를 확인합니다.

이 접근 방식은 리소스를 메트릭과 같은 다른 컨트롤에 바인딩하는 데 사용할 수 있습니다.

리소스 매개 변수 옵션

매개 변수	설명	예시
`{Applications}`	선택한 리소스 ID입니다.	/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication
`{Applications:label}`	선택한 리소스의 레이블입니다.	`acmefrontend` 참고: 다중 값 리소스 매개 변수의 경우 이 레이블은 `acmefrontend (+3 others)`와(과) 같이 단축될 수 있으며, 선택한 모든 값의 모든 레이블을 포함하지 않을 수 있습니다.
`{Applications:value}`	선택한 리소스의 값입니다.	'/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication'
`{Applications:name}`	선택한 리소스의 이름입니다.	`acmefrontend`
`{Applications:resourceGroup}`	선택한 리소스의 리소스 그룹입니다.	`acmegroup`
`{Applications:resourceType}`	선택한 리소스의 종류입니다.	microsoft.insights/components
`{Applications:subscription}`	선택한 리소스의 구독입니다.
`{Applications:grid}`	리소스 속성을 보여 주는 그리드입니다. 디버그하는 동안 텍스트 블록에서 렌더링하는 데 유용합니다.

다음 단계

Azure 통합 문서 시작

다음을 통해 공유