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 Resource Manager 範本中輕鬆指派標記值。 若要在範本中接收控制項的輸出，請在您的範本中包含參數，如下列範例所示：

  "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 元素。