Параметры ресурса книги

Статья
11/05/2024

Параметры ресурсов позволяют выбирать ресурсы в книгах. Эта возможность полезна при указании области, из которой следует получать данные. Например, пользователи могут выбрать набор виртуальных машин, которые впоследствии будут использоваться при представлении данных на диаграммах.

Значения из средств выбора ресурсов могут поступать из контекста книги, статического списка или из запросов 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

Начните с пустой книги в режиме редактирования.
Выберите Добавить параметры>Добавить параметр.
В открывающейся области параметров введите:
1. Имя параметра: Applications
2. Тип параметра: Resource picker
3. Требуется: checked
4. Разрешить множественный выбор: checked
5. Получать данные из: JSON
6. Добавьте следующий фрагмент 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" }
]
```
7. Выберите Обновить.
При необходимости задайте для параметра 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

Поделиться через