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

Microsoft.Common.TagsByResource UI 元素

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

UI 示例

部署中的 Microsoft.Common.TagsByResource 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 函数。 当没有任何标记分配给给定的资源类型时,可以使用该函数来分配空对象。

后续步骤