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


---

# Datenklassifizierungs-API

# Datenklassifizierungs-API {#ariaid-title1}

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

Die Datenklassifizierung Die API stellt Endpunkte bereit, um Daten nach Typ zu gruppieren.
Mit Datenklassifizierungs-API , Sie können:

* Weisen Sie Datenklassifizierungen vorhandenen Wörterbucheinträgen zu.
* Suchen Sie die Datenklassifizierungen für bestimmte Wörterbucheinträge.
* Entfernen Sie alle Datenklassifizierungen, die bestimmten Wörterbucheinträgen zugeordnet sind.
* Ruft eine Liste aller in der aktuellen Domäne verfügbaren Datenklassifizierungen ab.
{#data-classification-api__ul_hy2_srm_xnb}

Diese API erfordert das Plugin „Datenklassifizierung" \[com.Glide.Data_classification\].

Weitere Informationen finden Sie unter [Datenklassifizierung](https://www.servicenow.com/docs/access?context=data-classification&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).

## Datenklassifizierung: RUFT /Data_classification/getAllDataClasses AB {#ariaid-title2}

Gibt eine Liste aller Datenklassifizierungen zurück, die in der aktuellen Domäne verfügbar sind.
Erfordert die Rolle admin, Data_classification_admin oder Data_classification_Auditor.

### URL-Format

Standard-URL: /api/now/Data_classification/getAllDataClasses

### Unterstützte Anforderungsparameter

{#data_class-GET-getAllDataClasses__entry__2}

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

{#data_class-GET-getAllDataClasses__entry__6}

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

{#data_class-GET-getAllDataClasses__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.").
{#data_class-GET-getAllDataClasses__entry__14}{#data_class-GET-getAllDataClasses__accept-RESTAPI}

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

{#data_class-GET-getAllDataClasses__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.").
{#data_class-GET-getAllDataClasses__entry__22}{#data_class-GET-getAllDataClasses__entry-200-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#data_class-GET-getAllDataClasses__entry__26}

| Name | Beschreibung |
|-|-|
| Ergebnis | Ergebnis der Anforderung. Gibt die sys_ID und den Namen für jede verfügbare Datenklassifizierung zurück. Wenn keine Datenklassifizierungen vorhanden sind, wird ein leeres Array zurückgegeben. Datenklassifizierungen können in über- und untergeordneten Beziehungen organisiert werden. Wenn übergeordnete Datenklassifizierungen vorhanden sind, werden sie im Ergebnis identifiziert. Datentyp: Array von Objekten "result": [ { "name": "String", "parent": {Object}, "sys_id": "String" } ] |
| result.name | Name der Datenklassifizierung. Datentyp: Zeichenfolge |
| Ergebnis.übergeordnetes Element | Eintrag für eine übergeordnete Datenklassifizierung. Datentyp: Objekt "parent": { "name": "String", "sys_id": "String" } |
| result.parent.name | Name der übergeordneten Datenklassifizierung. Datentyp: Zeichenfolge |
| Ergebnis.parent.sys_ID | SYS_ID des übergeordneten Datensatzes der Datenklassifizierung. Datentyp: Zeichenfolge Tabelle: Datenklassifizierung \[Data_classification\] |
| Ergebnis.sys_ID | SYS_ID des Datensatzes der Datenklassifizierung. Datentyp: Zeichenfolge Tabelle: Datenklassifizierung \[Data_classification\] |
[ ]

### Curl-Anforderung

Ruft eine Liste aller verfügbaren Datenklassifizierungen ab.

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

    {
      "result": [
        {
          "parent": {
            "sys_id": "a9670fc773fc1010ae8dd21efaf6a735",
            "name": "Confidential"
          },
          "sys_id": "348107b951d71010f877f3f178e7dd0d",
          "name": "Personally identifiable information"
        },
        {
          "sys_id": "a9670fc773fc1010ae8dd21efaf6a735",
          "name": "Confidential"
        },
        {
          "sys_id": "59b7070b73fc1010ae8dd21efaf6a764",
          "name": "Restricted"
        },
        {
          "sys_id": "11d60fc773fc1010ae8dd21efaf6a744",
          "name": "Internal"
        },
        {
          "sys_id": "f5b4cf4773fc1010ae8dd21efaf6a766",
          "name": "Public"
        }
      ]
    }

## Datenklassifizierung -- POST /Data_classification/Classify {#ariaid-title3}

Weist vorhandenen Wörterbucheinträgen vordefinierte oder anwenderdefinierte Datenklassifizierungen zu.
Erfordert die Rolle admin oder Data_classification_admin.

### URL-Format

Standard-URL: /api/now/Data_classification/Classify

### Unterstützte Anforderungsparameter

{#data_class-POST-classify__entry__2}

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

{#data_class-POST-classify__entry__6}

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

{#data_class-POST-classify__entry__10}

| Name | Beschreibung |
|-|-|
| Dictionary_entry | Erforderlich. SYS_IDs der Datensätze, die Sie klassifizieren möchten. Wird als kommagetrennte Liste eingegeben, die in einer Zeichenfolge eingeschlossen ist. Tabelle: Wörterbuchtabelle \[sys_dictionary\] Datentyp: Zeichenfolge |
| Data_classes | Erforderlich. SYS_IDs der Datenklassifizierungen, die Sie zuweisen möchten. Wird als kommagetrennte Liste eingegeben, die in einer Zeichenfolge eingeschlossen ist. Tabelle: Datenklassifizierung \[Data_classification\] Datentyp: Zeichenfolge |
[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.").
{#data_class-POST-classify__entry__16}{#data_class-POST-classify__accept-RESTAPI}{#data_class-POST-classify__content_type-RESTAPI}

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

{#data_class-POST-classify__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[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.").
{#data_class-POST-classify__entry__26}{#data_class-POST-classify__entry-200-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 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)

{#data_class-POST-classify__entry__32}

| Name | Beschreibung |
|-|-|
| Ergebnis | Nachricht, die das Ergebnis des Vorgangs beschreibt. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Weist einem Wörterbucheintrag eine Datenklassifizierung zu.

    curl "https://instance.servicenow.com/api/now/data_classification/classify" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        \"dictionary_entries\": \"445de0a6dba30300efc57416bf9619b0\",
        \"data_classes\": \"40edb1f51bbcec50b92a10a61a4bcb8a\"
    }" \
    --user 'username':'password'

    {
      "result": "Successfully stored the data classification configurations"
    }

## Datenklassifizierung -- POST /Data_classification/Clear {#ariaid-title4}

Entfernt alle Datenklassifizierungen für die angegebenen Wörterbucheinträge.
Erfordert die Rolle admin oder Data_classification_admin.

### URL-Format

Standard-URL: /api/now/Data_classification/Clear

### Unterstützte Anforderungsparameter

{#data_class-POST-clear__entry__2}

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

{#data_class-POST-clear__entry__6}

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

{#data_class-POST-clear__entry__10}

| Name | Beschreibung |
|-|-|
| Dictionary_entry | Erforderlich. SYS_IDs der Datensätze, aus denen Sie Klassifizierungen entfernen möchten. Wird als kommagetrennte Liste eingegeben, die in einer Zeichenfolge eingeschlossen ist. Tabelle: Wörterbuch \[sys_dictionary\] Datentyp: Zeichenfolge |
[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.").
{#data_class-POST-clear__entry__14}{#data_class-POST-clear__accept-RESTAPI}{#data_class-POST-clear__content_type-RESTAPI}

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

{#data_class-POST-clear__entry__20}

| 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.").
{#data_class-POST-clear__entry__24}{#data_class-POST-clear__entry-200-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 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)

{#data_class-POST-clear__entry__30}

| Name | Beschreibung |
|-|-|
| Ergebnis | Nachricht, die das Ergebnis des Vorgangs beschreibt. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Löscht die Datenklassifizierungen für einen Wörterbucheintrag.

    curl "https://instance.servicenow.com/api/now/data_classification/clear" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        \"dictionary_entries\": \"445de0a6dba30300efc57416bf9619b0\"
    }" \
    --user 'username':'password'

    {
      "result": "Classifications removed for the specified dictionary entries"
    }

## Datenklassifizierung -- POST /Data_classification/getClassification {#ariaid-title5}

Ruft alle Datenklassifizierungen für die angegebenen Wörterbucheinträge ab.
Erfordert die Rolle admin, Data_classification_admin oder Data_classification_Auditor.

### URL-Format

Standard-URL: /api/now/Data_classification/getClassification

### Unterstützte Anforderungsparameter

{#data_class-POST-getClassification__entry__2}

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

{#data_class-POST-getClassification__entry__6}

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

{#data_class-POST-getClassification__entry__10}

| Name | Beschreibung |
|-|-|
| Dictionary_entry | Erforderlich. SYS_IDs der Datensätze, für die Sie Klassifizierungen abrufen möchten. Wird als kommagetrennte Liste eingegeben, die in einer Zeichenfolge eingeschlossen ist. Tabelle: Wörterbuch \[sys_dictionary\] Datentyp: Zeichenfolge |
[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.").
{#data_class-POST-getClassification__entry__14}{#data_class-POST-getClassification__accept-RESTAPI}{#data_class-POST-getClassification__content_type-RESTAPI}

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

{#data_class-POST-getClassification__entry__20}

| 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.").
{#data_class-POST-getClassification__entry__24}{#data_class-POST-getClassification__entry-200-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 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)

{#data_class-POST-getClassification__entry__30}

| Name | Beschreibung |
|-|-|
| Ergebnis | Ergebnis der Anforderung. Gibt ein JSON-Objekt zurück, das die sys_ID jedes Wörterbucheintrags mit einem Array der zugehörigen Datenklassifizierungen enthält. Wenn keine Datenklassifizierungen zugeordnet sind, wird eine Nachricht zurückgegeben, die das Ergebnis des Vorgangs beschreibt. Datenklassifizierungen können in über- und untergeordneten Beziehungen organisiert werden. Wenn übergeordnete Datenklassifizierungen vorhanden sind, werden sie im Ergebnis identifiziert. Datentyp: Objekt "result": { <sys_dictionary_sys_id>: [ { "name": "String", "parent": {Object}, "sys_id": "String" } ] } |
| result.name | Name der Datenklassifizierung. Datentyp: Zeichenfolge |
| Ergebnis.übergeordnetes Element | Eintrag für eine übergeordnete Datenklassifizierung. Datentyp: Objekt "parent": { "name": "String", "sys_id": "String" } |
| result.parent.name | Name der übergeordneten Datenklassifizierung. Datentyp: Zeichenfolge |
| Ergebnis.parent.sys_ID | SYS_ID des übergeordneten Datensatzes der Datenklassifizierung. Datentyp: Zeichenfolge Tabelle: Datenklassifizierung \[Data_classification\] |
| Ergebnis.sys_ID | SYS_ID des Datensatzes der Datenklassifizierung. Datentyp: Zeichenfolge Tabelle: Datenklassifizierung \[Data_classification\] |
[ ]

### Curl-Anforderung

Ruft die Datenklassifizierungen ab, die einem bestimmten Wörterbucheintrag zugeordnet sind.

    curl "https://instance.servicenow.com/api/now/data_classification/getClassification" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        \"dictionary_entries\": \"445de0a6dba30300efc57416bf9619b0\"
    }" \
    --user 'username':'password'

    {
      "result": {
        "445de0a6dba30300efc57416bf9619b0": [
          {
            "parent": {
              "sys_id": "a9670fc773fc1010ae8dd21efaf6a735",
              "name": "Confidential"
            },
            "sys_id": "348107b951d71010f877f3f178e7dd0d",
            "name": "Personally identifiable information"
          }
        ]
      }
    }


