Действия связи

Доступ к действиям ссылок можно получить с помощью компонентов ссылок книги или с помощью параметров столбцов в сетках, плитках или графах.

Общие действия ссылок

Действие ссылки	Действие при выборе
Общие сведения	Показывает значения строк в представлении контекста сетки свойств.
Сведения о ячейке	Показывает значение ячейки в представлении контекста сетки свойств. Удобно, если ячейка содержит динамический тип с информацией (например, объект JSON с такими свойствами запроса, как расположение и экземпляр роли).
URL	Ожидается, что значение ячейки будет представлять собой допустимый URL-адрес HTTP. Ячейка — это ссылка, при щелчке по которой этот URL-адрес открывается в новой вкладке.

Application Insights

Действие ссылки	Действие при выборе
Данные пользовательских событий	Открывает сведения о поиске в Application Insights с идентификатором пользовательского события (itemId) в ячейке.
Сведения	Работает аналогично действию "Сведения о пользовательском событии", но не отображает сведения о зависимостях, исключениях, просмотрах страниц, запросах и трассировках.
Пользовательские потоки для пользовательских событий	Открывает представление навигации пользователей в инструменте Application Insights "Маршруты пользователей", сведенное по имени пользовательского события в ячейке.
Маршруты пользователей	Работает аналогично действию "Пользовательские потоки для пользовательских событий", но не отображает сведения об исключениях, просмотрах страниц и запросах.
Временная шкала пользователя	Открывает временную шкалу пользователя с идентификатором пользователя (user_Id) в ячейке.
Временная шкала сеанса	Открывает область поиска в Application Insights для значения в ячейке, например, для поиска текста абв, где "абв" — значение в ячейке.

Ресурс Azure

Действие ссылки	Действие при выборе
Развертывание ARM	Развертывает шаблон Azure Resource Manager (ARM). При выборе этого элемента отображаются дополнительные поля, с помощью которых можно выбрать, какой шаблон ARM будет открыт, и настроить его параметры. См. параметры ссылок для развертывания Azure Resource Manager.
Создание правила генерации оповещений	Создает правило генерации оповещений для ресурса.
Пользовательское представление	Открывает пользовательское представление. При выборе этого элемента отображаются дополнительные поля, в которых можно настроить расширение представления, имя представления и все параметры, используемые для открытия представления. См. параметры ссылок на пользовательские представления.
Метрики	Открывает представление метрик.
Общие сведения о ресурсе	Открывает представление ресурса на портале с учетом значения идентификатора ресурса в ячейке. Можно также задать значение подменю, которое открывает определенный пункт меню в представлении ресурсов.
Книга (шаблон)	Открывает шаблон книги. При выборе этого элемента отображаются дополнительные поля, в которых можно настроить открываемый шаблон. См. параметры книги (шаблона).
Copilot в Azure (предварительная версия)	При вызове действия он форматирует и отправляет запрос в Microsoft Copilot в Azure (предварительная версия). См. раздел "Copilot" в параметрах Azure (предварительная версия).

Параметры ссылки

При использовании отрисовщика ссылок доступны следующие параметры:

Параметр	Description
Представление, которое будет открыто	Позволяет выбрать одно из действий.
Пункт меню	Если выбрано действие Общие сведения о ресурсе, это элемент меню отображается в общих сведениях о ресурсе. С его помощью можно открывать оповещения или журналы действий вместо общих сведений о ресурсе. Для каждого типа ресурсов Azure доступны разные значения пунктов меню.
Метка связи	Если это значение задано, оно отображается в столбце сетки. В противном случае отображается значение ячейки. Если требуется отобразить другое значение, например, тепловую карту или значок, не используйте отрисовщик ссылок. Вместо этого используйте соответствующий отрисовщик и выберите параметр Сделать этот элемент ссылкой.
Открытие ссылки в области контекста	Если этот параметр задан, ссылка будет открываться во всплывающей контекстной панели в правой части окна, а не в полноэкранном представлении.

При использовании параметра Сделать этот элемент ссылкой доступны следующие параметры:

Параметр	Description
Источник значения ссылки	При отображении ячейки в качестве отрисовщика со ссылкой это поле задает источник значения ссылки. Значение можно выбрать из раскрывающегося списка или из других столбцов в сетке. Например, ячейка может содержать значение тепловой карты. Но, возможно, вы захотите открывать раздел Общие сведения о ресурсе для указанного в строке идентификатора ресурса при щелчке по ссылке. В этом случае нужно указать, что источником значения ссылки является поле Идентификатор ресурса.
Представление, которое будет открыто	То же, что выше.
Пункт меню	То же, что выше.
Открытие ссылки в области контекста	То же, что выше.

