API-Abfragen für Cloud-Computing-Geräte definieren

Beim Erstellen oder Ändern eines Discovery-Musters, können Sie den Vorgang Cloud REST-Aufruf verwenden, um Informationen aus den Configuration Items des PaaS-Typs (Platform-as-a-Service) zu extrahieren, beispielsweise Microsoft Azure oder Amazon Web Services.

Vorbereitungen

Erforderliche Rolle: pd_admin

• Überprüfen Sie, ob das Betriebssystem des Konfigurationselements (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 Sie zu der Registerkarte Basis des CI-Musters.
  2. Beachten Sie das Betriebssystem für dieses CI.
  3. Navigieren zu Systemdefinition > Tabellen.
  4. Legen Sie das Suchfeld auf Bezeichnung fest und geben Sie den Namen des Betriebssystems ein, wie auf der Registerkarte Standard des Musters angegeben.
  5. 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 die , um einen Schritt hinzufügen.

Grundkenntnisse in der Programmierung sind wünschenswert.

Warum und wann dieser Vorgang ausgeführt wird

Stellen Sie den Cloud REST-Aufrufvorgang in Mustern bereit, die zur Erkennung von Paas-CIs verwendet werden.

Weitere Informationen finden Sie in der offiziellen Dokumentation mit API-Bezug, die von den Herstellern zur Verfügung gestellt wird. So erhalten Sie die Abfragesyntax für das Gerät, das Sie mit dem Cloud REST-Aufrufvorgang abrufen 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 in der Liste Vorgang die Option Cloud REST-Aufruf.
2. Definieren Sie Abfrageparameter nach Bedarf:
   Warnung:

   Wenn Sie diesen Vorgang wie in Mustervorgänge anpassen beschrieben 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 Variablen verwenden. Sie können auch einen Wert aus dem eindeutigen Feld einer Tabellenvariable wie in Werte und Variablen in Mustern eingeben beschrieben 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 API-Dokumentation ausdrücklich die HTTP-Abfragemethode erwähnt, verwenden Sie die GET-Methode.
   Textkörper	(Optional) Geben Sie einen Anforderungstext als Zeichenfolge ein. Wenn in der Zeichenfolge Anführungsstriche enthalten sind, verwenden Sie den Backslash 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.

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 wie in 6 beschrieben.
4. Wählen Sie die Parsing-Strategie aus der Liste Analyse definieren aus.

   Parsing-Strategie	Beschreibung
   Oracle LDAP-Datei XML-Datei INI-Datei Eigenschaftsdatei JSON-Datei (benutzerdefiniert)	Strategie zum horizontalen Analysieren von Dateien (nicht vertikal). Sie können diese Parsing-Strategie nur für Textdateien verwenden. Weitere Informationen finden Sie unter Text aus einer horizontalen Datei analysieren.
   Vertikale Datei	Rufen Sie Text aus einer strukturierten Textdatei ab, in der jeder Datensatz mehrere Zeilen umfasst. Weitere Informationen finden Sie unter Text aus einer vertikalen Datei analysieren.
   Nach Schlüsselwort	Rufen Sie Text direkt nach einem bestimmten Schlüsselwort ab. Weitere Informationen finden Sie unter Text mit Stichwort, Befehl und Positionstyp analysieren.
   Befehlszeile Java-Stil	Rufen Sie den Wert eines Befehlszeilenparameters mithilfe von Parametern im Java-Stil ab. Weitere Informationen finden Sie unter Text mit Stichwort, Befehl und Positionstyp analysieren.
   Befehlszeile Unix-Stil	Rufen Sie den Wert eines Befehlszeilenparameters mit Standard-Unix-Parametern ab. Weitere Informationen finden Sie unter Text mit Stichwort, Befehl und Positionstyp analysieren.
   Position Ab Ende	Rufen Sie den durch seine Position angegebenen Text vom Ende der Zeile ab. Weitere Informationen finden Sie unter Text mit Stichwort, Befehl und Positionstyp analysieren.
   Position Ab Start	Rufen Sie den durch seine Position angegebenen Text vom Anfang der Zeile ab. Weitere Informationen finden Sie unter Text mit Stichwort, Befehl und Positionstyp analysieren.
   Regulärer Ausdruck	Rufen Sie den durch einen regulären Ausdruck angegebenen Text ab. Für diese Option müssen Sie mit der Regex-Java-Syntax vertraut sein. Weitere Informationen finden Sie unter Text mit einem regulären Ausdruck analysieren.
   Begrenzter Text	Rufen Sie den durch Trennzeichen angegebenen Text und die Position innerhalb der Zeile ab (die häufigste Methode, um Text aus generischen Textdateien abzurufen). Weitere Informationen finden Sie unter Text mit Trennzeichen analysieren.

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 mit den folgenden Schritten:
   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 Discovery zu stoppen, wenn keine Ergebnisse gefunden werden.
8. Wenn Sie sich im Debug-Modus befinden, testen Sie den Schritt, indem Sie auf Test klicken und überprüfen, ob die Operation das erwartete Ergebnis liefert.

Beispiel

Diese Operation wird in verwendet	Dieses Objekt
Hierarchie	Applikation
CI-Typ	Load Balancer-Service [cmdb_ci_lb_service]
Muster	Amazon AWS Elastic Load Balancer Service
Abschnitt	AWS-Lastenausgleichsmodul-Service
Schrittnummer und -Name	2. Rufen Sie die ersten 100 RDS-Instanzen ab.

Verwenden Sie den Cloud-REST-Aufrufvorgang, um Informationen zu Datenbankinstanzen zu extrahieren, die in der Region us-west-2 in der Amazon-Cloud ausgeführt werden.

Nächste Maßnahme

• Bearbeiten Sie das Muster durch Hinzufügen eines neuen Schritts und Definieren seiner Operation weiter.
• Schließen Sie das Muster ab.

Zugehörige Tasks

• Muster-Debug-Modus aktivieren
• Einen Schritt bedingt machen

Zugehörige Verweise

• Werte und Variablen in Mustern eingeben
• Mustervariablen