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


---

# Tabellen-API

# Tabellen-API {#ariaid-title1}

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

Die Tabelle Die API stellt Endpunkte bereit, mit denen Sie CRUD-Vorgänge (Erstellen, Lesen, Aktualisieren und Löschen) für vorhandene Tabellen ausführen können.

Der aufrufende Anwender muss über ausreichende Rollen verfügen, um auf die Daten in der in der Anforderung angegebenen Tabelle zuzugreifen.

## Tabelle: LÖSCHEN SIE /now/table/{tableName}/{sys_ID} {#ariaid-title2}

Löscht den angegebenen Datensatz aus der angegebenen Tabelle.

### URL-Format {#table-DELETE__section_ls4_vk5_wlb}

Versionierte URL: /api/now/{api_Version}/table/{tableName}/{sys_ID}

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

### Unterstützte Anforderungsparameter

{#table-DELETE__entry__2}{#table-DELETE__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| sys_id | SYS_ID des zu löschenden Datensatzes. Datentyp: Zeichenfolge |
| tableName | Name der Tabelle, aus der der angegebene Datensatz gelöscht werden soll, z. B. „Incident" oder „Asset". Datentyp: Zeichenfolge |
[Tabelle : 1. Pfad-Parameter]

{#table-DELETE__entry__10}

| Name | Beschreibung |
|-|-|
| sysparm_query_no_domain | Kennzeichnung, die angibt, ob die Datensatzsuche auf die Domänen beschränkt werden soll, für die der angemeldete Anwender konfiguriert ist. Gültige Werte: * Falsch: Schließen Sie den Datensatz aus, wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann. * Wahr: Schließen Sie den Datensatz ein, auch wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann. {#table-DELETE__ul_pxp_3c1_3nb} Datentyp: Boolescher Wert Standard: Falsch Hinweis: Die sysparm_query_no_domainDer Parameter ist nur für Systemadministratoren oder Anwender mit der Rolle „query_no_domain_table_api" verfügbar. |
[Tabelle : 2. Abfrageparameter]

{#table-DELETE__entry__14}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

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

{#table-DELETE__entry__22}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 204 | Gibt an, dass die Anforderung erfolgreich abgeschlossen wurde. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#table-DELETE__entry__30}

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

### Curl-Anforderung

Löschen Sie einen Datensatz aus der Incident-Tabelle.

    curl "https://instance.servicenow.com/api/now/table/incident/d977b66a4f411200adf9f8e18110c7b2" \
    --request DELETE \
    --header "Accept:application/json" \
    --user 'username':'password'

Es ist kein Antworttext vorhanden.

    None

## Tabelle -- RUFT /now/table/{tableName} AB {#ariaid-title3}

Ruft mehrere Datensätze für die angegebene Tabelle ab.
Grundlegende Anweisungen finden Sie unter [Ruft vorhandene Incidents ab](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs.").

### URL-Format

Versionierte URL: /api/now/{api_Version}/table/{tableName}

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

### Unterstützte Anforderungsparameter

{#table-GET__entry__2}{#table-GET__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Je nach Version gibt dieser Endpunkt verschiedene Ergebnisse für eine gültige Abfrage zurück. * Version 1 gibt Fehlercode 404 ohne Ergebnisse zurück. * Version 2 gibt den Erfolgscode 200 und ein leeres Array als Antworttext zurück. {#table-GET__ul_byj_5kw_w4b} Datentyp: Zeichenfolge |
| tableName | Name der Tabelle, aus der die Datensätze abgerufen werden sollen. Datentyp: Zeichenfolge |
[Tabelle : 7. Pfad-Parameter]

{#table-GET__entry__8}{#table-GET__rest_api_sysparm_display_value_param}{#table-GET__rest_api_sysparm_exclude_reference_link}{#table-GET__rest_api_sysparm_fields_param}{#table-GET__sysparm-limit-RESTAPI}{#table-GET__sysparm_offset-ph-RESTAPI}{#table-GET__rest_api_sysparm_query_param}{#table-GET__rest_api_param_sysparm_suppress_pagination}

| Name | Beschreibung |
|-|-|
| Name-Wert-Paare | Name-Wert-Paare, die zum Filtern des Ergebnissatzes verwendet werden sollen. Dieser Parameter schließt sich gegenseitig aus sysparm_query. Beispiel: Anstatt zu verwenden `&Sysparm_query=Active=true `, Sie können die aufrufende Anweisung vereinfachen, indem Sie verwenden `&Active=wahr `. Sie können den Anzeigewert auch verwenden, wenn das Feld ein Auswahl- oder Referenztypfeld ist, z. B. `&Status=Geschlossen `Anstelle von `&Status=7 `. Um mehrere Schlüssel-Wert-Paare anzugeben, trennen Sie jedes durch ein und-Zeichen, z. B. `&Active=wahr&assigned_to=john.smith `. Datentyp: Zeichenfolge |
| Sysparm_Display_value | Bestimmt den Typ der zurückgegebenen Daten, entweder die tatsächlichen Werte aus der Datenbank oder die Anzeigewerte der Felder. Anzeigewerte werden basierend auf dem ist-Wert in der Datenbank und den Anwender- oder Systemeinstellungen und -Einstellungen geändert. Wenn Anzeigewerte zurückgegeben werden, ist der zurückgegebene Wert vom Feldtyp abhängig. * Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch beschreibender. * Datumsfelder: Der Datenbankwert hat das UTC-Format, während der Anzeigewert auf der Zeitzone des Anwenders basiert. * Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der angezeigte Wert basierend auf dem Verschlüsselungskontext des Anwenders unverschlüsselt ist. * Referenzfelder: Der Datenbankwert ist sys_ID, der Anzeigewert ist jedoch ein Anzeigefeld des referenzierten Datensatzes. Datentyp: Zeichenfolge Gültige Werte: * Wahr: Gibt die Anzeigewerte für alle Felder zurück. * Falsch: Gibt die tatsächlichen Werte aus der Datenbank zurück. * Alle: Gibt sowohl ist-Werte als auch Anzeigewerte zurück. {#table-GET__ul_vzj_1pw_pp} Standard: Falsch Hinweis: Es gibt keine bevorzugte Methode zum Festlegen dieses Parameters. Die Angabe des Anzeigewerts kann jedoch zu Leistungsproblemen führen, da er nicht direkt aus der Datenbank gelesen wird und möglicherweise auf andere Felder und Datensätze verweist. Weitere Informationen zu Anzeigewerten und ist-Werten finden Sie unter [Häufig gestellte Fragen zur Tabellen-API (KB0534905).](https://support.servicenow.com/kb_view.do?sysparm_article=KB0534905) |
| sysparm_exclude_reference_link | Kennzeichnung, die angibt, ob Tabellen-API-Links für Referenzfelder ausgeschlossen werden sollen. Gültige Werte: * Wahr: Tabellen-API-Links für Referenzfelder ausschließen. * Falsch: Tabellen-API-Links für Referenzfelder einschließen. {#table-GET__ul_llg_cnr_tgb} Datentyp: Boolescher Wert Standard: Falsch |
| Sysparm_fields | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben. |
| Sysparm_limit | Maximale Anzahl zurückzugebender Datensätze. Für Anforderungen, die diese Anzahl von Datensätzen überschreiten, verwenden Sie sysparm_offsetParameter zum Paginieren des Datensatzabrufs. Dieser Grenzwert wird vor der ACL-Auswertung angewendet. Wenn keine Datensätze zurückgegeben werden, einschließlich der Datensätze, auf die Sie Zugriff haben, ordnen Sie die Datensatzreihenfolge so an, dass Datensätze, auf die Sie zuerst zugreifen können, zurückgegeben werden. Hinweis: Ungewöhnlich groß sysparm_limitWerte können sich auf die Systemleistung auswirken. Datentyp: Zahl Standard: 20 Maximum: 100 |
| Sysparm_no_count | Kennzeichnung, die angibt, ob eine ausgeführt werden soll `Anzahl auswählen (*) `Abfrage der Tabelle, um die Anzahl der Zeilen in der zugehörigen Tabelle zurückzugeben. Gültige Werte: * Wahr: Führen Sie keinen aus `Anzahl auswählen (*) `. * Falsch: Führen Sie eine aus `Anzahl auswählen (*) `. {#table-GET__ul_j2x_wm1_3nb} Datentyp: Boolescher Wert Standard: Falsch |
| Sysparm_Offset | Startdatensatzindex, für den 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. Beispiel: Wenn Sie diesen Endpunkt zum ersten Mal aufrufen, sysparm_offsetIst auf „0" festgelegt. Um einfach alle verfügbaren Datensätze durchzublättern, verwenden Sie `Sysparm_Offset=sysparm_Offset+sysparm_limit `, Bis Sie das Ende aller Datensätze erreichen.{#table-GET__sysparm_offset-p-RESTAPI} Übergeben Sie keine negative Zahl in sysparm_offsetParameter. Datentyp: Zahl Standard: 0 |
| Sysparm_query | [Codierte Abfrage](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US)Wird verwendet, um den Ergebnissatz zu filtern. Sie können einen UI-Filter verwenden, um eine ordnungsgemäß codierte Abfrage zu erhalten. Syntax: `Sysparm_query=<col_name> <operator> <value> `. * \<col_name\>: Name der Tabellenspalte, nach der gefiltert werden soll. * \<operator\>: Unterstützt die folgenden Werte: * =: Stimmt genau mit \<value\> überein. * !=: Stimmt nicht mit \<value\> überein. * \^: Logisch UND mehrere Abfrageanweisungen. * \^ODER: Logisch ODER mehrere Abfrageanweisungen. * LIKE: \<col_name\> enthält die angegebene Zeichenfolge. Funktioniert nur für \<col_name\>-Felder, deren Datentyp „Zeichenfolge" ist. * STARTSMIT: \<col_name\> beginnt mit der angegebenen Zeichenfolge. Funktioniert nur für \<col_name\>-Felder, deren Datentyp „Zeichenfolge" ist. * ENDSWITH: \<col_name\> endet mit der angegebenen Zeichenfolge. Funktioniert nur für \<col_name\>-Felder, deren Datentyp „Zeichenfolge" ist. {#table-GET__ul_bgf_5vz_mlb} \<value\>: Wert, mit dem abgeglichen werden soll. {#table-GET__ul_g2p_svz_mlb} Bei allen Parametern wird zwischen Groß- und Kleinschreibung unterschieden. Abfragen können mehr als einen Eintrag enthalten, z. B. Sysparm_query=\<col_name\> \<operator\> \<value\>\[\<operator\> \<col_name\> \<operator\> \<value\>\] . Zum Beispiel: `(Sysparm_query=caller_ID=javascript:gs.getUserID()^Active=wahr)` Codierte Abfragen unterstützen auch die Funktion „Sortieren nach". Um Antworten basierend auf bestimmten Feldern zu sortieren, verwenden Sie `SORTIEREN NACH `Und `ORDERBYDESC `Klauseln in sysparm_query. Syntax: * `ORDERBY<col_name>` * `ORDERBYDESC<col_name>` {#table-GET__ul_sq4_rc1_nlb} Beispiel: `Sysparm_query=Active=wahr^ORDERBYNummer^ORDERBYDESCCATEGORY ` Diese Abfrage filtert alle aktiven Datensätze und ordnet die Ergebnisse in aufsteigender Reihenfolge nach Nummer und dann in absteigender Reihenfolge nach Kategorie an. Wenn ein Teil der Abfrage ungültig ist, z. B. durch Angabe eines ungültigen Feldnamens, ignoriert die Instanz den ungültigen Teil. Gibt dann Zeilen zurück, die nur den gültigen Teil der Abfrage verwenden. Sie können dieses Verhalten mithilfe der Eigenschaft steuern glide.invalid_query.returns_no_rows. Legen Sie diese Eigenschaft auf „wahr" fest, um keine Zeilen für eine ungültige Abfrage zurückzugeben. Hinweis: Die glide.invalid_query.returns_no_rowsEigenschaft steuert das Verhalten aller Abfragen in der Instanz, z. B. in Listen, Skripts ( GlideRecord.Abfrage() ) Und Webservice-APIs. Datentyp: Zeichenfolge |
| Sysparm_query_category | Name der Kategorie, die für Abfragen verwendet werden soll. Datentyp: Zeichenfolge |
| sysparm_query_no_domain | Kennzeichnung, die angibt, ob die Datensatzsuche auf die Domänen beschränkt werden soll, für die der angemeldete Anwender konfiguriert ist. Gültige Werte: * Falsch: Schließen Sie den Datensatz aus, wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann. * Wahr: Schließen Sie den Datensatz ein, auch wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann. {#table-GET__ul_pxp_3c1_3nb} Datentyp: Boolescher Wert Standard: Falsch Hinweis: Die sysparm_query_no_domainDer Parameter ist nur für Systemadministratoren oder Anwender mit der Rolle „query_no_domain_table_api" verfügbar. |
| sysparm_suppress_pagination_header | Kennzeichnung, die angibt, ob der Linkheader aus der Antwort entfernt werden soll. Der Linkheader stellt verschiedene URLs für relative Seiten im Datensatzsatz bereit, die Sie zum Paginieren des zurückgegebenen Datensatzes verwenden können. Gültige Werte: * Wahr: Entfernen Sie den Linkheader aus der Antwort. * Falsch: Entfernen Sie den Linkheader nicht aus der Antwort. {#table-GET__ul_pmz_vbl_tgb} Datentyp: Boolescher Wert Standard: Falsch |
| sysparm_view | UI-Ansicht, für die die Daten gerendert werden sollen. Bestimmt die in der Antwort zurückgegebenen Felder. Gültige Werte: * Desktop * Mobile * both {#table-GET__ul_wr5_5xl_tgb} Wenn Sie auch angeben sysparm_fieldsParameter, hat Vorrang. Datentyp: Zeichenfolge |
[Tabelle : 8. Abfrageparameter]

{#table-GET__entry__34}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

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

{#table-GET__entry__42}

| Header | Beschreibung |
|-|-|
| Verknüpfen | Relative URLs basierend auf der vorherigen Anforderung, mit denen Sie den verfügbaren Datensatzsatz durchblättern können. Zum Beispiel: `https://<instance name>.servicenow.com/api/now/table/cmdb_ci?sysparm_offset=40&sysparm_limit=1000>;rel="next" `, `https://<instance name>.servicenow.com/api/now/table/cmdb_ci?sysparm_offset=40&sysparm_limit=1000>;rel="prev" `, `https://<instance name>.servicenow.com/api/now/table/cmdb_ci?sysparm_offset=0&sysparm_limit=1000>;rel="first" `, `https://<instance name>.servicenow.com/api/now/table/cmdb_ci?sysparm_offset=2780&sysparm_limit=1000>;rel="last"` Für zusätzliche Informationen zu relParameter, siehe <https://html.spec.whatwg.org/multipage/links.html#linkTypes>. |
| X-Gesamtzahl | Gesamtanzahl der von der Abfrage zurückgegebenen Datensätze. |
[Tabelle : 11. 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.").
{#table-GET__entry__48}

| Statuscode | Beschreibung |
|-|-|
| 200 | Anforderung erfolgreich abgeschlossen. Wenn eine gültige Abfrage keine Ergebnisse zurückgegeben hat, enthält der Antworttext nur ein leeres Ergebnis-Array. |
[Tabelle : 12. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#table-GET__entry__52}

| Parameter | Beschreibung |
|-|-|
| Name-Wert-Paare | Feldnamen und Werte aller Parameter im angegebenen Datensatz oder der in den Abfrageparametern angegebenen. |
[ ]

### Curl-Anforderung

Ruft den ersten Datensatz aus der Problemtabelle ab.

    curl "https://instance.servicenow.com/api/now/table/problem?sysparm_limit=1" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

Die Antwort enthält die Name-Wert-Paare für den angeforderten Datensatz.

    {
      "result": [
        {
          "parent": "",
          "made_sla": "true",
          "watch_list": "",
          "upon_reject": "cancel",
          "sys_updated_on": "2016-01-19 04:52:04",
          "approval_history": "",
          "number": "PRB0000050",
          "sys_updated_by": "glide.maint",
          "opened_by": {
            "link": "https://instance.servicenow.com/api/now/table/sys_user/glide.maint",
            "value": "glide.maint"
          },
          "user_input": "",
          "sys_created_on": "2016-01-19 04:51:19",
          "sys_domain": {
            "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
            "value": "global"
          },
          "state": "4",
          "sys_created_by": "glide.maint",
          "knowledge": "false",
          "order": "",
          "closed_at": "2016-01-19 04:52:04",
          "cmdb_ci": {
            "link": "https://instance.servicenow.com/api/now/table/cmdb_ci/55b35562c0a8010e01cff22378e0aea9",
            "value": "55b35562c0a8010e01cff22378e0aea9"
          },
          "delivery_plan": "",
          "impact": "3",
          "active": "false",
          "work_notes_list": "",
          "business_service": "",
          "priority": "4",
          "sys_domain_path": "/",
          "time_worked": "",
          "expected_start": "",
          "rejection_goto": "",
          "opened_at": "2016-01-19 04:49:47",
          "business_duration": "1970-01-01 00:00:00",
          "group_list": "",
          "work_end": "",
          "approval_set": "",
          "wf_activity": "",
          "work_notes": "",
          "short_description": "Switch occasionally drops connections",
          "correlation_display": "",
          "delivery_task": "",
          "work_start": "",
          "assignment_group": "",
          "additional_assignee_list": "",
          "description": "Switch occasionally drops connections",
          "calendar_duration": "1970-01-01 00:02:17",
          "close_notes": "updated firmware",
          "sys_class_name": "problem",
          "closed_by": "",
          "follow_up": "",
          "sys_id": "04ce72c9c0a8016600b5b7f75ac67b5b",
          "contact_type": "phone",
          "urgency": "3",
          "company": "",
          "reassignment_count": "",
          "activity_due": "",
          "assigned_to": "",
          "comments": "",
          "approval": "not requested",
          "sla_due": "",
          "comments_and_work_notes": "",
          "due_date": "",
          "sys_mod_count": "1",
          "sys_tags": "",
          "escalation": "0",
          "upon_approval": "proceed",
          "correlation_id": "",
          "location": ""
        }
      ]
    }

## Tabelle -- RUFT /now/table/{tableName}/{sys_ID} AB {#ariaid-title4}

Ruft den durch die angegebene sys_ID identifizierten Datensatz aus der angegebenen Tabelle ab.

### URL-Format {#table-GET-id__section_rg1_dcv_wlb}

Versionierte URL: /api/now/{api_Version}/table/{tableName}/{sys_ID}

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

### Unterstützte Anforderungsparameter

{#table-GET-id__entry__2}{#table-GET-id__version-not_optional-RESTAPI}

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

{#table-GET-id__entry__10}

| Name | Beschreibung |
|-|-|
| Sysparm_Display_value | Bestimmt den Typ der zurückgegebenen Daten, entweder die tatsächlichen Werte aus der Datenbank oder die Anzeigewerte der Felder. Anzeigewerte werden basierend auf dem ist-Wert in der Datenbank und den Anwender- oder Systemeinstellungen und -Einstellungen geändert. Wenn Anzeigewerte zurückgegeben werden, ist der zurückgegebene Wert vom Feldtyp abhängig. * Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch beschreibender. * Datumsfelder: Der Datenbankwert hat das UTC-Format, während der Anzeigewert auf der Zeitzone des Anwenders basiert. * Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der angezeigte Wert basierend auf dem Verschlüsselungskontext des Anwenders unverschlüsselt ist. * Referenzfelder: Der Datenbankwert ist sys_ID, der Anzeigewert ist jedoch ein Anzeigefeld des referenzierten Datensatzes. Datentyp: Zeichenfolge Gültige Werte: * Wahr: Gibt die Anzeigewerte für alle Felder zurück. * Falsch: Gibt die tatsächlichen Werte aus der Datenbank zurück. * Alle: Gibt sowohl ist-Werte als auch Anzeigewerte zurück. {#table-GET-id__ul_vzj_1pw_pp} Standard: Falsch Hinweis: Es gibt keine bevorzugte Methode zum Festlegen dieses Parameters. Die Angabe des Anzeigewerts kann jedoch zu Leistungsproblemen führen, da er nicht direkt aus der Datenbank gelesen wird und möglicherweise auf andere Felder und Datensätze verweist. Weitere Informationen zu Anzeigewerten und ist-Werten finden Sie unter [Häufig gestellte Fragen zur Tabellen-API (KB0534905).](https://support.servicenow.com/kb_view.do?sysparm_article=KB0534905) |
| sysparm_exclude_reference_link | Kennzeichnung, die angibt, ob Tabellen-API-Links für Referenzfelder ausgeschlossen werden sollen. Gültige Werte: * Wahr: Tabellen-API-Links für Referenzfelder ausschließen. * Falsch: Tabellen-API-Links für Referenzfelder einschließen. {#table-GET-id__ul_llg_cnr_tgb} Datentyp: Boolescher Wert Standard: Falsch |
| Sysparm_fields | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben. |
| sysparm_query_no_domain | Kennzeichnung, die angibt, ob die Datensatzsuche auf die Domänen beschränkt werden soll, für die der angemeldete Anwender konfiguriert ist. Gültige Werte: * Falsch: Schließen Sie den Datensatz aus, wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann. * Wahr: Schließen Sie den Datensatz ein, auch wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann. {#table-GET-id__ul_pxp_3c1_3nb} Datentyp: Boolescher Wert Standard: Falsch Hinweis: Die sysparm_query_no_domainDer Parameter ist nur für Systemadministratoren oder Anwender mit der Rolle „query_no_domain_table_api" verfügbar. |
| sysparm_view | UI-Ansicht, für die die Daten gerendert werden sollen. Bestimmt die in der Antwort zurückgegebenen Felder. Gültige Werte: * Desktop * Mobile * both {#table-GET-id__ul_wr5_5xl_tgb} Wenn Sie auch angeben sysparm_fieldsParameter, hat Vorrang. Datentyp: Zeichenfolge |
[Tabelle : 14. Abfrageparameter]

{#table-GET-id__entry__22}

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

### Header

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

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

{#table-GET-id__entry__30}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. 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.").
{#table-GET-id__entry__34}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 18. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#table-GET-id__entry__40}

| Parameter | Beschreibung |
|-|-|
| Name-Wert-Paare | Feldnamen und Werte aller Parameter im angegebenen Datensatz oder der in den Abfrageparametern angegebenen. |
[ ]

### Curl-Anforderung

Ruft einen Datensatz aus der Incident-Tabelle ab.

    curl "https://instance.servicenow.com/api/now/table/incident/a9e30c7dc61122760116894de7bcc7bd" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

Die Antwort enthält die Name-Wert-Paare für den angeforderten Datensatz.

    {
      "result": {
        "upon_approval": "",
        "location": {
          "link": "https://instance.servicenow.com/api/now/table/cmn_location/105cf7f3c611227501e75e08b14a38ba",
          "value": "105cf7f3c611227501e75e08b14a38ba"
        },
        "expected_start": "",
        "reopen_count": "",
        "close_notes": "",
        "additional_assignee_list": "",
        "impact": "1",
        "urgency": "3",
        "correlation_id": "",
        "sys_tags": "",
        "sys_domain": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
          "value": "global"
        },
        "description": "",
        "group_list": "",
        "priority": "3",
        "delivery_plan": "",
        "sys_mod_count": "4",
        "work_notes_list": "",
        "business_service": "",
        "follow_up": "",
        "closed_at": "",
        "sla_due": "2015-11-11 22:04:15",
        "delivery_task": "",
        "sys_updated_on": "2015-11-01 22:37:27",
        "parent": "",
        "work_end": "",
        "number": "INC0000046",
        "closed_by": "",
        "work_start": "",
        "calendar_stc": "",
        "category": "software",
        "business_duration": "",
        "incident_state": "1",
        "activity_due": "",
        "correlation_display": "",
        "company": "",
        "active": "true",
        "due_date": "",
        "assignment_group": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user_group/8a4dde73c6112278017a6a4baf547aa7",
          "value": "8a4dde73c6112278017a6a4baf547aa7"
        },
        "caller_id": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user/46c6f9efa9fe198101ddf5eed9adf6e7",
          "value": "46c6f9efa9fe198101ddf5eed9adf6e7"
        },
        "knowledge": "false",
        "made_sla": "false",
        "comments_and_work_notes": "",
        "parent_incident": "",
        "state": "1",
        "user_input": "",
        "sys_created_on": "2015-11-01 22:05:30",
        "approval_set": "",
        "reassignment_count": "1",
        "rfc": "",
        "child_incidents": "",
        "opened_at": "2015-11-02 22:04:15",
        "short_description": "Can't access SFA software",
        "order": "",
        "sys_updated_by": "glide.maint",
        "resolved_by": "",
        "notify": "1",
        "upon_reject": "",
        "approval_history": "",
        "problem_id": {
          "link": "https://instance.servicenow.com/api/now/table/problem/a9e4890bc6112276003d7a5a5c774a74",
          "value": "a9e4890bc6112276003d7a5a5c774a74"
        },
        "work_notes": "",
        "calendar_duration": "",
        "close_code": "",
        "sys_id": "a9e30c7dc61122760116894de7bcc7bd",
        "approval": "not requested",
        "caused_by": "",
        "severity": "3",
        "sys_created_by": "admin",
        "resolved_at": "",
        "assigned_to": "",
        "business_stc": "",
        "wf_activity": "",
        "sys_domain_path": "/",
        "cmdb_ci": {
          "link": "https://instance.servicenow.com/api/now/table/cmdb_ci/a9c0c8d2c6112276018f7705562f9cb0",
          "value": "a9c0c8d2c6112276018f7705562f9cb0"
        },
        "opened_by": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user/46c6f9efa9fe198101ddf5eed9adf6e7",
          "value": "46c6f9efa9fe198101ddf5eed9adf6e7"
        },
        "subcategory": "",
        "rejection_goto": "",
        "sys_class_name": "incident",
        "watch_list": "",
        "time_worked": "",
        "contact_type": "phone",
        "escalation": "0",
        "comments": ""
      }
    }

## Tabelle -- PATCH /now/table/{tableName}/{sys_ID} {#ariaid-title5}

Aktualisiert den angegebenen Datensatz mit den im Anforderungstext enthaltenen Name-Wert-Paaren.

### URL-Format {#table-PATCH__section_jmq_j2v_wlb}

Versionierte URL: /api/now/{api_Version}/table/{tableName}/{sys_ID}

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

### Unterstützte Anforderungsparameter

{#table-PATCH__entry__2}{#table-PATCH__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| sys_id | SYS_ID des zu aktualisierenden Datensatzes. Datentyp: Zeichenfolge |
| tableName | Name der Tabelle, in der sich der angegebene Datensatz befindet. Datentyp: Zeichenfolge |
[Tabelle : 19. Pfad-Parameter]

{#table-PATCH__entry__10}

| Name | Beschreibung |
|-|-|
| Sysparm_Display_value | Bestimmt den Typ der zurückgegebenen Daten, entweder die tatsächlichen Werte aus der Datenbank oder die Anzeigewerte der Felder. Anzeigewerte werden basierend auf dem ist-Wert in der Datenbank und den Anwender- oder Systemeinstellungen und -Einstellungen geändert. Wenn Anzeigewerte zurückgegeben werden, ist der zurückgegebene Wert vom Feldtyp abhängig. * Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch beschreibender. * Datumsfelder: Der Datenbankwert hat das UTC-Format, während der Anzeigewert auf der Zeitzone des Anwenders basiert. * Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der angezeigte Wert basierend auf dem Verschlüsselungskontext des Anwenders unverschlüsselt ist. * Referenzfelder: Der Datenbankwert ist sys_ID, der Anzeigewert ist jedoch ein Anzeigefeld des referenzierten Datensatzes. Datentyp: Zeichenfolge Gültige Werte: * Wahr: Gibt die Anzeigewerte für alle Felder zurück. * Falsch: Gibt die tatsächlichen Werte aus der Datenbank zurück. * Alle: Gibt sowohl ist-Werte als auch Anzeigewerte zurück. {#table-PATCH__ul_vzj_1pw_pp} Standard: Falsch Hinweis: Es gibt keine bevorzugte Methode zum Festlegen dieses Parameters. Die Angabe des Anzeigewerts kann jedoch zu Leistungsproblemen führen, da er nicht direkt aus der Datenbank gelesen wird und möglicherweise auf andere Felder und Datensätze verweist. Weitere Informationen zu Anzeigewerten und ist-Werten finden Sie unter [Häufig gestellte Fragen zur Tabellen-API (KB0534905).](https://support.servicenow.com/kb_view.do?sysparm_article=KB0534905) |
| Sysparm_fields | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben. |
| sysparm_input_display_value | Kennzeichnung, die angibt, ob Feldwerte mithilfe des Anzeigewerts oder des ist-Werts festgelegt werden sollen. Abhängig von den verschiedenen Arten von Feldern kann der Endpunkt die übergebenen Anzeigewerte manipulieren, um die richtigen Werte in der Datenbank zu speichern. Wenn Sie beispielsweise den Anzeigenamen für ein Referenzfeld senden, speichert der Endpunkt die sys_ID für diesen Wert in der Datenbank. Bei Datums- und Uhrzeitfeldern wird der Datums- und Uhrzeitwert an die Zeitzone des aktuellen Anwenders angepasst. Bei „falsch" werden der Datums- und Uhrzeitwert mithilfe der GMT-Zeitzone eingefügt. Gültige Werte: * Wahr: Behandelt Eingabewerte als Anzeigewerte, und sie werden so bearbeitet, dass sie ordnungsgemäß in der Datenbank gespeichert werden. * Falsch: Behandelt Eingabewerte als ist-Werte und speichert sie ohne Manipulation in der Datenbank. {#table-PATCH__ul_shq_cfx_pp} Datentyp: Boolescher Wert Standard: Falsch: Entspricht dem Datentyp, der während des Datenabrufs (GET-Methoden) zurückgegeben wird, d. h. den tatsächlichen Werten. Hinweis: Um den Wert eines verschlüsselten Felds festzulegen, müssen Sie diesen Parameter auf festlegen <kbd class="ph userinput">Wahr </kbd>. Wenn dieser Parameter nicht auf „wahr" festgelegt ist, werden an verschlüsselte Felder übermittelte Werte nicht gespeichert. Darüber hinaus muss der anfordernde Anwender über den entsprechenden Verschlüsselungskontext verfügen, bevor die Anforderung übermittelt wird. Verschlüsselte Felder werden für Anwender ohne den entsprechenden Verschlüsselungskontext ausgeblendet. Weitere Informationen zur Feldverschlüsselung finden Sie unter [Encryption](https://www.servicenow.com/docs/access?context=encryption-landing&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). |
| sysparm_query_no_domain | Kennzeichnung, die angibt, ob die Datensatzsuche auf die Domänen beschränkt werden soll, für die der angemeldete Anwender konfiguriert ist. Gültige Werte: * Falsch: Schließen Sie den Datensatz aus, wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann. * Wahr: Schließen Sie den Datensatz ein, auch wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann. {#table-PATCH__ul_pxp_3c1_3nb} Datentyp: Boolescher Wert Standard: Falsch Hinweis: Die sysparm_query_no_domainDer Parameter ist nur für Systemadministratoren oder Anwender mit der Rolle „query_no_domain_table_api" verfügbar. |
| sysparm_view | UI-Ansicht, für die die Daten gerendert werden sollen. Bestimmt die in der Antwort zurückgegebenen Felder. Gültige Werte: * Desktop * Mobile * both {#table-PATCH__ul_wr5_5xl_tgb} Wenn Sie auch angeben sysparm_fieldsParameter, hat Vorrang. Datentyp: Zeichenfolge |
[Tabelle : 20. Abfrageparameter]

{#table-PATCH__entry__22}

| Name | Beschreibung |
|-|-|
| Name-Wert-Paare | Feldname und neuer Wert für jeden Parameter, der im angegebenen Datensatz aktualisiert werden soll. Hinweis: Möglicherweise sind nicht alle Felder in einem Datensatz zum Aktualisieren verfügbar. Beispiel: Felder mit dem Präfix „sys_" sind normalerweise Systemparameter, die automatisch generiert werden und nicht aktualisiert werden können. |
[Tabelle : 21. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| X-no-response-body | Standardmäßig enthalten Antworten Textinhalte, die den geänderten Datensatz detaillieren. Legen Sie diesen Anforderungsheader auf „wahr" fest, um den Antworttext zu unterdrücken. |
[Tabelle : 22. Anforderungskopfzeilen.]

{#table-PATCH__entry__34}

| Header | Beschreibung |
|-|-|
| Keine |   |
[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.").
{#table-PATCH__entry__38}{#table-PATCH__entry-200-status-code}{#table-PATCH__entry-400-status-code}{#table-PATCH__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. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 24. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#table-PATCH__entry__46}

| Name | Beschreibung |
|-|-|
| Name-Wert-Paare | Feldnamen und Werte aller Parameter im angegebenen Datensatz oder der in den Abfrageparametern angegebenen. |
[ ]

### Curl-Anforderung

Aktualisieren Sie einen Datensatz in der Incident-Tabelle.

    curl "https://instance.servicenow.com/api/now/table/incident/ef43c6d40a0a0b5700c77f9bf387afe3" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{'assigned_to':'681b365ec0a80164000fb0b05854a0cd','urgency':'1','comments':'Elevating urgency, this is a blocking issue'}" \
    --user 'username':'password'

Die Antwort enthält die Name-Wert-Paare für den aktualisierten Datensatz.

    {
      "result": {
        "upon_approval": "proceed",
        "location": {
          "link": "https://instance.servicenow.com/api/now/table/cmn_location/108752c8c611227501d4ab0e392ba97f",
          "value": "108752c8c611227501d4ab0e392ba97f"
        },
        "expected_start": "",
        "reopen_count": "",
        "close_notes": "",
        "additional_assignee_list": "",
        "impact": "1",
        "urgency": "1",
        "correlation_id": "",
        "sys_tags": "",
        "sys_domain": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
          "value": "global"
        },
        "description": "",
        "group_list": "",
        "priority": "1",
        "delivery_plan": "",
        "sys_mod_count": "7",
        "work_notes_list": "",
        "business_service": "",
        "follow_up": "",
        "closed_at": "",
        "sla_due": "2017-07-05 05:58:24",
        "delivery_task": "",
        "sys_updated_on": "2016-01-22 14:12:37",
        "parent": "",
        "work_end": "",
        "number": "INC0000050",
        "closed_by": "",
        "work_start": "",
        "calendar_stc": "",
        "category": "hardware",
        "business_duration": "",
        "incident_state": "2",
        "activity_due": "2016-01-22 16:12:37",
        "correlation_display": "",
        "company": {
          "link": "https://instance.servicenow.com/api/now/table/core_company/31bea3d53790200044e0bfc8bcbe5dec",
          "value": "31bea3d53790200044e0bfc8bcbe5dec"
        },
        "active": "true",
        "due_date": "",
        "assignment_group": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user_group/8a5055c9c61122780043563ef53438e3",
          "value": "8a5055c9c61122780043563ef53438e3"
        },
        "caller_id": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user/5b7c200d0a640069006b3845b5d0fa7c",
          "value": "5b7c200d0a640069006b3845b5d0fa7c"
        },
        "knowledge": "false",
        "made_sla": "true",
        "comments_and_work_notes": "",
        "parent_incident": "",
        "state": "2",
        "user_input": "",
        "sys_created_on": "2015-11-02 18:05:40",
        "approval_set": "",
        "reassignment_count": "0",
        "rfc": "",
        "child_incidents": "",
        "opened_at": "2015-11-02 21:58:24",
        "short_description": "Can't access Exchange server - is it down?",
        "order": "",
        "sys_updated_by": "admin",
        "resolved_by": "",
        "notify": "1",
        "upon_reject": "cancel",
        "approval_history": "",
        "problem_id": "",
        "work_notes": "",
        "calendar_duration": "",
        "close_code": "",
        "sys_id": "ef43c6d40a0a0b5700c77f9bf387afe3",
        "approval": "not requested",
        "caused_by": "",
        "severity": "3",
        "sys_created_by": "glide.maint",
        "resolved_at": "",
        "assigned_to": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user/681b365ec0a80164000fb0b05854a0cd",
          "value": "681b365ec0a80164000fb0b05854a0cd"
        },
        "business_stc": "",
        "wf_activity": "",
        "sys_domain_path": "/",
        "cmdb_ci": {
          "link": "https://instance.servicenow.com/api/now/table/cmdb_ci/281190e3c0a8000b003f593aa3f20ca6",
          "value": "281190e3c0a8000b003f593aa3f20ca6"
        },
        "opened_by": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user/glide.maint",
          "value": "glide.maint"
        },
        "subcategory": "",
        "rejection_goto": "",
        "sys_class_name": "incident",
        "watch_list": "",
        "time_worked": "",
        "contact_type": "phone",
        "escalation": "3",
        "comments": ""
      }
    }

## Tabelle -- POST /now/table/{tableName} {#ariaid-title6}

Fügt einen Datensatz in die angegebene Tabelle ein. Das Einfügen mehrerer Datensätze wird von dieser Methode nicht unterstützt.

### URL-Format {#table-POST__section_pxb_vfv_wlb}

Versionierte URL: /api/now/{api_Version}/table/{tableName}

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

### Unterstützte Anforderungsparameter

{#table-POST__entry__2}{#table-POST__version-not_optional-RESTAPI}

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

{#table-POST__entry__8}

| Name | Beschreibung |
|-|-|
| Sysparm_Display_value | Bestimmt den Typ der zurückgegebenen Daten, entweder die tatsächlichen Werte aus der Datenbank oder die Anzeigewerte der Felder. Anzeigewerte werden basierend auf dem ist-Wert in der Datenbank und den Anwender- oder Systemeinstellungen und -Einstellungen geändert. Wenn Anzeigewerte zurückgegeben werden, ist der zurückgegebene Wert vom Feldtyp abhängig. * Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch beschreibender. * Datumsfelder: Der Datenbankwert hat das UTC-Format, während der Anzeigewert auf der Zeitzone des Anwenders basiert. * Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der angezeigte Wert basierend auf dem Verschlüsselungskontext des Anwenders unverschlüsselt ist. * Referenzfelder: Der Datenbankwert ist sys_ID, der Anzeigewert ist jedoch ein Anzeigefeld des referenzierten Datensatzes. Datentyp: Zeichenfolge Gültige Werte: * Wahr: Gibt die Anzeigewerte für alle Felder zurück. * Falsch: Gibt die tatsächlichen Werte aus der Datenbank zurück. * Alle: Gibt sowohl ist-Werte als auch Anzeigewerte zurück. {#table-POST__ul_vzj_1pw_pp} Standard: Falsch Hinweis: Es gibt keine bevorzugte Methode zum Festlegen dieses Parameters. Die Angabe des Anzeigewerts kann jedoch zu Leistungsproblemen führen, da er nicht direkt aus der Datenbank gelesen wird und möglicherweise auf andere Felder und Datensätze verweist. Weitere Informationen zu Anzeigewerten und ist-Werten finden Sie unter [Häufig gestellte Fragen zur Tabellen-API (KB0534905).](https://support.servicenow.com/kb_view.do?sysparm_article=KB0534905) |
| sysparm_exclude_reference_link | Kennzeichnung, die angibt, ob Tabellen-API-Links für Referenzfelder ausgeschlossen werden sollen. Gültige Werte: * Wahr: Tabellen-API-Links für Referenzfelder ausschließen. * Falsch: Tabellen-API-Links für Referenzfelder einschließen. {#table-POST__ul_llg_cnr_tgb} Datentyp: Boolescher Wert Standard: Falsch |
| Sysparm_fields | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben. |
| sysparm_input_display_value | Kennzeichnung, die angibt, ob Feldwerte mithilfe des Anzeigewerts oder des ist-Werts festgelegt werden sollen. Abhängig von den verschiedenen Arten von Feldern kann der Endpunkt die übergebenen Anzeigewerte manipulieren, um die richtigen Werte in der Datenbank zu speichern. Wenn Sie beispielsweise den Anzeigenamen für ein Referenzfeld senden, speichert der Endpunkt die sys_ID für diesen Wert in der Datenbank. Bei Datums- und Uhrzeitfeldern wird der Datums- und Uhrzeitwert an die Zeitzone des aktuellen Anwenders angepasst. Bei „falsch" werden der Datums- und Uhrzeitwert mithilfe der GMT-Zeitzone eingefügt. Gültige Werte: * Wahr: Behandelt Eingabewerte als Anzeigewerte, und sie werden so bearbeitet, dass sie ordnungsgemäß in der Datenbank gespeichert werden. * Falsch: Behandelt Eingabewerte als ist-Werte und speichert sie ohne Manipulation in der Datenbank. {#table-POST__ul_shq_cfx_pp} Datentyp: Boolescher Wert Standard: Falsch: Entspricht dem Datentyp, der während des Datenabrufs (GET-Methoden) zurückgegeben wird, d. h. den tatsächlichen Werten. Hinweis: Um den Wert eines verschlüsselten Felds festzulegen, müssen Sie diesen Parameter auf festlegen <kbd class="ph userinput">Wahr </kbd>. Wenn dieser Parameter nicht auf „wahr" festgelegt ist, werden an verschlüsselte Felder übermittelte Werte nicht gespeichert. Darüber hinaus muss der anfordernde Anwender über den entsprechenden Verschlüsselungskontext verfügen, bevor die Anforderung übermittelt wird. Verschlüsselte Felder werden für Anwender ohne den entsprechenden Verschlüsselungskontext ausgeblendet. Weitere Informationen zur Feldverschlüsselung finden Sie unter [Encryption](https://www.servicenow.com/docs/access?context=encryption-landing&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). |
| sysparm_view | UI-Ansicht, für die die Daten gerendert werden sollen. Bestimmt die in der Antwort zurückgegebenen Felder. Gültige Werte: * Desktop * Mobile * both {#table-POST__ul_wr5_5xl_tgb} Wenn Sie auch angeben sysparm_fieldsParameter, hat Vorrang. Datentyp: Zeichenfolge |
[Tabelle : 26. Abfrageparameter]

{#table-POST__entry__20}

| Name | Beschreibung |
|-|-|
| Name-Wert-Paare | Feldname und zugeordneter Wert für jeden Parameter, der im angegebenen Datensatz definiert werden soll. Hinweis: Möglicherweise sind nicht alle Felder in einem Datensatz zum Aktualisieren verfügbar. Beispiel: Felder mit dem Präfix „sys_" sind normalerweise Systemparameter, die automatisch generiert werden und nicht aktualisiert werden können.Felder, die nicht angegeben und vom System nicht automatisch generiert werden, werden auf den Nullwert des zugehörigen Datentyps festgelegt. |
[Tabelle : 27. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| X-no-response-body | Standardmäßig enthalten Antworten Textinhalte, die den neuen Datensatz detaillieren. Legen Sie diesen Header in der Anforderung auf „wahr" fest, um den Antworttext zu unterdrücken. |
[Tabelle : 28. Anforderungskopfzeilen.]

{#table-POST__entry__32}

| Header | Beschreibung |
|-|-|
| Standort | Speicherort der erstellten Ressource. |
[Tabelle : 29. 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.").
{#table-POST__entry__36}{#table-POST__entry-400-status-code}{#table-POST__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 201 | Gibt an, dass die Anforderung erfolgreich abgeschlossen wurde. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 30. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#table-POST__entry__44}

| Name | Beschreibung |
|-|-|
| Name-Wert-Paare | Feldnamen und Werte aller Parameter im neu erstellten Datensatz oder der in den Abfrageparametern angegebenen Parameter. |
[ ]

### Curl-Anforderung

Fügen Sie einen neuen Datensatz in die Incident-Tabelle ein.

    curl "https://instance.servicenow.com/api/now/table/incident" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{'short_description':'Unable to connect to office wifi','assignment_group':'287ebd7da9fe198100f92cc8d1d2154e','urgency':'2','impact':'2'}" \
    --user 'username':'password'

Die Antwort enthält die Name-Wert-Paare für den neuen Datensatz.

    {
      "result": {
        "upon_approval": "proceed",
        "location": "",
        "expected_start": "",
        "reopen_count": "0",
        "close_notes": "",
        "additional_assignee_list": "",
        "impact": "2",
        "urgency": "2",
        "correlation_id": "",
        "sys_tags": "",
        "sys_domain": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
          "value": "global"
        },
        "description": "",
        "group_list": "",
        "priority": "3",
        "delivery_plan": "",
        "sys_mod_count": "0",
        "work_notes_list": "",
        "business_service": "",
        "follow_up": "",
        "closed_at": "",
        "sla_due": "",
        "delivery_task": "",
        "sys_updated_on": "2016-01-22 14:28:24",
        "parent": "",
        "work_end": "",
        "number": "INC0010002",
        "closed_by": "",
        "work_start": "",
        "calendar_stc": "",
        "category": "inquiry",
        "business_duration": "",
        "incident_state": "1",
        "activity_due": "",
        "correlation_display": "",
        "company": "",
        "active": "true",
        "due_date": "",
        "assignment_group": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user_group/287ebd7da9fe198100f92cc8d1d2154e",
          "value": "287ebd7da9fe198100f92cc8d1d2154e"
        },
        "caller_id": "",
        "knowledge": "false",
        "made_sla": "true",
        "comments_and_work_notes": "",
        "parent_incident": "",
        "state": "1",
        "user_input": "",
        "sys_created_on": "2016-01-22 14:28:24",
        "approval_set": "",
        "reassignment_count": "0",
        "rfc": "",
        "child_incidents": "0",
        "opened_at": "2016-01-22 14:28:24",
        "short_description": "Unable to connect to office wifi",
        "order": "",
        "sys_updated_by": "admin",
        "resolved_by": "",
        "notify": "1",
        "upon_reject": "cancel",
        "approval_history": "",
        "problem_id": "",
        "work_notes": "",
        "calendar_duration": "",
        "close_code": "",
        "sys_id": "c537bae64f411200adf9f8e18110c76e",
        "approval": "not requested",
        "caused_by": "",
        "severity": "3",
        "sys_created_by": "admin",
        "resolved_at": "",
        "assigned_to": "",
        "business_stc": "",
        "wf_activity": "",
        "sys_domain_path": "/",
        "cmdb_ci": "",
        "opened_by": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user/6816f79cc0a8016401c5a33be04be441",
          "value": "6816f79cc0a8016401c5a33be04be441"
        },
        "subcategory": "",
        "rejection_goto": "",
        "sys_class_name": "incident",
        "watch_list": "",
        "time_worked": "",
        "contact_type": "phone",
        "escalation": "0",
        "comments": ""
      }
    }

## Tabelle -- PUT /now/table/{tableName}/{sys_ID} {#ariaid-title7}

Aktualisiert den angegebenen Datensatz mit dem Anforderungstext.

### URL-Format

Versionierte URL: /api/now/{api_Version}/table/{tableName}/{sys_ID}

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

### Unterstützte Anforderungsparameter

{#table-PUT__entry__2}{#table-PUT__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| sys_id | Eindeutiger Bezeichner des zu aktualisierenden Datensatzes. Datentyp: Zeichenfolge |
| tableName | Name der Tabelle, in der sich der Datensatz befindet. Datentyp: Zeichenfolge |
[Tabelle : 31. Pfad-Parameter]

{#table-PUT__entry__10}{#table-PUT__sysparm_view-entry-RESTAPI}

| Name | Beschreibung |
|-|-|
| Sysparm_Display_value | Bestimmt den Typ der zurückgegebenen Daten, entweder die tatsächlichen Werte aus der Datenbank oder die Anzeigewerte der Felder. Anzeigewerte werden basierend auf dem ist-Wert in der Datenbank und den Anwender- oder Systemeinstellungen und -Einstellungen geändert. Wenn Anzeigewerte zurückgegeben werden, ist der zurückgegebene Wert vom Feldtyp abhängig. * Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch beschreibender. * Datumsfelder: Der Datenbankwert hat das UTC-Format, während der Anzeigewert auf der Zeitzone des Anwenders basiert. * Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der angezeigte Wert basierend auf dem Verschlüsselungskontext des Anwenders unverschlüsselt ist. * Referenzfelder: Der Datenbankwert ist sys_ID, der Anzeigewert ist jedoch ein Anzeigefeld des referenzierten Datensatzes. Datentyp: Zeichenfolge Gültige Werte: * Wahr: Gibt die Anzeigewerte für alle Felder zurück. * Falsch: Gibt die tatsächlichen Werte aus der Datenbank zurück. * Alle: Gibt sowohl ist-Werte als auch Anzeigewerte zurück. {#table-PUT__ul_vzj_1pw_pp} Standard: Falsch Hinweis: Es gibt keine bevorzugte Methode zum Festlegen dieses Parameters. Die Angabe des Anzeigewerts kann jedoch zu Leistungsproblemen führen, da er nicht direkt aus der Datenbank gelesen wird und möglicherweise auf andere Felder und Datensätze verweist. Weitere Informationen zu Anzeigewerten und ist-Werten finden Sie unter [Häufig gestellte Fragen zur Tabellen-API (KB0534905).](https://support.servicenow.com/kb_view.do?sysparm_article=KB0534905) |
| sysparm_exclude_reference_link | Kennzeichnung, die angibt, ob Tabellen-API-Links für Referenzfelder ausgeschlossen werden sollen. Gültige Werte: * Wahr: Tabellen-API-Links für Referenzfelder ausschließen. * Falsch: Tabellen-API-Links für Referenzfelder einschließen. {#table-PUT__ul_llg_cnr_tgb} Datentyp: Boolescher Wert Standard: Falsch |
| Sysparm_fields | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben. |
| sysparm_input_display_value | Kennzeichnung, die angibt, ob Feldwerte mithilfe des Anzeigewerts oder des ist-Werts festgelegt werden sollen. Gültige Werte: * Wahr: Behandelt Eingabewerte als Anzeigewerte, und sie werden so bearbeitet, dass sie ordnungsgemäß in der Datenbank gespeichert werden können. * Falsch: Behandelt Eingabewerte als ist-Werte und speichert sie ohne Manipulation in der Datenbank. {#table-PUT__ul_shq_cfx_pp} Datentyp: Boolescher Wert Standard: Falsch Hinweis: * Wenn dieser Parameter auf festgelegt ist Wahr , Achten Sie auf Eingabewerte, insbesondere Datumswerte, da diese als über die Zeitzoneneinstellung des Anwenders bereitgestellt interpretiert und in das UTC-Format umgewandelt werden. * Um den Wert eines verschlüsselten Felds festzulegen, müssen Sie diesen Parameter auf festlegen <kbd class="ph userinput">Wahr </kbd>. Wenn dieser Parameter nicht auf „wahr" festgelegt ist, werden an verschlüsselte Felder übermittelte Werte nicht gespeichert. Darüber hinaus muss der anfordernde Anwender über den entsprechenden Verschlüsselungskontext verfügen, bevor die Anforderung übermittelt wird. Verschlüsselte Felder werden für Anwender ohne den entsprechenden Verschlüsselungskontext ausgeblendet. Weitere Informationen zu Anzeigewerten und ist-Werten finden Sie unter [Tabellen-API -- häufig gestellte Fragen (KB0534905)](https://support.servicenow.com/kb_view.do?sysparm_article=KB0534905). Weitere Informationen zur Feldverschlüsselung finden Sie unter [Field Encryption](https://www.servicenow.com/docs/access?context=field-encryption&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). {#table-PUT__ul_sn1_ffx_pp} |
| sysparm_query_no_domain | Kennzeichnung, die angibt, ob die Datensatzsuche auf die Domänen beschränkt werden soll, für die der angemeldete Anwender konfiguriert ist. Gültige Werte: * Falsch: Schließen Sie den Datensatz aus, wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann. * Wahr: Schließen Sie den Datensatz ein, auch wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann. {#table-PUT__ul_pxp_3c1_3nb} Datentyp: Boolescher Wert Standard: Falsch Hinweis: Die sysparm_query_no_domainDer Parameter ist nur für Systemadministratoren oder Anwender mit der Rolle „query_no_domain_table_api" verfügbar. |
| sysparm_view | UI-Ansicht, für die die Daten gerendert werden sollen. Bestimmt die in der Antwort zurückgegebenen Felder. Gültige Werte: * Desktop * Mobile * both {#table-PUT__ul_wr5_5xl_tgb} Wenn Sie auch angeben sysparm_fieldsParameter, hat Vorrang. Datentyp: Zeichenfolge |
[Tabelle : 32. Abfrageparameter]

{#table-PUT__entry__24}

| Name | Beschreibung |
|-|-|
| Name-Wert-Paare | Name-Wert-Paare für die Felder, die in der zugehörigen Tabelle aktualisiert werden sollen. Um beispielsweise die Kurzbeschreibungsdatei zu aktualisieren, geben Sie ein Name-Wert-Paar ähnlich dem folgenden ein: `--Data „{\"short_description\": \"meine Kurzbeschreibung\" }" \ `. |
[Tabelle : 33. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml. |
| X-no-response-body | Standardmäßig enthalten Antworten Textinhalte, die den geänderten Datensatz detaillieren. Legen Sie diesen Header in der Anforderung auf „wahr" fest, um den Antworttext zu unterdrücken. |
[Tabelle : 34. Anforderungskopfzeilen.]

{#table-PUT__entry__36}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 35. 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.").
{#table-PUT__entry__40}{#table-PUT__entry-200-status-code}{#table-PUT__entry-400-status-code}{#table-PUT__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. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 36. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#table-PUT__entry__48}

| Name | Beschreibung |
|-|-|
| Name-Wert-Paare | Alle Felder (nicht nur geändert) mit ihren zugehörigen Werten für die Change-Anforderung. |
[ ]

### Curl-Anforderung

Aktualisieren Sie einen Datensatz in der Incident-Tabelle.

    curl "https://instance.servicenow.com/api/now/table/incident/ef43c6d40a0a0b5700c77f9bf387afe3" \
    --request PUT \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{'assigned_to':'681b365ec0a80164000fb0b05854a0cd','urgency':'1','comments':'Elevating urgency, this is a blocking issue'}" \
    --user 'username':'password'

Die Antwort enthält die Name-Wert-Paare für den aktualisierten Datensatz.

    {
      "result": {
        "upon_approval": "proceed",
        "location": {
          "link": "https://instance.servicenow.com/api/now/table/cmn_location/108752c8c611227501d4ab0e392ba97f",
          "value": "108752c8c611227501d4ab0e392ba97f"
        },
        "expected_start": "",
        "reopen_count": "",
        "close_notes": "",
        "additional_assignee_list": "",
        "impact": "1",
        "urgency": "1",
        "correlation_id": "",
        "sys_tags": "",
        "sys_domain": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
          "value": "global"
        },
        "description": "",
        "group_list": "",
        "priority": "1",
        "delivery_plan": "",
        "sys_mod_count": "7",
        "work_notes_list": "",
        "business_service": "",
        "follow_up": "",
        "closed_at": "",
        "sla_due": "2017-07-05 05:58:24",
        "delivery_task": "",
        "sys_updated_on": "2016-01-22 14:12:37",
        "parent": "",
        "work_end": "",
        "number": "INC0000050",
        "closed_by": "",
        "work_start": "",
        "calendar_stc": "",
        "category": "hardware",
        "business_duration": "",
        "incident_state": "2",
        "activity_due": "2016-01-22 16:12:37",
        "correlation_display": "",
        "company": {
          "link": "https://instance.servicenow.com/api/now/table/core_company/31bea3d53790200044e0bfc8bcbe5dec",
          "value": "31bea3d53790200044e0bfc8bcbe5dec"
        },
        "active": "true",
        "due_date": "",
        "assignment_group": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user_group/8a5055c9c61122780043563ef53438e3",
          "value": "8a5055c9c61122780043563ef53438e3"
        },
        "caller_id": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user/5b7c200d0a640069006b3845b5d0fa7c",
          "value": "5b7c200d0a640069006b3845b5d0fa7c"
        },
        "knowledge": "false",
        "made_sla": "true",
        "comments_and_work_notes": "",
        "parent_incident": "",
        "state": "2",
        "user_input": "",
        "sys_created_on": "2015-11-02 18:05:40",
        "approval_set": "",
        "reassignment_count": "0",
        "rfc": "",
        "child_incidents": "",
        "opened_at": "2015-11-02 21:58:24",
        "short_description": "Can't access Exchange server - is it down?",
        "order": "",
        "sys_updated_by": "admin",
        "resolved_by": "",
        "notify": "1",
        "upon_reject": "cancel",
        "approval_history": "",
        "problem_id": "",
        "work_notes": "",
        "calendar_duration": "",
        "close_code": "",
        "sys_id": "ef43c6d40a0a0b5700c77f9bf387afe3",
        "approval": "not requested",
        "caused_by": "",
        "severity": "3",
        "sys_created_by": "glide.maint",
        "resolved_at": "",
        "assigned_to": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user/681b365ec0a80164000fb0b05854a0cd",
          "value": "681b365ec0a80164000fb0b05854a0cd"
        },
        "business_stc": "",
        "wf_activity": "",
        "sys_domain_path": "/",
        "cmdb_ci": {
          "link": "https://instance.servicenow.com/api/now/table/cmdb_ci/281190e3c0a8000b003f593aa3f20ca6",
          "value": "281190e3c0a8000b003f593aa3f20ca6"
        },
        "opened_by": {
          "link": "https://instance.servicenow.com/api/now/table/sys_user/glide.maint",
          "value": "glide.maint"
        },
        "subcategory": "",
        "rejection_goto": "",
        "sys_class_name": "incident",
        "watch_list": "",
        "time_worked": "",
        "contact_type": "phone",
        "escalation": "3",
        "comments": ""
      }
    }


