Configurer les paramètres d’entrée du bloc de ressources

Vous pouvez configurer des opérations pour chaque interface d’un bloc de ressources en spécifiant les paramètres d’entrée, les étapes et les attributs de sortie. Les paramètres d’entrée contiennent des valeurs dont le système a besoin pour identifier et gérer une ressource virtuelle, comme le centre de données et le groupe de ressources dans lesquels se trouve la ressource.

Avant de commencer

Rôle requis : sn_cmp.cloud_service_designer

Pourquoi et quand exécuter cette tâche

Le système associe automatiquement les opérations par défaut de l’API dans le cloud (CAPI) au bloc de ressources lorsque vous y ajoutez des interfaces. Il fournit également des paramètres d’entrée par défaut pour chaque opération.

Procédure

1. Ouvrez un bloc de ressources, puis cliquez sur l’onglet Opérations .

   

   Le sous-onglet Paramètres d’entrée s’affiche par défaut.

2. Sélectionnez l’interface dans la liste de choix d’interface .

   Les interfaces de cette liste de choix sont dérivées de la liste Interface d’invité de ressource de l’onglet Informations générales que vous avez déjà configurée lors de la création d’un bloc de ressources.

   

3. Sélectionnez l’opération sur laquelle vous souhaitez modifier les paramètres d’entrée.
   Vous pouvez également créer une opération.
   1. Cliquez sur l’icône Ajouter une opération .

      

   2. Remplissez le formulaire (voir tableau) :

      Champ	Description
      Nom	Saisissez un nom descriptif.
      Type d'opération	Sélectionnez le type d’opération dans la liste de choix.
      Type d'accès	Sélectionnez Public pour rendre l’opération de bloc de ressources disponible à partir du formulaire de commande du catalogue lorsqu’un utilisateur gère une pile dont il est propriétaire. Les opérations réelles apparaissent dans une liste sur le formulaire de commande du catalogue : Sélectionnez Privé pour empêcher l’utilisation de l’opération lorsqu’un utilisateur lance une pile. Ce paramètre s’applique au niveau de l’élément de catalogue, et non au niveau de l’ensemble de la pile. Vous pouvez contrôler le type d’accès sur l’ensemble de la pile lorsque vous configurez des plans. Par exemple, vous pouvez marquer l’opération d’annulation d’approvisionnement comme privée pour une machine virtuelle individuelle, mais pas pour l’ensemble de la pile. Cela permet à l’utilisateur de tout annuler en même temps et empêche l’utilisateur de simplement annuler l’approvisionnement de l’ordinateur virtuel.

   3. Cliquez sur Envoyer.
4. Configurez les paramètres d’entrée pour fournir un moyen d’entrer les éléments dont vous avez besoin pour exécuter l’opération sélectionnée.

   Par exemple, si vous ajoutez une opération de mise en service pour une ressource AWS, vous avez besoin, au minimum, des paramètres CloudAccount et Location pour effectuer l’opération. Vous devez connaître l’API du fournisseur pour savoir quoi lui transmettre. Par exemple, si vous souhaitez ajouter une opération de mise en service pour une catégorie S3 sur AWS, vous devez connaître les opérations AWS autorisées sur les catégories et les éléments de demande pour des éléments tels que la création d’une catégorie (l’opération de catégorie PUT). Vous pouvez généralement trouver ces ressources dans la documentation AWS et Azure.

   1. Cliquez sur l’icône Ajouter des paramètres d’entrée .

      

   2. Ajoutez le nom du paramètre que vous avez obtenu à partir de l’API du fournisseur dans le cloud.
      Dans cet exemple, vous pouvez ajouter CreateBucketConfiguration pour une catégorie AWS S3.
   3. Dans la colonne Source de données , sélectionnez le type de paramètre d’entrée que vous configurez.
      Cette valeur spécifie la source ou l’emplacement d’où provient la valeur du paramètre :

      • Texte : une valeur de texte que l’utilisateur transmet.
      • Pools : requête que vous souhaitez exécuter sur un pool pour en récupérer une valeur. La valeur de la source de données de pool doit suivre cette convention : ServiceNow ::P ools ::P oolName.Pool-Filter-Name. Voir Pools et filtres pour Mise en service dans le cloud pour plus d’informations sur les piscines.
      • CSVList : valeurs d’une liste de valeurs séparées par des virgules que vous saisissez dans la valeur de la source de données.
      • Tableau : un tableau de valeurs. Vous pouvez lui envoyer un tableau en JavaScript par programmation. Le format est le suivant : ['abc','def'].
      • FormData : données soumises à partir du formulaire configuré dans le plan.
      • ResourceScript : expression qui transmet une valeur. L’expression doit suivre cette convention dans le champ Mappage :

        $(Script :script-name.function[arg1=${value-to-pass},arg2=${value-to-pass}])

      • TLR : valeur héritée du conteneur de ressources de niveau supérieur au-dessus de ce bloc de ressources dans le plan.
   4. Cliquez sur Enregistrer.
   5. Dans la colonne Mappage , vous pouvez afficher les valeurs de mappage générées automatiquement.
      Les mappages spécifient où extraire les informations dans le système. Vous n’avez pas besoin de modifier les valeurs de mappage, à l’exception des paramètres de type ResourceScript , dans lesquels vous devez entrer l’expression.
   6. Dans la colonne Valeur par défaut , spécifiez une valeur que vous souhaitez que le système utilise si l’utilisateur ne transmet aucune valeur ou si vous n’avez rien saisi dans la valeur de la source de données.
   7. Sélectionnez Créer un formulaire pour rendre cet attribut disponible dans le formulaire de commande que l’utilisateur voit lorsqu’il essaie de mettre en service l’élément de pile.
      Vous pouvez également sélectionner Obligatoire pour forcer l’utilisateur à saisir une valeur.
   8. Dans la colonne Restreint à, cliquez sur l’icône restreinte ( restreint ), puis sélectionnez un bloc de ressources pour limiter l’attribut à transmettre à un hôte spécifique.

      Dans cet exemple, vous configurez un bloc de ressources pour un serveur virtuel sur vSphere, qui nécessite le nom du dossier de l’ordinateur virtuel (représenté par l’attribut VmFolderName ). Les autres types de centres de données n’ont pas besoin du nom du dossier de l’ordinateur virtuel. Par conséquent, vous pouvez restreindre VmFolderName au bloc de ressources du centre de données vSphere.

      Cette image illustre comment l’attribut VMFolderName est limité au centre de données vSphere.