Microsoft. Elemento UI Common.ResourceScope

L'elemento ResourceScope interfaccia utente (UI) permette agli utenti di selezionare l'abbonamento, il gruppo di risorse e la posizione per una distribuzione. Usalo per il flusso di distribuzione comune dei gruppi di risorse in una vista Modul.

ResourceScope è specifico della vista Forma. In createUiDefinition.json, abbonamento, gruppo di risorse e posizione sono invece forniti dal passaggio implicito Basics.

Esempio UI

L'elemento ResourceScope visualizza i campi di dettaglio del progetto per l'ambito di implementazione, inclusi abbonamento, gruppo di risorse e regione.

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

Output di esempio

{
  "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 gli abbonamenti selezionabili agli abbonamenti in cui sono disponibili i fornitori elencati.
  • resourceGroup.allowExisting Controlla se gli utenti possono selezionare un gruppo di risorse esistente.
  • resourceName aggiunge un campo nome risorsa al selettore di scopo. Usalo resourceName.constraints.validations per convalidare il nome.
  • location.resourceTypes filtra le regioni in posizioni che supportano i tipi di risorsa elencati.
  • Fai riferimento all'ID del gruppo di risorse selezionato con [steps('basics').resourceScope.resourceGroup.id].
  • Fai riferimento al nome della location selezionato con [steps('basics').resourceScope.location.name].
  • Fai riferimento al nome della risorsa con [steps('basics').resourceScope.resourceName].

Per le implementazioni di gruppi di risorse, utilizzare l'ambito selezionato in 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]"
  }
}

Passaggi successivi