Définir une requête REST dans le cloud pour les appareils de cloud computing

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 3 minutes de lecture

    • Dans le cadre de la création ou de la modification d'un modèle de détection, vous pouvez utiliser l'opération de requête REST dans le cloud pour extraire des informations à partir d'éléments de configuration (CI) de type PaaS (Platform as a Service), tels que Microsoft Azure ou Amazon Web Services.

    Avant de commencer

    • Vérifiez que le système d'exploitation des CI pour lesquels vous souhaitez utiliser l'opération de requête REST dans le cloud étend le type de système d'exploitation du centre de données logique [cmdb_ci_logical_datacenter] :
      1. Accédez à la Concepteur de modèle > Schémas de découverte.
      2. Double-cliquez sur le modèle pertinent pour l'ouvrir dans le concepteur de modèle.
      3. Cliquez sur l'onglet De base.
      4. Notez le système d'exploitation de ce CI.
      5. Accédez à la Définition du système > Tables.
      6. Définissez le champ de recherche sur Étiquette et saisissez le nom du système d'exploitation comme indiqué dans l'onglet De base du modèle.
      7. Cherchez le système d'exploitation dans la liste et vérifiez que le centre de données logique apparaît dans la colonne Étend la table.

    • Accédez à l'étape de modèle pertinente :

      1. Sur le formulaire de modèle, sélectionnez la section d'identification pertinente pour Découverte.

        Vous pouvez également sélectionner la section d'identification ou de connexion pertinente pour Mappage des services.

      2. Sélectionnez l'étape de modèle pertinente ou cliquez sur l'icône Ajouter une nouvelle étape ci-dessus pour ajouter une étape.

    Une connaissance de base de la programmation est souhaitée.

    Rôle requis : pd_admin

    Pourquoi et quand exécuter cette tâche

    Déployez l'opération de requête REST dans le cloud dans les modèles utilisés pour la détection des CI PaaS. Cette opération personnalisée basée sur un script Java n'est disponible qu'après le téléchargement de la version 1.0.24 ou d'une version ultérieure des modèles à partir de ServiceNow Store. Utilisez cette opération au lieu de l'opération d'appel REST dans le cloud disponible dans le système de base.

    Consultez la documentation officielle relative à l'API fournie par les fabricants pour obtenir la syntaxe de requêtede l'appareil que vous souhaitez interroger à l'aide de l'opération de requête REST dans le cloud. Par exemple :

    Procédure

    1. Sélectionnez Requête REST dans le cloud dans la liste Opération.
    2. Définissez les paramètres de requête si nécessaire :
      Remarque :
      si vous avez personnalisé cette opération, les paramètres de requête peuvent être différents.
      Champ Description
      URL Spécifiez l'URL comme décrit dans la documentation officielle de Microsoft Azure ou Amazon Web Services.

      Vous pouvez utiliser des variables. Vous pouvez également saisir une valeur du champ spécifique dans une variable tabulaire.
      Méthode

      Saisissez la valeur de la méthode sous forme de chaîne en lettres majuscules, par exemple « GET ». Les méthodes prises en charge sont les suivantes :

      • GET
      • POST
      • PUT

      Reportez-vous au guide d'API pertinent pour plus d'informations. Si la documentation de l'API ne mentionne pas spécifiquement la méthode de requête HTTP, utilisez la méthode GET.
      Corps (Facultatif) Entrez un corps de requête sous forme de chaîne.

      Si la chaîne contient des guillemets, utilisez la barre oblique inverse devant les guillemets pour indiquer que la chaîne ne se termine pas aux guillemets.
      En-têtes (Facultatif) Si la documentation d'API pertinente indique que des en-têtes HTTP doivent être envoyés, entrez ces en-têtes au format suivant :

      Header_name1:header_value1,header_name2:header_value2

      Par exemple, Content-Type:xml.
      Formaté JSON formaté ou non
    3. Pour enregistrer l'intégralité de la sortie de commande en tant que variable, sélectionnez AUCUN dans la liste Définir l'analyse et définissez la variable.
    4. Sélectionnez la stratégie d'analyse dans la liste Définir l'analyse.
    5. Si vous travaillez en mode de débogage, définissez les critères d'analyse comme suit :
      1. Cliquez sur Exécuter une opération pour afficher le résultat dans le volet Sortie.
      2. Dans le panneau Sortie, marquez le texte ou les symboles que vous souhaitez que la variable contienne.
      3. Dans la zone de nom de la variable, saisissez le nom de la nouvelle variable, par exemple « process_name ».

        Définir un nom de variable pour la chaîne marquée dans le panneau Sortie
      4. Appuyez sur Entrée.
        La nouvelle variable est ajoutée dans le panneau Variables.
    6. Si vous ne travaillez pas en mode de débogage, définissez les critères d'analyse comme suit :
      1. Dans le panneau Variables, cliquez sur Ajouter une variable, puis saisissez le nom de la nouvelle variable.
      2. Cliquez sur l'icône Avancé.

        Afficher le panneau Variables avancées
      3. Cliquez sur Ajouter une étiquette de colonne.
      4. Entrez la requête d'analyse.
      5. Entrez une valeur pour le délimiteur.
      6. Entrez une valeur pour la position.
    7. Sélectionnez Terminer pour arrêter la détection si aucun résultat n'est trouvé.

    Exemple

    Cette opération est utilisée dans Cet élément
    Hiérarchie Application
    Type de CI Stockage d'objets dans le cloud [cmdb_ci_cloud_object_storage]
    Modèle Amazon AWS S3
    Section Identification d'AWS S3
    Numéro et nom de l'étape 3. Répertorier les catégories

    Opération de requête REST dans le cloud

    Utilisez l'opération de requête REST dans le cloud pour extraire des informations sur les catégories AWS, leurs noms et leurs dates de création.