Nicht übereinstimmende API-Erweiterungsklassen

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 3 Minuten Lesedauer

    • Die CMDB CI-Klassenmodelle App fügt Klassen für nicht abgeglichene APIs hinzu oder aktualisiert sie. 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 Erkennbarkeitstools verwendet.

    CMDB CI-Klassenmodelle Ist ein ServiceNow Store App, die Klassenmodelle hinzufügt, die erweitern CMDB Klassenhierarchie. Die neuen oder aktualisierten Klassen umfassen Klassenbeschreibungen, Identifizierungsregeln, Bezeichnereinträge und, falls zutreffend, abhängige Beziehungen. Sie können die hinzugefügten Klassen wie jede andere verwenden CMDB Klasse. Anwendungen wie Muster für Discovery und Service-Mapping Kann die Klassenerweiterungen verwenden, um CIs auszufüllen und Technologien und Software zu erkennen.

    Siehe Vollständige Release-Hinweise für alle CMDB CI-Klassenmodelle.

    Apps im Store anfordern

    Besuchen Sie ServiceNow StoreUm 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 Erkennbarkeitstools verwendet.

    Klassen

    In diesem Abschnitt werden die Klassen aufgeführt, die CMDB CI-Klassenmodelle App fügt hinzu oder aktualisiert sie.

    CMDB CI-Klassenmodelle: Release 1.49.0 fügt die folgende Klasse für nicht übereinstimmende API-Endpunkte hinzu. Für die Liste der Klassen in Basissystem, Einschließlich Klassen, die diese App erweitern könnte, siehe CMDB-Tabellenbeschreibungen.

    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 nicht abgeglichenen API-Endpunktklasse [cmdb_ci_unmatched_api_endpoint] die folgenden Attribute hinzu.

    Tabelle : 1. Nicht abgeglichener API-Endpunkt [cmdb_ci_unmatched_api_endpoint]
    Attribut Datentyp Beschreibung
    Methode Zeichenfolge Back-End-Protokolltypen der API. Beispiele:
    • Lambda
    • HTTP
    • Logik-App
    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:
    • Standard
    • Schlüssel
    • Oauth
    • Keine
    Anforderungsdatentypen Zeichenfolge (255) Liste der Datentypen in der Anforderung. Beispiele:
    • CC
    • E-Mail
    • Adresse
    Antwortdatentypen Zeichenfolge (255) Liste der Datentypen in der Antwort. Beispiele:
    • CC
    • E-Mail
    • Adresse

    Wichtige Beziehungsstrukturen

    Der nicht abgeglichene API-Endpunkt [cmdb_ci_unmatched_api_endpoint] CMDB Erkannte Klassen- und API-Endpunkte [api_Endpoint_detected] nicht-CMDB-Tabelle sind für Szenarien vorgesehen, 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_detected] 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 keine Standard-Identifizierungsregeln anwenden können, können zuerst die Tabelle „erkannter API-Endpunkt“ [api_Endpoint_detected] ausfüllen. Sie können dann eine vom Kunden definierte Integration verwenden, um diese wohlformatierten Daten heraufstufen, die den Qualitäts- und Bedingungsanforderungen für API [cmdb_ci_api] entsprechen, und die API-Komponente [cmdb_ci_api_component] füllt die am besten geeignete Tabelle aus.

    In Fällen, in denen die Daten nicht richtig analysiert werden können oder unerwartet strukturiert sind, können Sie stattdessen eine vom Kunden definierte Integration verwenden, um die nicht abgeglichene API-Endpunkttabelle [cmdb_ci_unmatched_api_endpoint] auszufüllen.

    Daten, die die Tabelle „erkannter API-Endpunkt“ [api_Endpoint_detected] ausfüllen, werden alle 30 Tage gelöscht.

    Tabelle : 2. API-Endpunkt erkannt [api_Endpoint_detected]
    Attribut Datentyp Beschreibung
    Name Zeichenfolge (100) Name des API-Endpunkts.
    Methode Zeichenfolge REST-API-Methoden. Beispiele:
    • GET
    • POST
    • DELETE
    URL Zeichenfolge (1024) URL der aufgerufenen Ressource.
    Typ Auswahlliste Typ der API. Sie können Folgendes angeben:
    • REST
    • SOAP
    • HTTP
    • gRPC
    • GraphQL
    • Websocket
    Autorisierung Zeichenfolge Typ der Autorisierungs- oder Authentifizierungsmethode. Beispiel:
    • Standard
    • Schlüssel
    • OAuth
    • Keine
    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:
    • CC
    • E-Mail
    • Adresse
    Antwortdatentypen Zeichenfolge (255) Liste der Datentypen in der Antwort. Beispiele:
    • CC
    • E-Mail
    • Adresse
    Header Zeichenfolge (255) Kommagetrennte Liste von Headernamen.
    Konfigurationselement Referenz Verweis auf eine Übereinstimmung CMDB CI (API-Komponente oder nicht abgeglichener API-Endpunkt).

    Zugehörige nicht- CMDB Tabellen

    Die nicht abgeglichene API-Erweiterungsklasse verwendet die nicht-CMDB-Tabelle „api-Bereitstellung“ [api_Deployment] als zugehörige Liste:

    Tabelle : 3. API-Bereitstellung [api_Deployment]
    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 Konfigurationselement. Dies wird normalerweise manuell als Referenz angegeben, wenn Sie wissen, für welches CI die API bereitgestellt wird.