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

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Open API des Ressourcenbestands

# Open API des Ressourcenbestands {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 27 Minuten Lesedauer

Die offene Ressourcenbestands- API bietet Endpunkte zum Erstellen, Abrufen und Löschen von Ressourcen.
Verwenden Sie diese API, um Ressourcen in den folgenden Tabellen zu verwalten.

* Kabel \[cmdb_ci_cable\]
* Gerätehalter \[cmdb_ci_equipment_holder\]
* Schnittstellenkarte \[cmdb_ci_interface_card\]
* IP-Adresse \[cmdb_ci_ip_address\]
* Logische Verbindung \[cmdb_ci_ni_logical_path\]
* Netzwerkschnittstelle \[cmdb_ci_ni_interface\]
* Netzwerkstandort \[cmdb_ci_ni_site\]
* Physische Verbindung \[cmdb_ci_ni_physical_link\]
* Litze \[cmdb_ci_Strand\]
* Topologie \[cmdb_ci_topology\]
* Tabellen, die durch die sys_property sn_ni_core.equipment_tables angegeben werden, sowie alle Tabellen, die die angegebenen Tabellen erweitern.
* Tabellen, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitern.
* Untergeordnete Tabellen, die eine der folgenden Tabellen erweitern:
  * Kabel \[cmdb_ci_cable\]
  * Gerätehalter \[cmdb_ci_equipment_holder\]
  * Litze \[cmdb_ci_Strand\]
  {#resource-inventory-api__ul_umw_gvn_bcc}
{#resource-inventory-api__ul_utd_jmd_wxb}

Diese API ist in der Anwendung Network Inventory Core enthalten, die unter ServiceNow Storeverfügbar ist.

Diese API wird im Namespace `sn_ni_core` bereitgestellt.

Der anrufende Benutzer muss über die Rolle sn_ni_core.inventory_integrator verfügen.

Diese API kann erweitert werden, um Anpassungen für erforderliche Parameter, die Validierung des Anforderungstexts und Feldzuordnungen vorzunehmen. Weitere Informationen finden Sie im Abschnitt .

Die Resource Inventory Open API ist eine ServiceNow® -Implementierung der REST-Spezifikation der TM Forum Resource Inventory API. Diese Implementierung basiert auf dem [TMF639 Resource Inventory API User Guide v4.0.1](https://www.tmforum.org/resources/standard/tmf639-resource-inventory-api-user-guide-v4-0/), Juli 2020.

## Offene API des Ressourcenbestands -- DELETE /sn_ni_core/resource/{id} {#ariaid-title2}

Löscht einen angegebenen Ressourcendatensatz.

### URL-Format

Standard-URL: /api/sn_ni_core/resource/{id}

### Unterstützte Anforderungsparameter

{#resource-inv-DELETE__table_tjw_q3s_g5b__entry__2}

| Name | Beschreibung |
|-|-|
| id | Sys_id der Ressource. Befindet sich je nach Ressourcentyp in einer der folgenden Tabellen. * Schnittstellenkarte \[cmdb_ci_interface_card\] * Logische Verbindung \[cmdb_ci_ni_logical_path\] * Netzwerkschnittstelle \[cmdb_ci_ni_interface\] * Netzwerkstandort \[cmdb_ci_ni_site\] * Physische Verbindung \[cmdb_ci_ni_physical_link\] * Tabellen, die durch die sys_property sn_ni_core.equipment_tables angegeben werden, sowie alle Tabellen, die die angegebenen Tabellen erweitern. * Tabellen, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitern. {#resource-inv-DELETE__res-inv-tables} Hinweis: Ressourcen in der IP-Adresstabelle \[cmdb_ci_ip_address\] können mit dieser API nicht gelöscht werden. Datentyp: Zeichenfolge |
[Tabelle : 1. Pfadparameter]

{#resource-inv-DELETE__table_tjw_q3s_g5b} {#resource-inv-DELETE__table_cnn_cht_g5b__entry__2}

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

{#resource-inv-DELETE__table_cnn_cht_g5b} {#resource-inv-DELETE__table_fdn_t3t_g5b__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Parameter des Anforderungstexts (JSON)]

{#resource-inv-DELETE__table_fdn_t3t_g5b}

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. 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/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#resource-inv-DELETE__table_e4k_vhs_g5b__entry__2}{#resource-inv-DELETE__accept-JSON-only-entry-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
[Tabelle : 4. Anforderungskopfzeilen]

{#resource-inv-DELETE__table_e4k_vhs_g5b} {#resource-inv-DELETE__table_gfy_npw_f5b__entry__2}

| Kopfzeile | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur application/json. |
[Tabelle : 5. Antwortkopfzeilen]

{#resource-inv-DELETE__table_gfy_npw_f5b}

### 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 [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#resource-inv-DELETE__table_b4x_lrs_g5b__entry__2}{#resource-inv-DELETE__entry-400-status-code}{#resource-inv-DELETE__entry-401-status-code}{#resource-inv-DELETE__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 215 | Anforderung zur Verarbeitung erfolgreich erhalten. Die Anforderung wird asynchron abgeschlossen. |
| 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 403 | Unzulässig. Fehler beim Löschen der Ressource. Die Ressource wird möglicherweise von den zugehörigen Ressourcen benötigt. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 6. Statuscodes]

{#resource-inv-DELETE__table_b4x_lrs_g5b}

### Parameter des Antwort-Haupttexts (JSON)

{#resource-inv-DELETE__entry__34}

| Name | Beschreibung |
|-|-|
| Keine |   |
[ ]

### cURL-Anforderung

In diesem Beispiel wird eine -Ressource gelöscht.

    curl "https://instance.service-now.com/api/sn_ni_core/resource/54ada05e875c15109a9c0f65dabb3586" \
    --request DELETE \
    --header "Accept:application/json" \
    --user 'username':'password'

Antworttext.

    ""

## Offene API des Ressourcenbestands: GET /sn_ni_core/resource {#ariaid-title3}

Ruft eine Liste aller Ressourcendatensätze ab.

### URL-Format

Standard-URL: /api/sn_ni_core/resource

### Unterstützte Anforderungsparameter

{#resource-inv-GET-resource__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 7. Pfadparameter]

{#resource-inv-GET-resource__entry__6}{#resource-inv-GET-resource__tmf-offset}

| Name | Beschreibung |
|-|-|
| @type | Erforderlich. Tabellenname des abzurufenden Ressourcentyps. Sie können pro API-Aufruf nur einen Ressourcentyp abrufen. Gültige Werte: * `cmdb_ci_cable` (Kabel) * `cmdb_ci_interface_card` (Schnittstellenkarte) * `cmdb_ci_ip_address` (IP-Adresse) * `cmdb_ci_ni_logical_path` (logische Verbindung) * `cmdb_ci_ni_interface` (Netzwerkschnittstelle) * `cmdb_ci_ni_site` (Netzwerkstandort) * `cmdb_ci_ni_physical_link` (Physische Verbindung) * `cmdb_ci_Strand` (Strand) * `cmdb_ci_topology` (Topologie) * Name einer durch die sys_property sn_ni_core.equipment_tables angegebenen Tabelle oder Name einer Tabelle, die die angegebenen Tabellen erweitert. * Name einer Tabelle, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitert {#resource-inv-GET-resource__ul_wmt_vfz_d5b} Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung zum Filtern von Ressourcen. In der Antwort werden nur Ressourcen mit der angegebenen Beschreibung zurückgegeben. Datentyp: Zeichenfolge |
| Felder | Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Gültige Werte: * Beschreibung * href * id * name * Hinweis * Ort * Zugehörige Partei * Ressourcenmerkmal * resourceRelationship * resourceSpecification * startOperatingDate {#resource-inv-GET-resource__ul_pzn_4gz_d5b} Standard: Gibt alle Felder zurück. Datentyp: Zeichenfolge |
| limit | Maximale Anzahl der zurückzugebenden Datensätze. Verwenden Sie für Anforderungen, die diese Anzahl von Datensätzen überschreiten, den Parameter offset, um den Datensatzabruf zu paginieren. Standard: 20 Datentyp: Zahl |
| name | Name zum Filtern von Ressourcen. In der Antwort werden nur Ressourcen mit dem angegebenen Namen zurückgegeben. Datentyp: Zeichenfolge |
| Offset | Startindex, ab dem mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktion ermöglicht das Abrufen aller Datensätze in kleinen, verwaltbaren Abschnitten, unabhängig von der Anzahl der Datensätze. Standard: 0 Datentyp: Zahl |
| resourceSpecification.id | sys_id der Ressourcenspezifikation, die zum Filtern von Ressourcen verwendet werden soll. Die sys_id muss aus einem Modell in einer der folgenden Tabellen stammen. * Gerätehaltermodelle \[sn_ni_core_equipment_holder_product_model\] * Anlagenmodelle \[sn_ni_core_equipment_product_model\] * Schnittstellenkartenmodelle \[sn_ni_core_interface_card_product_model\] * Logische Verbindungsmodelle \[sn_ni_core_logical_connection_product_model\] * Netzwerkschnittstellenmodelle \[sn_ni_core_network_interface_product_model\] * Physische Verbindungsmodelle \[sn_ni_core_physical_connection_product_model\] {#resource-inv-GET-resource__ul_a3t_1lz_d5b}In der Antwort werden nur Ressourcen zurückgegeben, deren Modell mit der angegebenen sys_id übereinstimmt. Datentyp: Zeichenfolge |
[Tabelle : 8. Abfrageparameter]

{#resource-inv-GET-resource__entry__22}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. Parameter des Anforderungstexts (JSON)]

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. 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/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#resource-inv-GET-resource__entry__26}{#resource-inv-GET-resource__accept-JSON-only-entry-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
[Tabelle : 10. Anforderungskopfzeilen]

{#resource-inv-GET-resource__table_lpj_dh1_vxb__entry__2}

| Kopfzeile | Beschreibung |
|-|-|
| Inhaltsbereich | Gibt den Inhaltsbereich an, der in einem paginierten Aufruf zurückgegeben wird. Beispiel: Wenn `Offset=2` und `Limit=3`, ist der Wert des Content-Range -Headers `Elemente 3-5`. |
| Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur application/json. |
| Verknüpfung | Enthält die folgenden Links zum Navigieren durch Abfrageergebnisse. * zuerst * letzte * Weiter * previous {#resource-inv-GET-resource__ul_zzk_sdm_lsb} |
| X-Gesamtzahl | Für paginierte Abfragen gibt dieser Header die Gesamtzahl der auf dem Server verfügbaren Datensätze an. Hinweis: Wenn die Gesamtzahl der Datensätze 100.000 überschreitet, gibt dieser Header immer 100.000 zurück. |
[Tabelle : 11. Antwortkopfzeilen]

{#resource-inv-GET-resource__table_lpj_dh1_vxb}

### 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 [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#resource-inv-GET-resource__entry__40}{#resource-inv-GET-resource__entry-200-status-code}{#resource-inv-GET-resource__entry-400-status-code}{#resource-inv-GET-resource__entry-401-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 206 | Teilinhalt. Die Anforderung wurde erfolgreich verarbeitet und hat einen Teilbereich von Inhalten zurückgegeben, die durch einen paginierten Aufruf angegeben wurden. |
| 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
[Tabelle : 12. Statuscodes]

### Parameter des Antwort-Haupttexts (JSON) {#resource-inv-GET-resource__section_nkb_1rw_f5b}

{#resource-inv-GET-resource__table_okb_1rw_f5b__entry__2}{#resource-inv-GET-resource__type-descr-entry}{#resource-inv-GET-resource__related-party-parm}

| Name | Beschreibung |
|-|-|
| @type | Der Typ der Ressource. Gültige Werte: * `cmdb_ci_cable` (Kabel) * `cmdb_ci_interface_card` (Schnittstellenkarte) * `cmdb_ci_ip_address` (IP-Adresse) * `cmdb_ci_ni_logical_path` (logische Verbindung) * `cmdb_ci_ni_interface` (Netzwerkschnittstelle) * `cmdb_ci_ni_site` (Netzwerkstandort) * `cmdb_ci_ni_physical_link` (Physische Verbindung) * `cmdb_ci_Strand` (Strand) * `cmdb_ci_topology` (Topologie) * Name einer durch die sys_property sn_ni_core.equipment_tables angegebenen Tabelle oder Name einer Tabelle, die die angegebenen Tabellen erweitert. * Name einer Tabelle, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitert {#resource-inv-GET-resource__d3249e148} Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung der Ressource. Datentyp: Zeichenfolge |
| href | Relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge |
| id | Sys_id der Ressource. Befindet sich je nach Ressourcentyp in einer der folgenden Tabellen. * Kabel \[cmdb_ci_cable\] * Gerätehalter \[cmdb_ci_equipment_holder\] * Schnittstellenkarte \[cmdb_ci_interface_card\] * IP-Adresse \[cmdb_ci_ip_address\] * Logische Verbindung \[cmdb_ci_ni_logical_path\] * Netzwerkschnittstelle \[cmdb_ci_ni_interface\] * Netzwerkstandort \[cmdb_ci_ni_site\] * Physische Verbindung \[cmdb_ci_ni_physical_link\] * Litze \[cmdb_ci_Strand\] * Topologie \[cmdb_ci_topology\] * Tabellen, die durch die sys_property sn_ni_core.equipment_tables angegeben werden, sowie alle Tabellen, die die angegebenen Tabellen erweitern. * Tabellen, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitern. * Untergeordnete Tabellen, die eine der folgenden Tabellen erweitern: * Kabel \[cmdb_ci_cable\] * Gerätehalter \[cmdb_ci_equipment_holder\] * Litze \[cmdb_ci_Strand\] {#resource-inv-GET-resource__ul_umw_gvn_bcc} {#resource-inv-GET-resource__res-inv-tables} Datentyp: Zeichenfolge |
| name | Name der Ressource Datentyp: Zeichenfolge |
| Hinweis | Liste der Notizen zur Ressource. Datentyp: Array "note": [ { "text": "String" } ] |
| Anmerkung.Text | Der Hinweistext. Datentyp: Zeichenfolge |
| Ort | Netzwerkstandort für die Ressource. Dieser Parameter wird für Ressourcen vom Typ „Netzwerkstandort", „Physische Verbindung" oder „Logische Verbindung" nicht unterstützt. Datentyp: Objekt "place": { "@referredType": "String", "href": "String", "id": "String" } |
| ort.@referredType | Der Typ des Orts. Dieser Wert ist immer `GeographicAddress`. Datentyp: Zeichenfolge |
| ort.href | Relativer Link zum Ortsdatensatz. Datentyp: Zeichenfolge |
| place.id | Sys_id des Ortsdatensatzes in der Tabelle „Netzwerkstandort" \[cmdb_ci_ni_site\]. Datentyp: Zeichenfolge |
| Zugehörige Partei | Details zu Kontakten für die Ressource. Datentyp: Array "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] |
| zugehörigepartei.@referenztyp | Typ der zugehörigen Partei Zu finden in der Tabelle „Gruppe" \[sys_user_group\] im Feld Typ. Datentyp: Zeichenfolge |
| Zugehörigepartei.href | Relativer Link zum Datensatz der zugehörigen Partei. Datentyp: Zeichenfolge |
| relatedParty.id | Sys_id des zugehörigen Parteidatensatzes in der Tabelle „Gruppe" \[sys_user_group\] Datentyp: Zeichenfolge |
| zugehörigePartei.Rolle | Die Rolle der zugehörigen Partei. Zu finden in der Teams-Tabelle \[cmdb_rel_team\] im Feld Gruppentyp. Datentyp: Zeichenfolge |
| Ressourcenmerkmal | Liste der Merkmale der Ressource. Die folgenden Ressourcentypen erfordern bestimmte Ressourceneigenschaften. * Für physische und logische Verbindungsressourcen ist ein `Port A-` oder `Port Z-` Merkmal erforderlich. Wenn der Lebenszyklusphasenstatus der Ressource „In Gebrauch" lautet, sind `Port A` und `Port Z` erforderlich. * Für Gerätehalter-Ressourcen ist ein `Containertyp-` Merkmal erforderlich. {#resource-inv-GET-resource__ul_wsv_p2m_g5b} Datentyp: Array "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] |
| resourceCharacteristic.name | Feldname aus der Ressourcentabelle, die durch den Parameter @type angegeben wird. Sie können die Felder „model_id", „name", „network_site", „operation_notes", „operational_status", „short_description" und „start_date" sowie keine Felder mit dem Präfix „sys_" wie „sys_id" verwenden. Datentyp: Zeichenfolge |
| Ressourcenmerkmal.Wert | Der Wert des Merkmals. Datentyp: Zeichenfolge |
| Ressourcenmerkmal.Werttyp | Der Typ des Werts. Gültige Werte: * boolean * datetime * Float * integer * ph_number * Referenz * Zeichenfolge {#resource-inv-GET-resource__ul_bk1_rw2_g5b} Datentyp: Zeichenfolge |
| resourceRelationship | Liste der zugehörigen Ressourcen. Die folgenden Ressourcentypen erfordern bestimmte zugehörige Ressourcen. * Für Schnittstellenkarten-Ressourcen ist eine Beziehung zu einer Gerätehalter-Ressource erforderlich, bei der der Containertyp „Slot" oder „Sub-Slot" ist. * Für Netzwerkschnittstellen-Ressourcen ist eine Beziehung zu einer Anlagen- oder Schnittstellenkarten-Ressource erforderlich. * Für Gerätehalter-Ressourcen, bei denen der Containertyp „Slot" oder „Sub-Slot" ist, ist eine Beziehung zu einer Geräte- oder Schnittstellenkarten-Ressource erforderlich. {#resource-inv-GET-resource__ul_rlv_3dm_g5b} Datentyp: Array "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] |
| resourceRelationship.relationshipType | Typ der Beziehung zwischen den beiden Ressourcen im Format `[dieser Ressourcendeskriptor]::[zugehöriger Ressourcendeskriptor]`. Beispiel: `Contains::Contained by` gibt an, dass die zugehörige Ressource das untergeordnete Element dieser Ressource ist. Gültige Werte für die Deskriptoren finden Sie in der Tabelle „CI-Beziehungstyp" \[cmdb_rel_type\] in den Spalten Übergeordneter Deskriptor und Untergeordneter Deskriptor. Datentyp: Zeichenfolge |
| resourceBeziehung.Ressource | Details zur zugehörigen Ressource. Die zugehörige Ressource muss einer der folgenden Ressourcentypen sein. * Kabel * Gerät * Gerätehalter * Schnittstellenkarte * Logische Verbindung * Netzwerkschnittstelle * Netzwerkstandort * Physische Verbindung * Strand * Topologie {#resource-inv-GET-resource__ul_wmt_vtx_d5y} Datentyp: Objekt "resource": { "id": "String", "href": "String" } |
| resourceRelationship.resource.id | Sys_id der zugehörigen Ressource. Befindet sich je nach Typ der zugehörigen Ressource in einer der folgenden Tabellen. * Schnittstellenkarte \[cmdb_ci_interface_card\] * Logische Verbindung \[cmdb_ci_ni_logical_path\] * Netzwerkschnittstelle \[cmdb_ci_ni_interface\] * Netzwerkstandort \[cmdb_ci_ni_site\] * Physische Verbindung \[cmdb_ci_ni_physical_link\] * Tabellen, die durch die sys_property sn_ni_core.equipment_tables angegeben werden, sowie alle Tabellen, die die angegebenen Tabellen erweitern. * Tabellen, die den Gerätehalter erweitern \[cmdb_ci_equipment_holder\] {#resource-inv-GET-resource__ul_vr1_4gf_g5b} Datentyp: Zeichenfolge |
| resourceRelationship.resource.href | Relativer Link zum zugehörigen Ressourcendatensatz. Datentyp: Zeichenfolge |
| resourceSpecification | Ressourcenspezifikation Datentyp: Objekt "resourceSpecification": { "id": "String" } |
| resourceSpecification.id | Sys_id des zugeordneten Modells für die Ressource. Befindet sich je nach Modelltyp in einer der folgenden Tabellen. * Kabelmodelle \[sn_ent_cable_model\] * Gerätehaltermodelle \[sn_ent_nw_holder_model\] * Anlagenmodelle \[sn_ent_nw_equipment_model\] * Schnittstellenkartenmodelle \[sn_ent_nw_interface_model\] * Logische Verbindungsmodelle \[sn_ent_logical_nw_connection_model\] * Netzwerkschnittstellenmodelle \[sn_ent_nw_interface_model\] * Physische Verbindungsmodelle \[sn_ent_physical_nw_connection_model\] * Litzenmodelle \[sn_ent_Strand_model\] * Topologiemodelle \[sn_ent_network_topology_model\] {#resource-inv-GET-resource__d3249e774} Datentyp: Zeichenfolge |
| startOperatingDate | Datum und Uhrzeit der ersten Inbetriebnahme der Ressource. Datentyp: Zeichenfolge |
[ ]

{#resource-inv-GET-resource__table_okb_1rw_f5b}  

### cURL-Anforderung

In diesem Beispiel werden die Felder name, idund href für die ersten fünf Ressourcendatensätze eines Netzwerkstandorts abgerufen.

    curl "https://instance.service-now.com/api/sn_ni_core/resource?@type=cmdb_ci_ni_site&fields=name%2Cid%2Chref&limit=5" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

Antworttext.

    [
       {
          "name": "DALLAS TX CO/HUB",
          "id": "c23683c54051c910f8772175cacd725c",
          "href": "/api/sn_ni_core/resource/c23683c54051c910f8772175cacd725c"
       },
       {
          "name": "PFP LOC F-800",
          "id": "0ac19bc54051c910f8772175cacd724b",
          "href": "/api/sn_ni_core/resource/0ac19bc54051c910f8772175cacd724b"
       },
       {
          "name": "FIBER SERVICE TERMINAL 003",
          "id": "d0541fcd4051c910f8772175cacd72c8",
          "href": "/api/sn_ni_core/resource/d0541fcd4051c910f8772175cacd72c8"
       },
       {
          "name": "270 RUMWOOD MAIN",
          "id": "e6f6df8d4051c910f8772175cacd72b2",
          "href": "/api/sn_ni_core/resource/e6f6df8d4051c910f8772175cacd72b2"
       },
       {
          "name": "3620 CHESTER ROMI48073",
          "id": "917dd8f6870e851079c40f2d0ebb353d",
          "href": "/api/sn_ni_core/resource/917dd8f6870e851079c40f2d0ebb353d"
       }
    ]

## Offene API des Ressourcenbestands -- GET /sn_ni_core/resource/{id} {#ariaid-title4}

Ruft einen angegebenen Ressourcendatensatz ab.

### URL-Format

Standard-URL: /api/sn_ni_core/resource/{id}

### Unterstützte Anforderungsparameter

{#resource-inv-GET-resource-id__table_tjw_q3s_g5b__entry__2}

| Name | Beschreibung |
|-|-|
| id | Sys_id der Ressource. Befindet sich je nach Ressourcentyp in einer der folgenden Tabellen. * Kabel \[cmdb_ci_cable\] * Gerätehalter \[cmdb_ci_equipment_holder\] * Schnittstellenkarte \[cmdb_ci_interface_card\] * IP-Adresse \[cmdb_ci_ip_address\] * Logische Verbindung \[cmdb_ci_ni_logical_path\] * Netzwerkschnittstelle \[cmdb_ci_ni_interface\] * Netzwerkstandort \[cmdb_ci_ni_site\] * Physische Verbindung \[cmdb_ci_ni_physical_link\] * Litze \[cmdb_ci_Strand\] * Topologie \[cmdb_ci_topology\] * Tabellen, die durch die sys_property sn_ni_core.equipment_tables angegeben werden, sowie alle Tabellen, die die angegebenen Tabellen erweitern. * Tabellen, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitern. * Untergeordnete Tabellen, die eine der folgenden Tabellen erweitern: * Kabel \[cmdb_ci_cable\] * Gerätehalter \[cmdb_ci_equipment_holder\] * Litze \[cmdb_ci_Strand\] {#resource-inv-GET-resource-id__ul_umw_gvn_bcc} {#resource-inv-GET-resource-id__res-inv-tables} Datentyp: Zeichenfolge |
[Tabelle : 13. Pfadparameter]

{#resource-inv-GET-resource-id__table_tjw_q3s_g5b} {#resource-inv-GET-resource-id__entry__6}

| Name | Beschreibung |
|-|-|
| Felder | Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Gültige Werte: * Beschreibung * href * id * name * Hinweis * Ort * Zugehörige Partei * Ressourcenmerkmal * resourceRelationship * resourceSpecification * startOperatingDate {#resource-inv-GET-resource-id__ul_pzn_4gz_d5b} Standard: Gibt alle Felder zurück. Datentyp: Zeichenfolge |
[Tabelle : 14. Abfrageparameter]

{#resource-inv-GET-resource-id__table_yh2_zhs_g5b__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 15. Parameter des Anforderungstexts (JSON)]

{#resource-inv-GET-resource-id__table_yh2_zhs_g5b}

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. 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/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#resource-inv-GET-resource-id__table_e4k_vhs_g5b__entry__2}{#resource-inv-GET-resource-id__accept-JSON-only-entry-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
[Tabelle : 16. Anforderungskopfzeilen]

{#resource-inv-GET-resource-id__table_e4k_vhs_g5b} {#resource-inv-GET-resource-id__table_gfy_npw_f5b__entry__2}

| Kopfzeile | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur application/json. |
[Tabelle : 17. Antwortkopfzeilen]

{#resource-inv-GET-resource-id__table_gfy_npw_f5b}

### 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 [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#resource-inv-GET-resource-id__table_yn5_ths_g5b__entry__2}{#resource-inv-GET-resource-id__entry-200-status-code}{#resource-inv-GET-resource-id__entry-400-status-code}{#resource-inv-GET-resource-id__entry-401-status-code}{#resource-inv-GET-resource-id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 18. Statuscodes]

{#resource-inv-GET-resource-id__table_yn5_ths_g5b}

### Parameter des Antwort-Haupttexts (JSON) {#resource-inv-GET-resource-id__section_nkb_1rw_f5b}

{#resource-inv-GET-resource-id__table_okb_1rw_f5b__entry__2}{#resource-inv-GET-resource-id__type-descr-entry}{#resource-inv-GET-resource-id__related-party-parm}

| Name | Beschreibung |
|-|-|
| @type | Der Typ der Ressource. Gültige Werte: * `cmdb_ci_cable` (Kabel) * `cmdb_ci_interface_card` (Schnittstellenkarte) * `cmdb_ci_ip_address` (IP-Adresse) * `cmdb_ci_ni_logical_path` (logische Verbindung) * `cmdb_ci_ni_interface` (Netzwerkschnittstelle) * `cmdb_ci_ni_site` (Netzwerkstandort) * `cmdb_ci_ni_physical_link` (Physische Verbindung) * `cmdb_ci_Strand` (Strand) * `cmdb_ci_topology` (Topologie) * Name einer durch die sys_property sn_ni_core.equipment_tables angegebenen Tabelle oder Name einer Tabelle, die die angegebenen Tabellen erweitert. * Name einer Tabelle, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitert {#resource-inv-GET-resource-id__ul_wmt_vfz_d5b} Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung der Ressource. Datentyp: Zeichenfolge |
| href | Relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge |
| id | Sys_id der Ressource. Befindet sich je nach Ressourcentyp in einer der folgenden Tabellen. * Kabel \[cmdb_ci_cable\] * Gerätehalter \[cmdb_ci_equipment_holder\] * Schnittstellenkarte \[cmdb_ci_interface_card\] * IP-Adresse \[cmdb_ci_ip_address\] * Logische Verbindung \[cmdb_ci_ni_logical_path\] * Netzwerkschnittstelle \[cmdb_ci_ni_interface\] * Netzwerkstandort \[cmdb_ci_ni_site\] * Physische Verbindung \[cmdb_ci_ni_physical_link\] * Litze \[cmdb_ci_Strand\] * Topologie \[cmdb_ci_topology\] * Tabellen, die durch die sys_property sn_ni_core.equipment_tables angegeben werden, sowie alle Tabellen, die die angegebenen Tabellen erweitern. * Tabellen, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitern. * Untergeordnete Tabellen, die eine der folgenden Tabellen erweitern: * Kabel \[cmdb_ci_cable\] * Gerätehalter \[cmdb_ci_equipment_holder\] * Litze \[cmdb_ci_Strand\] {#resource-inv-GET-resource-id__d3249e283} {#resource-inv-GET-resource-id__d3249e238} Datentyp: Zeichenfolge |
| name | Name der Ressource Datentyp: Zeichenfolge |
| Hinweis | Liste der Notizen zur Ressource. Datentyp: Array "note": [ { "text": "String" } ] |
| Anmerkung.Text | Der Hinweistext. Datentyp: Zeichenfolge |
| Ort | Netzwerkstandort für die Ressource. Dieser Parameter wird für Ressourcen vom Typ „Netzwerkstandort", „Physische Verbindung" oder „Logische Verbindung" nicht unterstützt. Datentyp: Objekt "place": { "@referredType": "String", "href": "String", "id": "String" } |
| ort.@referredType | Der Typ des Orts. Dieser Wert ist immer `GeographicAddress`. Datentyp: Zeichenfolge |
| ort.href | Relativer Link zum Ortsdatensatz. Datentyp: Zeichenfolge |
| place.id | Sys_id des Ortsdatensatzes in der Tabelle „Netzwerkstandort" \[cmdb_ci_ni_site\]. Datentyp: Zeichenfolge |
| Zugehörige Partei | Details zu Kontakten für die Ressource. Datentyp: Array "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] |
| zugehörigepartei.@referenztyp | Typ der zugehörigen Partei Zu finden in der Tabelle „Gruppe" \[sys_user_group\] im Feld Typ. Datentyp: Zeichenfolge |
| Zugehörigepartei.href | Relativer Link zum Datensatz der zugehörigen Partei. Datentyp: Zeichenfolge |
| relatedParty.id | Sys_id des zugehörigen Parteidatensatzes in der Tabelle „Gruppe" \[sys_user_group\] Datentyp: Zeichenfolge |
| Ressourcenmerkmal | Liste der Merkmale der Ressource. Die folgenden Ressourcentypen erfordern bestimmte Ressourceneigenschaften. * Für physische und logische Verbindungsressourcen ist ein `Port A-` oder `Port Z-` Merkmal erforderlich. Wenn der Lebenszyklusphasenstatus der Ressource „In Gebrauch" lautet, sind `Port A` und `Port Z` erforderlich. * Für Gerätehalter-Ressourcen ist ein `Containertyp-` Merkmal erforderlich. {#resource-inv-GET-resource-id__ul_wsv_p2m_g5b} Datentyp: Array "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] |
| resourceCharacteristic.name | Feldname aus der Ressourcentabelle, die durch den Parameter @type angegeben wird. Sie können die Felder „model_id", „name", „network_site", „operation_notes", „operational_status", „short_description" und „start_date" sowie keine Felder mit dem Präfix „sys_" wie „sys_id" verwenden. Datentyp: Zeichenfolge |
| Ressourcenmerkmal.Wert | Der Wert des Merkmals. Datentyp: Zeichenfolge |
| Ressourcenmerkmal.Werttyp | Der Typ des Werts. Gültige Werte: * boolean * datetime * Float * integer * ph_number * Referenz * Zeichenfolge {#resource-inv-GET-resource-id__ul_bk1_rw2_g5b} Datentyp: Zeichenfolge |
| resourceRelationship | Liste der zugehörigen Ressourcen. Die folgenden Ressourcentypen erfordern bestimmte zugehörige Ressourcen. * Für Schnittstellenkarten-Ressourcen ist eine Beziehung zu einer Gerätehalter-Ressource erforderlich, bei der der Containertyp „Slot" oder „Sub-Slot" ist. * Für Netzwerkschnittstellen-Ressourcen ist eine Beziehung zu einer Anlagen- oder Schnittstellenkarten-Ressource erforderlich. * Für Gerätehalter-Ressourcen, bei denen der Containertyp „Slot" oder „Sub-Slot" ist, ist eine Beziehung zu einer Geräte- oder Schnittstellenkarten-Ressource erforderlich. {#resource-inv-GET-resource-id__ul_rlv_3dm_g5b} Datentyp: Array "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] |
| resourceRelationship.relationshipType | Typ der Beziehung zwischen den beiden Ressourcen im Format `[dieser Ressourcendeskriptor]::[zugehöriger Ressourcendeskriptor]`. Beispiel: `Contains::Contained by` gibt an, dass die zugehörige Ressource das untergeordnete Element dieser Ressource ist. Gültige Werte für die Deskriptoren finden Sie in der Tabelle „CI-Beziehungstyp" \[cmdb_rel_type\] in den Spalten Übergeordneter Deskriptor und Untergeordneter Deskriptor. Datentyp: Zeichenfolge |
| resourceBeziehung.Ressource | Details zur zugehörigen Ressource. Die zugehörige Ressource muss einer der folgenden Ressourcentypen sein. * Kabel * Gerät * Gerätehalter * Schnittstellenkarte * Logische Verbindung * Netzwerkschnittstelle * Netzwerkstandort * Physische Verbindung * Strand * Topologie {#resource-inv-GET-resource-id__ul_wmt_vtx_d5y} Datentyp: Objekt "resource": { "id": "String", "href": "String" } |
| resourceRelationship.resource.id | Sys_id der zugehörigen Ressource. Befindet sich je nach Typ der zugehörigen Ressource in einer der folgenden Tabellen. * Schnittstellenkarte \[cmdb_ci_interface_card\] * Logische Verbindung \[cmdb_ci_ni_logical_path\] * Netzwerkschnittstelle \[cmdb_ci_ni_interface\] * Netzwerkstandort \[cmdb_ci_ni_site\] * Physische Verbindung \[cmdb_ci_ni_physical_link\] * Tabellen, die durch die sys_property sn_ni_core.equipment_tables angegeben werden, sowie alle Tabellen, die die angegebenen Tabellen erweitern. * Tabellen, die den Gerätehalter erweitern \[cmdb_ci_equipment_holder\] {#resource-inv-GET-resource-id__ul_vr1_4gf_g5b} Datentyp: Zeichenfolge |
| resourceRelationship.resource.href | Relativer Link zum zugehörigen Ressourcendatensatz. Datentyp: Zeichenfolge |
| resourceSpecification | Ressourcenspezifikation Datentyp: Objekt "resourceSpecification": { "id": "String" } |
| resourceSpecification.id | Sys_id des zugeordneten Modells für die Ressource. Befindet sich je nach Modelltyp in einer der folgenden Tabellen. * Kabelmodelle \[sn_ent_cable_model\] * Gerätehaltermodelle \[sn_ent_nw_holder_model\] * Anlagenmodelle \[sn_ent_nw_equipment_model\] * Schnittstellenkartenmodelle \[sn_ent_nw_interface_model\] * Logische Verbindungsmodelle \[sn_ent_logical_nw_connection_model\] * Netzwerkschnittstellenmodelle \[sn_ent_nw_interface_model\] * Physische Verbindungsmodelle \[sn_ent_physical_nw_connection_model\] * Litzenmodelle \[sn_ent_Strand_model\] * Topologiemodelle \[sn_ent_network_topology_model\] {#resource-inv-GET-resource-id__ul_a3t_1lz_d5b} Datentyp: Zeichenfolge |
| startOperatingDate | Datum und Uhrzeit der ersten Inbetriebnahme der Ressource. Datentyp: Zeichenfolge |
[ ]

{#resource-inv-GET-resource-id__table_okb_1rw_f5b}  

### cURL-Anforderung

In diesem Beispiel wird ein angegebener Ressourcendatensatz abgerufen.

    curl "https://instance.service-now.com/api/sn_ni_core/resource/915da8e140ddc910f8772175cacd72de" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

Antworttext.

    {
       "href": "/api/sn_ni_core/resource/915da8e140ddc910f8772175cacd72de",
       "id": "915da8e140ddc910f8772175cacd72de",
       "name": "DLLSTXMR/ESS7450/IOM-01/MDA-01/NI-01",
       "place": {
          "id": "c23683c54051c910f8772175cacd725c",
          "href": "/api/now/table/cmdb_ci_ni_site/c23683c54051c910f8772175cacd725c",
          "@referredType": "GeographicAddress"
       },
       "resourceCharacteristic": [
          {
             "name": "attested",
             "valueType": "boolean",
             "value": "false"
          },
          {
             "name": "availability",
             "valueType": "string",
             "value": "used"
          },
          {
             "name": "cabled",
             "valueType": "boolean",
             "value": "false"
          },
          {
             "name": "can_print",
             "valueType": "boolean",
             "value": "false"
          },
          {
             "name": "connector_type",
             "valueType": "string",
             "value": "sc"
          },
          {
             "name": "cost_cc",
             "valueType": "string",
             "value": "USD"
          },
          {
             "name": "equipment_clli",
             "valueType": "string",
             "value": "DLLSTXESS01"
          },
          {
             "name": "fault_count",
             "valueType": "integer",
             "value": "0"
          },
          {
             "name": "install_status",
             "valueType": "integer",
             "value": "1"
          },
          {
             "name": "life_cycle_stage",
             "valueType": "reference",
             "value": "Operational"
          },
          {
             "name": "life_cycle_stage_status",
             "valueType": "reference",
             "value": "In Use"
          },
          {
             "name": "manufacturer",
             "valueType": "reference",
             "value": "a2f6a4914055c910f8772175cacd723a"
          },
          {
             "name": "monitor",
             "valueType": "boolean",
             "value": "false"
          },
          {
             "name": "network_domain",
             "valueType": "string",
             "value": "core"
          },
          {
             "name": "ni_type",
             "valueType": "reference",
             "value": "646cf25fe42e0510f877e70ec9bcaca8"
          },
          {
             "name": "port_bandwidth",
             "valueType": "reference",
             "value": "ff39ae92eb900110700ca73bc152286d"
          },
          {
             "name": "replaceable",
             "valueType": "boolean",
             "value": "false"
          },
          {
             "name": "skip_sync",
             "valueType": "boolean",
             "value": "false"
          },
          {
             "name": "telco_equipment",
             "valueType": "reference",
             "value": "583e7b95405dc910f8772175cacd7292"
          },
          {
             "name": "unverified",
             "valueType": "boolean",
             "value": "false"
          },
          {
             "name": "virtual",
             "valueType": "boolean",
             "value": "false"
          }
       ],
       "resourceRelationship": [
          {
             "relationshipType": "Contained by::Contains",
             "resource": {
                "id": "81baac6140ddc910f8772175cacd728e",
                "href": "/api/sn_ni_core/resource/81baac6140ddc910f8772175cacd728e"
             }
          },
          {
             "relationshipType": "Contained by::Contains",
             "resource": {
                "id": "bf624bc640194d10f8772175cacd7225",
                "href": "/api/sn_ni_core/resource/bf624bc640194d10f8772175cacd7225"
             }
          }
       ],
       "resourceSpecification": {
          "id": "980416b0874e8110d28eb259dabb356b",
          "href": "/api/now/table/sn_ni_core_network_inventory_product_model/980416b0874e8110d28eb259dabb356b",
          "@referredType": "NetworkInterfaceModel"
       },
       "@type": "cmdb_ci_ni_interface"
    }

## Offene API des Ressourcenbestands -- POST /sn_ni_core/resource {#ariaid-title5}

Erstellt einen Ressourcendatensatz.

### URL-Format

Standard-URL: /api/sn_ni_core/resource

### Unterstützte Anforderungsparameter

{#resource-inv-POST-resource__table_vzn_xns_g5b__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 19. Pfadparameter]

{#resource-inv-POST-resource__table_vzn_xns_g5b} {#resource-inv-POST-resource__entry__6}

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

{#resource-inv-POST-resource__entry__10}{#resource-inv-POST-resource__type-descr-entry}{#resource-inv-POST-resource__name-entry}{#resource-inv-POST-resource__note-text-entry}{#resource-inv-POST-resource__place-entry}{#resource-inv-POST-resource__place-id-entry}{#resource-inv-POST-resource__related-party-parm}{#resource-inv-POST-resource__rel-party-id-parm}{#resource-inv-POST-resource__res-char-name-parm}{#resource-inv-POST-resource__res-char-value-parm}{#resource-inv-POST-resource__rel-type-parm}{#resource-inv-POST-resource__rel-resource-parm}{#resource-inv-POST-resource__rel-resource-id-parm}{#resource-inv-POST-resource__res-spec-id-parm}

| Name | Beschreibung |
|-|-|
| @type | Der Typ der Ressource. Gültige Werte: * `cmdb_ci_cable` (Kabel) * `cmdb_ci_interface_card` (Schnittstellenkarte) * `cmdb_ci_ip_address` (IP-Adresse) * `cmdb_ci_ni_logical_path` (logische Verbindung) * `cmdb_ci_ni_interface` (Netzwerkschnittstelle) * `cmdb_ci_ni_site` (Netzwerkstandort) * `cmdb_ci_ni_physical_link` (Physische Verbindung) * `cmdb_ci_Strand` (Strand) * `cmdb_ci_topology` (Topologie) * Name einer durch die sys_property sn_ni_core.equipment_tables angegebenen Tabelle oder Name einer Tabelle, die die angegebenen Tabellen erweitert. * Name einer Tabelle, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitert {#resource-inv-POST-resource__ul_wmt_vfz_d5b} Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung der Ressource. Datentyp: Zeichenfolge |
| name | Erforderlich. Name der Ressource Datentyp: Zeichenfolge |
| Hinweis | Liste der Notizen zur Ressource. Datentyp: Array "note": [ { "text": "String" } ] |
| Anmerkung.Text | Erforderlich, wenn der Parameter note verwendet wird. Der Hinweistext. Datentyp: Zeichenfolge |
| Ort | Erforderlich für Gerätehalter-Ressourcen, bei denen der Containertyp „Käfig", „Schacht", „Schrank", „Rack", „Aufstellung" oder „Bestandsmodell-Bundle" ist. Erforderlich für alle Ausrüstungsressourcen. Netzwerkstandort für die Ressource. Dieser Parameter wird für Ressourcen vom Typ „Netzwerkstandort", „Physische Verbindung" oder „Logische Verbindung" nicht unterstützt. Datentyp: Objekt "place": { "@referredType": "String", "href": "String", "id": "String" } |
| ort.@referredType | Der Typ des Orts. Dieser Wert ist immer `GeographicAddress`. Datentyp: Zeichenfolge |
| ort.href | Relativer Link zum Ortsdatensatz. Datentyp: Zeichenfolge |
| place.id | Erforderlich, wenn der Parameter place verwendet wird. Sys_id des Ortsdatensatzes in der Tabelle „Netzwerkstandort" \[cmdb_ci_ni_site\]. Datentyp: Zeichenfolge |
| Zugehörige Partei | Details zu Kontakten für die Ressource. Datentyp: Array "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] |
| zugehörigepartei.@referenztyp | Typ der zugehörigen Partei Zu finden in der Tabelle „Gruppe" \[sys_user_group\] im Feld Typ. Datentyp: Zeichenfolge |
| Zugehörigepartei.href | Relativer Link zum Datensatz der zugehörigen Partei. Datentyp: Zeichenfolge |
| relatedParty.id | Erforderlich, wenn der Parameter relatedParty verwendet wird. Sys_id des zugehörigen Parteidatensatzes in der Tabelle „Gruppe" \[sys_user_group\] Datentyp: Zeichenfolge |
| Ressourcenmerkmal | Liste der Merkmale der Ressource. Die folgenden Ressourcentypen erfordern bestimmte Ressourceneigenschaften. * Für physische und logische Verbindungsressourcen ist ein `Port A-` oder `Port Z-` Merkmal erforderlich. Wenn der Lebenszyklusphasenstatus der Ressource „In Gebrauch" lautet, sind `Port A` und `Port Z` erforderlich. * Für Gerätehalter-Ressourcen ist ein `Containertyp-` Merkmal erforderlich. {#resource-inv-POST-resource__ul_wsv_p2m_g5b} Datentyp: Array "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] |
| resourceCharacteristic.name | Erforderlich, wenn der Parameter resourceCharacteristic verwendet wird. Feldname aus der Ressourcentabelle, die durch den Parameter @type angegeben wird. Sie können die Felder „model_id", „name", „network_site", „operation_notes", „operational_status", „short_description" und „start_date" sowie keine Felder mit dem Präfix „sys_" wie „sys_id" verwenden. Datentyp: Zeichenfolge |
| Ressourcenmerkmal.Wert | Erforderlich, wenn der Parameter resourceCharacteristic verwendet wird. Der Wert des Merkmals. Datentyp: Zeichenfolge |
| Ressourcenmerkmal.Werttyp | Der Typ des Werts. Gültige Werte: * boolean * datetime * Float * integer * ph_number * Referenz * Zeichenfolge {#resource-inv-POST-resource__ul_bk1_rw2_g5b} Datentyp: Zeichenfolge |
| resourceRelationship | Liste der zugehörigen Ressourcen. Die folgenden Ressourcentypen erfordern bestimmte zugehörige Ressourcen. * Für Schnittstellenkarten-Ressourcen ist eine Beziehung zu einer Gerätehalter-Ressource erforderlich, bei der der Containertyp „Slot" oder „Sub-Slot" ist. * Für Netzwerkschnittstellen-Ressourcen ist eine Beziehung zu einer Anlagen- oder Schnittstellenkarten-Ressource erforderlich. * Für Gerätehalter-Ressourcen, bei denen der Containertyp „Slot" oder „Sub-Slot" ist, ist eine Beziehung zu einer Geräte- oder Schnittstellenkarten-Ressource erforderlich. {#resource-inv-POST-resource__ul_rlv_3dm_g5b} Datentyp: Array "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] |
| resourceRelationship.relationshipType | Erforderlich, wenn der Parameter resourceRelationship verwendet wird. Typ der Beziehung zwischen den beiden Ressourcen im Format `[dieser Ressourcendeskriptor]::[zugehöriger Ressourcendeskriptor]`. Beispiel: `Contains::Contained by` gibt an, dass die zugehörige Ressource das untergeordnete Element dieser Ressource ist. Gültige Werte für die Deskriptoren finden Sie in der Tabelle „CI-Beziehungstyp" \[cmdb_rel_type\] in den Spalten Übergeordneter Deskriptor und Untergeordneter Deskriptor. Datentyp: Zeichenfolge |
| resourceBeziehung.Ressource | Erforderlich, wenn der Parameter resourceRelationship verwendet wird. Details zur zugehörigen Ressource. Die zugehörige Ressource muss einer der folgenden Ressourcentypen sein. * Kabel * Gerät * Gerätehalter * Schnittstellenkarte * Logische Verbindung * Netzwerkschnittstelle * Netzwerkstandort * Physische Verbindung * Strand * Topologie {#resource-inv-POST-resource__ul_wmt_vtx_d5y} Datentyp: Objekt "resource": { "id": "String", "href": "String" } |
| resourceRelationship.resource.id | Erforderlich, wenn der Parameter resourceRelationship verwendet wird. Sys_id der zugehörigen Ressource. Befindet sich je nach Typ der zugehörigen Ressource in einer der folgenden Tabellen. * Schnittstellenkarte \[cmdb_ci_interface_card\] * Logische Verbindung \[cmdb_ci_ni_logical_path\] * Netzwerkschnittstelle \[cmdb_ci_ni_interface\] * Netzwerkstandort \[cmdb_ci_ni_site\] * Physische Verbindung \[cmdb_ci_ni_physical_link\] * Tabellen, die durch die sys_property sn_ni_core.equipment_tables angegeben werden, sowie alle Tabellen, die die angegebenen Tabellen erweitern. * Tabellen, die den Gerätehalter erweitern \[cmdb_ci_equipment_holder\] {#resource-inv-POST-resource__ul_vr1_4gf_g5b} Datentyp: Zeichenfolge |
| resourceRelationship.resource.href | Relativer Link zum zugehörigen Ressourcendatensatz. Datentyp: Zeichenfolge |
| resourceSpecification | Ressourcenspezifikation Datentyp: Objekt "resourceSpecification": { "id": "String" } |
| resourceSpecification.id | Erforderlich, wenn der Parameter resourceSpecification verwendet wird. Sys_id des zugeordneten Modells für die Ressource. Befindet sich je nach Modelltyp in einer der folgenden Tabellen. * Kabelmodelle \[sn_ent_cable_model\] * Gerätehaltermodelle \[sn_ent_nw_holder_model\] * Anlagenmodelle \[sn_ent_nw_equipment_model\] * Schnittstellenkartenmodelle \[sn_ent_nw_interface_model\] * Logische Verbindungsmodelle \[sn_ent_logical_nw_connection_model\] * Netzwerkschnittstellenmodelle \[sn_ent_nw_interface_model\] * Physische Verbindungsmodelle \[sn_ent_physical_nw_connection_model\] * Litzenmodelle \[sn_ent_Strand_model\] * Topologiemodelle \[sn_ent_network_topology_model\] {#resource-inv-POST-resource__ul_a3t_1lz_d5b} Datentyp: Zeichenfolge |
| startOperatingDate | Datum und Uhrzeit der ersten Inbetriebnahme der Ressource. Datentyp: Zeichenfolge |
[Tabelle : 21. Parameter des Anforderungstexts (JSON)]

### Header

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. 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/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#resource-inv-POST-resource__entry__62}{#resource-inv-POST-resource__accept-JSON-only-entry-RESTAPI}{#resource-inv-POST-resource__content_type-JSON-only-entry-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
[Tabelle : 22. Anforderungskopfzeilen]

{#resource-inv-POST-resource__entry__68}

| Kopfzeile | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur application/json. |
| Standort | URL der erstellten Ressource. |
[Tabelle : 23. Antwortkopfzeilen]

### 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 [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#resource-inv-POST-resource__table_b4x_lrs_g5b__entry__2}{#resource-inv-POST-resource__entry-400-status-code}{#resource-inv-POST-resource__entry-401-status-code}

| Statuscode | Beschreibung |
|-|-|
| 215 | Anforderung zur Verarbeitung erfolgreich erhalten. Die Anforderung wird asynchron abgeschlossen. |
| 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
[Tabelle : 24. Statuscodes]

{#resource-inv-POST-resource__table_b4x_lrs_g5b}

### Parameter des Antwort-Haupttexts (JSON) {#resource-inv-POST-resource__section_nkb_1rw_f5b}

{#resource-inv-POST-resource__table_okb_1rw_f5b__entry__2}{#resource-inv-POST-resource__d3249e144}{#resource-inv-POST-resource__d3249e407}

| Name | Beschreibung |
|-|-|
| @type | Der Typ der Ressource. Gültige Werte: * `cmdb_ci_cable` (Kabel) * `cmdb_ci_interface_card` (Schnittstellenkarte) * `cmdb_ci_ip_address` (IP-Adresse) * `cmdb_ci_ni_logical_path` (logische Verbindung) * `cmdb_ci_ni_interface` (Netzwerkschnittstelle) * `cmdb_ci_ni_site` (Netzwerkstandort) * `cmdb_ci_ni_physical_link` (Physische Verbindung) * `cmdb_ci_Strand` (Strand) * `cmdb_ci_topology` (Topologie) * Name einer durch die sys_property sn_ni_core.equipment_tables angegebenen Tabelle oder Name einer Tabelle, die die angegebenen Tabellen erweitert. * Name einer Tabelle, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitert {#resource-inv-POST-resource__d3249e148} Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung der Ressource. Datentyp: Zeichenfolge |
| href | Relativer Link zum Ressourcendatensatz. Datentyp: Zeichenfolge |
| id | Sys_id der Ressource. Befindet sich je nach Ressourcentyp in einer der folgenden Tabellen. * Kabel \[cmdb_ci_cable\] * Gerätehalter \[cmdb_ci_equipment_holder\] * Schnittstellenkarte \[cmdb_ci_interface_card\] * IP-Adresse \[cmdb_ci_ip_address\] * Logische Verbindung \[cmdb_ci_ni_logical_path\] * Netzwerkschnittstelle \[cmdb_ci_ni_interface\] * Netzwerkstandort \[cmdb_ci_ni_site\] * Physische Verbindung \[cmdb_ci_ni_physical_link\] * Litze \[cmdb_ci_Strand\] * Topologie \[cmdb_ci_topology\] * Tabellen, die durch die sys_property sn_ni_core.equipment_tables angegeben werden, sowie alle Tabellen, die die angegebenen Tabellen erweitern. * Tabellen, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitern. * Untergeordnete Tabellen, die eine der folgenden Tabellen erweitern: * Kabel \[cmdb_ci_cable\] * Gerätehalter \[cmdb_ci_equipment_holder\] * Litze \[cmdb_ci_Strand\] {#resource-inv-POST-resource__ul_umw_gvn_bcc} {#resource-inv-POST-resource__res-inv-tables} Datentyp: Zeichenfolge |
| name | Name der Ressource Datentyp: Zeichenfolge |
| Hinweis | Liste der Notizen zur Ressource. Datentyp: Array "note": [ { "text": "String" } ] |
| Anmerkung.Text | Der Hinweistext. Datentyp: Zeichenfolge |
| Ort | Netzwerkstandort für die Ressource. Dieser Parameter wird für Ressourcen vom Typ „Netzwerkstandort", „Physische Verbindung" oder „Logische Verbindung" nicht unterstützt. Datentyp: Objekt "place": { "@referredType": "String", "href": "String", "id": "String" } |
| ort.@referredType | Der Typ des Orts. Dieser Wert ist immer `GeographicAddress`. Datentyp: Zeichenfolge |
| ort.href | Relativer Link zum Ortsdatensatz. Datentyp: Zeichenfolge |
| place.id | Sys_id des Ortsdatensatzes in der Tabelle „Netzwerkstandort" \[cmdb_ci_ni_site\]. Datentyp: Zeichenfolge |
| Zugehörige Partei | Details zu Kontakten für die Ressource. Datentyp: Array "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] |
| zugehörigepartei.@referenztyp | Typ der zugehörigen Partei Zu finden in der Tabelle „Gruppe" \[sys_user_group\] im Feld Typ. Datentyp: Zeichenfolge |
| Zugehörigepartei.href | Relativer Link zum Datensatz der zugehörigen Partei. Datentyp: Zeichenfolge |
| relatedParty.id | Sys_id des zugehörigen Parteidatensatzes in der Tabelle „Gruppe" \[sys_user_group\] Datentyp: Zeichenfolge |
| Ressourcenmerkmal | Liste der Merkmale der Ressource. Die folgenden Ressourcentypen erfordern bestimmte Ressourceneigenschaften. * Für physische und logische Verbindungsressourcen ist ein `Port A-` oder `Port Z-` Merkmal erforderlich. Wenn der Lebenszyklusphasenstatus der Ressource „In Gebrauch" lautet, sind `Port A` und `Port Z` erforderlich. * Für Gerätehalter-Ressourcen ist ein `Containertyp-` Merkmal erforderlich. {#resource-inv-POST-resource__d3249e482} Datentyp: Array "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] |
| resourceCharacteristic.name | Feldname aus der Ressourcentabelle, die durch den Parameter @type angegeben wird. Sie können die Felder „model_id", „name", „network_site", „operation_notes", „operational_status", „short_description" und „start_date" sowie keine Felder mit dem Präfix „sys_" wie „sys_id" verwenden. Datentyp: Zeichenfolge |
| Ressourcenmerkmal.Wert | Der Wert des Merkmals. Datentyp: Zeichenfolge |
| Ressourcenmerkmal.Werttyp | Der Typ des Werts. Gültige Werte: * boolean * datetime * Float * integer * ph_number * Referenz * Zeichenfolge {#resource-inv-POST-resource__d3249e558} Datentyp: Zeichenfolge |
| resourceRelationship | Liste der zugehörigen Ressourcen. Die folgenden Ressourcentypen erfordern bestimmte zugehörige Ressourcen. * Für Schnittstellenkarten-Ressourcen ist eine Beziehung zu einer Gerätehalter-Ressource erforderlich, bei der der Containertyp „Slot" oder „Sub-Slot" ist. * Für Netzwerkschnittstellen-Ressourcen ist eine Beziehung zu einer Anlagen- oder Schnittstellenkarten-Ressource erforderlich. * Für Gerätehalter-Ressourcen, bei denen der Containertyp „Slot" oder „Sub-Slot" ist, ist eine Beziehung zu einer Geräte- oder Schnittstellenkarten-Ressource erforderlich. {#resource-inv-POST-resource__d3249e593} Datentyp: Array "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] |
| resourceRelationship.relationshipType | Typ der Beziehung zwischen den beiden Ressourcen im Format `[dieser Ressourcendeskriptor]::[zugehöriger Ressourcendeskriptor]`. Beispiel: `Contains::Contained by` gibt an, dass die zugehörige Ressource das untergeordnete Element dieser Ressource ist. Gültige Werte für die Deskriptoren finden Sie in der Tabelle „CI-Beziehungstyp" \[cmdb_rel_type\] in den Spalten Übergeordneter Deskriptor und Untergeordneter Deskriptor. Datentyp: Zeichenfolge |
| resourceBeziehung.Ressource | Details zur zugehörigen Ressource. Die zugehörige Ressource muss einer der folgenden Ressourcentypen sein. * Kabel * Gerät * Gerätehalter * Schnittstellenkarte * Logische Verbindung * Netzwerkschnittstelle * Netzwerkstandort * Physische Verbindung * Strand * Topologie {#resource-inv-POST-resource__d3249e653} Datentyp: Objekt "resource": { "id": "String", "href": "String" } |
| resourceRelationship.resource.id | Sys_id der zugehörigen Ressource. Befindet sich je nach Typ der zugehörigen Ressource in einer der folgenden Tabellen. * Schnittstellenkarte \[cmdb_ci_interface_card\] * Logische Verbindung \[cmdb_ci_ni_logical_path\] * Netzwerkschnittstelle \[cmdb_ci_ni_interface\] * Netzwerkstandort \[cmdb_ci_ni_site\] * Physische Verbindung \[cmdb_ci_ni_physical_link\] * Tabellen, die durch die sys_property sn_ni_core.equipment_tables angegeben werden, sowie alle Tabellen, die die angegebenen Tabellen erweitern. * Tabellen, die den Gerätehalter erweitern \[cmdb_ci_equipment_holder\] {#resource-inv-POST-resource__d3249e706} Datentyp: Zeichenfolge |
| resourceRelationship.resource.href | Relativer Link zum zugehörigen Ressourcendatensatz. Datentyp: Zeichenfolge |
| resourceSpecification | Ressourcenspezifikation Datentyp: Objekt "resourceSpecification": { "id": "String" } |
| resourceSpecification.id | Sys_id des zugeordneten Modells für die Ressource. Befindet sich je nach Modelltyp in einer der folgenden Tabellen. * Kabelmodelle \[sn_ent_cable_model\] * Gerätehaltermodelle \[sn_ent_nw_holder_model\] * Anlagenmodelle \[sn_ent_nw_equipment_model\] * Schnittstellenkartenmodelle \[sn_ent_nw_interface_model\] * Logische Verbindungsmodelle \[sn_ent_logical_nw_connection_model\] * Netzwerkschnittstellenmodelle \[sn_ent_nw_interface_model\] * Physische Verbindungsmodelle \[sn_ent_physical_nw_connection_model\] * Litzenmodelle \[sn_ent_Strand_model\] * Topologiemodelle \[sn_ent_network_topology_model\] {#resource-inv-POST-resource__d3249e774} Datentyp: Zeichenfolge |
| startOperatingDate | Datum und Uhrzeit der ersten Inbetriebnahme der Ressource. Datentyp: Zeichenfolge |
[ ]

{#resource-inv-POST-resource__table_okb_1rw_f5b}  

### cURL-Anforderung

In diesem Beispiel wird ein Netzwerkstandort in Denver, CO, USA erstellt.

    curl "https://instance.service-now.com/api/sn_ni_core/resource" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"name\": \"DENVER CO CO/HUB\",
      \"note\": [
        {
          \"text\": \"Cisco maintenance team onsite June 22, 2022.\"
        }
      ],
      \"resourceCharacteristic\": [
        {
          \"name\": \"attested\",
          \"valueType\": \"boolean\",
          \"value\": \"false\"
        },
        {
          \"name\": \"can_print\",
          \"valueType\": \"boolean\",
          \"value\": \"false\"
        },
        {
          \"name\": \"clli_code\",
          \"valueType\": \"string\",
          \"value\": \"DNVRCOMR02T\"
        },
        {
          \"name\": \"comments\",
          \"valueType\": \"string\",
          \"value\": \"Site is scheduled for diesel generator test July 13, 2022 at 9am CST.\"
        },
        {
          \"name\": \"cost_cc\",
          \"valueType\": \"string\",
          \"value\": \"USD\"
        },
        {
          \"name\": \"county\",
          \"valueType\": \"string\",
          \"value\": \"DENVER\"
        },
        {
          \"name\": \"data_center_code\",
          \"valueType\": \"string\",
          \"value\": \"DNVR00564\"
        },
        {
          \"name\": \"fault_count\",
          \"valueType\": \"integer\",
          \"value\": \"0\"
        },
        {
          \"name\": \"install_status\",
          \"valueType\": \"integer\",
          \"value\": \"1\"
        },
        {
          \"name\": \"life_cycle_stage\",
          \"valueType\": \"reference\",
          \"value\": \"Operational\"
        },
        {
          \"name\": \"life_cycle_stage_status\",
          \"valueType\": \"reference\",
          \"value\": \"In Use\"
        },
        {
          \"name\": \"location\",
          \"valueType\": \"reference\",
          \"value\": \"25ab8f300a0a0bb300d99f69c3ac24cd\"
        },
        {
          \"name\": \"managed_by\",
          \"valueType\": \"reference\",
          \"value\": \"b0f31e5673500010c2e7660c4cf6a711\"
        },
        {
          \"name\": \"monitor\",
          \"valueType\": \"boolean\",
          \"value\": \"false\"
        },
        {
          \"name\": \"network_domain\",
          \"valueType\": \"string\",
          \"value\": \"core\"
        },
        {
          \"name\": \"ni_type\",
          \"valueType\": \"reference\",
          \"value\": \"8e8f3770404d0110f8772175cacd7204\"
        },
        {
          \"name\": \"pots_number\",
          \"valueType\": \"ph_number\",
          \"value\": \"(214) 555-1234\"
        },
        {
          \"name\": \"skip_sync\",
          \"valueType\": \"boolean\",
          \"value\": \"false\"
        },
        {
          \"name\": \"third_party_ownership\",
          \"valueType\": \"boolean\",
          \"value\": \"false\"
        },
        {
          \"name\": \"unverified\",
          \"valueType\": \"boolean\",
          \"value\": \"false\"
        }
      ],
      \"resourceRelationship\": [
        {
          \"relationshipType\": \"Connects to::Connected by\",
          \"resource\": {
            \"id\": \"e6f6df8d4051c910f8772175cacd72b2\",
            \"href\": \"/api/sn_ni_core/resource/e6f6df8d4051c910f8772175cacd72b2\"
          }
        },
        {
          \"relationshipType\": \"Connects to::Connected by\",
          \"resource\": {
            \"id\": \"0ac19bc54051c910f8772175cacd724b\",
            \"href\": \"/api/sn_ni_core/resource/0ac19bc54051c910f8772175cacd724b\"
          }
        },
        {
          \"relationshipType\": \"Connects to::Connected by\",
          \"resource\": {
            \"id\": \"997e5c11875851109a9c0f65dabb35ac\",
            \"href\": \"/api/sn_ni_core/resource/997e5c11875851109a9c0f65dabb35ac\"
          }
        },
        {
          \"relationshipType\": \"Contains::Contained by\",
          \"resource\": {
            \"id\": \"5b10e8154015c910f8772175cacd724d\",
            \"href\": \"/api/sn_ni_core/resource/5b10e8154015c910f8772175cacd724d\"
          }
        },
        {
          \"relationshipType\": \"Contains::Contained by\",
          \"resource\": {
            \"id\": \"57e73b51405dc910f8772175cacd726e\",
            \"href\": \"/api/sn_ni_core/resource/57e73b51405dc910f8772175cacd726e\"
          }
        },
        {
          \"relationshipType\": \"Contains::Contained by\",
          \"resource\": {
            \"id\": \"bf58f751405dc910f8772175cacd72e8\",
            \"href\": \"/api/sn_ni_core/resource/bf58f751405dc910f8772175cacd72e8\"
          }
        },
        {
          \"relationshipType\": \"Contains::Contained by\",
          \"resource\": {
            \"id\": \"b5711e31405d0d10f8772175cacd7232\",
            \"href\": \"/api/sn_ni_core/resource/b5711e31405d0d10f8772175cacd7232\"
          }
        },
        {
          \"relationshipType\": \"Contains::Contained by\",
          \"resource\": {
            \"id\": \"ed811e31405d0d10f8772175cacd72d3\",
            \"href\": \"/api/sn_ni_core/resource/ed811e31405d0d10f8772175cacd72d3\"
          }
        },
        {
          \"relationshipType\": \"Contains::Contained by\",
          \"resource\": {
            \"id\": \"d74937d1405dc910f8772175cacd7288\",
            \"href\": \"/api/sn_ni_core/resource/d74937d1405dc910f8772175cacd7288\"
          }
        },
        {
          \"relationshipType\": \"Contains::Contained by\",
          \"resource\": {
            \"id\": \"da0df2e3e4e64510f877e70ec9bcacc6\",
            \"href\": \"/api/sn_ni_core/resource/da0df2e3e4e64510f877e70ec9bcacc6\"
          }
        }
      ],
      \"@type\": \"cmdb_ci_ni_site\"
    }" \
    --user 'username':'password'

Antworttext.

    {
       "href": "/api/sn_ni_core/resource/00399f0aed349150f877305f29f832b2",
       "id": "00399f0aed349150f877305f29f832b2",
       "name": "DENVER CO CO/HUB",
       "note": [
          {
             "text": "Cisco maintenance team onsite June 22, 2022."
          }
       ],
       "resourceCharacteristic": [
          {
             "name": "altitude_units",
             "valueType": "string",
             "value": "feet"
          },
          {
             "name": "attestation_status",
             "valueType": "string",
             "value": "Not Yet Reviewed"
          },
          {
             "name": "attested",
             "valueType": "boolean",
             "value": "false"
          },
          {
             "name": "can_print",
             "valueType": "boolean",
             "value": "false"
          },
          {
             "name": "clli_code",
             "valueType": "string",
             "value": "DNVRCOMR02T"
          },
          {
             "name": "comments",
             "valueType": "string",
             "value": "Site is scheduled for diesel generator test July 13, 2022 at 9am CST."
          },
          {
             "name": "cost_cc",
             "valueType": "string",
             "value": "USD"
          },
          {
             "name": "county",
             "valueType": "string",
             "value": "DENVER"
          },
          {
             "name": "data_center_code",
             "valueType": "string",
             "value": "DNVR00564"
          },
          {
             "name": "discovery_source",
             "valueType": "string",
             "value": "Resource Inventory Open API"
          },
          {
             "name": "fault_count",
             "valueType": "integer",
             "value": "0"
          },
          {
             "name": "first_discovered",
             "valueType": "datetime",
             "value": "2022-07-21T19:38:04.000Z"
          },
          {
             "name": "install_status",
             "valueType": "integer",
             "value": "1"
          },
          {
             "name": "last_discovered",
             "valueType": "datetime",
             "value": "2022-07-21T19:38:04.000Z"
          },
          {
             "name": "life_cycle_stage",
             "valueType": "reference",
             "value": "Operational"
          },
          {
             "name": "life_cycle_stage_status",
             "valueType": "reference",
             "value": "In Use"
          },
          {
             "name": "location",
             "valueType": "reference",
             "value": "25ab8f300a0a0bb300d99f69c3ac24cd"
          },
          {
             "name": "managed_by",
             "valueType": "reference",
             "value": "b0f31e5673500010c2e7660c4cf6a711"
          },
          {
             "name": "monitor",
             "valueType": "boolean",
             "value": "false"
          },
          {
             "name": "network_domain",
             "valueType": "string",
             "value": "core"
          },
          {
             "name": "ni_type",
             "valueType": "reference",
             "value": "8e8f3770404d0110f8772175cacd7204"
          },
          {
             "name": "pots_number",
             "valueType": "ph_number",
             "value": "(214) 555-1234"
          },
          {
             "name": "skip_sync",
             "valueType": "boolean",
             "value": "false"
          },
          {
             "name": "third_party_ownership",
             "valueType": "boolean",
             "value": "false"
          },
          {
             "name": "unverified",
             "valueType": "boolean",
             "value": "false"
          }
       ],
       "resourceRelationship": [
          {
             "relationshipType": "Connects to::Connected by",
             "resource": {
                "id": "e6f6df8d4051c910f8772175cacd72b2",
                "href": "/api/sn_ni_core/resource/e6f6df8d4051c910f8772175cacd72b2"
             }
          },
          {
             "relationshipType": "Connects to::Connected by",
             "resource": {
                "id": "0ac19bc54051c910f8772175cacd724b",
                "href": "/api/sn_ni_core/resource/0ac19bc54051c910f8772175cacd724b"
             }
          },
          {
             "relationshipType": "Connects to::Connected by",
             "resource": {
                "id": "997e5c11875851109a9c0f65dabb35ac",
                "href": "/api/sn_ni_core/resource/997e5c11875851109a9c0f65dabb35ac"
             }
          },
          {
             "relationshipType": "Contains::Contained by",
             "resource": {
                "id": "5b10e8154015c910f8772175cacd724d",
                "href": "/api/sn_ni_core/resource/5b10e8154015c910f8772175cacd724d"
             }
          },
          {
             "relationshipType": "Contains::Contained by",
             "resource": {
                "id": "57e73b51405dc910f8772175cacd726e",
                "href": "/api/sn_ni_core/resource/57e73b51405dc910f8772175cacd726e"
             }
          },
          {
             "relationshipType": "Contains::Contained by",
             "resource": {
                "id": "bf58f751405dc910f8772175cacd72e8",
                "href": "/api/sn_ni_core/resource/bf58f751405dc910f8772175cacd72e8"
             }
          },
          {
             "relationshipType": "Contains::Contained by",
             "resource": {
                "id": "b5711e31405d0d10f8772175cacd7232",
                "href": "/api/sn_ni_core/resource/b5711e31405d0d10f8772175cacd7232"
             }
          },
          {
             "relationshipType": "Contains::Contained by",
             "resource": {
                "id": "ed811e31405d0d10f8772175cacd72d3",
                "href": "/api/sn_ni_core/resource/ed811e31405d0d10f8772175cacd72d3"
             }
          },
          {
             "relationshipType": "Contains::Contained by",
             "resource": {
                "id": "d74937d1405dc910f8772175cacd7288",
                "href": "/api/sn_ni_core/resource/d74937d1405dc910f8772175cacd7288"
             }
          },
          {
             "relationshipType": "Contains::Contained by",
             "resource": {
                "id": "da0df2e3e4e64510f877e70ec9bcacc6",
                "href": "/api/sn_ni_core/resource/da0df2e3e4e64510f877e70ec9bcacc6"
             }
          }
       ],
       "@type": "cmdb_ci_ni_site"
    }

## Offene API des Ressourcenbestands -- POST /sn_ni_core/resourceinventoryviatemplate {#ariaid-title6}

Erstellt ein Ressourcenkonfigurationselement (Configuration Item, CI) und die zugehörige CI-Hierarchie basierend auf einer Vorlage.
Bevor Sie diesen Endpunkt aufrufen, müssen Sie in der Tabelle „Bestandsvorlage" \[sn_ni_core_inventory_template\] eine Bestandsvorlage erstellen. Sie können die gesamte Hierarchie zugehöriger CIs in einer Bestandsvorlage definieren. Sie können dann alle CIs und Beziehungen über eine einzige API-Anforderung erstellen.

### URL-Format

Standard-URL: /api/sn_ni_core/resourceinventoryviatemplate

### Unterstützte Anforderungsparameter

{#resource-inv-POST-template__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 25. Pfadparameter]

{#resource-inv-POST-template__entry__6}

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

{#resource-inv-POST-template__entry__10}

| Name | Beschreibung |
|-|-|
| overrides | Liste der zu überschreibenden Spalten und der zu verwendenden Werte. Datentyp: Objekt "overrides": { "column_name": "String" } |
| Überschreibungen.Spalte_Name | Erforderlich, wenn der Parameter overrides verwendet wird. Name und Wert der Spalte Datentyp: Zeichenfolge |
| parentId | Erforderlich. Sys_id des übergeordneten CI. Befindet sich je nach Typ des übergeordneten CI in einer der folgenden Tabellen. * Kabel \[cmdb_ci_cable\] * Gerätehalter \[cmdb_ci_equipment_holder\] * Schnittstellenkarte \[cmdb_ci_interface_card\] * IP-Adresse \[cmdb_ci_ip_address\] * Logische Verbindung \[cmdb_ci_ni_logical_path\] * Netzwerkschnittstelle \[cmdb_ci_ni_interface\] * Netzwerkstandort \[cmdb_ci_ni_site\] * Physische Verbindung \[cmdb_ci_ni_physical_link\] * Litze \[cmdb_ci_Strand\] * Topologie \[cmdb_ci_topology\] * Tabellen, die durch die sys_property sn_ni_core.equipment_tables angegeben werden, sowie alle Tabellen, die die angegebenen Tabellen erweitern. * Tabellen, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitern. * Untergeordnete Tabellen, die eine der folgenden Tabellen erweitern: * Kabel \[cmdb_ci_cable\] * Gerätehalter \[cmdb_ci_equipment_holder\] * Litze \[cmdb_ci_Strand\] {#resource-inv-POST-template__ul_umw_gvn_bcc} {#resource-inv-POST-template__ul_ihw_mmd_wxb} Datentyp: Zeichenfolge |
| templateId | Erforderlich. Sys_id der Vorlage. Befindet sich in der Tabelle „Bestandsvorlage" \[sn_ni_core_inventory_template\]. Datentyp: Zeichenfolge |
| templateOverrides | Liste der Vorlagenüberschreibungen. Datentyp: Array "templateOverrides": [ { "overrideTemplateId": "String", "templateId": "String" } ] |
| templateOverrides.overrideTemplateId | Erforderlich, wenn der Parameter templateOverrides verwendet wird. sys_id der verfügbaren Vorlage. Datentyp: Zeichenfolge |
| templateOverrides.templateId | Erforderlich, wenn der Parameter templateOverrides verwendet wird. sys_id der zugehörigen Vorlage. Datentyp: Zeichenfolge |
[Tabelle : 27. Parameter des Anforderungstexts (JSON)]

### Header

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. 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/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#resource-inv-POST-template__table_ss4_qtt_g5b__entry__2}{#resource-inv-POST-template__accept-JSON-only-entry-RESTAPI}{#resource-inv-POST-template__content_type-JSON-only-entry-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
[Tabelle : 28. Anforderungskopfzeilen]

{#resource-inv-POST-template__table_ss4_qtt_g5b} {#resource-inv-POST-template__table_b21_rtt_g5b__entry__2}

| Kopfzeile | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur application/json. |
| Standort | URL des erstellten CI an oberster Stelle in der Hierarchie. |
[Tabelle : 29. Antwortkopfzeilen]

{#resource-inv-POST-template__table_b21_rtt_g5b}

### 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 [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#resource-inv-POST-template__table_b4x_lrs_g5b__entry__2}{#resource-inv-POST-template__entry-400-status-code}{#resource-inv-POST-template__entry-401-status-code}

| Statuscode | Beschreibung |
|-|-|
| 201 | Ressource erstellt. |
| 400 | Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Fehler. Bei der Anforderung ist ein Fehler aufgetreten. Beispiel: Die Anforderung hat Validierungsprüfungen nicht bestanden. |
[Tabelle : 30. Statuscodes]

{#resource-inv-POST-template__table_b4x_lrs_g5b}

### Parameter des Antwort-Haupttexts (JSON)

{#resource-inv-POST-template__entry__48}

| Name | Beschreibung |
|-|-|
| Ergebnis | Ergebnisobjekt mit Informationen zu den erstellten CIs. Datentyp: Objekt "result": { "sys_id": "String" } |
| result.sys_id | Sys_id des erstellten CI an oberster Stelle in der Hierarchie. Datentyp: Zeichenfolge |
[ ]

### cURL-Anforderung

In diesem Beispiel wird mithilfe einer Vorlage eine CI-Hierarchie erstellt.

    curl "https://instance.service-now.com/api/sn_ni_core/resourceinventoryviatemplate" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       "templateId": "90475711ed6ec110f877d2f57b8accda",
       "parentId": "917dd8f6870e851079c40f2d0ebb353d",
       "overrides": {
          "equipment_clli": "test"
       },
       "templateOverrides": [
          {
             "templateId": "ac3b679ded6ec110f877d2f57b8acc29",
             "overrideTemplateId": "f9604efb54e18110f87749bbc4ad38d8"
          },
          {
             "templateId": "171c23dded6ec110f877d2f57b8acc33",
             "overrideTemplateId": "0f38e59187424110e14f64e73cbb35b4"
          }
       ]
    }" \
    --user 'username':'password'

Antworttext.

    "result": {
       "sys_id": "00598f0aed346259f388105f29f892c4"
    }