Definieren Sie eine Cloud-REST-Abfrage für Cloud-Computing-Geräte

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer
  • Beim Erstellen oder Ändern eines Discovery-Musters können Sie verwenden Cloud-REST-Abfrage Vorgang zum Extrahieren von Informationen aus Konfigurationselementen (CIs) des Typs „PaaS“ (Platform as a Service), z. B. Microsoft Azure oder Amazon Webservices.

    Vorbereitungen

    • Stellen Sie sicher, dass das Betriebssystem der CIs, für die Sie den Cloud-REST-Abfragevorgang verwenden möchten, den BS-Typ [cmdb_ci_logical_datacenter] des logischen Rechenzentrums erweitert:
      1. Navigieren zu Musterdesigner > Discovery-Musteran.
      2. Doppelklicken Sie auf das entsprechende Muster, um es im Musterdesigner zu öffnen.
      3. Klicken Sie auf Standard Registerkarte.
      4. Beachten Sie das Betriebssystem für dieses CI.
      5. Navigieren zu Systemdefinition > Tabellenan.
      6. Legen Sie das Suchfeld auf fest Bezeichnung Und geben Sie den Namen des Betriebssystems ein, wie auf angegeben Standard Registerkarte des Musters.
      7. Suchen Sie das Betriebssystem in der Liste, und überprüfen Sie, ob das logische Rechenzentrum in angezeigt wird Erweitert die Tabelle Spalte.
    • Navigieren Sie zu dem entsprechenden Pattern-Schritt:

      1. Wählen Sie auf dem Musterformular den entsprechenden Identifikationsteil für aus Discovery .

        Alternativ wählen Sie den entsprechenden Identifikations- oder Verbindungsabschnitt für aus Service-Mapping .

      2. Wählen Sie den entsprechenden Musterschritt aus, oder klicken Sie auf Fügen Sie oben einen Schritt hinzu Symbol zum Hinzufügen eines Schritts.

    Grundkenntnisse in der Programmierung sind wünschenswert.

    Erforderliche Rolle: pd_admin

    Warum und wann dieser Vorgang ausgeführt wird

    Stellen Sie den Cloud-REST-Abfragevorgang in Mustern bereit, die für die Discovery von PaaS-CIs verwendet werden. Dieser Java-skriptbasierte anwenderdefinierte Vorgang ist erst verfügbar, nachdem die Musterversion 1.0.24 oder höher von heruntergeladen wurde ServiceNow Store. Verwenden Sie diesen Vorgang anstelle des im Basissystem verfügbaren Cloud-REST-Aufrufvorgangs.

    In der offiziellen API-bezogenen Dokumentation der Hersteller finden Sie die Abfragesyntax für das Gerät, das Sie mit dem Cloud-REST-Abfragevorgang abfragen möchten. Zum Beispiel:

    Prozedur

    1. Wählen Sie Aus Cloud-REST-Abfrage Von Vorgang Liste.
    2. Definieren Sie Abfrageparameter nach Bedarf:
      Hinweis:
      Wenn Sie diesen Vorgang angepasst haben, können die Abfrageparameter unterschiedlich sein.
      Feld Beschreibung
      URL Geben Sie die URL an, wie in der offiziellen Microsoft Azure- oder Amazon-Webservices-Dokumentation beschrieben.

      Sie können Variablen verwenden. Sie können auch einen Wert aus dem spezifischen Feld in einer tabellarischen Variable eingeben.

      Methode

      Geben Sie den Methodenwert als Zeichenfolge mit allen Großbuchstaben ein, z. B. „GET“. Unterstützte Methoden sind:

      • GET
      • POST
      • PUT

      Weitere Informationen finden Sie im entsprechenden API-Leitfaden. Wenn in der API-Dokumentation die HTTP-Abfragemethode nicht ausdrücklich erwähnt wird, verwenden Sie die GET-Methode.

      Textkörper (Optional) Geben Sie einen Anforderungstext als Zeichenfolge ein.

      Wenn die Zeichenfolge Anführungszeichen enthält, verwenden Sie das umgekehrte Schrägstrich vor den Anführungszeichen, um anzugeben, dass die Zeichenfolge nicht in Anführungszeichen endet.

      Header (Optional) wenn in der relevanten API-Dokumentation angegeben ist, dass HTTP-Header gesendet werden müssen, geben Sie diese Header im folgenden Format ein:

      Header_name1:Header_value1,Header_name2:Header_value2

      Beispiel: Inhaltstyp:xml .
      Formatiert JSON formatiert oder nicht
    3. Wählen Sie aus, um die Befehlsausgabe als Variable vollständig zu speichern KEINE Von Definieren Sie Die Analyse Listen Sie die Variable auf, und definieren Sie sie.
    4. Wählen Sie die Parsing-Strategie aus der Liste Analyse definieren aus.
    5. Wenn Sie im Debugging-Modus arbeiten, definieren Sie die Analysekriterien wie folgt:
      1. Klicken Sie Auf Vorgang Ausführen Um das Ergebnis in anzuzeigen Ausgabe Bereich.
      2. Im Feld Ausgabe markieren Sie Text oder Symbole, der/die eine Variable enthalten soll/sollen.
      3. Geben Sie im Feld Variablenname den Namen für die neue Variable ein, beispielsweise 'process_name'.

        Variablenname für die im Ausgabebereich markierte Zeichenfolge definieren
      4. Drücken Sie die Eingabetaste.
        Die neue Variable wird im Feld Variablen hinzugefügt.
    6. Wenn Sie nicht im Debugging-Modus arbeiten, definieren Sie die Analysekriterien wie folgt:
      1. Klicken Sie im Variablenbereich auf Variable hinzufügen, und geben Sie den Namen für die neue Variable ein.
      2. Klicken Sie auf das Symbol Erweitert.

        Bereich „Erweiterte Variablen“ anzeigen
      3. Klicken Sie auf Spaltenbezeichnung hinzufügen.
      4. Geben Sie die Analyse-Abfrage ein.
      5. Geben Sie einen Wert für das Trennzeichen ein.
      6. Geben Sie einen Wert für die Position ein.
    7. Wählen Sie Beenden, um die Discovery zu stoppen, wenn keine Ergebnisse gefunden werden.

    Beispiel

    Diese Operation wird verwendet in Dieses Objekt
    Hierarchie Anwendung
    CI-Typ Cloud-Objektspeicher [cmdb_ci_cloud_object_storage]
    Muster Amazon AWS S3
    Abschnitt Identifizierung von AWS S3
    Schrittnummer und -Name 3. Listen Sie Buckets auf

    Der Cloud-REST-Abfragevorgang

    Verwenden Sie den Cloud-REST-Abfragevorgang, um Informationen zu AWS-Buckets, ihren Namen und Erstellungsdaten zu extrahieren.