你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
链接操作
可以通过工作簿链接组件或者网格、标题或图形的列设置来访问链接操作。
常规链接操作
| 链接操作 | 选择的操作 |
|---|---|
| 一般详细信息 | 在属性网格上下文视图中显示行值。 |
| 单元格详细信息 | 在属性网格上下文视图中显示单元格值。 当单元包含带有信息的动态类型（例如，包含位置、角色实例等请求属性的 JSON）时，此操作非常有用。 |
| URL | 单元格的值应为有效的 HTTP URL。 单元格是用于在新选项卡中打开该 URL 的链接。 |
Application Insights
| 链接操作 | 选择的操作 |
|---|---|
| 自定义事件详细信息 | 使用单元格中的自定义事件 ID (itemId) 打开 Application Insights 搜索详细信息. |
| 详细信息 | 类似于自定义事件详细信息，只是在依赖项、异常、页面视图、请求和跟踪方面不同。 |
| 自定义事件用户流 | 打开围绕单元格中自定义事件名称构建的 Application Insights 用户流体验。 |
| 用户流 | 类似于自定义事件用户流，只是在异常、页面视图和请求方面不同。 |
| 用户时间线 | 使用单元格中的用户 ID (user_Id) 打开用户时间线。 |
| 会话时间线 | 针对单元格中的值打开 Application Insights 搜索体验，例如，当单元格中的值为 abc 时，搜索文本“abc”。 |
Azure 资源
| 链接操作 | 选择的操作 |
|---|---|
| ARM 部署 | 部署 Azure 资源管理器 (ARM) 模板。 选择此项后，将显示更多字段来让你配置要打开的 ARM 模板以及该模板的参数。 请参阅 Azure 资源管理器部署链接设置。 |
| 创建警报规则 | 创建资源的警报规则。 |
| 自定义视图 | 打开自定义视图。 选择此项后，将显示更多字段，可在其中配置视图扩展名、视图名称以及用于打开视图的任何参数。 查看自定义视图链接设置。 |
| 指标 | 打开指标视图。 |
| 资源概述 | 根据单元格中的资源 ID 值在门户中打开资源的视图。 你还可以选择设置子菜单值，该值会打开资源视图中的特定菜单项。 |
| 工作簿（模板） | 打开工作簿模板。 选择此项后，将显示更多字段，可在其中配置要打开的模板。 请参阅工作簿（模板）设置。 |
| Azure Copilot（预览版） | 调用操作时，它会格式化并将提示发送到 Microsoft Azure Copilot（预览版）。 请参阅 Azure Copilot（预览版）设置。 |
链接设置
使用链接呈现器时，以下设置可用：
| 设置 | 说明 |
|---|---|
| 要打开的视图 | 允许你选择其中一个操作。 |
| Menu item | 如果已选择“资源概述”，则此菜单项将出现在资源的概述中。 使用此菜单项可以打开警报或活动日志而不是资源的“概述”。 每种 Azure 资源类型的菜单项值都不同。 |
| 链接标签 | 如果已指定此值，则它会显示在网格列中。 如果未指定此值，则会显示单元格的值。 如果你希望显示其他值（例如热度地图或图标），请不要使用链接呈现器。 请改用适当的呈现器，并选择“将此项设为链接”选项。 |
| 在“上下文”窗格中打开链接 | 如果已指定该项，则链接会在窗口右侧以弹出的“上下文”视图形式打开，而不是以完整视图形式打开。 |
使用“将此项设为链接”选项时，以下设置可用：
| 设置 | 说明 |
|---|---|
| 链接值来自 | 当单元格显示为带链接的呈现器时，此字段指定要在链接中使用的“链接”值的来源。 可以从网格中其他列的下拉列表中进行选择。 例如，单元格可能是热度地图值。 但你也许希望该链接打开行中资源 ID 的“资源概述”。 在这种情况下，可以将链接值设置为来自“资源 ID”字段。 |
| 要打开的视图 | 同上。 |
| Menu item | 同上。 |
| 在“上下文”窗格中打开链接 | 同上。 |
ARM 操作设置
使用此设置通过指定 ARM API 详细信息来调用 ARM 操作。 可在此处找到 ARM REST API 的文档。 在所有 UX 字段中，可以使用 {paramName} 来解析参数。 还可以使用 ["columnName"] 来解析列。 在下面的示例图像中，可以通过编写 ["id"] 来引用列 id。 如果列是 Azure 资源 ID，则可以使用格式化程序 label 获取资源的友好名称。 请参阅参数格式。
“ARM 操作设置”选项卡
本部分定义 ARM 操作 API。
| Source | 说明 |
|---|---|
| ARM 操作路径 | ARM 操作路径。 例如：“/subscriptions/：subscription/resourceGroups/：resourceGroup/someAction？api-version=：apiversion”。 |
| HTTP 方法 | 选择 HTTP 方法。 可用选项有：POST、PUT、PATCH、DELETE |
| 长操作 | 长操作从 Azure-AsyncOperation 轮询 URI，或者从原始操作轮询 Location 响应标头。 详细了解跟踪异步 Azure 操作。 |
| 参数 | 带有键和值的 URL 参数网格。 |
| 标头 | 带键和值的标头网格。 |
| Body | JSON 中请求有效负载的编辑器。 |
ARM 操作 UX 设置
本部分配置用户在运行 ARM 操作之前看到的内容。
| Source | 说明 |
|---|---|
| 标题 | 在运行视图上使用的标题。 |
| 自定义 ARM 操作名称 | 作者可以在触发操作后自定义通知上显示的 ARM 操作。 |
| ARM 操作的说明 | Markdown 文本，用于在用户想要运行 ARM 操作时向用户提供有用的说明。 |
| 从以下位置运行按钮文本 | 在运行（执行）按钮上使用的标签来触发 ARM 操作。 |
设置这些配置后，当用户选择链接时，视图将打开，其中包含此处所述的 UX。 如果用户选择由运行按钮文本的来源指定的按钮，则会使用配置的值运行 ARM 操作。 在上下文窗格底部，可以选择“查看请求详细信息”来检查用于 ARM 操作的 HTTP 方法和 ARM API 终结点。
ARM 操作的进度和结果显示为 Azure 门户通知。
Azure 资源管理器部署链接设置
如果链接类型是“ARM 部署”，则必须指定其他设置才能打开资源管理器部署。 有两个主要配置选项卡：“模板设置”和“UX 设置”。
模板设置
此部分定义模板应来自何处，以及用于运行资源管理器部署的参数。
| 源 | 说明 |
|---|---|
| 资源组 ID 来自 | 资源 ID 用于管理已部署的资源。 订阅用于管理已部署的资源和成本。 资源组可以像文件夹一样用来组织和管理所有资源。 如果未指定此值，则部署会失败。 从“链接源”中的“单元格”、“列”、“参数”和“静态值”中进行选择。 |
| ARM 模板 URI 来自 | ARM 模板本身的 URI。 模板 URI 需要可供将要部署该模板的用户访问。 从“链接源”中的“单元格”、“列”、“参数”和“静态值”中进行选择。 有关详细信息，请参阅《Azure 快速启动模板》。 |
| ARM 模板参数 | 定义用于上面定义的模板 URI 的模板参数。 这些参数用于在运行页上部署模板。 网格包含一个“展开”工具栏按钮，有助于用户使用模板 URI 中定义的名称来填充参数并设置为静态空值。 只有当网格中没有参数且模板 URI 已经过设置时，才可以使用此选项。 下半部分是参数输出的外观的预览。 选择“刷新”可以使用当前的更改更新预览。 参数通常是值。 引用是可以指向用户有权访问的密钥保管库机密的内容。 模板查看器窗格限制无法正确呈现引用参数，将显示为 null/值。 因此，用户将无法从“模板查看器”选项卡正确部署引用参数。 |
UX 设置
此部分配置你在运行 Azure 资源管理器部署之前会看到的内容。
| 源 | 说明 |
|---|---|
| 标题来源 | 在运行视图上使用的标题。 从“链接源”中的“单元格”、“列”、“参数”和“静态值”中进行选择。 |
| 描述来自 | 这是 Markdown 文本，用于在用户需要部署模板时为用户提供有用的说明。 从“链接源”中的“单元格”、“列”、“参数”和“静态值”中进行选择。 如果选择“静态值”，则会显示多行文本框。 在此文本框中，可以使用 "{paramName}" 来解析参数。 还可以通过在列名后面追加 "_column"（例如 {columnName_column}）将列视为参数。 在以下示例图像中，可以通过编写 "{VMName_column}" 来引用列 "VMName"。 冒号后面的值是参数格式化程序。 在本例中，它是 value。 |
| 从以下位置运行按钮文本 | 在用于部署 ARM 模板的运行（执行）按钮上使用的标签。 用户选择此按钮可开始部署 ARM 模板。 |
设置这些配置后，当你选择链接时，将打开包含 UX 设置中所述 UX 的视图。 如果选择“从以下位置运行按钮文本”，则会使用模板设置中的值部署 ARM 模板。 选择“查看模板”会打开“模板查看器”选项卡，在部署之前可在其中检查模板和参数。
自定义视图链接设置
使用此设置可在 Azure 门户中打开“自定义视图”。 可以使用表单或 URL 配置设置。
注意
无法在上下文选项卡中打开具有菜单的视图。如果将具有菜单的视图配置为在上下文选项卡中打开，则在选择链接时不会显示任何上下文选项卡。
窗体
| 源 | 说明 |
|---|---|
| 扩展名称 | 承载视图名称的扩展的名称。 |
| 视图名称 | 要打开的视图的名称。 |
有两种类型的输入：网格和 JSON。 使用网格可提供简单的键和值选项卡输入。 使用 JSON 可指定嵌套的 JSON 输入。
网格
- 参数名：视图输入参数的名称。
- 参数来源：指出视图参数值预期的来源位置。 从“链接源”中的“单元格”、“列”、“参数”和“静态值”中进行选择。
注意
如果选择“静态值”，则可以使用括号解析参数以链接文本框中的
"{paramName}"。 可以通过在列名后追加_column（如"{columnName_column}"）将列视为参数列。 - 参数值：根据“参数来源”中的值，此下拉列表包含可用的参数、列或静态值。
JSON
- 在编辑器中以 JSON 格式指定选项卡输入。 与“网格”模式一样，引用参数和列时，可以使用
{paramName}来表示参数，使用{columnName_column}来表示列。 选择“显示 JSON 示例”会显示所有已解析参数的预期输出和用于视图输入的列。
URL
粘贴一个门户 URL，其中包含扩展、视图名称以及打开视图所需的任何输入。 选择“初始化设置”后会填充表单，以便可以添加、修改或删除任何视图输入。
工作簿（模板）链接设置
如果选择的链接类型是“工作簿(模板)”，则必须指定其他设置才能打开正确的工作簿模板。 以下设置包含网格如何查找每个设置的相应值的选项。
| 设置 | 说明 |
|---|---|
| 工作簿所有者资源 ID 来自 | 此值是“拥有”工作簿的 Azure 资源的资源 ID。 通常情况下，它是 Application Insights 资源或 Log Analytics 工作区。 在 Azure Monitor 中，此值也可能是文本字符串 "Azure Monitor"。 保存工作簿时，此值是工作簿要链接到的位置。 |
| 工作簿资源来源 | Azure 资源 ID 的数组，用于指定工作簿中使用的默认资源。 例如，如果将要打开的模板显示虚拟机指标，则此处的值将是虚拟机资源 ID。 很多时候，所有者和资源设置为相同的设置。 |
| 模板 ID 来自 | 指定要打开的模板的 ID。 库中的社区模板是最常见情况。 使用 Community- 作为模板路径的前缀，例如 Workbooks/Performance/Apdex 模板的 Community-Workbooks/Performance/Apdex。 如果它是指向已保存的工作簿或模板的链接，请使用该项的 Azure 资源 ID 的完整路径，例如 /subscriptions/12345678-a1b2-1234-a1b2-c3d4e5f6/resourceGroups/rgname/providers/microsoft.insights/workbooks/1a2b3c4d-5678-abcd-xyza-1a2b3c4d5e6f。 |
| 工作簿类型来源 | 指定要打开的工作簿模板的类型。 最常见的情况是使用默认或工作簿选项来使用当前工作簿中的值。 |
| 库类型来源 | 此值指定会显示在已打开模板的“库”视图中的库类型。 最常见的情况是使用默认或工作簿选项来使用当前工作簿中的值。 |
| 位置来自 | 如果要打开特定工作簿资源，则应指定位置字段。 如果未指定位置，则查找工作簿内容的速度会慢得多。 如果知道位置，请指定它。 如果你不知道位置或打开的模板没有特定位置，请将此字段保留为 Default。 |
| 将特定参数传递给模板 | 选择此项可以将特定参数传递给模板。 如果已选择，则只会将指定的参数传递给模板，否则将当前工作簿中的所有参数传递给模板。 在这种情况下，两个工作簿中的参数 names 必须相同才能使此参数有效。 |
| 工作簿模板参数 | 此部分定义传递给目标模板的参数。 名称应与目标模板中的参数的名称匹配。 从“单元格”、“列”、“参数”和“静态值”中进行选择。 名称和值不得为空，否则无法将该参数传递给目标模板。 |
对于上述每个设置，必须选择链接工作簿中的值来自何处。 请参阅链接源。
打开工作簿链接时，将向新的工作簿视图传递在上述设置中配置的所有值。
链接源
| 源 | 说明 |
|---|---|
| 单元 | 使用网格中该单元格中的值作为链接值。 |
| 列 | 选择后，将显示一个字段，可在其中选择网格中的另一列。 与行对应的该列的值将在链接值中使用。 此链接值通常用于使网格的每一行都能通过将“模板 ID”字段设置为“列”来打开不同的模板。 或者用于为不同资源打开相同的工作簿模板，前提是已将“工作簿资源”字段设置为包含 Azure 资源 ID 的列。 |
| 参数 | 选择后，会显示一个字段，可在其中选择参数。 该参数的值用作选择链接时的值。 |
| 静态值 | 选择后，会显示一个字段，可在其中输入链接工作簿中使用的静态值。 该值通常适用于网格中的所有行都对某个字段使用同一值的情形。 |
| 组件 | 使用在工作簿的当前组件中设置的值。 这常见于查询和指标组件，目的是将链接工作簿中的工作簿资源设置为在查询/指标组件中使用的资源，而不是在当前工作簿中使用的资源。 |
| 工作簿 | 使用在当前工作簿中设置的值。 |
| 默认 | 使用在未指定任何值的情况下使用的默认值。 这种情况常见于“库类型来源”，其中的默认库将根据所有者资源的类型来设置。 |
Azure Copilot（预览版）设置
调用 Azure Copilot（预览版）链接时，它将格式化已配置的链接，并将其作为提示发送到 Microsoft Azure Copilot（预览版）。 然后，Microsoft Azure Copilot 会对提示做出响应，以进一步解释有关 Azure 概念、服务或产品/服务的详细信息。 可以将链接操作配置为在提示文本中插入参数值或网格内容。
注意
如果你的环境中未启用 Microsoft Azure Copilot（预览版），则已格式化的提示不会发送到 Microsoft Azure Copilot，而是会显示在“单元格详细信息”侧窗格中。
选择“配置...”按钮以打开 Azure Copilot（预览版）提示设置窗格。 Azure Copilot（预览版）提示设置将显示文本区域，可在其中配置提示文本并使用标准 {parameter} 语法插入参数标记，或者通过标准 ["column name"] 语法引用网格列。 目前，格式化后的提示内容限制为 500 个字符。 任何剩余内容都将被截断。
