Cloud-REST-Abfrage für Cloud-Computing-Geräte definieren

Als Teil der Erstellung oder Änderung eines Erkennungsmusters können Sie den Vorgang Cloud-REST-Abfrage verwenden, um Informationen aus Konfigurationselementen (CIs) des PaaS-Typs (Platform as a Service) zu extrahieren, z. B. Microsoft Azure oder Amazon Web Services.

Vorbereitungen

• Überprüfen Sie, ob das Betriebssystem des CI, für das Sie den Vorgang „Cloud-REST-Aufruf“ verwenden möchten, den Betriebssystemtyp des logischen Datenzentrums [cmdb_ci_logical_datacenter] erweitert:
  1. Navigieren zu Musterdesigner > Discovery-Muster.
  2. Doppelklicken Sie auf das relevante Muster, um es im Musterdesigner zu öffnen.
  3. Klicken Sie auf die Registerkarte Standard.
  4. Beachten Sie das Betriebssystem für dieses CI.
  5. Navigieren zu Systemdefinition > Tabellen.
  6. Legen Sie das Suchfeld auf Bezeichnung fest und geben Sie den Namen des Betriebssystems ein, wie auf der Registerkarte Standard des Musters angegeben.
  7. Suchen Sie das Betriebssystem in der Liste, und stellen Sie sicher, dass das logische Rechenzentrum in der Spalte Erweitert Tabelle angezeigt wird.

• 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 das Symbol Schritt darüber hinzufügen, um einen Schritt hinzufügen.

Grundkenntnisse in der Programmierung sind wünschenswert.

Erforderliche Rolle: pd_admin

Warum und wann dieser Vorgang ausgeführt wird

Stellen Sie den Cloud-REST-Aufrufvorgang in Mustern für die Erkennung von PaaS-CIs bereit. Dieser auf Java-Skript basierende benutzerdefinierte Vorgang ist nur verfügbar, nachdem Musterversion 1.0.24 oder höher aus dem ServiceNow Store heruntergeladen wurde. Verwenden Sie diesen Vorgang anstelle des im Standardsystem verfügbaren Cloud-REST-Aufrufvorgangs.

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

• http://docs.aws.amazon.com/AWSEC2/latest/APIReference/Welcome.html
• https://docs.microsoft.com/en-us/rest/api/apimanagement/

Prozedur

1. Wählen Sie Cloud-REST-Abfrage aus der Liste Vorgang aus.
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 wie in der offiziellen Microsoft Azure- oder Amazon Web Services-Dokumentation beschrieben an. Sie können Variablen verwenden. Sie können auch einen Wert aus einem bestimmten Feld in einer tabellarischen Variable eingeben.
   Methode	Geben Sie den Methodenwert als Zeichenfolge in Großbuchstaben ein, z. B. „GET“. Unterstützte Methoden: GET POST PUT Weitere Informationen finden Sie im entsprechenden API-Leitfaden. Wenn die HTTP-Abfragemethode in der API-Dokumentation 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 den umgekehrten Schrägstrich vor den Anführungszeichen, um anzugeben, dass die Zeichenfolge nicht bei den Anführungszeichen endet.
   Header	(Optional) Wenn die relevante API-Dokumentation besagt, dass HTTP-Header gesendet werden müssen, geben Sie diese Header im folgenden Format ein: Header_name1:header_value1,header_name2:header_value2 Zum Beispiel: Content-Type:xml.
   Formatiert	JSON formatiert oder nicht

3. Wenn Sie die gesamte Befehlsausgabe als Variable speichern möchten, klicken Sie in der Liste Analyse definieren auf KEINE, und definieren Sie die Variable.
4. Wählen Sie die Parsing-Strategie aus der Liste Analyse definieren aus.
5. Wenn Sie im Debug-Modus arbeiten, definieren Sie die Analysekriterien wie folgt:
   1. Klicken Sie auf Vorgang ausführen, um das Ergebnis im Bereich Ausgabe anzuzeigen.
   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'.

      
      
      

   4. Drücken Sie die Eingabetaste.
      Die neue Variable wird im Feld Variablen hinzugefügt.
6. Wenn Sie nicht im Debug-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.

      
      
      

   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 Erkennung zu stoppen, wenn keine Ergebnisse gefunden werden.

Beispiel

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

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