Microsoft. Elemento UI Common.ResourceScope

O ResourceScope elemento interface de usuário (UI) permite que os usuários selecionem a assinatura, o grupo de recursos e a localização para uma implantação. Use-o para o fluxo comum de implantação de grupos de recursos em uma visualização de formulário.

ResourceScope é específico para a visualização Formulário. Em createUiDefinition.json, assinatura, grupo de recursos e localização são fornecidos pela etapa implícita Basics.

Exemplo de UI

O ResourceScope elemento renderiza os campos de detalhes do projeto para o escopo de implantação, incluindo assinatura, grupo de recursos e região.

Schema

{
  "name": "resourceScope",
  "type": "Microsoft.Common.ResourceScope",
  "subscription": {
    "resourceProviders": [
      "Microsoft.KeyVault"
    ]
  },
  "resourceGroup": {
    "allowExisting": true
  },
  "resourceName": {
    "label": "Key vault name",
    "toolTip": "Enter a globally unique key vault name.",
    "constraints": {
      "validations": [
        {
          "regex": "^[a-zA-Z0-9-]{3,24}$",
          "message": "The name must be 3-24 characters long and contain only letters, numbers, and hyphens."
        }
      ]
    }
  },
  "location": {
    "label": "Region",
    "toolTip": "Select the Azure region for the resource.",
    "resourceTypes": [
      "Microsoft.KeyVault/vaults"
    ]
  }
}

Saída de exemplo

{
  "subscription": {
    "displayName": "Contoso subscription",
    "subscriptionId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "11111111-1111-1111-1111-111111111111"
  },
  "resourceGroup": {
    "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/example-rg",
    "name": "example-rg",
    "location": "westus2"
  },
  "location": {
    "name": "westus2",
    "displayName": "West US 2"
  },
  "resourceName": "example-vault"
}

Remarks

  • subscription.resourceProviders Filtra assinaturas selecionáveis para assinaturas onde os provedores listados estão disponíveis.
  • resourceGroup.allowExisting controla se os usuários podem selecionar um grupo de recursos existente.
  • resourceName adiciona um campo de nome de recurso ao seletor de escopo. Use resourceName.constraints.validations para validar o nome.
  • location.resourceTypes Filtra regiões para locais que suportam os tipos de recursos listados.
  • Consulte o ID do grupo de recursos selecionado com [steps('basics').resourceScope.resourceGroup.id].
  • Consulte o nome do local selecionado com [steps('basics').resourceScope.location.name].
  • Referenciar o nome do recurso com [steps('basics').resourceScope.resourceName].

Para implantações de grupos de recursos, use o escopo selecionado em:view.outputs

"outputs": {
  "kind": "ResourceGroup",
  "resourceGroupId": "[steps('basics').resourceScope.resourceGroup.id]",
  "location": "[steps('basics').resourceScope.location.name]",
  "parameters": {
    "name": "[steps('basics').resourceScope.resourceName]",
    "location": "[steps('basics').resourceScope.location.name]"
  }
}

Próximas Etapas 

  • Last updated on