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.

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

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 é true, o usuário não pode 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

• Para uma introdução à criação de definições de interface do usuário, vá para CreateUiDefinition.json para a experiência de criação do aplicativo gerenciado do Azure.
• Para obter uma descrição das propriedades comuns em elementos de interface do usuário, consulte Elementos de CreateUiDefinition.