你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Microsoft.Common.TagsByResource UI 元素

一个控件，用于将标记与部署中的资源相关联。

UI 示例

架构

{
  "name": "element1",
  "type": "Microsoft.Common.TagsByResource",
  "resources": [
    "Microsoft.Storage/storageAccounts",
    "Microsoft.Compute/virtualMachines"
  ]
}

示例输出

{
  "Microsoft.Storage/storageAccounts": {
    "Dept": "Finance",
    "Environment": "Production"
  },
  "Microsoft.Compute/virtualMachines": {
    "Dept": "Finance"
  }
}

备注

• 必须至少指定 resources 数组中的一项。

• resources 中的每个元素都必须是完全限定的资源类型。 这些元素显示在“资源” 下拉列表中，并且可供用户标记。

• 控件的输出进行了格式设置，以便于在 Azure 资源管理器模板中轻松分配标记值。 若要在模板中接收控件的输出，请在模板中包括参数，如以下示例中所示：

  "parameters": {
    "tagsByResource": { "type": "object", "defaultValue": {} }
  }
  

  对于可以标记的每个资源，请将标记属性分配给该资源类型的参数值：

  {
    "name": "saName1",
    "type": "Microsoft.Storage/storageAccounts",
    "tags": "[ if(contains(parameters('tagsByResource'), 'Microsoft.Storage/storageAccounts'), parameters('tagsByResource')['Microsoft.Storage/storageAccounts'], json('{}')) ]",
    ...
  

• 在访问 tagsByResource 参数时，请使用 if 函数。 当没有任何标记分配给给定的资源类型时，可以使用该函数来分配空对象。

后续步骤

• 有关创建 UI 定义的简介，请参阅 CreateUiDefinition 入门。
• 有关 UI 元素中的公用属性的说明，请参阅 CreateUiDefinition 元素。