---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CMDB Datenerfassungs-API

# CMDB Datenerfassungs-API {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 Minuten Lesedauer

Die CMDB-Datenerfassung Die API stellt Endpunkte bereit, die die Batch-Erfassung eines Arrays von Objekten in einer Importsatztabelle ermöglichen.  
Warnung:  
Diese API wird nicht mehr empfohlen. Verwenden Sie für die gleiche Funktionalität mit verbesserter Skalierbarkeit und Stabilität [Importsatz -- POSTEN /now/Import/{stagingTableName}/insertMultiple](https://servicenow-prod.fluidtopics.net/aWiMMCwNun5T~ymudsBmpw#import-POST-insertMultiple "Fügt mehrere Datensätze in eine angegebene Bereitstellungstabelle ein und löst die Transformation basierend auf vordefinierten Transformationszuordnungen oder robusten Transformationsmodul-Konfigurationen (RTE) in einer einzigen Anforderung aus.")Endpunkt. Von QuebecGeben Sie die Verwendung von ab CMDB-Datenerfassungs-API Muss zur Verwendung von migriert werden Importsatz: InsertMultiple Stattdessen Endpunkt.

Darüber hinaus funktioniert diese API für zboote Instanzen standardmäßig nicht.

Diese API wird über aktiviert Configuration Management Database (CMDB)(Com.snc.cmdb) Plugin und erfordert die Rolle „cmdb_import_api_admin".

## CMDB Datenerfassung -- /cmdb/ingest/{data_source_sys_id} POSTEN {#ariaid-title2}

Fügt Datensätze in die Importsatztabelle ein, die dem Datenquellendatensatz zugeordnet ist, der durch die übergebene sys_ID identifiziert wird
Warnung:  
Diese API wird nicht mehr empfohlen. Verwenden Sie für die gleiche Funktionalität mit verbesserter Skalierbarkeit und Stabilität [Importsatz -- POSTEN /now/Import/{stagingTableName}/insertMultiple](https://servicenow-prod.fluidtopics.net/aWiMMCwNun5T~ymudsBmpw#import-POST-insertMultiple "Fügt mehrere Datensätze in eine angegebene Bereitstellungstabelle ein und löst die Transformation basierend auf vordefinierten Transformationszuordnungen oder robusten Transformationsmodul-Konfigurationen (RTE) in einer einzigen Anforderung aus.")Endpunkt. Von QuebecGeben Sie die Verwendung von ab CMDB-Datenerfassungs-API Muss zur Verwendung von migriert werden Importsatz: InsertMultiple Stattdessen Endpunkt.

Darüber hinaus funktioniert diese API für zboote Instanzen standardmäßig nicht.

Der Anforderungstext muss das JSON-Array von Objekten (Nutzlast) enthalten, die in die Importsatztabelle eingefügt werden sollen. Jedes Objekt entspricht einer Zeile in der Tabelle, jedes Name-Wert-Paar entspricht einer Spalte. Die JSON-Nutzlast muss die Feldnamen aus dem Importsatz ohne das Präfix „u_" nutzen. Beispielsweise muss der Feldname „u_matching_Record" in der Nutzlast des Anforderungstexts „matching_Record" lauten. Wenn die Importsatztabelle vorhanden ist, hängt der Endpunkt die Zeilen (Objekte) an die vorhandene Importsatztabelle an. Es wird keine Überprüfung auf Duplikate oder Aktualisierung vorhandener Datensätze durchgeführt.

Wenn Sie anfänglich eine Anwendung erstellen, müssen Sie zuerst den zugehörigen Datenquellendatensatz in Ihrer Instanz erstellen, bevor Sie diesen Endpunkt aufrufen. Wenn Sie diesen Endpunkt nur verwenden, um einer vorhandenen Importsatztabelle Datensätze hinzuzufügen, müssen Sie den Datenquellendatensatz nicht erstellen, aber Sie müssen seine sys_ID kennen Der Datenquellendatensatz beschreibt die Importsatztabelle, in die die angegebene Nutzlast eingefügt werden soll. Diese Tabelle muss die Tabelle „Importsatzzeilen \[sys_import_set_row\]" erweitern. Außerdem muss die Datenquelle auf festgelegt werden <kbd class="ph userinput">Anhang </kbd>Und das Format auf festgelegt <kbd class="ph userinput">JSON </kbd>. Weitere Informationen zu Datenquellen finden Sie unter [Datenquellen](https://www.servicenow.com/docs/access?context=c_DataSources&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US).

Wenn die im Datenquellendatensatz definierte Importsatztabelle nicht vorhanden ist, hängt der Endpunkt die übergebene Nutzlast an den Datenquellendatensatz an. Um die erste Importsatztabelle zu erstellen, müssen Sie die Daten manuell in die Importsatztabelle importieren. Klicken Sie zum Importieren der Daten im Formular „zugehörige Datenquelle" auf Testen Sie 20 Datensätze Oder Alle Datensätze Laden Link im Abschnitt „zugehörige Links". Sobald die Importsatztabelle erstellt wurde, können Sie der Tabelle mit diesem Endpunkt keine Spalten hinzufügen. Wenn später Name-Wert-Paare übergeben werden, die in der Importsatztabelle nicht vorhanden sind, werden sie ohne Warnung ignoriert. Wenn Sie die Spalten in der Importsatztabelle ändern müssen, können Sie sie der Tabelle manuell hinzufügen. Sie können auch die Importsatztabelle löschen oder umbenennen und den Endpunkt mithilfe der neuen Nutzlast erneut aufrufen.

Sie müssen über die Rolle „cmdb_import_api_admin" verfügen, um auf diesen Endpunkt zuzugreifen.

### URL-Format {#cmdb-POST-ingest__section_dxb_tlr_cmb}

Versionierte URL: /api/now/{api_Version}/cmdb/ingest/{data_source_sys_id}

Standard-URL: /api/now/cmdb/ingest/{data_source_sys_id}  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#cmdb-POST-ingest__entry__2}{#cmdb-POST-ingest__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| data_source_sys_id | SYS_ID des Datenquellendatensatzes. Datentyp: Zeichenfolge |
[Tabelle : 1. Pfad-Parameter]

{#cmdb-POST-ingest__entry__8}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 2. Abfrageparameter]

{#cmdb-POST-ingest__entry__12}

| Name | Beschreibung |
|-|-|
| Array | Freiform-Array von Objekten, die die Daten beschreiben, die an die zugehörige Importsatztabelle angehängt werden sollen. Jedes Objekt im Array definiert eine Zeile in der Tabelle „Importsätze"; jedes Name-Wert-Paar eine Spalte. Hinweis: Dieses Array muss benannt werden, z. B. `„{\"Records\":[{\"hostname\": \"hostname1\", \"serialnumber\": \"2acd3873-7fc5-454c-8844-e7769e4d6cfc\", \"model\": \"Modell-ID"},{\"Vendor\": \"ABC Co\"}]} `. Datentyp: Array von Objekten |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#cmdb-POST-ingest__entry__16}{#cmdb-POST-ingest__accept-RESTAPI}{#cmdb-POST-ingest__content_type-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 4. Anforderungskopfzeilen.]

{#cmdb-POST-ingest__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#cmdb-POST-ingest__entry__26}{#cmdb-POST-ingest__entry-400-status-code}{#cmdb-POST-ingest__entry-404-status-code}{#cmdb-POST-ingest__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 201 | Erstellt. Der Datenquelle wurde ein Anhang hinzugefügt. |
| 202 | Akzeptiert. Zeilen wurden der Importsatztabelle hinzugefügt. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 409 | Konflikt. Anhang ist bereits in der Datenquelle vorhanden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
| 501 | Nicht Implementiert. Anforderungsformat wird nicht unterstützt. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#cmdb-POST-ingest__entry__42}

| Name | Beschreibung |
|-|-|
| Fehler | Beschreibt einen aufgetretenen Fehler. Datentyp: Objekt "error": { "details": "String", "message": "String" } |
| error.details | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehler.Nachricht | Nachricht, die den Fehler beschreibt. Datentyp: Zeichenfolge |
| import_set | Name der Importsatztabelle, an die die Nutzlast angehängt wurde. Datentyp: Zeichenfolge |
| Staged_row_count | Anzahl der Zeilen, die an die Importsatztabelle angehängt sind. Datentyp: Zahl |
| Staging_table | Name des Datenquellendatensatzes, der zum Bereitstellen der Nutzlast verwendet wird. Datentyp: Zeichenfolge |
| Status | Fehlerstatus. Datentyp: Zeichenfolge |
[ ]

### Beispiel für Curl-Anforderung

    curl "instance.service-now.com/api/now/cmdb/ingest/4dd9686d1b9800103d374087bc4bcb3d" \
    --request POST \
    --header "Accept: application/json" \
    --header "Content-Type:application/json" \
    --data "{\"records\":[{\"hostname\": \"Hostname1\", \"serialnumber\": \"2acd3873-7fc5-454c-8844-e7769e4d6cfc\", \"model\": \"Model 5100"},{\"vendor\": \"ABC Co\"},
    {\"hostname\": \"Hostname2\", \"serialnumber\": \"3adb3873-7fc5-564d-8844-e7769e4d6ded\", \"model\": \"Model 5200"},{\"vendor\": \"ACME Co\"}]}"
    --user "username":"password"

Erfolgreiche Antwort:

    {
      "result": {
        "staged_row_count": 2,
        "import_set": "ISET0010010",
        "staging_table": "sn_my_demo_integra_demo_data_source_01"
      }
    }