Параметры действия ARM

Используйте этот параметр для вызова действия ARM, указав сведения об API ARM. Здесь приведена документация по REST API ARM. Во всех полях пользовательского интерфейса можно разрешить параметры с помощью {paramName}. Вы также можете разрешить столбцы с помощью ["columnName"]. В приведенных ниже примерах изображений можно ссылаться на столбец id , написав ["id"]. Если столбец является идентификатором ресурса Azure, вы можете получить понятное имя ресурса с помощью средства labelформатирования. См. форматирование параметров.

Вкладка "Параметры действия ARM"

В этом разделе определяется API действий ARM.

Исходный код	Описание
Путь к действию ARM	Путь действия ARM. Например: "/subscriptions/:subscription/resourceGroups/:resourceGroup/someAction?api-version=:apiversion".
Метод Http	Выберите метод HTTP. Доступны следующие варианты: POST, PUT, PATCHDELETE
Длинная операция	Long Operations опрашит URI из Azure-AsyncOperation заголовка ответа или Location заголовка ответа из исходной операции. Дополнительные сведения об отслеживании асинхронных операций Azure.
Параметры	Сетка параметров URL-адреса с ключом и значением.
Заголовки	Сетка заголовков с ключом и значением.
Текст	Редактор полезных данных запроса в ФОРМАТЕ JSON.

Параметры пользовательского интерфейса действий ARM

В этом разделе описано, что пользователи видят перед запуском действия ARM.

Исходный код	Описание
Заголовок	Заголовок, используемый в представлении запуска.
Настройка имени действия ARM	Авторы могут настроить действие ARM, отображаемое в уведомлении после активации действия.
Описание действия ARM	Текст markdown, используемый для предоставления полезного описания пользователям, когда они хотят запустить действие ARM.
Источник текста кнопки запуска	Метка, используемая на кнопке запуска (выполнения), чтобы активировать действие ARM.

После установки этих конфигураций, когда пользователь выбирает ссылку, откроется представление с помощью описанного здесь пользовательского интерфейса. Если пользователь выбирает кнопку, указанную текстом кнопки "Выполнить", он запускает действие ARM с помощью настроенных значений. В нижней части области контекста можно выбрать пункт "Просмотреть сведения о запросе", чтобы проверить метод HTTP и конечную точку API ARM, используемую для действия ARM.

Ход выполнения и результат действия ARM отображается как уведомление портал Azure.

Параметры ссылок для развертывания Azure Resource Manager

Если тип ссылки — развертывание ARM, необходимо указать дополнительные параметры, чтобы открыть развертывание Resource Manager. Существует две основные вкладки для параметров конфигурации: Параметры шаблона и Параметры пользовательского интерфейса.

Параметры шаблона

В этом разделе определяются источник шаблона и параметры, которые используются для запуска развертывания Resource Manager.

Оригинал	Description
Идентификатор группы ресурсов поступает из	ИД ресурса используется для управления развернутыми ресурсами. Подписка используется для управления развернутыми ресурсами и затратами. Группы ресурсов используются как папки для упорядочения всех ресурсов и управления ими. Если это значение не указано, развертывание завершается ошибкой. Выберите один из вариантов: Ячейка, Столбец, Параметр или Статическое значение в разделе Источники ссылки.
Источник URI шаблона ARM	URI самого шаблона ARM. Универсальный код ресурса (URI) шаблона должен быть доступен пользователям, которые развертывают шаблон. Выберите один из вариантов: Ячейка, Столбец, Параметр или Статическое значение в разделе Источники ссылки. Дополнительные сведения см . в шаблонах быстрого запуска Azure.
Параметры шаблона ARM	Определяют параметры шаблона, которые используются для заданного ранее URI шаблона. Эти параметры используются для развертывания шаблона на странице запуска. Сетка содержит кнопку Развернуть на панели инструментов. Эта кнопка позволяет заполнить параметры, используя имена, определенные в URI шаблона, и задать для них пустые статические значения. Этот параметр можно использовать только в том случае, если в сетке нет параметров, а URI шаблона задан. В нижнем разделе можно предварительно просмотреть настроенные параметры. Чтобы обновить окно предварительного просмотра с учетом внесенных изменений, нажмите кнопку Обновить. Параметры обычно представляют собой значения. Ссылки могут указывать на секреты из хранилища ключей, к которым есть доступ у пользователя. Ограничение области просмотра шаблонов не отображает ссылочные параметры правильно и отображается как null/value. В результате пользователи не смогут правильно развертывать ссылочные параметры на вкладке Средство просмотра шаблонов.

Параметры интерфейса

В этом разделе описано, что вы видите перед запуском развертывания Resource Manager.

