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


---

# Anhang-API

# Anhang-API {#ariaid-title1}

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

Die Anhang Die API stellt Endpunkte bereit, mit denen Sie Dateianhänge hochladen und abfragen können.

Sie können mit jeder Anforderung eine einzelne Datei hochladen oder abrufen.

Die Anhang Die API berücksichtigt alle Systembeschränkungen für hochgeladene Dateien, z. B. maximale Dateigröße und zulässige Anhangstypen. Sie können diese Einstellungen mithilfe der Eigenschaften steuern com.glide.attachment.max_size, Standardmäßig 1024 MB, und glide.attachment.extensions.  
Hinweis:  
Die Anhang API akzeptiert alle Inhaltstypwerte (\*/\*). Geben Sie beim Hochladen eines Anhangs den Dateiinhaltstyp an. Der Inhaltstyp wird mit Dateimetadaten gespeichert, sodass andere Tools die Datei korrekt identifizieren und analysieren können.

Das folgende Video enthält weitere Informationen zu Anhang API:


## API-Rollenanforderungen für Anhänge {#c_AttachmentAPI__section_tby_gn1_xhb}

Zum Erstellen von Anhängen der Anwenderdatensatz, der zur Authentifizierung der HTTP-Anforderung mit verwendet wird ServiceNowMuss über alle Rollen verfügen, die zum Erstellen von Anhangsdatensätzen \[sys_attachment\] erforderlich sind. Sie muss auch alle Rollen haben, die zum Lesen und Schreiben von Datensätzen in der Zieltabelle erforderlich sind, z. B. die itil-Rolle zum Hinzufügen von Anhängen zu Incident-Datensätzen.

Standardmäßig gibt es keine einzelne Rolle, mit der ein Anwender Anhänge hinzufügen kann. Sie können eine Rolle erstellen, um das Hinzufügen von Anhängen explizit zu ermöglichen, und diese Rolle dann dem Anwenderaccount zuweisen, der für die Anforderung verwendet wird.

## Anhang: LÖSCHEN SIE /now/attachment/{sys_ID} {#ariaid-title2}

Diese Methode löscht den Anhang mit einem bestimmten sys_ID-Wert.

### URL-Format {#attachment-DELETE__section_xl1_kft_2mb}

Versionierte URL: /api/now/v1/attachment/{sys_ID}

