Compartilhar via


Elemento de interface do usuário Microsoft.Storage.StorageAccountSelector

Um controle usado para selecionar uma conta de armazenamento nova ou existente.

Os nomes da conta de armazenamento devem ser globalmente exclusivos no Azure com um comprimento de 3 a 24 caracteres e incluir apenas letras minúsculas ou números.

Exemplo de interface do usuário

O controle StorageAccountSelector mostra o nome padrão de uma conta de armazenamento. O padrão é definido em seu código.

Captura de tela do elemento seletor de conta de armazenamento que mostra o valor padrão de uma nova conta de armazenamento.

O controle StorageAccountSelector possibilita que o usuário crie uma nova conta de armazenamento ou selecione uma conta de armazenamento existente.

Captura de tela que mostra as opções do seletor de conta de armazenamento para criar uma nova conta de armazenamento.

Esquema

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

Saída de exemplo

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

Comentários

  • O defaultValue.name é necessário e o valor é validado automaticamente para exclusividade. Se o nome da conta de armazenamento não for exclusivo, o usuário deverá especificar um nome diferente ou escolher uma conta de armazenamento existente.
  • O valor padrão para defaultValue.type é Premium_LRS. Você pode definir qualquer tipo de conta de armazenamento como o valor padrão. Por exemplo, Standard_LRS ou Standard_GRS.
  • Os tipos não especificados em constraints.allowedTypes ficam ocultos e os tipos não especificados em constraints.excludedTypes são mostrados. constraints.allowedTypes e constraints.excludedTypes são opcionais, mas não podem ser usados simultaneamente.
  • Se options.hideExisting for true, o usuário não poderá escolher uma conta de armazenamento existente. O valor padrão é false. O controle só mostra as contas de armazenamento como existentes se elas estiverem no mesmo grupo de recursos e região que as seleções feitas na guia Básico.
  • A propriedade kind exibe o valor se uma nova conta de armazenamento foi criada ou o valor de uma conta de armazenamento existente.

Exemplo

Os valores padrão para o nome e o tipo da conta de armazenamento são exemplos. Você pode definir seus próprios valores padrão para seu ambiente.

Na seção outputs, a saída storageSelector inclui todos os valores para uma conta de armazenamento. Os storageKind e storageName são exemplos de como gerar valores específicos.

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

Saída de exemplo

A saída de uma nova conta de armazenamento.

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

A saída de uma conta de armazenamento existente.

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

Próximas etapas