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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 minutes de lecture

    • Vous pouvez configurer des opérations pour chaque interface d'un bloc de ressources en spécifiant des paramètres d'entrée, des étapes et des attributs de sortie. Les paramètres d'entrée contiennent les 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 lequel 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.

      Onglet Opérations pour les blocs de ressources

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

    2. Sélectionnez l'interface dans la liste de choix Interface.

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

      Sélection d'une interface de 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 nouvelle opération.
      1. Cliquez sur l'icône Ajouter une opération.

        Ajout d'une opération

      2. Renseignez le formulaire (consultez le 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 de catalogue lorsqu'un utilisateur gère une pile qu'il possède. Les opérations réelles apparaissent dans une liste du formulaire de commande de catalogue :

        Opérations pour l'utilisateur

        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 la pile entière. 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 Mettre hors service comme privée pour un ordinateur virtuel individuel, mais pas pour l'ensemble de la pile. Cela permet à l'utilisateur de tout mettre hors service en même temps et empêche l'utilisateur de simplement mettre hors service 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 afin d'exécuter l'opération sélectionnée.

      Par exemple, si vous ajoutez l'opération Mettre en service pour une ressource AWS, il vous faut, au minimum, le paramètre CloudAccount et le paramètre Emplacement pour effectuer l'opération. Vous devez connaître l'API des fournisseurs pour savoir ce qu'il faut lui transmettre. Par exemple, si vous souhaitez ajouter l'opération Mettre 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 PUT Bucket). 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.

        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 : valeur textuelle 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 du pool doit suivre cette convention : ServiceNow::Pools::PoolName.Pool-Filter-Name. Voir Pools et filtres pour Mise en service dans le cloud pour plus d'informations sur les pools.
        • 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 : tableau de valeurs. Vous pouvez lui envoyer un tableau par programmation dans JavaScript. 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 indiquent 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, où 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 lors de la tentative de mise en service de l'élément de pile.
        Vous pouvez également sélectionner Obligatoire pour forcer l'utilisateur à entrer une valeur.
      8. Dans la colonne Limité à, cliquez sur l'icône de limitation ( limité à), 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. VMFolderName

        Limiter à un centre de données vSphere