Standard-URL: /api/now/attachment/{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

{#attachment-DELETE__entry__2}

| Name | Beschreibung |
|-|-|
| sys_id | SYS_ID-Wert des zu löschenden Anhangs. Datentyp: Zeichenfolge |
[Tabelle : 1. Pfad-Parameter]

{#attachment-DELETE__entry__6}

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

{#attachment-DELETE__entry__10}

| 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.").
{#attachment-DELETE__entry__14}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 4. Anforderungskopfzeilen.]

{#attachment-DELETE__entry__18}

| 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.").
{#attachment-DELETE__entry__22}{#attachment-DELETE__entry-401-status-code}{#attachment-DELETE__entry-404-status-code}{#attachment-DELETE__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 204 | Gibt an, dass die Anforderung erfolgreich ausgeführt wurde. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#attachment-DELETE__entry__32}

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

### Curl-Anforderung

    curl "https://instance.servicenow.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5" \
    --request DELETE \
    --user 'username':'password'

    ""

## Anhang -- GET /now/attachment {#ariaid-title3}

Gibt die Metadaten für mehrere Anhänge zurück.

### URL-Format {#attachment-GET__section_efx_gw4_dmb}

Versionierte URL: api/now/v1/attachment

Standard-URL: api/now/attachment  
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

{#attachment-GET__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 7. Pfad-Parameter]

{#attachment-GET__entry__6}{#attachment-GET__row_sysparm_offset}

| Name | Beschreibung |
|-|-|
| Sysparm_limit | Grenzwert, der auf die Paginierung angewendet werden soll. Hinweis: Ungewöhnlich groß `Sysparm_limit `Werte können sich auf die Systemleistung auswirken. Datentyp: Zeichenfolge Standard: 1000 |
| Sysparm_Offset | Anzahl der Datensätze, die aus der Abfrage ausgeschlossen werden sollen. Verwenden Sie diesen Parameter, um mehr Datensätze abzurufen als in angegeben sysparm_limitParameter. Beispiel: Wenn sysparm_limitIst auf 500 festgelegt, es gibt jedoch zusätzliche Datensätze, die Sie abfragen möchten. Sie können einen angeben sysparm_offsetParameterwert von 500 zum Abrufen des zweiten Satzes von Datensätzen. Datentyp: Zeichenfolge Standard: 0 |
| Sysparm_query | Codierte Abfrage. Abfragen für Anhang API sind relativ zur Tabelle „Anhänge" \[sys_attachment\]. Beispiel: (sysparm_query=file_name=attachment.doc) Die codierte Abfrage bietet Unterstützung für Sortieren nach . Um Antworten basierend auf bestimmten Feldern zu sortieren, verwenden Sie SORTIEREN NACH Und ORDERBYDESC Klauseln in „sysparm_query". Beispiel: `Sysparm_query=ORDERBYfile_Name^ORDERBYDESCtable_Name `Ordnet die Ergebnisse zuerst in aufsteigender Reihenfolge nach Name und dann in absteigender Reihenfolge nach Tabellenname an. Datentyp: Zeichenfolge |
[Tabelle : 8. Abfrageparameter]

{#attachment-GET__entry__14}

| 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.").
{#attachment-GET__entry__18}{#attachment-GET__accept-RESTAPI}

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

{#attachment-GET__entry__22}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Inhaltstyp der Antwort. Bei Metadatenanforderungen ist dies der Inhaltstyp der Metadaten, nicht der Inhaltstyp der Anhangdateien. |
| Verknüpfen | Links zum Herunterladen der Anhänge. |
[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.").
{#attachment-GET__entry__28}{#attachment-GET__entry-200-status-code}{#attachment-GET__entry-401-status-code}{#attachment-GET__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 12. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#attachment-GET__entry__36}

| Name | Beschreibung |
|-|-|
| Zurückgegebene Informationen hängen von den ausgewählten Anhängen ab. |   |
[ ]

### Curl-Anforderung

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

    {
      "result": [
        {
          "table_sys_id": "5054b6f8c0a800060056addcf551ecf8",
          "size_bytes": "462",
          "download_link": "https://instance.service-now.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5/file",
          "sys_updated_on": "2009-05-21 04:12:21",
          "sys_id": "615ea769c0a80166001cf5f2367302f5",
          "image_height": "",
          "sys_created_on": "2009-05-21 04:12:21",
          "file_name": "blocks.swf",
          "sys_created_by": "glide.maint",
          "compressed": "true",
          "average_image_color": "",
          "sys_updated_by": "glide.maint",
          "sys_tags": "",
          "table_name": "content_block_programmatic",
          "image_width": "",
          "sys_mod_count": "0",
          "content_type": "application/x-shockwave-flash",
          "size_compressed": "485"
        }
      ]
    }

## Anhang -- RUFT /now/attachment/{sys_ID}/file AB {#ariaid-title4}

Gibt den Binärdateianhang mit einem bestimmten sys_ID-Wert zurück.

### URL-Format {#attachment-GET-file__section_apn_ybk_2mb}

Versionierte URL: /api/now/v1/attachment/{sys_ID}/file

Standard-URL: /api/now/attachment/{sys_ID}/file  
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

{#attachment-GET-file__entry__2}

| Name | Beschreibung |
|-|-|
| sys_id | SYS_ID des Anhangsdatensatzes, aus dem Binärdaten zurückgegeben werden sollen. |
[Tabelle : 13. Pfad-Parameter]

{#attachment-GET-file__entry__6}

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

{#attachment-GET-file__entry__10}

| 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.").
{#attachment-GET-file__entry__14}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Verwenden Sie beispielsweise `Image/JPEG `Oder `Bild/PNG `Dient ausschließlich zum Akzeptieren von JPEG- oder PNG-Bilddateien. Geben Sie an, um alle Bildtypen zuzulassen `Bild/* `; Um einen beliebigen Dateityp zuzulassen, geben Sie an `*/* `. Standard: \*/\* |
[Tabelle : 16. Anforderungskopfzeilen.]

{#attachment-GET-file__entry__18}

| Header | Beschreibung |
|-|-|
| X-Anhang-Metadaten | Metadaten zur zurückgegebenen Datei, z. B. Größe, Name und Dateityp. |
[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.").
{#attachment-GET-file__entry__22}{#attachment-GET-file__entry-200-status-code}{#attachment-GET-file__entry-400-status-code}{#attachment-GET-file__entry-401-status-code}{#attachment-GET-file__entry-500-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. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#attachment-GET-file__entry__32}

| Name | Beschreibung |
|-|-|
| Binärdateianhang |   |
[ ]

### Curl-Anforderung

    curl "https://instance.servicenow.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5/file" \
    --request GET \
    --header "Accept:*/*" \
    --user "username":"password"

    Binary response not shown.

## Anhang -- GET /now/attachment/{sys_ID} {#ariaid-title5}

Gibt die Metadaten für die Anhangdatei mit einem bestimmten sys_ID-Wert zurück.

### URL-Format {#attachment-GET-sys_id__section_wmy_pyj_2mb}

Versionierte URL: /api/now/v1/attachment/{sys_ID}

Standard-URL: /api/now/attachment/{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

{#attachment-GET-sys_id__entry__2}

| Name | Beschreibung |
|-|-|
| sys_id | SYS_ID des Anhangsdatensatzes, für den die Metadaten abgerufen werden sollen. |
[Tabelle : 19. Pfad-Parameter]

{#attachment-GET-sys_id__entry__6}

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

{#attachment-GET-sys_id__entry__10}

| Name | Beschreibung |
|-|-|
| Keine |   |
[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.").
{#attachment-GET-sys_id__entry__14}{#attachment-GET-sys_id__accept-RESTAPI}

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

{#attachment-GET-sys_id__entry__18}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Der Inhaltstyp der Antwort. Bei Metadatenanforderungen ist dies der Inhaltstyp der Metadaten, nicht der Inhaltstyp der Anhangdateien. |
[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.").
{#attachment-GET-sys_id__entry__22}{#attachment-GET-sys_id__entry-200-status-code}{#attachment-GET-sys_id__entry-401-status-code}{#attachment-GET-sys_id__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Gibt an, dass der angegebene Anhang nicht vorhanden ist oder der aktuelle Anwender nicht darauf zugreifen kann. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 24. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#attachment-GET-sys_id__entry__32}

| Name | Beschreibung |
|-|-|
| Metadaten, die für den angegebenen Anhang spezifisch sind. |   |
[ ]

### Curl-Anforderung

    curl "https://instance.servicenow.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

    {
      "result": {
        "table_sys_id": "5054b6f8c0a800060056addcf551ecf8",
        "size_bytes": "462",
        "download_link": "https://instance.service-now.com/api/now/attachment/615ea769c0a80166001cf5f2367302f5/file",
        "sys_updated_on": "2009-05-21 04:12:21",
        "sys_id": "615ea769c0a80166001cf5f2367302f5",
        "image_height": "",
        "sys_created_on": "2009-05-21 04:12:21",
        "file_name": "blocks.swf",
        "sys_created_by": "glide.maint",
        "compressed": "true",
        "average_image_color": "",
        "sys_updated_by": "glide.maint",
        "sys_tags": "",
        "table_name": "content_block_programmatic",
        "image_width": "",
        "sys_mod_count": "0",
        "content_type": "application/x-shockwave-flash",
        "size_compressed": "485"
      }
    }

## Anhang -- POST /now/attachment/file {#ariaid-title6}

Lädt eine angegebene Binärdatei als Anhang zu einem angegebenen Datensatz hoch.
Hinweis:  
Die anzuhängende Datei muss nach dem letzten Parameter in der übergebenen Anforderungsparameterliste angegeben werden.

### URL-Format {#attachment-POST-file__section_phs_45s_2mb}

Versionierte URL: /api/now/v1/attachment/file

Standard-URL: /api/now/attachment/file  
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

{#attachment-POST-file__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 25. Pfad-Parameter]

{#attachment-POST-file__entry__6}

| Name | Beschreibung |
|-|-|
| creation_time | Erstellungsdatum und -Uhrzeit des Anhangs. Verwenden Sie diesen Parameter, um Zeiten der Erstellung von Anhängen zu erfassen, wenn Now Mobile-AppIst offline, und der Anhang wird zu einem späteren Zeitpunkt in einen Datensatz hochgeladen. Datentyp: Zeichenfolge Standard: Das aktuelle Datum und die aktuelle Uhrzeit. |
| Encryption_context | SYS_ID eines Verschlüsselungskontextdatensatzes. Geben Sie diesen Parameter an, damit nur Anwender mit dem angegebenen Verschlüsselungskontext auf den Anhang zugreifen können. Weitere Informationen zu Verschlüsselungskontextdatensätzen finden Sie unter [Field Encryption](https://www.servicenow.com/docs/access?context=field-encryption&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). Datentyp: Zeichenfolge Standard: Die Datei wird mit dem für den Anwender zugänglichen Verschlüsselungskontext verschlüsselt, andernfalls wird die angehängte Datei nicht mit einem Verschlüsselungskontext verschlüsselt. |
| file_name | Erforderlich. Name, der dem Anhang zugewiesen werden soll. Datentyp: Zeichenfolge |
| table_name | Erforderlich. Name der Tabelle, an die die Datei angehängt werden soll. Datentyp: Zeichenfolge |
| table_sys_id | Erforderlich. SYS_ID des Datensatzes in der in angegebenen Tabelle table_nameAn die Sie die Datei anhängen möchten. Datentyp: Zeichenfolge |
[Tabelle : 26. Abfrageparameter]

{#attachment-POST-file__entry__18}

| Name | Beschreibung |
|-|-|
| \<String\> | Pfad zur Binärdatei, die an den angegebenen Datensatz angehängt werden soll. |
[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.").
{#attachment-POST-file__entry__22}{#attachment-POST-file__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Inhaltstyp der anzuhängenden Datei, z. B. Image/JPEG oder \*/\*. Dieser Header ist zum Veröffentlichen von Dateianhängen obligatorisch. |
[Tabelle : 28. Anforderungskopfzeilen.]

{#attachment-POST-file__entry__28}

| Header | Beschreibung |
|-|-|
| Standort | URL des neuen Anhangs. |
[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.").
{#attachment-POST-file__entry__32}{#attachment-POST-file__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 201 | Gibt an, dass die Abfrage erfolgreich ausgeführt wurde. |
| 400 | Gibt an, dass mindestens ein obligatorischer Parameter in der Anforderung fehlt. |
| 404 | Gibt den von angegebenen Datensatz an table_nameUnd table_sys_idParameter sind nicht vorhanden oder für den aktuellen Anwender nicht zugänglich. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 30. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#attachment-POST-file__table_kbr_qck_llb__entry__2}

| Element | Beschreibung |
|-|-|
| Ergebnis | Metadaten des angeforderten Anhangs. Datentyp: Objekt "result": { "average_image_color": "String", "compressed": "String", "content_type": "String", "created_by_name": "String", "download_link": "String", "file_name": "String", "image_height": "String", "image_width": "String", "size_bytes": "String", "size_compressed": "String", "sys_created_by": "String", "sys_created_on": "String", "sys_id": "String", "sys_mod_count": "String", "sys_tags": "String", "sys_updated_by": "String", "sys_updated_on": "String", "table_name": "String", "table_sys_id": "String", "updated_by_name": "String" } |
| Ergebnis.average_image_color | Wenn der Anhang ein Bild ist, die Summe aller Farben. Datentyp: Zeichenfolge Einheit: RGB oder Anzahl der Pixel. |
| result.compressed | Kennzeichnung, die angibt, ob die Anhangdatei komprimiert wurde. Mögliche Werte: * Wahr: Datei wurde komprimiert. * Falsch: Datei wurde nicht komprimiert. {#attachment-POST-file__ul_ev1_fmk_jlb} Datentyp: Zeichenfolge |
| Result.content_type | Inhaltstyp der zugeordneten Anhangdatei, z. B. Image oder JPEG oder Application/x-Shockwave-Flash. Datentyp: Zeichenfolge |
| Ergebnis.created_by_Name | Vollständiger Name der Entität, die die Anhangsdatei ursprünglich erstellt hat. Datentyp: Zeichenfolge |
| Ergebnis.Download_Link | URL des Anhangs auf herunterladen ServiceNowInstanz. Datentyp: Zeichenfolge |
| Ergebnis.Dateiname | Dateiname des Anhangs. Datentyp: Zeichenfolge |
| Ergebnis.Image_height | Bei einer Bilddatei die Höhe des Bildes. Datentyp: Zeichenfolge Einheit: Pixel |
| Ergebnis.Image_width | Bei einer Bilddatei die Breite des Bildes. Datentyp: Zeichenfolge Einheit: Pixel |
| Ergebnis.Größe_Byte | Größe des Anhangs. Datentyp: Zeichenfolge Einheit: Byte |
| Ergebnis.Größe_komprimiert | Größe der komprimierten Anhangdatei. Wenn die Datei nicht komprimiert ist, leer. Datentyp: Zeichenfolge Einheit: Byte |
| Ergebnis.sys_created_by | Entität, die die Anhangsdatei ursprünglich erstellt hat. Datentyp: Zeichenfolge |
| Ergebnis.sys_created_on | Datum und Uhrzeit der anfänglichen Speicherung der Anhangdatei in der Instanz. Datentyp: Zeichenfolge |
| Ergebnis.sys_ID | SYS_ID der Anhangdatei. Datentyp: Zeichenfolge |
| Ergebnis.sys_mod_count | Gibt an, wie oft die Anhangsdatei geändert wurde (in die Instanz hochgeladen). Datentyp: Zeichenfolge |
| Ergebnis.sys_Tags | Alle System-Tags, die der Anhangdatei zugeordnet sind. Datentyp: Zeichenfolge |
| Ergebnis.sys_updated_by | Entität, die die Anhangdatei zuletzt aktualisiert hat. Datentyp: Zeichenfolge |
| Ergebnis.sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung der Anhangsdatei. Datentyp: Zeichenfolge |
| Result.table_Name | Name der Tabelle, der der Anhang zugeordnet ist. Datentyp: Zeichenfolge |
| Result.table_sys_ID | SYS_ID der Tabelle, die dem Anhang zugeordnet ist. Datentyp: Zeichenfolge |
| Ergebnis.aktualisiert_by_Name | Vollständiger Name der Entität, die die Anhangsdatei zuletzt aktualisiert hat. Datentyp: Zeichenfolge |
[ ]

{#attachment-POST-file__table_kbr_qck_llb}  

### Curl-Anforderung

    curl "https://instance.servicenow.com/api/now/attachment/file?table_name=incident&table_sys_id=d71f7935c0a8016700802b64c67c11c6&file_name=Issue_screenshot" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type: image/jpeg" \
    --user "username":"password" \
    --data-binary "@ location of the file on file system"

    {
      "result": {
        "table_sys_id": "d71f7935c0a8016700802b64c67c11c6",
        "size_bytes": "36597",
        "download_link": "https://instance.servicenow.com/api/now/attachment/6ea10fe64f411200adf9f8e18110c739/file",
        "sys_updated_on": "2016-01-22 15:14:07",
        "sys_id": "6ea10fe64f411200adf9f8e18110c739",
        "image_height": "",
        "sys_created_on": "2016-01-22 15:14:07",
        "file_name": "Issue_screenshot",
        "sys_created_by": "admin",
        "compressed": "true",
        "average_image_color": "",
        "sys_updated_by": "admin",
        "sys_tags": "",
        "table_name": "incident",
        "image_width": "",
        "sys_mod_count": "0",
        "content_type": "image/jpeg",
        "size_compressed": "25130"
      }
    }

## Anhang: VERÖFFENTLICHEN SIE /now/attachment/upload {#ariaid-title7}

Lädt einen mehrteiligen Dateianhang hoch.
Die mehrteilige POST-Methode akzeptiert keine Parameter. Sie müssen den Tabellennamen und die sys_ID-Werte des Datensatzes im Formulartext angeben. Im Curl-Beispiel finden Sie ein Beispiel für eine mehrteilige Anforderung/Formulardaten.  
Wichtig:  
Wenn Sie mehrteilige POST verwenden, stellen Sie sicher, dass der Dateiinhalt nur im letzten Teil der Nachricht enthalten ist. Frühere Teile dürfen nur Metadaten wie Tabellenname und Datensatz-sys_ID enthalten

### URL-Format {#attachment-POST-upload__section_jby_v2t_2mb}

Versionierte URL: /api/now/v1/attachment/Upload

Standard-URL: /api/now/attachment/Upload  
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

{#attachment-POST-upload__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 31. Pfad-Parameter]

{#attachment-POST-upload__entry__6}

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

{#attachment-POST-upload__entry__10}

| Name | Beschreibung |
|-|-|
| Keine |   |
[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.").
{#attachment-POST-upload__entry__14}{#attachment-POST-upload__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Inhaltstyp der Anforderung. Legen Sie diesen Wert auf Multipart/Formulardaten fest, wenn Sie die Multipart-POST-Methode verwenden. |
[Tabelle : 34. Anforderungskopfzeilen.]

{#attachment-POST-upload__entry__20}

| Header | Beschreibung |
|-|-|
| Standort | URL des neuen Anhangs. |
[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.").
{#attachment-POST-upload__entry__24}{#attachment-POST-upload__entry-400-status-code}{#attachment-POST-upload__entry-401-status-code}{#attachment-POST-upload__entry-404-status-code}{#attachment-POST-upload__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 201 | Gibt an, dass die Abfrage erfolgreich ausgeführt 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. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 36. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#attachment-POST-upload__table_bbj_pfk_llb__entry__2}

| Element | Beschreibung |
|-|-|
| Ergebnis | Metadaten des angeforderten Anhangs. Datentyp: Objekt "result": { "average_image_color": "String", "compressed": "String", "content_type": "String", "created_by_name": "String", "download_link": "String", "file_name": "String", "image_height": "String", "image_width": "String", "size_bytes": "String", "size_compressed": "String", "sys_created_by": "String", "sys_created_on": "String", "sys_id": "String", "sys_mod_count": "String", "sys_tags": "String", "sys_updated_by": "String", "sys_updated_on": "String", "table_name": "String", "table_sys_id": "String", "updated_by_name": "String" } |
| Ergebnis.average_image_color | Wenn der Anhang ein Bild ist, die Summe aller Farben. Datentyp: Zeichenfolge Einheit: RGB oder Anzahl der Pixel. |
| result.compressed | Kennzeichnung, die angibt, ob die Anhangdatei komprimiert wurde. Mögliche Werte: * Wahr: Datei wurde komprimiert. * Falsch: Datei wurde nicht komprimiert. {#attachment-POST-upload__ul_ev1_fmk_jlb} Datentyp: Zeichenfolge |
| Result.content_type | Inhaltstyp der zugeordneten Anhangdatei, z. B. Image oder JPEG oder Application/x-Shockwave-Flash. Datentyp: Zeichenfolge |
| Ergebnis.created_by_Name | Vollständiger Name der Entität, die die Anhangsdatei ursprünglich erstellt hat. Datentyp: Zeichenfolge |
| Ergebnis.Download_Link | URL des Anhangs auf herunterladen ServiceNowInstanz. Datentyp: Zeichenfolge |
| Ergebnis.Dateiname | Dateiname des Anhangs. Datentyp: Zeichenfolge |
| Ergebnis.Image_height | Bei einer Bilddatei die Höhe des Bildes. Datentyp: Zeichenfolge Einheit: Pixel |
| Ergebnis.Image_width | Bei einer Bilddatei die Breite des Bildes. Datentyp: Zeichenfolge Einheit: Pixel |
| Ergebnis.Größe_Byte | Größe des Anhangs. Datentyp: Zeichenfolge Einheit: Byte |
| Ergebnis.Größe_komprimiert | Größe der komprimierten Anhangdatei. Wenn die Datei nicht komprimiert ist, leer. Datentyp: Zeichenfolge Einheit: Byte |
| Ergebnis.sys_created_by | Entität, die die Anhangsdatei ursprünglich erstellt hat. Datentyp: Zeichenfolge |
| Ergebnis.sys_created_on | Datum und Uhrzeit der anfänglichen Speicherung der Anhangdatei in der Instanz. Datentyp: Zeichenfolge |
| Ergebnis.sys_ID | SYS_ID der Anhangdatei. Datentyp: Zeichenfolge |
| Ergebnis.sys_mod_count | Gibt an, wie oft die Anhangsdatei geändert wurde (in die Instanz hochgeladen). Datentyp: Zeichenfolge |
| Ergebnis.sys_Tags | Alle System-Tags, die der Anhangdatei zugeordnet sind. Datentyp: Zeichenfolge |
| Ergebnis.sys_updated_by | Entität, die die Anhangdatei zuletzt aktualisiert hat. Datentyp: Zeichenfolge |
| Ergebnis.sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung der Anhangsdatei. Datentyp: Zeichenfolge |
| Result.table_Name | Name der Tabelle, der der Anhang zugeordnet ist. Datentyp: Zeichenfolge |
| Result.table_sys_ID | SYS_ID der Tabelle, die dem Anhang zugeordnet ist. Datentyp: Zeichenfolge |
| Ergebnis.aktualisiert_by_Name | Vollständiger Name der Entität, die die Anhangsdatei zuletzt aktualisiert hat. Datentyp: Zeichenfolge |
[ ]

{#attachment-POST-upload__table_bbj_pfk_llb}

### Mehrteilige obligatorische Werte VERÖFFENTLICHEN {#attachment-POST-upload__section_tk4_1ft_2mb}

Wenn Sie eine mehrteilige POST-Anforderung zum Hochladen eines Dateianhangs senden, fügen Sie Anhangsdaten in den Nachrichtentext und nicht in die URL-Parameter ein. Sie müssen diese Werte im Nachrichtentext angeben:{#attachment-POST-upload__table_p1v_nnj_js__entry__2}

| Wert | Beschreibung |
|-|-|
| Inhaltstyp | Inhaltstyp der Datei, der im Nachrichtentext für mehrteilige Uploads enthalten ist. Hinweis: Der Inhaltstyp muss im Dateiabschnitt der POST-Nachricht definiert werden, nicht in den Formulardaten. Ein Beispiel für eine mehrteilige Nachricht finden Sie im Beispiel für eine mehrteilige Nachricht. Datentyp: Zeichenfolge |
| table_name | Name der Tabelle, an die Sie die Datei anhängen möchten. Datentyp: Zeichenfolge |
| table_sys_id | SYS_ID des Datensatzes in der angegebenen Tabelle, an den Sie die Datei anhängen möchten. Datentyp: Zeichenfolge |
[Tabelle : 37. Obligatorische Werte]

{#attachment-POST-upload__table_p1v_nnj_js}  

### Curl-Anforderung

    curl "https://instance.servicenow.com/api/now/attachment/upload" \
    --request POST \
    --header "Accept:application/json"\
    --user "username":"password"\
    --header "Content-Type:multipart/form-data"\
     -F 'table_name=incident' \
     -F 'table_sys_id=d71f7935c0a8016700802b64c67c11c6'\
     -F 'uploadFile=@ location of the file on file system'
    \

    {
      "result": {
        "table_sys_id": "d71f7935c0a8016700802b64c67c11c6",
        "size_bytes": "36597",
        "download_link": "https://instance.service-now.com/api/now/attachment/994adbc64f511200adf9f8e18110c796/file",
        "sys_updated_on": "2016-02-02 14:00:21",
        "sys_id": "994adbc64f511200adf9f8e18110c796",
        "image_height": "",
        "sys_created_on": "2016-02-02 14:00:21",
        "file_name": "banner-CS0001345_v1_1.jpeg",
        "sys_created_by": "admin",
        "compressed": "true",
        "average_image_color": "",
        "sys_updated_by": "admin",
        "sys_tags": "",
        "table_name": "incident",
        "image_width": "",
        "sys_mod_count": "0",
        "content_type": "image/jpeg",
        "size_compressed": "25130"
      }
    }


