Benutzeroberflächenelement „Microsoft.Storage.StorageAccountSelector“

  • Artikel

Ein Steuerelement, das zum Auswählen eines neuen oder vorhandenen Speicherkontos verwendet wird.

Speicherkontonamen müssen in Azure global eindeutig sein und eine Länge von 3 bis 24 Zeichen aufweisen und nur Kleinbuchstaben oder Zahlen enthalten.

Benutzeroberflächenbeispiel

Das StorageAccountSelector-Steuerelement zeigt den Standardnamen für ein Speicherkonto an. Der Standardwert ist in Ihrem Code festgelegt.

Screenshot des Auswahlelements für das Speicherkonto, das den Standardwert für ein neues Speicherkonto zeigt.

Das StorageAccountSelector-Steuerelement ermöglicht es Ihnen, ein neues Speicherkonto zu erstellen oder ein bereits vorhandenes Speicherkonto auszuwählen.

Screenshot zeigt die Optionen für die Speicherkontoauswahl zum Erstellen eines neuen Speicherkontos.

Schema

{
  "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
}

Beispielausgabe

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

Bemerkungen

  • Der defaultValue.name ist erforderlich, und der Wert wird automatisch auf Eindeutigkeit überprüft. Wenn der Name des Speicherkontos nicht eindeutig ist, muss der Benutzer einen anderen Namen angeben oder ein vorhandenes Speicherkonto auswählen.
  • Der Standardwert für defaultValue.type lautet Premium_LRS. Sie können einen beliebigen Speicherkontotyp als Standardwert festlegen. Beispiel: Standard_LRS oder Standard_GRS.
  • Alle nicht in constraints.allowedTypes angegebenen Typen werden ausgeblendet, und nicht in constraints.excludedTypes angegebene Typen werden angezeigt. constraints.allowedTypes und constraints.excludedTypes sind optional, können jedoch nicht gleichzeitig angegeben werden.
  • Wenn true für options.hideExisting angegeben ist, kann der Benutzer kein vorhandenes Speicherkonto auswählen. Der Standardwert ist false. Das Steuerelement zeigt Speicherkonten nur dann als vorhanden an, wenn sie sich in derselben Ressourcengruppe und Region befinden wie die in der Registerkarte Grundlagen getätigten Auswahlen.
  • Die kind-Eigenschaft zeigt den Wert an, wenn ein neues Speicherkonto erstellt wurde, oder den Wert eines vorhandenen Speicherkontos.

Beispiel

Die Standardwerte für den Namen und Typ des Speicherkontos sind Beispiele. Sie können Ihre eigenen Standardwerte für Ihre Umgebung festlegen.

Im Abschnitt outputs enthält die storageSelector-Ausgabe alle Werte für ein Speicherkonto. Die storageKind und storageName sind Beispiele für die Ausgabe bestimmter Werte.

{
  "$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]"
    }
  }
}

Beispielausgabe

Die Ausgabe für ein neues Speicherkonto.

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

Die Ausgabe für ein vorhandenes Speicherkonto.

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

Nächste Schritte