活頁簿資源參數

發行項
10/15/2024

資源參數允許在活頁簿中挑選資源。這項功能在設定要從中取得資料的範圍時很有用。例如，可讓您選取圖表稍後在呈現資料時使用的這組 VM。

資源選擇器的值可以來自活頁簿內容、靜態清單或 Azure Resource Graph 查詢。

注意

資源參數清單中的每個資源標籤是以資源識別碼為基礎。您無法將該名稱取代為另一個值。為了清楚起見，本文件中的範例會顯示設定為標識符的標籤欄位，但該值不會用於實際參數。

建立資源參數 (活頁簿資源)

從編輯模式中的空白活頁簿開始。
選取 [新增參數] >[新增參數]。
在開啟的新參數窗格中，輸入：
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}`	選取的資源識別碼。	/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 活頁簿

共用方式為