Nicht abgeglichene API-Erweiterungsklassen
Die Store-App „CMDB CI Class Models“ (CMDB-CI-Klassenmodelle) fügt Klassen für nicht abgeglichene APIs (Anwendungsprogrammierschnittstellen) hinzu oder aktualisiert sie.
Die App fügt Klassenmodelle hinzu, die die Klassenhierarchie CMDB erweitern, einschließlich Klassenbeschreibungen, Identifizierungsregeln, Bezeichnereinträge und abhängige Beziehungen (falls zutreffend). Sie können die hinzugefügten Klassen wie jede andere CMDB -Klasse verwenden. Anwendungen wie Muster für Discovery und Service-Mapping können diese Klassenerweiterungen verwenden, um CIs auszufüllen und verschiedene Technologien und Software zu erkennen.
Apps im Store anfordern
Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.
Nicht abgeglichene APIs
API-Endpunkte, die nicht gut genug strukturiert sind, um die Klassen „API“ [cmdb_ci_api] und „API-Komponente“ [cmdb_ci_api_component] auszufüllen, füllen stattdessen die Klasse „Nicht abgeglichener API-Endpunkt“ [cmdb_ci_unmatched_api_endpoint] aus. Nicht abgeglichene APIs werden normalerweise von Integrationen wie Sicherheitsscannern oder Observability-Tools verwendet.
Klassen
In diesem Abschnitt werden die Klassen aufgelistet, die von der Store-App CMDB CI-Klassenmodelle hinzugefügt oder aktualisiert werden.
CMDB CI-Klassenmodelle: Release 1.49.0 fügt die folgende Klasse für nicht abgeglichene API-Endpunkte hinzu. Die Liste der CMDB -Klassen in einem Basissystem, einschließlich der Klassen, die durch diese Store-App möglicherweise erweitert werden, finden Sie unter Beschreibungen der CMDB-Tabellen.
| Klasse | Erweitert | Beschreibung |
|---|---|---|
| Nicht abgeglichener API-Endpunkt [cmdb_ci_unmatched_api_endpoint] |
Konfigurationselement [cmdb_ci] |
APIs mit unstrukturierten Endpunkten, die cmdb_ci_api oder cmdb_ci_api_component nicht ausfüllen können. |
Klassenattribute
CMDB CI-Klassenmodelle: Release 1.49.0 fügt der Klasse „Nicht abgeglichener API-Endpunkt“ [cmdb_ci_unmatched_api_endpoint] die folgenden Attribute hinzu.
| Attribut | Datentyp | Beschreibung |
|---|---|---|
| Methode | Zeichenfolge | Back-End-Protokolltypen der API. Beispiele:
|
| Protokoll | Zeichenfolge | Kommunikationsprotokoll. Beispiel: HTTP, HTTPS. |
| URL | Zeichenfolge (1024) | URL der aufgerufenen Ressource. |
| ID | Zeichenfolge (1024) | Eindeutiger Bezeichner aus dem Quellsystem. |
| Mit Internetzugriff | Boolean | Boolescher Wert, der angibt, ob die Komponente über das öffentliche Internet erreichbar ist. Geben Sie „1“ oder „wahr“ an, wenn die Komponente erreichbar ist. |
| Autorisierung | Zeichenfolge | Typ der Autorisierungs- oder Authentifizierungsmethode. Beispiel:
|
| Anforderungsdatentypen | Zeichenfolge (255) | Liste der Datentypen in der Anforderung. Beispiele:
|
| Antwortdatentypen | Zeichenfolge (255) | Liste der Datentypen in der Antwort. Beispiele:
|
Schlüsselbeziehungsstrukturen
Die Klasse „Nicht abgeglichener API-Endpunkt“ [cmdb_ci_unmatched_api_endpoint CMDB und die Tabelle „Nicht abgeglichener API-Endpunkt“ [api_endpoint_discovered] sind für Szenarien gedacht, in denen unstrukturierte API-Daten erfasst werden und über die Fähigkeiten von IntegrationHub-ETL hinaus verarbeitet werden müssen.
„Erkannter API-Endpunkt“ [api_endpoint_discovered] kann als Bereitstellungstabelle für Rohdaten für die Klassen „API“ [cmdb_ci_api] und „API-Komponente“ [cmdb_ci_api_component] dienen. API-Daten, die nicht aus einer gut strukturierten Datenquelle stammen oder für die keine Standardidentifizierungsregeln angewendet werden können, können zuerst die Tabelle „API-Endpunkt erkannt“ [api_endpoint_discovered] ausfüllen. Anschließend können Sie eine vom Kunden definierte Integration verwenden, um sicherzustellen, dass ordnungsgemäß formatierte Daten, die den Qualitäts- und Bedingungsanforderungen für API [cmdb_ci_api] und API-Komponente [cmdb_ci_api_component] entsprechen, die am besten geeignete Tabelle füllen.
In Fällen, in denen die Daten nicht korrekt analysiert werden können oder in einer unerwarteten Weise strukturiert sind, können Sie stattdessen eine kundendefinierte Integration verwenden, um die Tabelle „Nicht abgeglichener API-Endpunkt“ [cmdb_ci_unmatched_api_endpoint] zu füllen.
Daten, die die Tabelle „API-Endpunkt erkannt“ [api_endpoint_discovered] ausfüllen, werden alle 30 Tage gelöscht.
| Attribut | Datentyp | Beschreibung |
|---|---|---|
| Name | Zeichenfolge (100) | Name des API-Endpunkts. |
| Methode | Zeichenfolge | REST API-Methoden. Beispiele:
|
| URL | Zeichenfolge (1024) | URL der aufgerufenen Ressource. |
| Typ | Auswahlliste | Typ der API. Sie können Folgendes angeben:
|
| Autorisierung | Zeichenfolge | Typ der Autorisierungs- oder Authentifizierungsmethode. Beispiel:
|
| Mit Internetzugriff | Boolean | Boolescher Wert, der angibt, ob die Komponente über das öffentliche Internet erreichbar ist. Geben Sie „1“ oder „wahr“ an, wenn die Komponente erreichbar ist. |
| Anforderungsdatentypen | Zeichenfolge (255) | Liste der Datentypen in der Anforderung. Beispiele:
|
| Antwortdatentypen | Zeichenfolge (255) | Liste der Datentypen in der Antwort. Beispiele:
|
| Header | Zeichenfolge (255) | Kommagetrennte Liste von Headernamen. |
| Konfigurationselement | Referenz | Verweis auf ein übereinstimmendes CMDB-CI (API-Komponente oder nicht abgeglichener API-Endpunkt). |
Zugehörige Nicht-CMDB-Tabellen
Die API-Erweiterungsklasse „Nicht abgeglichen“ verwendet die Nicht-CMDB-Tabelle „API-Bereitstellung“ [api_deployment] als zugehörige Liste:
| Attribut | Datentyp | Beschreibung |
|---|---|---|
| Name | Zeichenfolge (100) | Name der API-Bereitstellung. |
| API | Referenz | Verweis auf die bereitgestellte API (cmdb_ci_api). |
| Nicht abgeglichener API-Endpunkt | Referenz | Verweis auf den nicht abgeglichenen API-Endpunkt, wenn die API nicht mit einer vorhandenen API (cmdb_ci_unmatched_api_endpoint) übereinstimmt. |
| Konfigurationselement | Referenz | Verweis auf das Configuration Item. Wird normalerweise manuell als Referenz angegeben, wenn Sie wissen, für welches CI die API bereitgestellt wird. |