Оригинал	Description
Источник заголовка	Заголовок, используемый в представлении запуска. Выберите один из вариантов: Ячейка, Столбец, Параметр или Статическое значение в разделе Источники ссылки.
Источник описания	Текст на языке Markdown содержит полезное описание для пользователей, которые хотят развернуть шаблон. Выберите один из вариантов: Ячейка, Столбец, Параметр или Статическое значение в разделе Источники ссылки. При выборе варианта Статическое значение отображается многострочное текстовое поле. В этом текстовом поле можно задать параметры с помощью "{paramName}". Кроме того, можно интерпретировать столбцы как параметры, добавляя "_column" после имени столбца, например, {columnName_column}. В примере на изображении ниже показано, что можно использовать конструкцию "{VMName_column}", чтобы сослаться на столбец "VMName". Значение после двоеточия — это форматировщик параметра. В данном случае это значение.
Источник текста кнопки запуска	Надпись на кнопке запуска (выполнения), которая используется для развертывания шаблона ARM. Пользователи выбирают эту кнопку, чтобы начать развертывание шаблона ARM.

После настройки этих параметров конфигурации при щелчке по ссылке открывается представление с пользовательским интерфейсом, описанным на вкладке "Параметры пользовательского интерфейса". При выборе параметра Источник текста кнопки "Выполнить" шаблон ARM развертывается с помощью параметров из раздела Параметры шаблона. При нажатии на кнопку Просмотреть шаблон открывается вкладка Средство просмотра шаблонов, на которой можно просмотреть шаблон и параметры перед развертыванием.

Параметры ссылок на пользовательское представление

Этот элемент можно использовать, чтобы открыть Пользовательские представления на портале Azure. Параметры можно настроить с помощью формы или URL-адреса.

Примечание.

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

Форма

Оригинал	Description
Имя расширения	Имя расширения, в котором размещается имя представления.
Имя представления	Имя представления, которое нужно открыть.

Существует два типа входных данных: сетки и JSON. Используйте сетку для простых табличных входных данных в формате "ключ-значение". Используйте JSON для указания вложенных входных данных JSON.

Сетка

• Имя параметра: имя входного параметра представления.
• Параметр поставляется из: указывает, откуда должно поступать значение параметра View. Выберите один из вариантов: Ячейка, Столбец, Параметр или Статическое значение в разделе Источники ссылки.

  Примечание.

  Если выбран вариант Статическое значение, параметры можно разрешить, указав ссылку "{paramName}" в скобках в текстовом поле. Столбцы можно рассматривать как столбцы параметров, добавляя _column после имени столбца, например:"{columnName_column}".

• Значение параметра: в зависимости от значения в поле Источник параметра этот раскрывающийся список содержит доступные параметры, столбцы или статическое значение.

JSON

• В редакторе введите входные данные в формате JSON. Как и в режиме Сетка, на параметры и столбцы можно ссылаться, используя {paramName} для параметров и {columnName_column} для столбцов. Если выбран вариант Показать пример JSON, будут показаны ожидаемые выходные данные всех разрешенных параметров и столбцов, которые использовались для входных данных представления.

URL

Вставьте URL-адрес портала, содержащий расширение, имя представления и все входные данные, которые необходимы, чтобы открыть представление. После выбора элемента Инициализировать параметры осуществляется заполнение формы, и вы можете добавлять, изменять и удалять любые входные данные представлений.

Параметры ссылки "Книга (шаблон)"

Если выбран тип ссылки Книга (шаблон), необходимо указать дополнительные параметры, чтобы открыть правильный шаблон книги. Для каждого из следующих параметров можно указать, как найти его значение в сетке.

