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

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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 Basique .
      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 entrez le nom du système d’exploitation tel qu’indiqué dans l’onglet Basique du schéma.
      7. Recherchez le système d’exploitation dans la liste et vérifiez que Centre de données logique s’affiche dans la colonne Table Extensions .

    • 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 étape au-dessus pour ajouter une étape.

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

    Rôle requis :_admin

    Pourquoi et quand exécuter cette tâche

    Déployez l’opération de requête REST dans le cloud dans les schémas utilisés pour la découverte des CI PaaS. Cette opération personnalisée basée sur un script Java n’est disponible qu’après le téléchargement des modèles version 1.0.24 ou ultérieure à 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ête de l’appareil que vous souhaitez interroger à l’aide de l’opération Cloud REST Query. Par exemple :

    Procédure

    1. Sélectionnez la requête REST dans le cloud dans la liste Opération .
    2. Définissez les paramètres de requête selon les besoins :
      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 entrer une valeur à partir d’un champ spécifique dans une variable tabulaire.
      Méthode

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

      • GET
      • POST
      • PUT

      Consultez le guide de l’API pertinent pour en savoir plus. Si la documentation de l’API ne mentionne pas spécifiquement la méthode de requête HTTP, utilisez la méthode GET.
      Détails (Facultatif) Saisissez le corps d’une demande 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 les en-têtes HTTP doivent être envoyés, saisissez 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 la sortie de la commande dans son intégralité en tant que variable, sélectionnez NONE dans la liste Define Parsing (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 l’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 dates de création.