Microsoft. Élément UI Common.ResourceScope

L’élément ResourceScope interface utilisateur (UI) permet aux utilisateurs de sélectionner l’abonnement, le groupe de ressources et l’emplacement pour un déploiement. Utilisez-le pour le flux de déploiement commun par groupe de ressources dans une vue Formulaire.

ResourceScope est spécifique à la vue Forme. Dans createUiDefinition.json, l’abonnement, le groupe de ressources et la localisation sont fournis par l’étape implicite Basics.

Exemple d’interface utilisateur

L’élément ResourceScope affiche les champs de détails du projet pour le périmètre de déploiement, y compris l’abonnement, le groupe de ressources et la région.

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

Exemple de résultat

{
  "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 filtre les abonnements sélectionnables aux abonnements où les fournisseurs listés sont disponibles.
  • resourceGroup.allowExisting contrôle la possibilité pour les utilisateurs de sélectionner un groupe de ressources existant.
  • resourceName ajoute un champ nom de ressource au sélecteur de champ d’application. Utilisez-le resourceName.constraints.validations pour valider le nom.
  • location.resourceTypes Filtrant les régions en emplacements qui prennent en charge les types de ressources listés.
  • Référez l’ID du groupe de ressources sélectionné avec [steps('basics').resourceScope.resourceGroup.id].
  • Référez le nom de lieu sélectionné avec [steps('basics').resourceScope.location.name].
  • Référez le nom de la ressource par [steps('basics').resourceScope.resourceName].

Pour les déploiements par groupes de ressources, utilisez le champ sélectionné dans 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]"
  }
}

Étapes suivantes

  • Last updated on