---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Datenklassifizierungs-API

# Datenklassifizierungs-API {#ariaid-title1}

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

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

* Weisen Sie vorhandenen Wörterbucheinträgen Datenklassifizierungen zu.
* Sucht in den 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=xanadu&pubname=xanadu-platform-security&ft:locale=en-US).

## Datenklassifizierung: GET /data_classification/getAllDataClasses {#ariaid-title2}

Gibt eine Liste aller in der aktuellen Domäne verfügbaren Datenklassifizierungen zurück.
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. Pfadparameter]

{#data_class-GET-getAllDataClasses__entry__6}

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

{#data_class-GET-getAllDataClasses__entry__10}

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

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#data_class-GET-getAllDataClasses__entry__14}{#data_class-GET-getAllDataClasses__accept-RESTAPI}

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

{#data_class-GET-getAllDataClasses__entry__18}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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]

### Parameter des Antworttexts (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 Beziehungen mit über- und untergeordneten Elementen organisiert werden. Wenn übergeordnete Datenklassifizierungen vorhanden sind, werden sie im Ergebnis identifiziert. Datentyp: Array "result": [ { "parent": {Object}, "sys_id": "String", "name": "String" } ] |
| result.parent | Eintrag für eine übergeordnete Datenklassifizierung. Datentyp: Objekt "parent": { "sys_id": "String", "name": "String" } |
| result.parent.sys_id | Sys_id der übergeordneten Datenklassifizierung aus der Datenklassifizierungstabelle \[data_classification\]. Datentyp: Zeichenfolge |
| result.parent.name | Name der übergeordneten Datenklassifizierung. Datentyp: Zeichenfolge |
| result.sys_id | Sys_id der Datenklassifizierung aus der Datenklassifizierungstabelle \[data_classification\]. Datentyp: Zeichenfolge |
| result.name | Name der Datenklassifizierung. Datentyp: Zeichenfolge |
[ ]

### 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. Pfadparameter]

{#data_class-POST-classify__entry__6}

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

{#data_class-POST-classify__entry__10}

| Name | Beschreibung |
|-|-|
| Dictionary_entries | Erforderlich. Die sys_ids der Datensätze, die Sie klassifizieren möchten. Die sys_ids stammen aus der Tabelle „Wörterbuch" \[sys_dictionary\]. Wird als kommagetrennte Liste in einer Zeichenfolge eingegeben. Datentyp: Zeichenfolge |
| data_classes | Erforderlich. Die sys_ids der Datenklassifizierungen, die Sie zuweisen möchten. Die sys_ids stammen aus der Datenklassifizierungstabelle \[data_classification\]. Wird als kommagetrennte Liste in einer Zeichenfolge eingegeben. Datentyp: Zeichenfolge |
[Tabelle : 9. Anforderungstextparameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#data_class-POST-classify__entry__16}{#data_class-POST-classify__accept-RESTAPI}{#data_class-POST-classify__content_type-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
| Content-Type | Datenformat des Anforderungstexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
[Tabelle : 10. Anforderungskopfzeilen]

{#data_class-POST-classify__entry__22}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 12. Statuscodes]

### Parameter des Antworttexts (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. Pfadparameter]

{#data_class-POST-clear__entry__6}

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

{#data_class-POST-clear__entry__10}

| Name | Beschreibung |
|-|-|
| Dictionary_entries | Erforderlich. Die sys_ids der Datensätze, aus denen Sie Klassifizierungen entfernen möchten. Die sys_ids stammen aus der Tabelle „Wörterbuch" \[sys_dictionary\]. Wird als kommagetrennte Liste in einer Zeichenfolge eingegeben. Datentyp: Zeichenfolge |
[Tabelle : 15. Anforderungstextparameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#data_class-POST-clear__entry__14}{#data_class-POST-clear__accept-RESTAPI}{#data_class-POST-clear__content_type-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
| Content-Type | Datenformat des Anforderungstexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
[Tabelle : 16. Anforderungskopfzeilen]

{#data_class-POST-clear__entry__20}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

### Parameter des Antworttexts (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. Pfadparameter]

{#data_class-POST-getClassification__entry__6}

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

{#data_class-POST-getClassification__entry__10}

| Name | Beschreibung |
|-|-|
| Dictionary_entries | Erforderlich. Die sys_ids der Datensätze, für die Sie Klassifizierungen abrufen möchten. Die sys_ids stammen aus der Tabelle „Wörterbuch" \[sys_dictionary\]. Wird als kommagetrennte Liste in einer Zeichenfolge eingegeben. Datentyp: Zeichenfolge |
[Tabelle : 21. Anforderungstextparameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#data_class-POST-getClassification__entry__14}{#data_class-POST-getClassification__accept-RESTAPI}{#data_class-POST-getClassification__content_type-RESTAPI}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
| Content-Type | Datenformat des Anforderungstexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
[Tabelle : 22. Anforderungskopfzeilen]

{#data_class-POST-getClassification__entry__20}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 23. Antwortkopfzeilen]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 24. Statuscodes]

### Parameter des Antworttexts (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 zugeordneten Datenklassifizierungen vorhanden sind, wird eine Nachricht zurückgegeben, die das Ergebnis des Vorgangs beschreibt. Datenklassifizierungen können in Beziehungen mit über- und untergeordneten Elementen organisiert werden. Wenn übergeordnete Datenklassifizierungen vorhanden sind, werden sie im Ergebnis identifiziert. Datentyp: Objekt "result": { <sys_dictionary_sys_id>: [ { "parent": {Object}, "sys_id": "String", "name": "String" } ] } |
| result.name | Name der Datenklassifizierung. Datentyp: Zeichenfolge |
| result.parent | Eintrag für eine übergeordnete Datenklassifizierung. Datentyp: Objekt "parent": { "sys_id": "String", "name": "String" } |
| result.parent.name | Name der übergeordneten Datenklassifizierung. Datentyp: Zeichenfolge |
| result.parent.sys_id | Sys_id der übergeordneten Datenklassifizierung aus der Datenklassifizierungstabelle \[data_classification\]. Datentyp: Zeichenfolge |
| result.sys_id | Sys_id der Datenklassifizierung aus der Datenklassifizierungstabelle \[data_classification\]. Datentyp: Zeichenfolge |
[ ]

### cURL-Anforderung

Rufen Sie 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"
          }
        ]
      }
    }