---
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


---

# Offene API für Ressourcenbestand

# Offene API für Ressourcenbestand {#ariaid-title1}

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

Die Ressourcenbestand Offen Die API stellt Endpunkte zum Erstellen, Abrufen und Löschen von Ressourcen bereit.
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_Litze\]
* Topologie \[cmdb_ci_Topology\]
* Tabellen, die von angegeben werden sn_ni_core.equipment_tablessys_property und 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_Litze\]
  {#resource-inventory-api__ul_umw_gvn_bcc}
{#resource-inventory-api__ul_utd_jmd_wxb}

Diese API ist in der Anwendung „Netzwerkbestand-Kern" enthalten, die auf verfügbar ist ServiceNow Store.

Diese API wird in bereitgestellt `sn_ni_Core `Namespace.

Der aufrufende Anwender muss über die Rolle „sn_ni_core.inventory_integrator" verfügen.

Diese API kann erweitert werden, um Anpassungen an erforderlichen Parametern, die Validierung des Anforderungstexts und Feldzuordnungen vorzunehmen. Weitere Informationen finden Sie im Abschnitt .

Die Ressourcenbestand Offen API ist ein ServiceNow®Implementierung der REST-Spezifikation der API für den Ressourcenbestand des TM-Forums. Diese Implementierung basiert auf [TMF639 API-Anwenderhandbuch für Ressourcenbestand v4.0.1](https://www.tmforum.org/resources/standard/tmf639-resource-inventory-api-user-guide-v4-0/), Juli 2020.

## Ressourcenbestand -- API öffnen -- /sn_ni_Core/resource/{ID} LÖSCHEN {#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 von angegeben werden sn_ni_core.equipment_tablessys_property und 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 Tabelle „IP-Adresse" \[cmdb_ci_ip_address\] können mit dieser API nicht gelöscht werden. Datentyp: Zeichenfolge |
[Tabelle : 1. Pfad-Parameter]

{#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. Anforderungstext-Parameter (JSON)]

{#resource-inv-DELETE__table_fdn_t3t_g5b}

### 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.").
{#resource-inv-DELETE__table_e4k_vhs_g5b__entry__2}{#resource-inv-DELETE__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 4. Anforderungskopfzeilen.]

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

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 5. Antwort-Header]

{#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 [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.").
{#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 erfolgreich zur Verarbeitung empfangen. Die Anforderung wird asynchron abgeschlossen. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen 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}

### Antworttext-Parameter (JSON)

{#resource-inv-DELETE__entry__34}

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

### Curl-Anforderung

Dieses Beispiel löscht eine Ressource.

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

Antworttext.

    ""

## Ressourcenbestand -- offene API -- 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. Pfad-Parameter]

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

| Name | Beschreibung |
|-|-|
| @Typ | Erforderlich. Tabellenname des Typs der abzurufenden Ressource. Sie können pro API-Aufruf nur einen Typ von Ressource 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 `(Litze) * `cmdb_ci_Topology `(Topologie) * Name einer Tabelle, die von angegeben wird sn_ni_core.equipment_tablessys_property 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, die zum Filtern von Ressourcen verwendet werden soll. Nur Ressourcen mit der angegebenen Beschreibung werden in der Antwort 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 * note * Ort * ZugehörigPartei * ResourceMerkmal * ResourceRelationship * ResourceSpecification * StartOperatingDate {#resource-inv-GET-resource__ul_pzn_4gz_d5b} Datentyp: Zeichenfolge Standard: Gibt alle Felder zurück. |
| limit | Maximale Anzahl zurückzugebender Datensätze. Für Anforderungen, die diese Anzahl von Datensätzen überschreiten, verwenden Sie offsetParameter zum Paginieren des Datensatzabrufs. Standard: 20 Datentyp: Zahl |
| name | Name, der zum Filtern von Ressourcen verwendet werden soll. Nur Ressourcen mit dem angegebenen Namen werden in der Antwort zurückgegeben. Datentyp: Zeichenfolge |
| Offset | Startindex, bei dem mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktionalität ermöglicht den Abruf aller Datensätze, unabhängig von der Anzahl der Datensätze, in kleinen verwaltbaren Blöcken. 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}Nur Ressourcen mit einem Modell, das der angegebenen sys_ID entspricht, werden in der Antwort zurückgegeben. Datentyp: Zeichenfolge |
[Tabelle : 8. Abfrageparameter]

{#resource-inv-GET-resource__entry__22}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. Anforderungstext-Parameter (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.").
{#resource-inv-GET-resource__entry__26}{#resource-inv-GET-resource__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 10. Anforderungskopfzeilen.]

{#resource-inv-GET-resource__table_lpj_dh1_vxb__entry__2}

| Header | Beschreibung |
|-|-|
| Inhaltsbereich | Inhaltsbereich, der in einem paginierten Aufruf zurückgegeben wird. Beispiel: Wenn `Offset=2 `Und `Grenzwert = 3 `, Der Wert von Content-RangeHeader ist `Elemente 3-5 `. |
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Verknüpfen | 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 mehr als 100.000 beträgt, gibt dieser Header immer 100.000 zurück. |
[Tabelle : 11. Antwort-Header]

{#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 [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.").
{#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, der von einem paginierten Aufruf angegeben wurde. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
[Tabelle : 12. Statuscodes]

### Antworttext-Parameter (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 |
|-|-|
| @Typ | 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 `(Litze) * `cmdb_ci_Topology `(Topologie) * Name einer Tabelle, die von angegeben wird sn_ni_core.equipment_tablessys_property 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__d3090e148} 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_Litze\] * Topologie \[cmdb_ci_Topology\] * Tabellen, die von angegeben werden sn_ni_core.equipment_tablessys_property und 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_Litze\] {#resource-inv-GET-resource__ul_umw_gvn_bcc} {#resource-inv-GET-resource__res-inv-tables} Datentyp: Zeichenfolge |
| name | Name der Ressource. Datentyp: Zeichenfolge |
| note | Liste der Notizen zur Ressource. Datentyp: Array von Objekten "note": [ { "text": "String" } ] |
| Hinweis.Text | Der Hinweistext. Datentyp: Zeichenfolge |
| Ort | Netzwerkstandort für die Ressource. Dieser Parameter wird für Ressourcen „Netzwerkstandort", „physische Verbindung" oder „logische Verbindung" nicht unterstützt. Datentyp: Objekt "place": { "@referredType": "String", "href": "String", "id": "String" } |
| Place.@referredType | Typ des Orts. Dieser Wert ist immer `GeographieAddress `. Datentyp: Zeichenfolge |
| Place.href | Relativer Link zum Ortsdatensatz. Datentyp: Zeichenfolge |
| place.id | SYS_ID des Ortsdatensatzes. Datentyp: Zeichenfolge Tabelle: Netzwerkstandort \[cmdb_ci_ni_site\] |
| ZugehörigPartei | Details zu Kontakten für die Ressource. Datentyp: Array von Objekten "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] |
| RelatedParty.@referredType | Typ der zugehörigen Partei. Befindet sich in in in Typ Feld. Datentyp: Zeichenfolge Tabelle: Im Feld „Typ" der Tabelle „Gruppe" \[sys_user_Group\]. |
| RelatedParty.href | Relativer Link zum Datensatz der zugehörigen Partei. Datentyp: Zeichenfolge |
| relatedParty.id | SYS_ID des Datensatzes der zugehörigen Partei. Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
| RelatedParty.role | Rolle der zugehörigen Partei. Datentyp: Zeichenfolge Tabelle: Im Feld Gruppentyp der Tabelle Teams \[cmdb_rel_Team\]. |
| ResourceMerkmal | Liste der Merkmale der Ressource. Die folgenden Ressourcentypen erfordern bestimmte Ressourcenmerkmale. * Für Ressourcen für physische Verbindung und logische Verbindung: A `Port A `Oder `Port Z `Merkmal ist erforderlich. Wenn der Lebenszyklusphasenstatus der Ressource „in Gebrauch" lautet, beides `Port A `Und `Port Z `Sind erforderlich. * Für Gerätehalter-Ressourcen `Containertyp `Merkmal ist erforderlich. {#resource-inv-GET-resource__ul_wsv_p2m_g5b} Datentyp: Array von Objekten "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] |
| resourceCharacteristic.name | Feldname aus der von angegebenen Ressourcentabelle @typeParameter. Sie können die Felder „model_ID", „Name", „Network_Site", „Operation_Notes", „Operational_Status" nicht verwenden. Short_description, Start_date oder beliebige sys_-Präfixfelder wie sys_ID Datentyp: Zeichenfolge |
| Ressourcenmerkmal.Wert | Der Wert des Merkmals. Datentyp: Zeichenfolge |
| ResourceMerkmal.WertTyp | Typ des Werts. Gültige Werte: * boolean * datetime * Gleitkommazahl * Ganzzahl * 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 Schnittstellenkartenressourcen eine Beziehung zu einer Gerätehalterressource, bei der der Containertyp „Steckplatz" oder „Untersteckplatz" ist. * Für Netzwerkschnittstellenressourcen ist eine Beziehung zu einem Gerät oder einer Schnittstellenkartenressource erforderlich. * Für Gerätehalterressourcen, bei denen der Containertyp „Steckplatz" oder „Untersteckplatz" ist, ist eine Beziehung zu einer Geräte- oder Schnittstellenkartenressource erforderlich. {#resource-inv-GET-resource__ul_rlv_3dm_g5b} Datentyp: Array "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] |
| ResourceBeziehung.Beziehungstyp | Typ der Beziehung zwischen den beiden Ressourcen im Format `[Dieser Ressourcendeskriptor]::[zugehöriger Ressourcendeskriptor] `. Beispiel: `Enthält::enthalten von `Gibt an, dass die zugehörige Ressource das untergeordnete Element dieser Ressource ist. Gültige Werte für die Deskriptoren befinden sich in der CI-Beziehungstyp-Tabelle \[cmdb_rel_type\] in Übergeordneter Deskriptor Und Untergeordneter Deskriptor Spalten. Datentyp: Zeichenfolge |
| Ressourcenbeziehung.Ressource | Details zur zugehörigen Ressource. Die zugehörige Ressource muss einer der folgenden Ressourcentypen sein. * Kabel * Ausrüstung * Gerätehalter * Schnittstellenkarte * Logische Verbindung * Netzwerkschnittstelle * Netzwerkstandort * Physische Verbindung * Litze * 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 von angegeben werden sn_ni_core.equipment_tablessys_property und alle Tabellen, die die angegebenen Tabellen erweitern. * Tabellen, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitern {#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__d3090e773} Datentyp: Zeichenfolge |
| StartOperatingDate | Datum und Uhrzeit, zu der die Ressource erstmals in Betrieb genommen wurde. Datentyp: Zeichenfolge |
[ ]

{#resource-inv-GET-resource__table_okb_1rw_f5b}  

### Curl-Anforderung

Dieses Beispiel ruft ab name, id, Und hrefFelder für die ersten fünf Ressourcendatensätze des Netzwerkstandorts.

    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 für Ressourcenbestand -- GET /sn_ni_Core/resource/{ID} AB {#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_Litze\] * Topologie \[cmdb_ci_Topology\] * Tabellen, die von angegeben werden sn_ni_core.equipment_tablessys_property und 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_Litze\] {#resource-inv-GET-resource-id__ul_umw_gvn_bcc} {#resource-inv-GET-resource-id__res-inv-tables} Datentyp: Zeichenfolge |
[Tabelle : 13. Pfad-Parameter]

{#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 * note * Ort * ZugehörigPartei * ResourceMerkmal * ResourceRelationship * ResourceSpecification * StartOperatingDate {#resource-inv-GET-resource-id__ul_pzn_4gz_d5b} Datentyp: Zeichenfolge Standard: Gibt alle Felder zurück. |
[Tabelle : 14. Abfrageparameter]

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

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

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

### 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.").
{#resource-inv-GET-resource-id__table_e4k_vhs_g5b__entry__2}{#resource-inv-GET-resource-id__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt 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}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 17. Antwort-Header]

{#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 [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.").
{#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 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen 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}

### Antworttext-Parameter (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 |
|-|-|
| @Typ | 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 `(Litze) * `cmdb_ci_Topology `(Topologie) * Name einer Tabelle, die von angegeben wird sn_ni_core.equipment_tablessys_property 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_Litze\] * Topologie \[cmdb_ci_Topology\] * Tabellen, die von angegeben werden sn_ni_core.equipment_tablessys_property und 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_Litze\] {#resource-inv-GET-resource-id__d3090e283} {#resource-inv-GET-resource-id__d3090e238} Datentyp: Zeichenfolge |
| name | Name der Ressource. Datentyp: Zeichenfolge |
| note | Liste der Notizen zur Ressource. Datentyp: Array von Objekten "note": [ { "text": "String" } ] |
| Hinweis.Text | Der Hinweistext. Datentyp: Zeichenfolge |
| Ort | Netzwerkstandort für die Ressource. Dieser Parameter wird für Ressourcen „Netzwerkstandort", „physische Verbindung" oder „logische Verbindung" nicht unterstützt. Datentyp: Objekt "place": { "@referredType": "String", "href": "String", "id": "String" } |
| Place.@referredType | Typ des Orts. Dieser Wert ist immer `GeographieAddress `. Datentyp: Zeichenfolge |
| Place.href | Relativer Link zum Ortsdatensatz. Datentyp: Zeichenfolge |
| place.id | SYS_ID des Ortsdatensatzes. Datentyp: Zeichenfolge Tabelle: Netzwerkstandort \[cmdb_ci_ni_site\] |
| ZugehörigPartei | Details zu Kontakten für die Ressource. Datentyp: Array von Objekten "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] |
| RelatedParty.@referredType | Typ der zugehörigen Partei. Befindet sich in in in Typ Feld. Datentyp: Zeichenfolge Tabelle: Im Feld „Typ" der Tabelle „Gruppe" \[sys_user_Group\]. |
| RelatedParty.href | Relativer Link zum Datensatz der zugehörigen Partei. Datentyp: Zeichenfolge |
| relatedParty.id | SYS_ID des Datensatzes der zugehörigen Partei. Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
| ResourceMerkmal | Liste der Merkmale der Ressource. Die folgenden Ressourcentypen erfordern bestimmte Ressourcenmerkmale. * Für Ressourcen für physische Verbindung und logische Verbindung: A `Port A `Oder `Port Z `Merkmal ist erforderlich. Wenn der Lebenszyklusphasenstatus der Ressource „in Gebrauch" lautet, beides `Port A `Und `Port Z `Sind erforderlich. * Für Gerätehalter-Ressourcen `Containertyp `Merkmal ist erforderlich. {#resource-inv-GET-resource-id__ul_wsv_p2m_g5b} Datentyp: Array von Objekten "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] |
| resourceCharacteristic.name | Feldname aus der von angegebenen Ressourcentabelle @typeParameter. Sie können die Felder „model_ID", „Name", „Network_Site", „Operation_Notes", „Operational_Status" nicht verwenden. Short_description, Start_date oder beliebige sys_-Präfixfelder wie sys_ID Datentyp: Zeichenfolge |
| Ressourcenmerkmal.Wert | Der Wert des Merkmals. Datentyp: Zeichenfolge |
| ResourceMerkmal.WertTyp | Typ des Werts. Gültige Werte: * boolean * datetime * Gleitkommazahl * Ganzzahl * 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 Schnittstellenkartenressourcen eine Beziehung zu einer Gerätehalterressource, bei der der Containertyp „Steckplatz" oder „Untersteckplatz" ist. * Für Netzwerkschnittstellenressourcen ist eine Beziehung zu einem Gerät oder einer Schnittstellenkartenressource erforderlich. * Für Gerätehalterressourcen, bei denen der Containertyp „Steckplatz" oder „Untersteckplatz" ist, ist eine Beziehung zu einer Geräte- oder Schnittstellenkartenressource erforderlich. {#resource-inv-GET-resource-id__ul_rlv_3dm_g5b} Datentyp: Array "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] |
| ResourceBeziehung.Beziehungstyp | Typ der Beziehung zwischen den beiden Ressourcen im Format `[Dieser Ressourcendeskriptor]::[zugehöriger Ressourcendeskriptor] `. Beispiel: `Enthält::enthalten von `Gibt an, dass die zugehörige Ressource das untergeordnete Element dieser Ressource ist. Gültige Werte für die Deskriptoren befinden sich in der CI-Beziehungstyp-Tabelle \[cmdb_rel_type\] in Übergeordneter Deskriptor Und Untergeordneter Deskriptor Spalten. Datentyp: Zeichenfolge |
| Ressourcenbeziehung.Ressource | Details zur zugehörigen Ressource. Die zugehörige Ressource muss einer der folgenden Ressourcentypen sein. * Kabel * Ausrüstung * Gerätehalter * Schnittstellenkarte * Logische Verbindung * Netzwerkschnittstelle * Netzwerkstandort * Physische Verbindung * Litze * 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 von angegeben werden sn_ni_core.equipment_tablessys_property und alle Tabellen, die die angegebenen Tabellen erweitern. * Tabellen, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitern {#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, zu der die Ressource erstmals in Betrieb genommen wurde. Datentyp: Zeichenfolge |
[ ]

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

### Curl-Anforderung

Dieses Beispiel ruft einen angegebenen Ressourcendatensatz ab.

    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"
    }

## Ressourcenbestand -- offene API -- 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. Pfad-Parameter]

{#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 |
|-|-|
| @Typ | 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 `(Litze) * `cmdb_ci_Topology `(Topologie) * Name einer Tabelle, die von angegeben wird sn_ni_core.equipment_tablessys_property 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 |
| note | Liste der Notizen zur Ressource. Datentyp: Array von Objekten "note": [ { "text": "String" } ] |
| Hinweis.Text | Erforderlich, wenn noteParameter wird verwendet. Der Hinweistext. Datentyp: Zeichenfolge |
| Ort | Erforderlich für Gerätehalterressourcen, bei denen der Containertyp „Käfig", „Schacht", „Schrank", „Rack", „Anordnung" ist oder Bestandsmodellpaket. Erforderlich für alle Ausrüstungsressourcen. Netzwerkstandort für die Ressource. Dieser Parameter wird für Ressourcen „Netzwerkstandort", „physische Verbindung" oder „logische Verbindung" nicht unterstützt. Datentyp: Objekt "place": { "@referredType": "String", "href": "String", "id": "String" } |
| Place.@referredType | Typ des Orts. Dieser Wert ist immer `GeographieAddress `. Datentyp: Zeichenfolge |
| Place.href | Relativer Link zum Ortsdatensatz. Datentyp: Zeichenfolge |
| place.id | Erforderlich, wenn placeParameter wird verwendet. SYS_ID des Ortsdatensatzes. Datentyp: Zeichenfolge Tabelle: Netzwerkstandort \[cmdb_ci_ni_site\] |
| ZugehörigPartei | Details zu Kontakten für die Ressource. Datentyp: Array von Objekten "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] |
| RelatedParty.@referredType | Typ der zugehörigen Partei. Befindet sich in in in Typ Feld. Datentyp: Zeichenfolge Tabelle: Im Feld „Typ" der Tabelle „Gruppe" \[sys_user_Group\]. |
| RelatedParty.href | Relativer Link zum Datensatz der zugehörigen Partei. Datentyp: Zeichenfolge |
| relatedParty.id | Erforderlich, wenn relatedPartyParameter wird verwendet. SYS_ID des Datensatzes der zugehörigen Partei. Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
| ResourceMerkmal | Liste der Merkmale der Ressource. Die folgenden Ressourcentypen erfordern bestimmte Ressourcenmerkmale. * Für Ressourcen für physische Verbindung und logische Verbindung: A `Port A `Oder `Port Z `Merkmal ist erforderlich. Wenn der Lebenszyklusphasenstatus der Ressource „in Gebrauch" lautet, beides `Port A `Und `Port Z `Sind erforderlich. * Für Gerätehalter-Ressourcen `Containertyp `Merkmal ist erforderlich. {#resource-inv-POST-resource__ul_wsv_p2m_g5b} Datentyp: Array von Objekten "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] |
| resourceCharacteristic.name | Erforderlich, wenn resourceCharacteristicParameter wird verwendet. Feldname aus der von angegebenen Ressourcentabelle @typeParameter. Sie können die Felder „model_ID", „Name", „Network_Site", „Operation_Notes", „Operational_Status" nicht verwenden. Short_description, Start_date oder beliebige sys_-Präfixfelder wie sys_ID Datentyp: Zeichenfolge |
| Ressourcenmerkmal.Wert | Erforderlich, wenn resourceCharacteristicParameter wird verwendet. Der Wert des Merkmals. Datentyp: Zeichenfolge |
| ResourceMerkmal.WertTyp | Typ des Werts. Gültige Werte: * boolean * datetime * Gleitkommazahl * Ganzzahl * 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 Schnittstellenkartenressourcen eine Beziehung zu einer Gerätehalterressource, bei der der Containertyp „Steckplatz" oder „Untersteckplatz" ist. * Für Netzwerkschnittstellenressourcen ist eine Beziehung zu einem Gerät oder einer Schnittstellenkartenressource erforderlich. * Für Gerätehalterressourcen, bei denen der Containertyp „Steckplatz" oder „Untersteckplatz" ist, ist eine Beziehung zu einer Geräte- oder Schnittstellenkartenressource erforderlich. {#resource-inv-POST-resource__ul_rlv_3dm_g5b} Datentyp: Array "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] |
| ResourceBeziehung.Beziehungstyp | Erforderlich, wenn resourceRelationshipParameter wird verwendet. Typ der Beziehung zwischen den beiden Ressourcen im Format `[Dieser Ressourcendeskriptor]::[zugehöriger Ressourcendeskriptor] `. Beispiel: `Enthält::enthalten von `Gibt an, dass die zugehörige Ressource das untergeordnete Element dieser Ressource ist. Gültige Werte für die Deskriptoren befinden sich in der CI-Beziehungstyp-Tabelle \[cmdb_rel_type\] in Übergeordneter Deskriptor Und Untergeordneter Deskriptor Spalten. Datentyp: Zeichenfolge |
| Ressourcenbeziehung.Ressource | Erforderlich, wenn resourceRelationshipParameter wird verwendet. Details zur zugehörigen Ressource. Die zugehörige Ressource muss einer der folgenden Ressourcentypen sein. * Kabel * Ausrüstung * Gerätehalter * Schnittstellenkarte * Logische Verbindung * Netzwerkschnittstelle * Netzwerkstandort * Physische Verbindung * Litze * Topologie {#resource-inv-POST-resource__ul_wmt_vtx_d5y} Datentyp: Objekt "resource": { "id": "String", "href": "String" } |
| resourceRelationship.resource.id | Erforderlich, wenn resourceRelationshipParameter wird verwendet. 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 von angegeben werden sn_ni_core.equipment_tablessys_property und alle Tabellen, die die angegebenen Tabellen erweitern. * Tabellen, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitern {#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 resourceSpecificationParameter wird verwendet. 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, zu der die Ressource erstmals in Betrieb genommen wurde. Datentyp: Zeichenfolge |
[Tabelle : 21. Anforderungstext-Parameter (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.").
{#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}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 22. Anforderungskopfzeilen.]

{#resource-inv-POST-resource__entry__68}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Standort | URL der erstellten Ressource. |
[Tabelle : 23. 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.").
{#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 erfolgreich zur Verarbeitung empfangen. Die Anforderung wird asynchron abgeschlossen. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
[Tabelle : 24. Statuscodes]

{#resource-inv-POST-resource__table_b4x_lrs_g5b}

### Antworttext-Parameter (JSON) {#resource-inv-POST-resource__section_nkb_1rw_f5b}

{#resource-inv-POST-resource__table_okb_1rw_f5b__entry__2}{#resource-inv-POST-resource__d3090e144}{#resource-inv-POST-resource__d3090e408}

| Name | Beschreibung |
|-|-|
| @Typ | 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 `(Litze) * `cmdb_ci_Topology `(Topologie) * Name einer Tabelle, die von angegeben wird sn_ni_core.equipment_tablessys_property 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__d3090e148} 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_Litze\] * Topologie \[cmdb_ci_Topology\] * Tabellen, die von angegeben werden sn_ni_core.equipment_tablessys_property und 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_Litze\] {#resource-inv-POST-resource__ul_umw_gvn_bcc} {#resource-inv-POST-resource__res-inv-tables} Datentyp: Zeichenfolge |
| name | Name der Ressource. Datentyp: Zeichenfolge |
| note | Liste der Notizen zur Ressource. Datentyp: Array von Objekten "note": [ { "text": "String" } ] |
| Hinweis.Text | Der Hinweistext. Datentyp: Zeichenfolge |
| Ort | Netzwerkstandort für die Ressource. Dieser Parameter wird für Ressourcen „Netzwerkstandort", „physische Verbindung" oder „logische Verbindung" nicht unterstützt. Datentyp: Objekt "place": { "@referredType": "String", "href": "String", "id": "String" } |
| Place.@referredType | Typ des Orts. Dieser Wert ist immer `GeographieAddress `. Datentyp: Zeichenfolge |
| Place.href | Relativer Link zum Ortsdatensatz. Datentyp: Zeichenfolge |
| place.id | SYS_ID des Ortsdatensatzes. Datentyp: Zeichenfolge Tabelle: Netzwerkstandort \[cmdb_ci_ni_site\] |
| ZugehörigPartei | Details zu Kontakten für die Ressource. Datentyp: Array von Objekten "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] |
| RelatedParty.@referredType | Typ der zugehörigen Partei. Befindet sich in in in Typ Feld. Datentyp: Zeichenfolge Tabelle: Im Feld „Typ" der Tabelle „Gruppe" \[sys_user_Group\]. |
| RelatedParty.href | Relativer Link zum Datensatz der zugehörigen Partei. Datentyp: Zeichenfolge |
| relatedParty.id | SYS_ID des Datensatzes der zugehörigen Partei. Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
| ResourceMerkmal | Liste der Merkmale der Ressource. Die folgenden Ressourcentypen erfordern bestimmte Ressourcenmerkmale. * Für Ressourcen für physische Verbindung und logische Verbindung: A `Port A `Oder `Port Z `Merkmal ist erforderlich. Wenn der Lebenszyklusphasenstatus der Ressource „in Gebrauch" lautet, beides `Port A `Und `Port Z `Sind erforderlich. * Für Gerätehalter-Ressourcen `Containertyp `Merkmal ist erforderlich. {#resource-inv-POST-resource__d3090e485} Datentyp: Array von Objekten "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] |
| resourceCharacteristic.name | Feldname aus der von angegebenen Ressourcentabelle @typeParameter. Sie können die Felder „model_ID", „Name", „Network_Site", „Operation_Notes", „Operational_Status" nicht verwenden. Short_description, Start_date oder beliebige sys_-Präfixfelder wie sys_ID Datentyp: Zeichenfolge |
| Ressourcenmerkmal.Wert | Der Wert des Merkmals. Datentyp: Zeichenfolge |
| ResourceMerkmal.WertTyp | Typ des Werts. Gültige Werte: * boolean * datetime * Gleitkommazahl * Ganzzahl * ph_number * Referenz * Zeichenfolge {#resource-inv-POST-resource__d3090e559} Datentyp: Zeichenfolge |
| ResourceRelationship | Liste der zugehörigen Ressourcen. Die folgenden Ressourcentypen erfordern bestimmte zugehörige Ressourcen. * Für Schnittstellenkartenressourcen eine Beziehung zu einer Gerätehalterressource, bei der der Containertyp „Steckplatz" oder „Untersteckplatz" ist. * Für Netzwerkschnittstellenressourcen ist eine Beziehung zu einem Gerät oder einer Schnittstellenkartenressource erforderlich. * Für Gerätehalterressourcen, bei denen der Containertyp „Steckplatz" oder „Untersteckplatz" ist, ist eine Beziehung zu einer Geräte- oder Schnittstellenkartenressource erforderlich. {#resource-inv-POST-resource__d3090e594} Datentyp: Array "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] |
| ResourceBeziehung.Beziehungstyp | Typ der Beziehung zwischen den beiden Ressourcen im Format `[Dieser Ressourcendeskriptor]::[zugehöriger Ressourcendeskriptor] `. Beispiel: `Enthält::enthalten von `Gibt an, dass die zugehörige Ressource das untergeordnete Element dieser Ressource ist. Gültige Werte für die Deskriptoren befinden sich in der CI-Beziehungstyp-Tabelle \[cmdb_rel_type\] in Übergeordneter Deskriptor Und Untergeordneter Deskriptor Spalten. Datentyp: Zeichenfolge |
| Ressourcenbeziehung.Ressource | Details zur zugehörigen Ressource. Die zugehörige Ressource muss einer der folgenden Ressourcentypen sein. * Kabel * Ausrüstung * Gerätehalter * Schnittstellenkarte * Logische Verbindung * Netzwerkschnittstelle * Netzwerkstandort * Physische Verbindung * Litze * Topologie {#resource-inv-POST-resource__d3090e653} 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 von angegeben werden sn_ni_core.equipment_tablessys_property und alle Tabellen, die die angegebenen Tabellen erweitern. * Tabellen, die den Gerätehalter \[cmdb_ci_equipment_holder\] erweitern {#resource-inv-POST-resource__d3090e706} 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__d3090e773} Datentyp: Zeichenfolge |
| StartOperatingDate | Datum und Uhrzeit, zu der die Ressource erstmals in Betrieb genommen wurde. Datentyp: Zeichenfolge |
[ ]

{#resource-inv-POST-resource__table_okb_1rw_f5b}  

### Curl-Anforderung

Dieses Beispiel erstellt einen Netzwerkstandort in Denver, Colorado.

    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"
    }

## Ressourcenbestand -- offene API -- /sn_ni_Core/resourceinventoryviatemplate VERÖFFENTLICHEN {#ariaid-title6}

Erstellt ein Ressourcenkonfigurationselement (CI) und eine zugehörige CI-Hierarchie basierend auf einer Vorlage.
Bevor Sie diesen Endpunkt aufrufen, müssen Sie eine Bestandsvorlage in der Tabelle „Bestandsvorlage" \[sn_ni_core_inventory_template\] 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. Pfad-Parameter]

{#resource-inv-POST-template__entry__6}

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

{#resource-inv-POST-template__entry__10}

| Name | Beschreibung |
|-|-|
| Überschreibungen | Liste der zu überschreibenden Spalten und der zu verwendenden Werte. Datentyp: Objekt "overrides": { "column_name": "String" } |
| Overrides.column_Name | Erforderlich, wenn overridesParameter wird verwendet. Spaltenname und -Wert. 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_Litze\] * Topologie \[cmdb_ci_Topology\] * Tabellen, die von angegeben werden sn_ni_core.equipment_tablessys_property und 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_Litze\] {#resource-inv-POST-template__ul_umw_gvn_bcc} {#resource-inv-POST-template__ul_ihw_mmd_wxb} Datentyp: Zeichenfolge |
| templateId | Erforderlich. SYS_ID der Vorlage. Datentyp: Zeichenfolge Tabelle: Bestandsvorlage \[sn_ni_core_inventory_template\] |
| TemplateÜberschreibungen | Liste der Vorlagenüberschreibungen. Datentyp: Array von Objekten "templateOverrides": [ { "overrideTemplateId": "String", "templateId": "String" } ] |
| TemplateOverrides.overrideTemplateId | Erforderlich, wenn templateOverridesParameter wird verwendet. Verfügbare Vorlage „sys_ID" Datentyp: Zeichenfolge |
| TemplateOverrides.templateId | Erforderlich, wenn templateOverridesParameter wird verwendet. Zugehörige Vorlage sys_ID Datentyp: Zeichenfolge |
[Tabelle : 27. Anforderungstext-Parameter (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.").
{#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}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 28. Anforderungskopfzeilen.]

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

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Standort | URL des erstellten CI oben in der Hierarchie. |
[Tabelle : 29. Antwort-Header]

{#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 [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.").
{#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 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Fehler. Bei der Anforderung ist ein Fehler aufgetreten. Beispielsweise hat die Anforderung Validierungsprüfungen fehlgeschlagen. |
[Tabelle : 30. Statuscodes]

{#resource-inv-POST-template__table_b4x_lrs_g5b}

### Antworttext-Parameter (JSON)

{#resource-inv-POST-template__entry__48}

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

### Curl-Anforderung

In diesem Beispiel wird eine CI-Hierarchie mithilfe einer Vorlage 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"
    }