Параметр	Description
Идентификатор ресурса владельца книги поступает из	Это значение представляет собой идентификатор ресурса Azure, которому "принадлежит" книга. Обычно это ресурс Application Insights или рабочая область Log Analytics. Внутри Azure Monitor это также может быть строковый литерал "Azure Monitor". Именно к этому значению будет привязана книга при сохранении.
Источник ресурсов книги	Массив идентификаторов ресурсов Azure, указывающий ресурс по умолчанию, который используется в книге. Например, если в открываемом шаблоне отображаются метрики виртуальных машин, то здесь значениями будут идентификаторы ресурсов виртуальных машин. Во многих случаях для владельца и ресурсов задаются одни и те же параметры.
Идентификатор шаблона поступает из	Укажите идентификатор шаблона, который нужно открыть. Шаблон сообщества из коллекции является наиболее распространенным вариантом. Укажите Community- в качестве префикса шаблона, например, Community-Workbooks/Performance/Apdex для шаблона Workbooks/Performance/Apdex. Если это ссылка на сохраненную книгу или шаблон, используйте полный путь к идентификатору ресурса Azure этого элемента. например, "/subscriptions/12345678-a1b2-1234-a1b2-c3d4e5f6/resourceGroups/rgname/providers/microsoft.insights/workbooks/1a2b3c4d-5678-abcd-xyza-1a2b3c4d5e6f.
Источник типа книги	Задайте тип шаблона книги, который нужно открыть. В наиболее распространенных случаях здесь нужно указать "по умолчанию" или "книга", чтобы использовать значение в текущей книге.
Источник типа коллекции	Это значение определяет тип коллекции, которая будет отображаться в представлении Коллекция открываемого шаблона. В наиболее распространенных случаях здесь нужно указать "по умолчанию" или "книга", чтобы использовать значение в текущей книге.
Источник расположения	Поле расположения должно быть указано, если вы открываете определенный ресурс книги. Если расположение не указано, поиск содержимого книги медленнее. Если расположение вам известно, укажите его. Если расположение неизвестно или вы открываете шаблон без определенного расположения, оставьте в этом поле значение Default.
Передача определенных параметров в шаблон	Установите этот флажок, чтобы передать в шаблон конкретные параметры. Если этот флажок установлен, в шаблон передаются только выбранные параметры, в противном случае в шаблон передаются все параметры в текущей книге. В этом случае для работы этого значения параметра имена параметров должны быть одинаковыми в обеих книгах.
Параметры шаблона книги	В этом разделе определяются параметры, которые передаются в целевой шаблон. Имя должно совпадать с именем параметра в целевом шаблоне. Выберите значение из следующих вариантов: Ячейка, Столбец, Параметр и Статическое значение. Чтобы параметр был передан в целевой шаблон, его имя и значение не должны быть пустыми.

Для каждого из предыдущих параметров необходимо выбрать, откуда поступает значение в связанной книге. См. раздел Источники ссылок.

Когда открывается ссылка на книгу, в новое представление книги передаются все значения, заданные на основе указанных выше параметров.

Источники ссылок

Оригинал	Description
Ячейка	В качестве значения ссылки используется значение в этой ячейке сетки.
Column	При выборе этой ячейки появится поле, в котором можно выбрать другой столбец в сетке. Значение этого столбца для строки используется в качестве значения ссылки. Это значение ссылки обычно используется для того, чтобы при щелчке по каждой строке в сетке можно было открывать различные шаблоны. Для этого в качестве Идентификатора шаблона задается столбец. Либо он используется для открытия того же шаблона книги для других ресурсов, если в поле Ресурсы книги установлен столбец, содержащий идентификатор ресурса Azure.
Параметр	При выборе этой ячейки появится поле, в котором можно выбрать параметр. Значение этого параметра будет использоваться в качестве значения при щелчке по ссылке.
Статическое значение	При выборе этой ячейки появится поле, в котором можно ввести статическое значение, используемое в связанной книге. Это значение обычно используется, когда все строки в сетке используют одно и то же значение для поля.
Компонент	Используется значение, заданное в текущем компоненте книги. Этот вариант часто применяется в компонентах запроса и метрик, чтобы задать в качестве ресурсов в связанной книге те ресурсы, которые используются в компоненте запроса или метрик, а не в текущей книге.
Книга	Используется значение, заданное в текущей книге.
По умолчанию.	Используется значение по умолчанию в тех случаях, когда значение не задано. Это распространенная ситуация для параметра Источник типа коллекции, для которого коллекция по умолчанию определяется типом ресурса-владельца.

Параметры Copilot в Azure (предварительная версия)

При вызове ссылки Copilot в Azure (предварительная версия) она форматирует настроенную ссылку и отправляет ее в виде запроса в Microsoft Copilot в Azure (предварительная версия). Затем Microsoft Copilot в Azure отвечает на запрос, чтобы объяснить больше о концепциях, службах или предложениях Azure. Действие ссылки можно настроить для вставки значений параметров или содержимого сетки в текст запроса.

Примечание.

Если Microsoft Copilot в Azure (предварительная версия) не включена в вашей среде, вместо отправки запроса в Microsoft Copilot в Azure будет отображаться форматированный запрос на боковой панели "Сведения о ячейках".

Нажмите кнопку "Настройка...", чтобы открыть панель параметров запроса Copilot в Azure (предварительная версия). Параметры запроса Copilot в Azure (предварительная версия) отображают текстовую область, в которой можно настроить текст запроса и вставить маркеры параметров с помощью стандартного синтаксиса или ссылаться на столбцы сетки с помощью стандартного {parameter} ["column name"] синтаксиса. Во время curret содержимое запроса ограничено 500 символами после форматирования. Любое оставшееся содержимое усечено.