Microsoft.Storage.StorageAccountSelector UI 要素

[アーティクル]
03/23/2023

新規または既存のストレージアカウントを選択するために使用されるコントロール。

ストレージアカウント名は、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 の要素」にアクセスしてください。

Microsoft.Storage.StorageAccountSelector UI 要素

UI サンプル

スキーマ

サンプル出力

解説

例

出力例

次のステップ

その他のリソース