Nicht übereinstimmende API-Erweiterungsklassen

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer

    • Die CMDB CI-Klassenmodelle Store-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.

    Die CMDB CI-Klassenmodelle App fügt Klassenmodelle hinzu, die erweitern CMDB Klassenhierarchie, einschließlich 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.

    Sie finden vollständige Versionshinweise für alle CMDB CI-Klassenmodelle Releases um: https://www.servicenow.com/docs/bundle/store-release-notes/page/release-notes/store/it-operations-management/store-rn-itom-cmdb-class-models.html?emcs_t=S2h8ZW1haWx8Ym9hcmRfc3Vic2NyaXB0aW9ufE1FMlVTSFREVDc3S0hTfDMzNDcxMjV8U1VCU0NSSVBUSU9OU3xoSw

    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 Erkennbarkeitstools verwendet.

    Klassen

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

    CMDB CI-Klassenmodelle: Release 1.49.0 fügt die folgende Klasse für nicht abgeglichene 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 Klasse „nicht abgeglichener API-Endpunkt“ [cmdb_ci_unmatched_api_Endpoint] die folgenden Attribute hinzu.

    Tabelle : 1. Nicht übereinstimmender 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 ist 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 angewendet werden 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 sicherzustellen, dass wohlgeformte 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 ausfüllen.

    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 Tabelle „nicht abgeglichener API-Endpunkt“ [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
    • VERÖFFENTLICHEN
    • LÖSCHEN
    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 ein übereinstimmendes CMDB-CI (API-Komponente oder nicht übereinstimmender 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.