Microsoft.Storage.StorageAccountSelector UI 元素

用於選取新或現有儲存體帳戶的控制項。

儲存體帳戶名稱在整個 Azure 中必須是全域唯一的，長度 3-24 個字元，且只有小寫字母和數字。

UI 範例

StorageAccountSelector 控制項會顯示記憶體帳戶的預設名稱。 預設會在您的程式碼中設定。

StorageAccountSelector 控制項可讓您建立新儲存體帳戶，或選取現有儲存體帳戶。

結構描述

{
  "name": "element1",
  "type": "Microsoft.Storage.StorageAccountSelector",
  "label": "Storage account selector",
  "toolTip": "",
  "defaultValue": {
    "name": "storageaccount01",
    "type": "Premium_LRS"
  },
  "constraints": {
    "allowedTypes": [],
    "excludedTypes": []
  },
  "options": {
    "hideExisting": false
  },
  "visible": true
}

範例輸出

{
  "name": "storageaccount01",
  "resourceGroup": "demoRG",
  "type": "Standard_LRS",
  "newOrExisting": "new",
  "kind": "StorageV2"
}

備註

• 其中需要 defaultValue.name 且會自動驗證值是否唯一。 如果儲存體帳戶名稱不是唯一的，使用者就必須指定不同的名稱，或選擇現有的儲存體帳戶。
• defaultValue.type 的預設值為 Premium_LRS。 您可以將任何儲存體帳戶類型設定為預設值。 例如 Standard_LRS 或 Standard_GRS。
• constraints.allowedTypes 中未指定的任何類型都會加以隱藏，constraints.excludedTypes 中未指定的任何類型都會加以顯示。 constraints.allowedTypes 和 constraints.excludedTypes 都是選擇性的，但不能同時使用。
• 如果 options.hideExisting 為 true，使用者就無法選擇現有的儲存體帳戶。 預設值為 false。 只有在儲存體帳戶與 [基本] 標籤上選取項目位於相同資源群組和區域的情況下，控制項才會將儲存體帳戶顯示為 [現有]。
• 如果已建立新的儲存體帳戶，則 kind 屬性會顯示值，否則為現有儲存體帳戶的值。

範例

儲存體帳戶名稱和類型的預設值為範例。 您可以為環境設定自己的預設值。

在 outputs 區段中，storageSelector 輸出包含儲存體帳戶的所有值。 storageKind 和 storageName 是如何輸出特定值的範例。

{
  "$schema": "https://schema.management.azure.com/schemas/0.1.2-preview/CreateUIDefinition.MultiVm.json#",
  "handler": "Microsoft.Azure.CreateUIDef",
  "version": "0.1.2-preview",
  "parameters": {
    "basics": [
      {}
    ],
    "steps": [
      {
        "name": "StorageAccountSelector",
        "label": "Storage account selector",
        "elements": [
          {
            "name": "storageSelectorElement",
            "type": "Microsoft.Storage.StorageAccountSelector",
            "label": "Storage account name",
            "toolTip": "",
            "defaultValue": {
              "name": "storageaccount01",
              "type": "Premium_LRS"
            },
            "options": {
              "hideExisting": false
            },
            "visible": true
          }
        ]
      }
    ],
    "outputs": {
      "location": "[location()]",
      "storageSelector": "[steps('StorageAccountSelector').storageSelectorElement]",
      "storageKind": "[steps('StorageAccountSelector').storageSelectorElement.kind]",
      "storageName": "[steps('StorageAccountSelector').storageSelectorElement.name]"
    }
  }
}

範例輸出

新儲存體帳戶的輸出。

{
  "location": {
    "value": "westus3"
  },
  "storageSelector": {
    "value": {
      "name": "demostorageaccount01",
      "resourceGroup": "demoRG",
      "type": "Standard_GRS",
      "newOrExisting": "new",
      "kind": "StorageV2"
    }
  },
  "storageKind": {
    "value": "StorageV2"
  },
  "storageName": {
    "value": "demostorageaccount01"
  }
}

現有儲存體帳戶的輸出。

{
  "location": {
    "value": "westus3"
  },
  "storageSelector": {
    "value": {
      "name": "demostorage99",
      "resourceGroup": "demoRG",
      "type": "Standard_LRS",
      "newOrExisting": "existing",
      "kind": "StorageV2"
    }
  },
  "storageKind": {
    "value": "StorageV2"
  },
  "storageName": {
    "value": "demostorage99"
  }
}

下一步

• 如需建立 UI 定義的簡介，請前往適用於 Azure 受控應用程式的 CreateUiDefinition.json 建立體驗。
• 如需 UI 元素中通用屬性的說明，請前往 CreateUiDefinition 元素。