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


---

# System für die API für domänenübergreifendes Identitätsmanagement (SCIM)

# System für die API für domänenübergreifendes Identitätsmanagement (SCIM) {#ariaid-title1}

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

Die System für domänenübergreifendes Identitätsmanagement (SCIM) Die API stellt Endpunkte zum Erstellen, Lesen, Aktualisieren und Löschen von Vorgängen für Anwender und Gruppen mithilfe des SCIM-Protokolls bereit.
Das SCIM-Protokoll ist ein HTTP-basiertes Protokoll auf Anwendungsebene, das auf HTTP \[ [RFC7230](https://datatracker.ietf.org/doc/html/rfc7230)\] Standard. Verwenden Sie diese API für die Bereitstellung und Verwaltung von Identitätsdaten, z. B. Anwender und Gruppen, im Web und in domänenübergreifenden Umgebungen, z. B. Enterprise-to-Cloud-Service Providern oder Cloud-Inter-Cloud-Szenarien.

Um auf diese API zuzugreifen, müssen Sie SCIM v2 aktivieren -- ServiceNow®Plugin „domänenübergreifende Identitätsverwaltung" (com.snc.integration.scim2).

## Ressourcenzuordnung

Der SCIM-Service verfügt über sechs Ressourcen:

* Anwender (Core und Erweiterung)
* Gruppe (Kern und Erweiterung)
* Unternehmen
* CostCenter
* Abteilung
* Standort

{#scim-api__ul_xp5_mjv_hrb}Die meisten Attribute in diesen SCIM-Ressourcen sind entsprechenden Feldern in einem vorhandenen zugeordnet ServiceNowTabelle. Die folgenden Tabellen definieren diese Zuordnungen. Attribute, die nicht Feldern in vorhandenen entsprechen ServiceNowTabellen sind zwei SCIM-spezifischen Tabellen zugeordnet. Weitere Informationen zu diesen Tabellen finden Sie unter [SCIM-spezifische Tabellen](https://servicenow-prod.fluidtopics.net/5knJWHJsqHs5_NJpS1ABww#scim-api "Die System für domänenübergreifendes Identitätsmanagement (SCIM) Die API stellt Endpunkte zum Erstellen, Lesen, Aktualisieren und Löschen von Vorgängen für Anwender und Gruppen mithilfe des SCIM-Protokolls bereit.").

Die SCIM-Anwenderressource hat sowohl Core-Schemas (Schema: URN:ietf:params:scim:Schemas:Core:2,0:Anwender) als auch Erweiterungsschemata (URN:ietf:params:scim:Schemas:Extension:servicenow:2,0:Anwender). Die meisten Anwender-Core- und Erweiterungsschema-Attribute sind der Anwendertabelle \[sys_user\] zugeordnet.  
{#scim-api__table_tdp_3ch_mrb__entry__2}

| SCIM-Attributname | Anwenderfeldname |
|-|-|
| aktiv | aktiv |
| Adressen.Land | country |
| addresses.default.country | country |
| addresses.home.country | country |
| Adressen.Ort | city |
| addresses.default.locality | city |
| Address.Home.locality | city |
| Address.postalCode | Postleitzahl |
| addresses.default.postalCode | Postleitzahl |
| Address.Home.postalCode | Postleitzahl |
| Adressen.Region | Staat |
| addresses.default.region | Staat |
| Address.Home.Region | Staat |
| Adressen.streetAddress | Straße |
| addresses.default.streetAddress | Straße |
| Address.Home.streetAddress | Straße |
| displayName | name |
| E-Mails.Wert | E-Mail |
| emails.default.value | E-Mail |
| E-Mails.Arbeit.Wert | E-Mail |
| ID | sys_id |
| Meta.erstellt | sys_created_on |
| Meta.lastModifiziert | sys_updated_on |
| Name.FAMILYNAME | last_name |
| Name.givenName | first_name |
| Name.HonorificPräfix | Einführung |
| Name.Mittelname | Middle_Name |
| Telefonnummern.Wert | Telefon |
| Telefonnummern.Startseite.Wert | home_phone |
| Telefonnummern.mobil.Wert | mobile_phone |
| Telefonnummern.Arbeit.Wert | Telefon |
| Bevorzugte Sprache | Preferred_language |
| Feld | Time_Zone |
| Titel | Titel |
| userName | user_name |
[Tabelle : 1. Zuordnung von Anwenderressource zu Anwendertabelle \[sys_user\]]

{#scim-api__table_tdp_3ch_mrb}  
{#scim-api__table_a32_jch_mrb__entry__2}

| SCIM-Attributname | SYS-SCIM-Anwenderfeldname |
|-|-|
| externalId | external_id |
[Tabelle : 2. Zuordnung der Anwenderressource zu SYS-SCIM-Anwendertabelle \[sys_scim_user\]]

{#scim-api__table_a32_jch_mrb}

Das erweiterte SCIM-Anwenderschema (URN:ietf:params:scim:Schemas:Extension:servicenow:2,0:Anwender) ist der Anwendertabelle \[sys_user\] zugeordnet.  
{#scim-api__table_uvm_jch_mrb__entry__2}

| SCIM-Attributname | Anwenderfeldname |
|-|-|
| company.name | company.name |
| Unternehmen.Wert | Company.sys_ID |
| costCenter.name | cost_center.name |
| Kostenstelle.Wert | Cost_Center.sys_ID |
| department.name | department.name |
| Abteilung.Wert | Abteilung.sys_ID |
| Employee-Nummer | Employee_number |
| Geschlecht | Geschlecht |
| location.name | location.name |
| Standort.Wert | Standort.sys_ID |
| manager.displayName | manager.name |
| manager.Wert | manager.sys_ID |
[Tabelle : 3. Vom Anwender erweiterte Ressource zu Anwender \[sys_user\] Tabellenzuordnung]

{#scim-api__table_uvm_jch_mrb}

Das SCIM-Gruppenressourcenschema (URN:ietf:params:scim:Schemas:Core:2,0:Group) ist der Tabelle „Gruppe" \[sys_user_Group\] zugeordnet.  
{#scim-api__table_typ_gkv_hrb__entry__2}

| SCIM-Attributname | Gruppenfeldname |
|-|-|
| displayName | name |
| ID | sys_id |
| Meta.erstellt | sys_created_on |
| Meta.lastModifiziert | sys_updated_on |
[Tabelle : 4. Gruppenressource zu Gruppentabellenzuordnung \[sys_user_Group\]]

{#scim-api__table_typ_gkv_hrb}

Der Parameter „SCIM-Gruppe externalId" ist der Tabelle „SYS-SCIM-Gruppe" \[sys_scim_Group\] zugeordnet.  
{#scim-api__table_h54_kch_mrb__entry__2}

| SCIM-Attributname | SYS-SCIM-Gruppenfeldname |
|-|-|
| externalId | external_id |
[Tabelle : 5. Gruppieren Sie die Ressource in die Tabellenzuordnung der SYS-SCIM-Gruppe \[sys_scim_Group\]]

{#scim-api__table_h54_kch_mrb}

Die SCIM-Gruppe ServiceNowErweiterungsschema (URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Group) ist der Tabelle „Gruppe" \[sys_user_Group\] zugeordnet.  
{#scim-api__table_ugn_1rn_ftb__entry__2}

| SCIM-Attributname | Gruppenfeldname |
|-|-|
| Unternehmen.Wert | Company.sys_ID |
| company.name | company.name |
[Tabelle : 6. Gruppenressource zu Gruppentabellenzuordnung \[sys_user_Group\]]

{#scim-api__table_ugn_1rn_ftb}

Das SCIM-Unternehmensressourcenschema (URN:ietf:params:scim:Schemas:custom:servicenow:2,0:Company) ist der Tabelle „Unternehmen" \[Core_Company\] zugeordnet.  
{#scim-api__table_wpv_kch_mrb__entry__2}

| SCIM-Attributname | Firmenfeldname |
|-|-|
| ID | sys_id |
| Meta.erstellt | sys_created_on |
| Meta.lastModifiziert | sys_updated_on |
| name | name |
[Tabelle : 7. Unternehmensressource zu Unternehmen \[Core_Company\] Tabellenzuordnung]

{#scim-api__table_wpv_kch_mrb}

Das Ressourcenschema „SCIM-Kostenstelle" (URN:ietf:params:scim:Schemas:custom:servicenow:2,0:Kostenstelle) ist der Tabelle „Kostenstelle" \[cmn_Cost_Center\] zugeordnet.  
{#scim-api__table_kxj_lch_mrb__entry__2}

| SCIM-Attributname | Feldname der Kostenstelle |
|-|-|
| ID | sys_id |
| Meta.erstellt | sys_created_on |
| Meta.lastModifiziert | sys_updated_on |
| name | name |
[Tabelle : 8. Kostenstellenressource zu Kostenstelle \[cmn_Cost_Center\]-Tabellenzuordnung]

{#scim-api__table_kxj_lch_mrb}

Das Ressourcenschema der SCIM-Abteilung (URN:ietf:params:scim:Schemas:custom:servicenow:2,0:Department) ist der Tabelle „Abteilung" \[cmn_Department\] zugeordnet.  
{#scim-api__table_lks_lch_mrb__entry__2}

| SCIM-Attributname | Abteilungsfeldname |
|-|-|
| ID | sys_id |
| Meta.erstellt | sys_created_on |
| Meta.lastModifiziert | sys_updated_on |
| name | name |
[Tabelle : 9. Tabellenzuordnung von Abteilungsressource zu Abteilung \[cmn_Department\]]

{#scim-api__table_lks_lch_mrb}

Das Ressourcenschema „SCIM-Standort" (URN:ietf:params:scim:Schemas:custom:servicenow:2,0:Location) ist der Tabelle „Standort" \[cmn_location\] zugeordnet.  
{#scim-api__table_snf_mch_mrb__entry__2}

| SCIM-Attributname | Feldname des Standorts |
|-|-|
| ID | sys_id |
| Meta.erstellt | sys_created_on |
| Meta.lastModifiziert | sys_updated_on |
| name | name |
[Tabelle : 10. Standortressource zu Standort \[cmn_location\]-Tabellenzuordnung]

{#scim-api__table_snf_mch_mrb}

## SCIM-spezifische Tabellen {#scim-api__SCIM_specific_tables-SCIM-table}

Zwei Tabellen, SYS-SCIM-Anwender \[sys_scim_user\] und SYS-SCIM-Gruppe \[sys_scim_Group\], enthalten die SCIM-Attribute, die nicht vorhandenen zugeordnet sind ServiceNowTabellen. Im Folgenden wird der Inhalt dieser Tabellen definiert.  
{#scim-api__table_w2h_nch_mrb__entry__2}

| Feldname | Beschreibung |
|-|-|
| Erstellt | Datum und Uhrzeit der Erstellung des zugehörigen Datensatzes. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Erstellt von | Name der Entität, die den Datensatz erstellt hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Externe ID | Externe ID, die von der Entität verwendet wird, die diesen Anwenderdatensatz erstellt hat, um auf den Anwender in ihrem System zu verweisen. Datentyp: Zeichenfolge Maximale Länge: 255 |
| Sys-ID | Eindeutiger Bezeichner für den Datensatz in einem ServiceNowInstanz. Datentyp: Zeichenfolge Maximale Länge: 32 |
| Aktualisiert | Datum und Uhrzeit der letzten Aktualisierung des zugeordneten Datensatzes. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Aktualisiert von | Name der Entität, die den zugeordneten Datensatz zuletzt aktualisiert hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Updates | Anzahl der Aktualisierungen des Datensatzes. Datentyp: Zahl (Ganzzahl) Maximale Länge: 40 |
| Anwender | Verweis auf den Anwender, der diesem Datensatz zugeordnet ist Referenz: Anwendertabelle \[sys_user\] Maximale Länge: 32 |
| Anwendertyp | Typ des Anwenderdatensatzes. Dieser Wert wird verwendet, um die Beziehung zwischen Organisation und Anwender zu identifizieren. Dies kann ein beliebiger Wert sein, typische Werte können jedoch Folgendes sein: * Vertragsunternehmen * Mitarbeiter * Extern * Praktikanten * Temp * Unbekannt {#scim-api__ul_kdr_nwz_nrb} Datentyp: Zeichenfolge Maximale Länge: 40 |
[Tabelle : 11. SYS-SCIM-Anwendertabelle \[sys_scim_user\]]

{#scim-api__table_w2h_nch_mrb}  
{#scim-api__table_mpt_nch_mrb__entry__2}

| Feldname | Beschreibung |
|-|-|
| Erstellt | Datum und Uhrzeit der Erstellung des zugehörigen Datensatzes. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Erstellt von | Name der Entität, die den Datensatz erstellt hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Externe ID | Externe ID, die von der Entität verwendet wird, die diesen Gruppendatensatz erstellt hat, um auf die Gruppe in ihrem System zu verweisen. Datentyp: Zeichenfolge Maximale Länge: 255 |
| Gruppe | Verweis auf die Gruppe, die diesem Datensatz zugeordnet ist. Referenz: Gruppe \[sys_user_Group\]-Tabelle Maximale Länge: 32 |
| Sys-ID | Eindeutiger Bezeichner für den Datensatz in einem ServiceNowInstanz. Datentyp: Zeichenfolge Maximale Länge: 32 |
| Aktualisiert | Datum und Uhrzeit der letzten Aktualisierung des zugeordneten Datensatzes. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Aktualisiert von | Name der Entität, die den zugeordneten Datensatz zuletzt aktualisiert hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Updates | Anzahl der Aktualisierungen des Datensatzes. Datentyp: Zahl (Ganzzahl) Maximale Länge: 40 |
[Tabelle : 12. Tabelle der SYS-SCIM-Gruppe \[sys_scim_Group\]]

{#scim-api__table_mpt_nch_mrb}

## Rollen und Zugriffssteuerungslisten

Die Rolle scim_admin ist erforderlich, um auf die SCIM-spezifischen Tabellen und die privaten SCIM-Endpunkte zuzugreifen, und ermöglicht den Zugriff auf die Tabellen Anwender \[sys_user\] und Gruppe \[sys_user_Group\].

Der SCIM-Service verfügt über vier ACLs für den Zugriff auf die Tabelle „SYS-SCIM-Anwender" \[sys_scim_user\] und die Tabelle „SYS-scim-Gruppe" \[sys_scim_Group\], die das Erstellen, Löschen, Lesen und Schreiben ermöglichen. Diese ACLs sind nur der Rolle „scim_admin" zugeordnet.

## SCIM: LÖSCHEN SIE /scim/Groups/{Group_ID} {#ariaid-title2}

Löscht den angegebenen Gruppendatensatz aus der Gruppentabelle \[sys_user_Group\] von ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Groups/{Group_ID}

Standard-URL: /api/now/scim/Groups/{Group_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

{#scim-DELETE-Groups-group_id__entry__2}{#scim-DELETE-Groups-group_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 |
| group_id | SYS_ID des zu löschenden Gruppendatensatzes. Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
[Tabelle : 13. Pfad-Parameter]

{#scim-DELETE-Groups-group_id__entry__8}

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

{#scim-DELETE-Groups-group_id__entry__12}

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

### Header

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

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

{#scim-DELETE-Groups-group_id__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.").
{#scim-DELETE-Groups-group_id__entry__24}{#scim-DELETE-Groups-group_id__entry-200-status-code}{#scim-DELETE-Groups-group_id__entry-404-status-code}

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

### Antworttext-Parameter (JSON)

{#scim-DELETE-Groups-group_id__entry__30}{#scim-DELETE-Groups-group_id__errors-SCIM-entry}{#scim-DELETE-Groups-group_id__errors_details-SCIM-entry}{#scim-DELETE-Groups-group_id__errors_scimType-SCIM-entry}{#scim-DELETE-Groups-group_id__errors_schemas-SCIM-entry}{#scim-DELETE-Groups-group_id__errors_status-SCIM-entry}

| Name | Beschreibung |
|-|-|
| Fehler | Antwort, die alle Fehler beschreibt, die während der Verarbeitung der Anforderung aufgetreten sind. Datentyp: Objekt "errors": { "details": "String", "schemas": "String", "scimType": "String", "status": "String" } |
| errors.detail | Detaillierte Fehlermeldung, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Fehler.scimType | SCIM-Fehlerdetailstichwort. Datentyp: Zeichenfolge |
| Fehler.Schemas | URI der SCIM-Schemata, die zur Verarbeitung der Fehlerantwort verwendet werden. Datentyp: Array von Zeichenfolgen |
| Fehler.Status | HTTP-Statuscode für die Fehlerantwort. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung zum Löschen einer Gruppe

Dieses Beispiel zeigt, wie ein Gruppendatensatz aus der Tabelle „Gruppe" \[sys_user_Group\] gelöscht wird.

    curl "https://instance-servicenow.com/api/now/scim/Groups/a0a9e9fb1b7e3010593876a61a4bcbe0" \
    --request DELETE \
    --header "Accept:application/scim+json" \

## SCIM -- GET /scim/Groups {#ariaid-title3}

Gibt einen oder mehrere Gruppendatensätze aus der Tabelle „Gruppe" \[sys_user_Group\] in einem zurück ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.
Hinweis:  
Eine Abfrage, die keine Übereinstimmungen zurückgibt, gibt Erfolg (HTTP-Statuscode 200) mit zurück totalResultsAuf 0 festlegen.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Groups

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

{#scim-GET-Groups__entry__2}{#scim-GET-Groups__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 |
[Tabelle : 19. Pfad-Parameter]

{#scim-GET-Groups__entry__6}{#scim-GET-Groups__attributes-SCIM-entry}{#scim-GET-Groups__count-SCIM-entry}{#scim-GET-Groups__excludedAttributes-SCIM-entry}{#scim-GET-Groups__filter-SCIM-ph}{#scim-GET-Groups__group_sortBy-SCIM-entry}{#scim-GET-Groups__sortOrder-SCIM-entry}{#scim-GET-Groups__group_startIndex-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| count | Anzahl der zurückzugebenden Datensätze. Ein negativer Wert wird als Null interpretiert. Datentyp: Zahl Maximum: 500 -- Ein Wert größer als dieser führt zu einem Fehler bei ungültigen Anforderungen. Standard: 10 |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
| Filter | Filterausdruck, der auf die Rückgabeergebnisse angewendet werden soll. Feldfilter werden als ausgedrückt `<field_name> <operator> <„value"> `. Siehe [RFC7644](https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2)Für eine Liste der gültigen Operatoren. Hinweis: Die `NICHT `Operator wird von dieser Methode nicht unterstützt. Um beispielsweise nach allen Gruppen zu filtern, deren Name mit „HR" beginnt, geben Sie ein `DisplayName SW „HR" `. Um mehr als einen Feldfilter anzugeben, verketten Sie die Filter mit `UND `Operand. Um beispielsweise nach allen Gruppen zu filtern, deren Name mit „HR" beginnt und zuletzt vor dem 3. Oktober 2021 geändert wurden, geben Sie ein `DisplayName SW „HR" UND Meta.lastModified LT „2021-10-33T00:00:00Z" `. Verwenden Sie Dot-Walking, um geschachtelte Attribute anzugeben. Nur die folgenden SCIM-Gruppenfelder sind zur Verwendung in Filtern verfügbar: * displayName * ExternalID: Nur unterstützt `EQ `Operator. * ID * Meta.erstellt * Meta.lastModifiziert {#scim-GET-Groups__ul_szc_2cc_grb} Datentyp: Zeichenfolge Standard: Keine Filterung |
| sortBy | Muss mit angegeben werden sortOrderParameter. Feld, nach dem die Rückgabeergebnisse sortiert werden sollen. Bei der Sortierung wird zwischen Groß- und Kleinschreibung unterschieden. Sie können nur die Parameter verwenden, die zum Filtern für verfügbar sind sortByParameter, außer dem externalIdIst nicht zulässig. Für Werte, die null sind: * Aufsteigend sortiert: Null-Werte werden nach oben sortiert. * Sortiert nach absteigend: Null-Werte werden nach unten sortiert. {#scim-GET-Groups__ul_xsb_zmm_hrb} Datentyp: Zeichenfolge Standard: Keine Sortierung |
| sortOrder | Muss mit angegeben werden sortByParameter. Reihenfolge, in der sortByParameter wird auf die Rückgabeergebnisse angewendet. Gültige Werte: * Aufsteigend * Absteigend {#scim-GET-Groups__ul_mmn_zrc_grb} Datentyp: Zeichenfolge Standard: Aufsteigend |
| startIndex | Einbasierter Index in der Tabelle, bei der mit dem Abrufen von Datensätzen begonnen werden soll. Beispiel: Wenn Sie diesen Parameter auf 100 und festlegen countParameter für 20. Der Endpunkt gibt Datensätze 100 bis 119 zurück. Hinweis: Jeder Wert, der auf weniger als einen festgelegt ist, wird als einer interpretiert. Datentyp: Zeichenfolge Standard: 1 |
[Tabelle : 20. Abfrageparameter]

{#scim-GET-Groups__entry__22}

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

### Header

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

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

{#scim-GET-Groups__entry__30}

| 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.").
{#scim-GET-Groups__entry__34}{#scim-GET-Groups__entry-200-status-code}{#scim-GET-Groups__status_400-SCIM-entry}{#scim-GET-Groups__entry-401-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. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben. * Stellen Sie sicher, dass countParameter ist nicht größer als 500. * Stellen Sie sicher, dass alle filterParameter sind gültig. {#scim-GET-Groups__ul_vn1_gvz_nrb} |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
[Tabelle : 24. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-GET-Groups__entry__42}{#scim-GET-Groups__itemsPerPage-SCIM-entry}{#scim-GET-Groups__totalResults-SCIM-entry}

| Name | Beschreibung |
|-|-|
| ItemsPerPage | Anzahl der in den Rückgabeergebnissen zurückgegebenen Datensätze. Datentyp: Zahl |
| Ressourcen | Liste der Gruppendatensätze. Datentyp: Array von Objekten "Resources": [ { "company": {Object}, "displayName": "String", "externalId": "String", "id": "String", "meta": [Array] } ] |
| Resources.company | Details zum Unternehmen oder zur Organisation der Gruppe. Datentyp: Objekt "company": { "display": "String", "$ref": "String", "value": "String" } |
| Resources.company.display | Name des Unternehmens. Datentyp: Zeichenfolge |
| Resources.company.$ref | Referenz-URI des Unternehmens. Format: `<host>/Unternehmen/<company sys_id> `, Z. B.: `http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63 `. Datentyp: Zeichenfolge |
| Resources.company.value | SYS_ID des zugeordneten Unternehmens. Datentyp: Zeichenfolge |
| Resources.displayName | Visuell lesbarer Name der Gruppe, z. B. HR-Team. Datentyp: Zeichenfolge |
| Resources.externalId | Eindeutiger Bezeichner, der der Gruppe von der Entität zugewiesen wurde, die sie bereitstellt. Datentyp: Zeichenfolge |
| Resources.ID | SYS_ID der Gruppe. Datentyp: Zeichenfolge |
| Ressourcen.Meta | Metadaten, die zur Gruppe gehören. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": String", "resourceType": String" } |
| Resources.Meta.erstellt | Datum und Uhrzeit der Erstellung des Gruppendatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des Gruppendatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.location | URI der abgerufenen Gruppe. Datentyp: Zeichenfolge |
| Resources.Meta.resourceType | Ressourcentyp der SCIM-Gruppen. Datentyp: Zeichenfolge |
| Ressourcen.Mitglieder | Liste der Anwender und Gruppen, die der Gruppe zugeordnet sind. Datentyp: Array von Objekten "members": [ { "display": "String", "value": "String", "$ref": "String" } ] |
| Resources.members.Display | Name des zugeordneten Gruppenmitglieds. Datentyp: Zeichenfolge |
| Resources.members.value | SYS_ID des zugeordneten Anwender- oder Gruppendatensatzes. Datentyp: Zeichenfolge |
| Resources.members.$ref | URI des zugeordneten Gruppenmitglieds. Datentyp: Zeichenfolge |
| Resources.Schemas | Liste der URIs der SCIM-Gruppenschemas, die zur Verarbeitung der Anforderung verwendet werden. Unterstützte Gruppenschemas: * URN:ietf:params:scim:Schemas:Core:2,0:Gruppe: Kernschema, das im Taskforce-System für Internet-Engineering für domänenübergreifende Identitätsverwaltung angegeben ist: Kernschemadokument ( <https://datatracker.ietf.org/doc/html/rfc7643#section-4.2>) * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Gruppe -- ServiceNowErweiterungsschema. Dieses Schema enthält Attribute, die in der Tabelle „Gruppen" \[sys_user_Group\] in einer Basis vorhanden sind ServiceNowSystem, sind aber nicht Teil des Kernschemas. * URN:ietf:params:scim:Schemas:Extension:servicenow:custom:2,0:Gruppe" -- Anwenderdefiniertes Erweiterungsschema. Dieses Schema ist Teil des resourceType „Gruppe" in der sys_scim_schema_extension-Tabelle. Wenn das Schema nicht aktiv ist, wird die Schema-URN in der Antwort nicht zurückgegeben. {#scim-GET-Groups__ul_ckx_x3t_2tb} Datentyp: Array von Zeichenfolgen |
| Schemas | Liste der URIs der SCIM-Listenantwortschemata, die zur Verarbeitung der Anforderung verwendet werden. Datentyp: Array |
| startIndex | Einbasierter Index in der Gruppentabelle \[sys_user_Group\], bei dem der Endpunkt mit dem Abrufen von Datensätzen begonnen hat. Datentyp: Zahl |
| Gesamtergebnisse | Gesamtanzahl der Datensätze, die der Anforderung entsprechen. Datentyp: Zahl |
[ ]

### Curl-Anforderung für mehrere Gruppen

Dieses Beispiel zeigt, wie mehrere Gruppen (in diesem Fall vier) mit angefordert werden countParameter.

    curl "https://instance-sevicenow.com/api/now/scim/Groups?count=4" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {"schemas":
      ["urn:ietf:params:scim:api:messages:2.0:ListResponse"],
      "totalResults":44,
      "Resources":[
        {"schemas":
          [
            "urn:ietf:params:scim:schemas:core:2.0:Group"",
            "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group",
            "urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group"
          ],
          "id":"019ad92ec7230010393d265c95c260dd",
          "meta":{
            "resourceType":"Group",
            "created":"2020-03-17T11:39:14Z",
            "lastModified":"2020-03-17T11:39:14Z",
            "location":"https://instance-sevicenow.com/api/now/scim/Groups/019ad92ec7230010393d265c95c260dd"
          },
          "displayName":"Analytics Settings Managers"
        },
        {"schemas":
          [
            "urn:ietf:params:scim:schemas:core:2.0:Group"",
            "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group",
            "urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group"
          ],
          "id":"0a52d3dcd7011200f2d224837e6103f2",
          "meta":{
            "resourceType":"Group",
            "created":"2021-09-29T16:42:02Z",
            "lastModified":"2021-09-29T16:42:02Z",
            "location":"https://instance-sevicenow.com/api/now/scim/Groups/0a52d3dcd7011200f2d224837e6103f2"
          },
          "displayName":"Application Development",
          "members":[
            {
              "value":"dc6053dcd7011200f2d224837e6103e0",
              "display":"John Doe",
              "$ref": "http://instance-sevicenow.com/api/now/scim/Users/dc6053dcd7011200f2d224837e6103e0"
            },
            {
              "value":"443193dcd7011200f2d224837e61037d",
              "display":"Abel Tutor",
              "$ref": "http://instance-sevicenow.com/api/now/scim/Users/443193dcd7011200f2d224837e61037d"
            }
          ],
          "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group": {
            "company": {
              "value": "81fd65ecac1d55eb42a426568fc87a63",
              "name": "ACME Japan",
              "$ref": "http://instance-sevicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63"
            }
          }
        },
        {"schemas":
          [
            "urn:ietf:params:scim:schemas:core:2.0:Group"",
            "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group",
            "urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group"
          ],
          "id":"0c4e7b573b331300ad3cc9bb34efc461",
          "meta":{
            "resourceType":"Group",
            "created":"2021-09-29T05:11:33Z",
            "lastModified":"2021-09-29T05:11:33Z",
            "location":"instance-sevicenow.com/api/now/scim/Groups/0c4e7b573b331300ad3cc9bb34efc461"
          },
          "displayName":"Problem Analyzers",
          "members":[
            {
              "value":"d3dbbf173b331300ad3cc9bb34efc466",
              "display":"Problem Manager",
              "$ref": "http://instance-sevicenow.com/api/now/scim/Users/babb4639b76233004fbc2089ee11a97f"
            },
            {
              "value":"38cb3f173b331300ad3cc9bb34efc4d6",
              "display":"Problem Coordinator B",
              "$ref": "http://instance-sevicenow.com/api/now/scim/Users/cbcc4639b76233004fbc2089ee111047"
            },
            {
              "value":"26fbff173b331300ad3cc9bb34efc4bd",
              "display":"Problem Administrator",
              "$ref": "http://instance-sevicenow.com/api/now/scim/Users/45324639b76232189fbc2089ee11bc34"
            }
          ],
          "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group": {
            "company": {
              "value": "913465ecac1d569b42a426568fc88af3",
              "name": "ACME London",
              "$ref": "http://instance-sevicenow.com/api/now/scim/Companies/913465ecac1d569b42a426568fc88af3"
            }
          }
        },
        {"schemas":
          [
            "urn:ietf:params:scim:schemas:core:2.0:Group"",
            "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group",
            "urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group"
          ],
          "id":"0c5e2a7ce4001410f877ce457cda6b98",
          "meta":{
            "resourceType":"Group",
            "created":"2020-04-06T03:47:08Z",
            "lastModified":"2020-07-29T04:02:26Z",
            "location":"instance-sevicenow.com/api/now/scim/Groups/0c5e2a7ce4001410f877ce457cda6b98"
          },
          "displayName":"Business Application Registration Approval Group"
        }
      ],
      "startIndex":1,
      "itemsPerPage":4
    }

### Curl-Anforderung für mehrere Gruppen mit excludedAttributes

Dieses Beispiel zeigt, wie mehrere Gruppen (in diesem Fall vier) mit angefordert werden countParameter und ohne die Meta- und Mitgliederfelder.

    curl "https://instance-sevicenow.com/api/now/scim/Groups?excludedAttributes=meta%2C%20members&count=4" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {"schemas":
      ["urn:ietf:params:scim:api:messages:2.0:ListResponse"],
      "totalResults":44,
      "Resources":[
        {"schemas":
          [
            "urn:ietf:params:scim:schemas:core:2.0:Group"",
            "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group",
            "urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group"
          ],
          "id":"019ad92ec7230010393d265c95c260dd",
          "displayName":"Analytics Settings Managers",
          "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group": {
            "company": {
              "value": "913465ecac1d569b42a426568fc88af3",
              "name": "ACME London",
              "$ref": "http://instance-sevicenow.com/api/now/scim/Companies/913465ecac1d569b42a426568fc88af3"
            }
          }
        },
        {"schemas":
          [
            "urn:ietf:params:scim:schemas:core:2.0:Group"",
            "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group",
            "urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group"
          ],
          "id":"0a52d3dcd7011200f2d224837e6103f2",
          "displayName":"Application Development"
        },
        {"schemas":
          [
            "urn:ietf:params:scim:schemas:core:2.0:Group"",
            "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group",
            "urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group"
          ],
          "id":"0c4e7b573b331300ad3cc9bb34efc461",
          "displayName":"Problem Analyzers"
        },
        {"schemas":
          [
            "urn:ietf:params:scim:schemas:core:2.0:Group"",
            "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group",
            "urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group"
          ],
          "id":"0c5e2a7ce4001410f877ce457cda6b98",
          "displayName":"Business Application Registration Approval Group",
          "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group": {
            "company": {
              "value": "81fd65ecac1d55eb42a426568fc87a63",
              "name": "ACME Japan",
              "$ref": "http://instance-sevicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63"
            }
          }
        }
      ],
      "startIndex":1,
      "itemsPerPage":4
    }

## SCIM -- GET /scim/Groups/{Group_ID} {#ariaid-title4}

Gibt den angegebenen Gruppendatensatz aus der Gruppentabelle \[sys_user_Group\] in zurück ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Groups/{Group_ID}

Standard-URL: /api/now/scim/Groups/{Group_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

{#scim-GET-Groups-group_id__entry__2}{#scim-GET-Groups-group_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 |
| group_id | SYS_ID des zurückzugebenden Gruppendatensatzes. |
[Tabelle : 25. Pfad-Parameter]

{#scim-GET-Groups-group_id__entry__8}{#scim-GET-Groups-group_id__attributes-SCIM-entry}{#scim-GET-Groups-group_id__excludedAttributes-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
[Tabelle : 26. Abfrageparameter]

{#scim-GET-Groups-group_id__entry__14}

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

### Header

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

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

{#scim-GET-Groups-group_id__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[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.").
{#scim-GET-Groups-group_id__entry__26}{#scim-GET-Groups-group_id__entry-200-status-code}{#scim-GET-Groups-group_id__status_400-SCIM-entry}{#scim-GET-Groups-group_id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben. * Stellen Sie sicher, dass countParameter ist nicht größer als 500. * Stellen Sie sicher, dass alle filterParameter sind gültig. {#scim-GET-Groups-group_id__ul_vn1_gvz_nrb} |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 30. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-GET-Groups-group_id__id_uwk_c5c_grb__entry__2}{#scim-GET-Groups-group_id__group_company-SCIM-entry}{#scim-GET-Groups-group_id__group_company_display-SCIM-entry}{#scim-GET-Groups-group_id__group_company_ref-SCIM-entry}{#scim-GET-Groups-group_id__group_company_value-SCIM-entry}{#scim-GET-Groups-group_id__group_displayName-SCIM-entry}{#scim-GET-Groups-group_id__group_externalId-SCIM-entry}{#scim-GET-Groups-group_id__group_id-SCIM-entry}{#scim-GET-Groups-group_id__group_meta-SCIM-entry}{#scim-GET-Groups-group_id__group_meta_created-SCIM-entry}{#scim-GET-Groups-group_id__group_meta_lastModified-SCIM-entry}{#scim-GET-Groups-group_id__group_meta_location-SCIM-entry}{#scim-GET-Groups-group_id__group_meta_resourceType-SCIM-entry}{#scim-GET-Groups-group_id__group_members-SCIM-entry}{#scim-GET-Groups-group_id__group_members_display-SCIM-entry}{#scim-GET-Groups-group_id__group_members_value-SCIM-entry}{#scim-GET-Groups-group_id__group_members_ref-SCIM-entry}{#scim-GET-Groups-group_id__group_schemas-SCIM-entry}

| Name | Beschreibung |
|-|-|
| Unternehmen | Details zum Unternehmen oder zur Organisation der Gruppe. Datentyp: Objekt "company": { "display": "String", "$ref": "String", "value": "String" } |
| Unternehmen.Anzeige | Name des Unternehmens. Datentyp: Zeichenfolge |
| Unternehmen.$ref | Referenz-URI des Unternehmens. Format: `<host>/Unternehmen/<company sys_id> `, Z. B.: `http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63 `. Datentyp: Zeichenfolge |
| Unternehmen.Wert | SYS_ID des zugeordneten Unternehmens. Datentyp: Zeichenfolge |
| displayName | Visuell lesbarer Name der Gruppe, z. B. HR-Team. Datentyp: Zeichenfolge |
| externalId | Eindeutiger Bezeichner, der der Gruppe von der Entität zugewiesen wurde, die sie bereitstellt. Datentyp: Zeichenfolge |
| ID | SYS_ID der Gruppe. Datentyp: Zeichenfolge |
| Meta | Metadaten, die zur Gruppe gehören. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": String", "resourceType": String" } |
| Meta.erstellt | Datum und Uhrzeit der Erstellung des Gruppendatensatzes. Datentyp: Zeichenfolge |
| Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des Gruppendatensatzes. Datentyp: Zeichenfolge |
| Meta.Standort | URI der abgerufenen Gruppe. Datentyp: Zeichenfolge |
| Meta.resourceType | Ressourcentyp der SCIM-Gruppen. Datentyp: Zeichenfolge |
| Mitglieder | Liste der Anwender und Gruppen, die der Gruppe zugeordnet sind. Datentyp: Array von Objekten "members": [ { "display": "String", "value": "String", "$ref": "String" } ] |
| Members.Display | Name des zugeordneten Gruppenmitglieds. Datentyp: Zeichenfolge |
| Members.value | SYS_ID des zugeordneten Anwender- oder Gruppendatensatzes. Datentyp: Zeichenfolge |
| Mitglieder.$ref | URI des zugeordneten Gruppenmitglieds. Datentyp: Zeichenfolge |
| Schemas | Liste der URIs der SCIM-Gruppenschemas, die zur Verarbeitung der Anforderung verwendet werden. Unterstützte Gruppenschemas: * URN:ietf:params:scim:Schemas:Core:2,0:Gruppe: Kernschema, das im Taskforce-System für Internet-Engineering für domänenübergreifende Identitätsverwaltung angegeben ist: Kernschemadokument ( <https://datatracker.ietf.org/doc/html/rfc7643#section-4.2>) * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Gruppe -- ServiceNowErweiterungsschema. Dieses Schema enthält Attribute, die in der Tabelle „Gruppen" \[sys_user_Group\] in einer Basis vorhanden sind ServiceNowSystem, sind aber nicht Teil des Kernschemas. * URN:ietf:params:scim:Schemas:Extension:servicenow:custom:2,0:Gruppe" -- Anwenderdefiniertes Erweiterungsschema. Dieses Schema ist Teil des resourceType „Gruppe" in der sys_scim_schema_extension-Tabelle. Wenn das Schema nicht aktiv ist, wird die Schema-URN in der Antwort nicht zurückgegeben. {#scim-GET-Groups-group_id__ul_ckx_x3t_2tb} Datentyp: Array von Zeichenfolgen |
[ ]

{#scim-GET-Groups-group_id__id_uwk_c5c_grb}  

### Curl-Anforderung für bestimmte Gruppe

Dieses Beispiel zeigt, wie ein bestimmter Gruppendatensatz abgerufen wird.

    curl "https://instance-servicenow.com/api/now/scim/Groups/e0140d671bbe3010593876a61a4bcb11" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {"schemas":
      [
        "urn:ietf:params:scim:schemas:core:2.0:Group",
        "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group",
        "urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group"
      ],
      "id":"e0140d671bbe3010593876a61a4bcb11",
      "externalId":"8ae5dc9e-c7ad-4d3d-a152-35a6b6222b83",
      "meta":{
        "resourceType":"Group",
        "created":"2021-09-30T18:20:43Z",
        "lastModified":"2021-09-30T18:20:43Z",
        "location":"https://instance-servicenow.com/api/now/scim/Groups/e0140d671bbe3010593876a61a4bcb11"},
        "displayName":"HR Group",
        "members":[
          {
            "value":"62826bf03710200044e0bfc8bcbe5df1",
            "display":"Abel Tuter",
            "$ref": "http://instance-servicenow.com/api/now/scim/Users/62826bf03710200044e0bfc8bcbe5df1"
          }
        ], 
        "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group": {
          "company": {
            "value": "81fd65ecac1d55eb42a426568fc87a63",
            "name": "ACME Japan",
            "$ref": "http://111.111.1.11:8080/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63"
          }
        }
      }
    }

## SCIM -- PATCH /scim/Groups/{Group_ID} {#ariaid-title5}

Ermöglicht Ihnen das Hinzufügen, Aktualisieren und Löschen angegebener Felder in einem Gruppendatensatz in der Tabelle „Gruppe" \[sys_user_Group\] von ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.
Weitere Informationen finden Sie unter [Wird mit PATCH geändert](https://datatracker.ietf.org/doc/html/rfc7644#section-3.5.2)Abschnitt von RFC 7644.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Groups/{Group_ID}

Standard-URL: /api/now/scim/Groups/{Group_ID}

### Unterstützte Anforderungsparameter

{#scim-PATCH-Groups-group_id__entry__2}{#scim-PATCH-Groups-group_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 |
| group_id | SYS_ID des zu aktualisierenden Gruppendatensatzes. Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
[Tabelle : 31. Pfad-Parameter]

{#scim-PATCH-Groups-group_id__entry__8}{#scim-PATCH-Groups-group_id__attributes-SCIM-entry}{#scim-PATCH-Groups-group_id__excludedAttributes-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
[Tabelle : 32. Abfrageparameter]

{#scim-PATCH-Groups-group_id__entry__14}{#scim-PATCH-Groups-group_id__group_schemas-SCIM-entry}

| Name | Beschreibung |
|-|-|
| Vorgänge | Erforderlich. Liste der Vorgangsobjekte, mit denen der angegebene Gruppendatensatz gepatcht werden soll. Datentyp: Array von Objekten "Operations": [ { "op": "String", "path": "String", "value": Any } ] |
| Vorgänge.OP | Erforderlich. Auszuführender Vorgang. Gültige Werte: * Hinzufügen: Fügen Sie dem Gruppendatensatz das angegebene Feld und den angegebenen Wert hinzu. * Entfernen: Entfernen Sie den Wert aus dem angegebenen Feld. Durch Datentyp „null" ersetzt. * Ersetzen: Ersetzen Sie den Wert des angegebenen Felds. Datentyp: Zeichenfolge |
| Vorgänge.Pfad | Erforderlich für `Entfernen `Vorgänge, optional für andere. Name/Pfad des zu ändernden Felds. Die pathParameter kann eines der folgenden Formate haben: * Ein direktes Feld, z. B. `DisplayName ` * Im Falle eines komplexen Arrays ein Zeiger auf ein bestimmtes Element mit einem Filter, z. B.: `E-Mails[type eq „work"] ` {#scim-PATCH-Groups-group_id__ul_zpv_ls5_frb} { "schemas": [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ], "Operations": [ { "op": "add", "path": "displayName", "value": "HR Group" }, { "op": "replace", "path": "members[value eq \"sysid1\"]", "value": { "value": "sysid2" } } ] } Datentyp: Zeichenfolge Standard: Betrachtet das Feld als Ressource. |
| Vorgänge.Wert | Wert des Felds, das in angegeben ist Operations.pathParameter. Das Format dieses Parameters hängt vom Datentyp des zugehörigen Felds ab. Beispiel: Wenn Sie eine einfache Zeichenfolge aktualisieren, z. B. den Titel, die valueFeld wird als Zeichenfolge ausgedrückt. "Operations": [ { "op": "add", "path": "displayName", "value": "HR Group" } ] Sie können auch einfache Zeichenfolgenwerte ohne deklarieren pathParameter, z. B.: "Operations": [ { "op": "add", "value": { "displayName": "HR Group" } } ] Im Folgenden wird gezeigt, wie der Gruppe ein Mitglied hinzugefügt wird: { "op": "add", "value": { "members": { "value": "62826bf03710200044e0bfc8bcbe5df1", } } } Wenn sich das zu aktualisierende Feld nicht im Basisschema befindet, müssen Sie das Name-Wert-Paar in ein Objekt einschließen, das die URN des zugeordneten Schemas angibt. "value": { "<schema_urn>": { "<field_name>": "<new_value>" }, } Zum Beispiel: "value": { "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group": { "groupNumber": "13454" }, } Datentyp: Beliebig |
| Vorgänge.Wert.Typ | Name des zu aktualisierenden Felds. Datentyp: Zeichenfolge |
| Vorgänge.Wert.Wert | Wert, mit dem das Feld aktualisiert werden soll. Datentyp: Zeichenfolge |
| Schemas | Erforderlich. SCIM-Schema-URI des Patchvorgangs: „URN:ietf:params:scim:api:messages:2,0:PatchOp" Datentyp: Zeichenfolge |
[Tabelle : 33. Anforderungstext-Parameter (JSON)]

### Header

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

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

{#scim-PATCH-Groups-group_id__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.").
{#scim-PATCH-Groups-group_id__entry__40}{#scim-PATCH-Groups-group_id__entry-200-status-code}{#scim-PATCH-Groups-group_id__entry-404-status-code}{#scim-PATCH-Groups-group_id__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 204 | Erfolgreich. Kein Inhalt (gilt nur für SCIM-Gruppenpatch-API) -- Dieser 204-Status hängt vom Status der SCIM-UI-Eigenschaft ab. `Aktivieren Sie die API-Antwort „Gruppenpatch" ohne Inhalt `, Und unterliegt dem Attributparameter, der gemäß RFC übergeben wurde: <https://www.rfc-editor.org/rfc/rfc7644#page-35>. Standardeigenschaftswert: Falsch Die `Aktivieren Sie die API-Antwort „Gruppenpatch" ohne Inhalt `Die Eigenschaft kann verwendet werden, um zusätzliche Leistungsgewinne bei der Antwortausführung zu erhalten, wenn der Client keine Antwortressourcen verbrauchen möchte. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. * Auf ungültige Werte prüfen: * Fehlerhafter Anforderungstext. * Pflichtfeld ist nicht angegeben oder leer. * Ungültige Anwender- oder Gruppen-sys_ID angegeben. * Überprüfen Sie, ob ein schreibgeschütztes oder unveränderliches Feld versucht, geändert zu werden. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben, oder dass die Anforderung die maximale Anzahl von Mitgliedern nicht überschreitet. {#scim-PATCH-Groups-group_id__status_400_extended-SCIM-entry} |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 409 | Gruppe ist bereits vorhanden. Die displayNameParameter muss eindeutig sein. |
| 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)

{#scim-PATCH-Groups-group_id__entry__54}{#scim-PATCH-Groups-group_id__group_company-SCIM-entry}{#scim-PATCH-Groups-group_id__group_company_display-SCIM-entry}{#scim-PATCH-Groups-group_id__group_company_ref-SCIM-entry}{#scim-PATCH-Groups-group_id__group_company_value-SCIM-entry}{#scim-PATCH-Groups-group_id__group_displayName-SCIM-entry}{#scim-PATCH-Groups-group_id__group_externalId-SCIM-entry}{#scim-PATCH-Groups-group_id__errors-SCIM-entry}{#scim-PATCH-Groups-group_id__errors_details-SCIM-entry}{#scim-PATCH-Groups-group_id__errors_scimType-SCIM-entry}{#scim-PATCH-Groups-group_id__errors_schemas-SCIM-entry}{#scim-PATCH-Groups-group_id__errors_status-SCIM-entry}{#scim-PATCH-Groups-group_id__d2953e865}{#scim-PATCH-Groups-group_id__d2953e877}{#scim-PATCH-Groups-group_id__group_id-SCIM-entry}{#scim-PATCH-Groups-group_id__group_members-SCIM-entry}{#scim-PATCH-Groups-group_id__group_members_display-SCIM-entry}{#scim-PATCH-Groups-group_id__group_members_value-SCIM-entry}{#scim-PATCH-Groups-group_id__group_members_ref-SCIM-entry}{#scim-PATCH-Groups-group_id__group_meta-SCIM-entry}{#scim-PATCH-Groups-group_id__group_meta_created-SCIM-entry}{#scim-PATCH-Groups-group_id__group_meta_lastModified-SCIM-entry}{#scim-PATCH-Groups-group_id__group_meta_location-SCIM-entry}{#scim-PATCH-Groups-group_id__group_meta_resourceType-SCIM-entry}{#scim-PATCH-Groups-group_id__d2953e1003}

| Name | Beschreibung |
|-|-|
| Unternehmen | Details zum Unternehmen oder zur Organisation der Gruppe. Datentyp: Objekt "company": { "display": "String", "$ref": "String", "value": "String" } |
| Unternehmen.Anzeige | Name des Unternehmens. Datentyp: Zeichenfolge |
| Unternehmen.$ref | Referenz-URI des Unternehmens. Format: `<host>/Unternehmen/<company sys_id> `, Z. B.: `http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63 `. Datentyp: Zeichenfolge |
| Unternehmen.Wert | SYS_ID des zugeordneten Unternehmens. Datentyp: Zeichenfolge |
| displayName | Visuell lesbarer Name der Gruppe, z. B. HR-Team. Datentyp: Zeichenfolge |
| externalId | Eindeutiger Bezeichner, der der Gruppe von der Entität zugewiesen wurde, die sie bereitstellt. Datentyp: Zeichenfolge |
| Fehler | Antwort, die alle Fehler beschreibt, die während der Verarbeitung der Anforderung aufgetreten sind. Datentyp: Objekt "errors": { "details": "String", "schemas": "String", "scimType": "String", "status": "String" } |
| errors.detail | Detaillierte Fehlermeldung, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Fehler.scimType | SCIM-Fehlerdetailstichwort. Datentyp: Zeichenfolge |
| Fehler.Schemas | URI der SCIM-Schemata, die zur Verarbeitung der Fehlerantwort verwendet werden. Datentyp: Array von Zeichenfolgen |
| Fehler.Status | HTTP-Statuscode für die Fehlerantwort. Datentyp: Zeichenfolge |
| displayName | Visuell lesbarer Name der Gruppe, z. B. HR-Team. Datentyp: Zeichenfolge |
| externalId | Eindeutiger Bezeichner, der der Gruppe von der Entität zugewiesen wurde, die sie bereitstellt. Datentyp: Zeichenfolge |
| ID | SYS_ID der Gruppe. Datentyp: Zeichenfolge |
| Mitglieder | Liste der Anwender und Gruppen, die der Gruppe zugeordnet sind. Datentyp: Array von Objekten "members": [ { "display": "String", "value": "String", "$ref": "String" } ] |
| Members.Display | Name des zugeordneten Gruppenmitglieds. Datentyp: Zeichenfolge |
| Members.value | SYS_ID des zugeordneten Anwender- oder Gruppendatensatzes. Datentyp: Zeichenfolge |
| Mitglieder.$ref | URI des zugeordneten Gruppenmitglieds. Datentyp: Zeichenfolge |
| Meta | Metadaten, die zur Gruppe gehören. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": String", "resourceType": String" } |
| Meta.erstellt | Datum und Uhrzeit der Erstellung des Gruppendatensatzes. Datentyp: Zeichenfolge |
| Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des Gruppendatensatzes. Datentyp: Zeichenfolge |
| Meta.Standort | URI der abgerufenen Gruppe. Datentyp: Zeichenfolge |
| Meta.resourceType | Ressourcentyp der SCIM-Gruppen. Datentyp: Zeichenfolge |
| Schemas | Liste der URIs der SCIM-Gruppenschemas, die zur Verarbeitung der Anforderung verwendet werden. Unterstützte Gruppenschemas: * URN:ietf:params:scim:Schemas:Core:2,0:Gruppe: Kernschema, das im Taskforce-System für Internet-Engineering für domänenübergreifende Identitätsverwaltung angegeben ist: Kernschemadokument ( <https://datatracker.ietf.org/doc/html/rfc7643#section-4.2>) * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Gruppe -- ServiceNowErweiterungsschema. Dieses Schema enthält Attribute, die in der Tabelle „Gruppen" \[sys_user_Group\] in einer Basis vorhanden sind ServiceNowSystem, sind aber nicht Teil des Kernschemas. * URN:ietf:params:scim:Schemas:Extension:servicenow:custom:2,0:Gruppe" -- Anwenderdefiniertes Erweiterungsschema. Dieses Schema ist Teil des resourceType „Gruppe" in der sys_scim_schema_extension-Tabelle. Wenn das Schema nicht aktiv ist, wird die Schema-URN in der Antwort nicht zurückgegeben. {#scim-PATCH-Groups-group_id__ul_ckx_x3t_2tb} Datentyp: Array von Zeichenfolgen |
[ ]

### Curl-Anforderung

Dieses Beispiel zeigt, wie einem Gruppendatensatz eine externe ID hinzugefügt und die aktuelle Liste der zugehörigen Mitglieder (Anwender) ersetzt wird.

    curl "https://instance-servicenow.com/api/now/scim/Groups/a92b84f96b073010638c83eece44af4e" \
    --request PATCH \
    --header "Accept:application/scim+json" \
    --header "Content-Type:application/scim+json" \
    --data "{
      "schemas": [
        "urn:ietf:params:scim:api:messages:2.0:PatchOp"
      ],
      "Operations": [
        {
          "op": "add",
          "path": "externalId",
          "value": "278fdc2e-a6aa-4140-bd23-9ba4987a2938"
        },
        {
          "op": "replace",
          "path": "members",
          "value": [
            {
              "value": "62826bf03710200044e0bfc8bcbe5df1"
            },
            {
              "value": "a8f98bb0eb32010045e1a5115206fe3a"
            }
          ]
        }
      ]
    }"

Antwort:

    {
      "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:Group",
        "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group",
        'urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group'
      ],
      "id": "a92b84f96b073010638c83eece44af4e",
      "externalId": "278fdc2e-a6aa-4140-bd23-9ba4987a2938",
      "meta": {
        "resourceType": "Group",
        "created": "2021-10-07T13:58:22Z",
        "lastModified": "2021-10-07T15:48:44Z",
        "location":
          "https://instance-sevicenow/api/now/scim/Groups/a92b84f96b073010638c83eece44af4e"
      },
      "displayName": "HR Team",
      "members": [
        {
          "value": "62826bf03710200044e0bfc8bcbe5df1",
          "display": "Abel Tuter",
          "$ref":
            "https://instance-sevicenow/api/now/scim/Users/62826bf03710200044e0bfc8bcbe5df1"
        },
        {
          "value": "a8f98bb0eb32010045e1a5115206fe3a",
          "display": "Abraham Lincoln",
          "$ref":
            "https://instance-sevicenow/api/now/scim/Users/a8f98bb0eb32010045e1a5115206fe3a"
        }
      ],
      "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group": {
        "company": {
          "value": "81fd65ecac1d55eb42a426568fc87a63",
          "name": "ACME Japan",
          "$ref": "http://instance-sevicenow/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63"
        }
      }
    }

## SCIM: /scim/Groups VERÖFFENTLICHEN {#ariaid-title6}

Erstellt einen Gruppendatensatz in der Gruppentabelle \[sys_user_Group\] von ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.
Sie können den Anzeigenamen der Gruppe definieren, eine externe ID, die zum Korrelieren dieser Gruppe mit einem externen System verwendet wird, und Mitglieder (Anwender/Gruppen) zur Gruppe hinzufügen.  
Hinweis:  
Die in der RFC7643-Spezifikation angegebenen Such- und Massenänderungen werden von diesem Endpunkt nicht unterstützt.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Groups

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

{#scim-POST-Groups__entry__2}{#scim-POST-Groups__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 |
[Tabelle : 37. Pfad-Parameter]

{#scim-POST-Groups__entry__6}{#scim-POST-Groups__attributes-SCIM-entry}{#scim-POST-Groups__excludedAttributes-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
[Tabelle : 38. Abfrageparameter]

{#scim-POST-Groups__entry__12}{#scim-POST-Groups__group_company-SCIM-entry}{#scim-POST-Groups__group_company_display-SCIM-entry}{#scim-POST-Groups__group_company_ref-SCIM-entry}{#scim-POST-Groups__group_company_value-SCIM-entry}{#scim-POST-Groups__group_request_displayName-SCIM-entry}{#scim-POST-Groups__group_externalId-SCIM-entry}{#scim-POST-Groups__group_request_schema-SCIM-entry}

| Name | Beschreibung |
|-|-|
| Unternehmen | Details zum Unternehmen oder zur Organisation der Gruppe. Datentyp: Objekt "company": { "display": "String", "$ref": "String", "value": "String" } |
| Unternehmen.Anzeige | Name des Unternehmens. Datentyp: Zeichenfolge |
| Unternehmen.$ref | Referenz-URI des Unternehmens. Format: `<host>/Unternehmen/<company sys_id> `, Z. B.: `http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63 `. Datentyp: Zeichenfolge |
| Unternehmen.Wert | SYS_ID des zugeordneten Unternehmens. Datentyp: Zeichenfolge |
| displayName | Erforderlich. Visuell lesbarer Name der Gruppe, z. B. HR-Team. Datentyp: Zeichenfolge |
| externalId | Eindeutiger Bezeichner, der der Gruppe von der Entität zugewiesen wurde, die sie bereitstellt. Datentyp: Zeichenfolge |
| Mitglieder | Liste der Anwender oder anderen Gruppen, die der Gruppe zugeordnet werden sollen. Datentyp: Array von Objekten "members:" [ { "value": "String" } ] Maximale Größe: 100 -- Sie können diese maximale Größe ändern, indem Sie die Systemeigenschaft com.snc.interation.scim2.max.member.count aktualisieren. |
| Members.value | SYS_ID des zugeordneten Anwender- oder Gruppendatensatzes. Datentyp: Zeichenfolge |
| Schemas | Erforderlich. Liste der URIs der SCIM-Gruppenschemas, die zur Verarbeitung der Anforderung verwendet werden. Unterstützte Gruppenschemas: * URN:ietf:params:scim:Schemas:Core:2,0:Gruppe: Kernschema, das im Taskforce-System für Internet-Engineering für domänenübergreifende Identitätsverwaltung angegeben ist: Kernschemadokument ( <https://datatracker.ietf.org/doc/html/rfc7643#section-4.2>) * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Gruppe -- ServiceNowErweiterungsschema. Dieses Schema enthält Attribute, die in der Tabelle „Gruppen" \[sys_user_Group\] in einer Basis vorhanden sind ServiceNowSystem, sind aber nicht Teil des Kernschemas. * URN:ietf:params:scim:Schemas:Extension:servicenow:custom:2,0:Gruppe" -- Anwenderdefiniertes Erweiterungsschema. Dieses Schema ist Teil des resourceType „Gruppe" in der sys_scim_schema_extension-Tabelle. Wenn das Schema nicht aktiv ist, wird die Schema-URN in der Antwort nicht zurückgegeben. {#scim-POST-Groups__ul_ckx_x3t_2tb} Datentyp: Array von Zeichenfolgen |
[Tabelle : 39. Anforderungstext-Parameter (JSON)]

### Header

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

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

{#scim-POST-Groups__entry__38}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 41. 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.").
{#scim-POST-Groups__entry__42}{#scim-POST-Groups__status_409-SCIM-entry}{#scim-POST-Groups__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 201 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. * Auf ungültige Werte prüfen: * Fehlerhafter Anforderungstext. * Pflichtfeld ist nicht angegeben oder leer. * Ungültige Anwender- oder Gruppen-sys_ID angegeben. * Überprüfen Sie, ob ein schreibgeschütztes oder unveränderliches Feld versucht, geändert zu werden. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben, oder dass die Anforderung die maximale Anzahl von Mitgliedern nicht überschreitet. {#scim-POST-Groups__status_400_extended-SCIM-entry} |
| 409 | Gruppe ist bereits vorhanden. Die displayNameParameter muss eindeutig sein. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 42. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-POST-Groups__id_uwk_c5c_grb__entry__2}{#scim-POST-Groups__d2953e811}{#scim-POST-Groups__d2953e824}{#scim-POST-Groups__d2953e835}{#scim-POST-Groups__d2953e854}{#scim-POST-Groups__group_displayName-SCIM-entry}{#scim-POST-Groups__d2953e877}{#scim-POST-Groups__group_id-SCIM-entry}{#scim-POST-Groups__group_meta-SCIM-entry}{#scim-POST-Groups__group_meta_created-SCIM-entry}{#scim-POST-Groups__group_meta_lastModified-SCIM-entry}{#scim-POST-Groups__group_meta_location-SCIM-entry}{#scim-POST-Groups__group_meta_resourceType-SCIM-entry}{#scim-POST-Groups__group_members-SCIM-entry}{#scim-POST-Groups__group_members_display-SCIM-entry}{#scim-POST-Groups__group_members_value-SCIM-entry}{#scim-POST-Groups__group_members_ref-SCIM-entry}{#scim-POST-Groups__group_schemas-SCIM-entry}

| Name | Beschreibung |
|-|-|
| Unternehmen | Details zum Unternehmen oder zur Organisation der Gruppe. Datentyp: Objekt "company": { "display": "String", "$ref": "String", "value": "String" } |
| Unternehmen.Anzeige | Name des Unternehmens. Datentyp: Zeichenfolge |
| Unternehmen.$ref | Referenz-URI des Unternehmens. Format: `<host>/Unternehmen/<company sys_id> `, Z. B.: `http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63 `. Datentyp: Zeichenfolge |
| Unternehmen.Wert | SYS_ID des zugeordneten Unternehmens. Datentyp: Zeichenfolge |
| displayName | Visuell lesbarer Name der Gruppe, z. B. HR-Team. Datentyp: Zeichenfolge |
| externalId | Eindeutiger Bezeichner, der der Gruppe von der Entität zugewiesen wurde, die sie bereitstellt. Datentyp: Zeichenfolge |
| ID | SYS_ID der Gruppe. Datentyp: Zeichenfolge |
| Meta | Metadaten, die zur Gruppe gehören. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": String", "resourceType": String" } |
| Meta.erstellt | Datum und Uhrzeit der Erstellung des Gruppendatensatzes. Datentyp: Zeichenfolge |
| Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des Gruppendatensatzes. Datentyp: Zeichenfolge |
| Meta.Standort | URI der abgerufenen Gruppe. Datentyp: Zeichenfolge |
| Meta.resourceType | Ressourcentyp der SCIM-Gruppen. Datentyp: Zeichenfolge |
| Mitglieder | Liste der Anwender und Gruppen, die der Gruppe zugeordnet sind. Datentyp: Array von Objekten "members": [ { "display": "String", "value": "String", "$ref": "String" } ] |
| Members.Display | Name des zugeordneten Gruppenmitglieds. Datentyp: Zeichenfolge |
| Members.value | SYS_ID des zugeordneten Anwender- oder Gruppendatensatzes. Datentyp: Zeichenfolge |
| Mitglieder.$ref | URI des zugeordneten Gruppenmitglieds. Datentyp: Zeichenfolge |
| Schemas | Liste der URIs der SCIM-Gruppenschemas, die zur Verarbeitung der Anforderung verwendet werden. Unterstützte Gruppenschemas: * URN:ietf:params:scim:Schemas:Core:2,0:Gruppe: Kernschema, das im Taskforce-System für Internet-Engineering für domänenübergreifende Identitätsverwaltung angegeben ist: Kernschemadokument ( <https://datatracker.ietf.org/doc/html/rfc7643#section-4.2>) * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Gruppe -- ServiceNowErweiterungsschema. Dieses Schema enthält Attribute, die in der Tabelle „Gruppen" \[sys_user_Group\] in einer Basis vorhanden sind ServiceNowSystem, sind aber nicht Teil des Kernschemas. * URN:ietf:params:scim:Schemas:Extension:servicenow:custom:2,0:Gruppe" -- Anwenderdefiniertes Erweiterungsschema. Dieses Schema ist Teil des resourceType „Gruppe" in der sys_scim_schema_extension-Tabelle. Wenn das Schema nicht aktiv ist, wird die Schema-URN in der Antwort nicht zurückgegeben. {#scim-POST-Groups__d2953e1008} Datentyp: Array von Zeichenfolgen |
[ ]

{#scim-POST-Groups__id_uwk_c5c_grb}  

### Curl-Anforderung -- POSTEN SIE eine neue Gruppe, und fügen Sie ein Mitglied hinzu

Dieses Beispiel erstellt group51 und fügt den Anwender Abel Tutor als Mitglied hinzu.

    curl "https://instance-servicenow.com/api/now/scim/Groups" \
    --request POST \
    --header "Accept:application/scim+json" \
    --header "Content-Type:application/scim+json" \
    --data "{
      \"schemas\": ["urn:ietf:params:scim:schemas:core:2.0:Group",
        "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group", 
        "urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group"],
      \"displayName\": \"HR Team\",
      \"externalId\": \"8ae5dc9e-c7ad-4d3d-a152-35a6b6222b83\",
      \"members\": [
        {
          \"value\": \"62826bf03710200044e0bfc8bcbe5df1\",
          \"$ref\": \"Users/62826bf03710200044e0bfc8bcbe5df1\"
        }
      ]
    }"

Antwort:

    {"schemas":
      [
        "urn:ietf:params:scim:schemas:core:2.0:Group",
        "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group",
        'urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group'
      ],
      "id":"e0140d671bbe3010593876a61a4bcb11",
      "externalId":"8ae5dc9e-c7ad-4d3d-a152-35a6b6222b83",
      "meta":{
        "resourceType":"Group",
        "created":"2021-09-30T18:20:43Z",
        "lastModified":"2021-09-30T18:20:43Z",
        "location":"https://instance-servicenow.com/api/now/scim/Groups/e0140d671bbe3010593876a61a4bcb11"},
        "displayName":"HR Team",
        "members":[
          {
            "value":"62826bf03710200044e0bfc8bcbe5df1",
            "display":"Abel Tuter",
            "$ref": "http://instance-servicenow.com/api/now/scim/Users/62826bf03710200044e0bfc8bcbe5df1"
          }
        ],
        "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group": {
          "company": {
            "value": "81fd65ecac1d55eb42a426568fc87a63",
            "name": "ACME Japan",
            "$ref": http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63
          }
        }
      }
    }

## SCIM -- PUT /scim/Groups/{Group_ID} {#ariaid-title7}

Aktualisiert den angegebenen Gruppendatensatz in der Gruppentabelle \[sys_user_Group\] von ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.
Felder, die in der Anforderung ausgelassen werden, werden nicht aktualisiert. Sie können ein Feld explizit löschen, indem Sie seinen Wert für ein einzelnes Wertfeld auf null und für Array-Typfelder wie auf ein leeres Array festlegen members.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Groups/{Group_ID}

Standard-URL: /api/now/scim/Groups/{Group_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

{#scim-PUT-Groups-group_id__entry__2}{#scim-PUT-Groups-group_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 |
| group_id | SYS_ID des zu aktualisierenden Gruppendatensatzes. Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
[Tabelle : 43. Pfad-Parameter]

{#scim-PUT-Groups-group_id__entry__8}{#scim-PUT-Groups-group_id__attributes-SCIM-entry}{#scim-PUT-Groups-group_id__excludedAttributes-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
[Tabelle : 44. Abfrageparameter]

{#scim-PUT-Groups-group_id__entry__14}{#scim-PUT-Groups-group_id__group_company-SCIM-entry}{#scim-PUT-Groups-group_id__group_company_display-SCIM-entry}{#scim-PUT-Groups-group_id__group_company_ref-SCIM-entry}{#scim-PUT-Groups-group_id__group_company_value-SCIM-entry}{#scim-PUT-Groups-group_id__group_displayName-SCIM-entry}{#scim-PUT-Groups-group_id__group_externalId-SCIM-entry}{#scim-PUT-Groups-group_id__group_request_schema-SCIM-entry}

| Name | Beschreibung |
|-|-|
| Unternehmen | Details zum Unternehmen oder zur Organisation der Gruppe. Datentyp: Objekt "company": { "display": "String", "$ref": "String", "value": "String" } |
| Unternehmen.Anzeige | Name des Unternehmens. Datentyp: Zeichenfolge |
| Unternehmen.$ref | Referenz-URI des Unternehmens. Format: `<host>/Unternehmen/<company sys_id> `, Z. B.: `http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63 `. Datentyp: Zeichenfolge |
| Unternehmen.Wert | SYS_ID des zugeordneten Unternehmens. Datentyp: Zeichenfolge |
| displayName | Visuell lesbarer Name der Gruppe, z. B. HR-Team. Datentyp: Zeichenfolge |
| externalId | Eindeutiger Bezeichner, der der Gruppe von der Entität zugewiesen wurde, die sie bereitstellt. Datentyp: Zeichenfolge |
| Mitglieder | Liste der Anwender, durch die die aktuelle Liste der Mitglieder ersetzt werden soll. Datentyp: Array von Objekten "members:" [ { "value": "String" } ] Maximale Größe: 100 -- Sie können diese maximale Größe ändern, indem Sie die Systemeigenschaft com.snc.interation.scim2.max.member.count aktualisieren. |
| Members.value | SYS_ID des zugeordneten Anwender- oder Gruppendatensatzes. Datentyp: Zeichenfolge |
| Schemas | Erforderlich. Liste der URIs der SCIM-Gruppenschemas, die zur Verarbeitung der Anforderung verwendet werden. Unterstützte Gruppenschemas: * URN:ietf:params:scim:Schemas:Core:2,0:Gruppe: Kernschema, das im Taskforce-System für Internet-Engineering für domänenübergreifende Identitätsverwaltung angegeben ist: Kernschemadokument ( <https://datatracker.ietf.org/doc/html/rfc7643#section-4.2>) * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Gruppe -- ServiceNowErweiterungsschema. Dieses Schema enthält Attribute, die in der Tabelle „Gruppen" \[sys_user_Group\] in einer Basis vorhanden sind ServiceNowSystem, sind aber nicht Teil des Kernschemas. * URN:ietf:params:scim:Schemas:Extension:servicenow:custom:2,0:Gruppe" -- Anwenderdefiniertes Erweiterungsschema. Dieses Schema ist Teil des resourceType „Gruppe" in der sys_scim_schema_extension-Tabelle. Wenn das Schema nicht aktiv ist, wird die Schema-URN in der Antwort nicht zurückgegeben. {#scim-PUT-Groups-group_id__ul_ckx_x3t_2tb} Datentyp: Array von Zeichenfolgen |
[Tabelle : 45. Anforderungstext-Parameter (JSON)]

### Header

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

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

{#scim-PUT-Groups-group_id__entry__40}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 47. 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.").
{#scim-PUT-Groups-group_id__entry__44}{#scim-PUT-Groups-group_id__entry-200-status-code}{#scim-PUT-Groups-group_id__entry-404-status-code}{#scim-PUT-Groups-group_id__status_409-SCIM-entry}{#scim-PUT-Groups-group_id__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. * Auf ungültige Werte prüfen: * Fehlerhafter Anforderungstext. * Pflichtfeld ist nicht angegeben oder leer. * Ungültige Anwender- oder Gruppen-sys_ID angegeben. * Überprüfen Sie, ob ein schreibgeschütztes oder unveränderliches Feld versucht, geändert zu werden. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben, oder dass die Anforderung die maximale Anzahl von Mitgliedern nicht überschreitet. {#scim-PUT-Groups-group_id__status_400_extended-SCIM-entry} |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 409 | Gruppe ist bereits vorhanden. Die displayNameParameter muss eindeutig sein. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 48. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-PUT-Groups-group_id__entry__56}{#scim-PUT-Groups-group_id__d2953e811}{#scim-PUT-Groups-group_id__d2953e824}{#scim-PUT-Groups-group_id__d2953e835}{#scim-PUT-Groups-group_id__d2953e854}{#scim-PUT-Groups-group_id__d2953e865}{#scim-PUT-Groups-group_id__errors-SCIM-entry}{#scim-PUT-Groups-group_id__errors_details-SCIM-entry}{#scim-PUT-Groups-group_id__errors_scimType-SCIM-entry}{#scim-PUT-Groups-group_id__errors_schemas-SCIM-entry}{#scim-PUT-Groups-group_id__errors_status-SCIM-entry}{#scim-PUT-Groups-group_id__d2953e877}{#scim-PUT-Groups-group_id__group_id-SCIM-entry}{#scim-PUT-Groups-group_id__group_members-SCIM-entry}{#scim-PUT-Groups-group_id__group_members_display-SCIM-entry}{#scim-PUT-Groups-group_id__group_members_value-SCIM-entry}{#scim-PUT-Groups-group_id__group_members_ref-SCIM-entry}{#scim-PUT-Groups-group_id__group_meta-SCIM-entry}{#scim-PUT-Groups-group_id__group_meta_created-SCIM-entry}{#scim-PUT-Groups-group_id__group_meta_lastModified-SCIM-entry}{#scim-PUT-Groups-group_id__group_meta_location-SCIM-entry}{#scim-PUT-Groups-group_id__group_meta_resourceType-SCIM-entry}{#scim-PUT-Groups-group_id__group_schemas-SCIM-entry}

| Name | Beschreibung |
|-|-|
| Unternehmen | Details zum Unternehmen oder zur Organisation der Gruppe. Datentyp: Objekt "company": { "display": "String", "$ref": "String", "value": "String" } |
| Unternehmen.Anzeige | Name des Unternehmens. Datentyp: Zeichenfolge |
| Unternehmen.$ref | Referenz-URI des Unternehmens. Format: `<host>/Unternehmen/<company sys_id> `, Z. B.: `http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63 `. Datentyp: Zeichenfolge |
| Unternehmen.Wert | SYS_ID des zugeordneten Unternehmens. Datentyp: Zeichenfolge |
| displayName | Visuell lesbarer Name der Gruppe, z. B. HR-Team. Datentyp: Zeichenfolge |
| Fehler | Antwort, die alle Fehler beschreibt, die während der Verarbeitung der Anforderung aufgetreten sind. Datentyp: Objekt "errors": { "details": "String", "schemas": "String", "scimType": "String", "status": "String" } |
| errors.detail | Detaillierte Fehlermeldung, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Fehler.scimType | SCIM-Fehlerdetailstichwort. Datentyp: Zeichenfolge |
| Fehler.Schemas | URI der SCIM-Schemata, die zur Verarbeitung der Fehlerantwort verwendet werden. Datentyp: Array von Zeichenfolgen |
| Fehler.Status | HTTP-Statuscode für die Fehlerantwort. Datentyp: Zeichenfolge |
| externalId | Eindeutiger Bezeichner, der der Gruppe von der Entität zugewiesen wurde, die sie bereitstellt. Datentyp: Zeichenfolge |
| ID | SYS_ID der Gruppe. Datentyp: Zeichenfolge |
| Mitglieder | Liste der Anwender und Gruppen, die der Gruppe zugeordnet sind. Datentyp: Array von Objekten "members": [ { "display": "String", "value": "String", "$ref": "String" } ] |
| Members.Display | Name des zugeordneten Gruppenmitglieds. Datentyp: Zeichenfolge |
| Members.value | SYS_ID des zugeordneten Anwender- oder Gruppendatensatzes. Datentyp: Zeichenfolge |
| Mitglieder.$ref | URI des zugeordneten Gruppenmitglieds. Datentyp: Zeichenfolge |
| Meta | Metadaten, die zur Gruppe gehören. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": String", "resourceType": String" } |
| Meta.erstellt | Datum und Uhrzeit der Erstellung des Gruppendatensatzes. Datentyp: Zeichenfolge |
| Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des Gruppendatensatzes. Datentyp: Zeichenfolge |
| Meta.Standort | URI der abgerufenen Gruppe. Datentyp: Zeichenfolge |
| Meta.resourceType | Ressourcentyp der SCIM-Gruppen. Datentyp: Zeichenfolge |
| Schemas | Liste der URIs der SCIM-Gruppenschemas, die zur Verarbeitung der Anforderung verwendet werden. Unterstützte Gruppenschemas: * URN:ietf:params:scim:Schemas:Core:2,0:Gruppe: Kernschema, das im Taskforce-System für Internet-Engineering für domänenübergreifende Identitätsverwaltung angegeben ist: Kernschemadokument ( <https://datatracker.ietf.org/doc/html/rfc7643#section-4.2>) * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Gruppe -- ServiceNowErweiterungsschema. Dieses Schema enthält Attribute, die in der Tabelle „Gruppen" \[sys_user_Group\] in einer Basis vorhanden sind ServiceNowSystem, sind aber nicht Teil des Kernschemas. * URN:ietf:params:scim:Schemas:Extension:servicenow:custom:2,0:Gruppe" -- Anwenderdefiniertes Erweiterungsschema. Dieses Schema ist Teil des resourceType „Gruppe" in der sys_scim_schema_extension-Tabelle. Wenn das Schema nicht aktiv ist, wird die Schema-URN in der Antwort nicht zurückgegeben. {#scim-PUT-Groups-group_id__d2953e1008} Datentyp: Array von Zeichenfolgen |
[ ]

### Curl-Anforderung zum Aktualisieren von Gruppenmitgliedern mithilfe von PUT

Im folgenden Beispiel wird das Mitglied, das der Gruppe zugeordnet ist, in Abraham Lincoln anstelle von Abel Tutor geändert und der Name der Gruppe in HR-Team geändert.

    curl "https://instance-servicenow.com/api/now/scim/Groups/e0140d671bbe3010593876a61a4bcb11" \
    --request PUT \
    --header "Accept:application/scim+json" \
    --header "Content-Type:application/scim+json" \
    --data "{
      \"schemas\": ["urn:ietf:params:scim:schemas:core:2.0:Group",
        "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group", 
        "urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group"],
      \"displayName\": \"HR Team\",
      \"externalId\": \"8ae5dc9e-c7ad-4d3d-a152-35a6b6222b83\",
      \"members\": [
        {
          \"value\": \"a8f98bb0eb32010045e1a5115206fe3a\",
          \"$ref\": \"Users\"
        }
      ]
    }" 

Antwort:

    {"schemas":
      [
        "urn:ietf:params:scim:schemas:core:2.0:Group",
        "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group",
        'urn:ietf:params:scim:schemas:extension:servicenow:custom:2.0:Group'
      ],
      "id":"e0140d671bbe3010593876a61a4bcb11",
      "externalId":"8ae5dc9e-c7ad-4d3d-a152-35a6b6222b83",
      "meta":{
        "resourceType":"Group",
        "created":"2021-09-30T18:20:43Z",
        "lastModified":"2021-09-30T21:19:40Z",
        "location":"https://instance-servicenow.com/api/now/scim/Groups/e0140d671bbe3010593876a61a4bcb11"
      },
      "displayName":"HR Team",
      "members":[
        {
          "value":"a8f98bb0eb32010045e1a5115206fe3a",
          "display":"Abraham Lincoln",
          "$ref": "http://instance-servicenow.com/api/now/scim/Users/62826bf03710200044e0bfc8bcbe5df1"
        }
      ],
      "urn:ietf:params:scim:schemas:extension:servicenow:2.0:Group": {
        "company": {
          "value": "81fd65ecac1d55eb42a426568fc87a63",
          "name": "ACME Japan",
          "$ref": "http://192.168.1.25:8080/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63"
        }
      }
    }

## SCIM: LÖSCHEN SIE /scim/Users/{user_ID} {#ariaid-title8}

Löscht den angegebenen Anwenderdatensatz aus der Anwendertabelle \[sys_user\] von ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Users/{user_ID}

Standard-URL: /api/now/scim/Users/{user_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

{#scim-DELETE-Users-user_id__entry__2}{#scim-DELETE-Users-user_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 |
| user_id | SYS_ID des zu löschenden Anwenderdatensatzes. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
[Tabelle : 49. Pfad-Parameter]

{#scim-DELETE-Users-user_id__entry__8}

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

{#scim-DELETE-Users-user_id__entry__12}

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

### Header

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

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

{#scim-DELETE-Users-user_id__entry__20}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 53. 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.").
{#scim-DELETE-Users-user_id__entry__24}{#scim-DELETE-Users-user_id__entry-200-status-code}{#scim-DELETE-Users-user_id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 204 | Kein Inhalt. Die Anforderung wurde erfolgreich verarbeitet. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 54. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-DELETE-Users-user_id__entry__30}{#scim-DELETE-Users-user_id__errors-SCIM-entry}{#scim-DELETE-Users-user_id__errors_details-SCIM-entry}{#scim-DELETE-Users-user_id__errors_scimType-SCIM-entry}{#scim-DELETE-Users-user_id__errors_schemas-SCIM-entry}{#scim-DELETE-Users-user_id__errors_status-SCIM-entry}

| Name | Beschreibung |
|-|-|
| Fehler | Antwort, die alle Fehler beschreibt, die während der Verarbeitung der Anforderung aufgetreten sind. Datentyp: Objekt "errors": { "details": "String", "schemas": "String", "scimType": "String", "status": "String" } |
| errors.detail | Detaillierte Fehlermeldung, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Fehler.scimType | SCIM-Fehlerdetailstichwort. Datentyp: Zeichenfolge |
| Fehler.Schemas | URI der SCIM-Schemata, die zur Verarbeitung der Fehlerantwort verwendet werden. Datentyp: Array von Zeichenfolgen |
| Fehler.Status | HTTP-Statuscode für die Fehlerantwort. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Dieses Beispiel zeigt, wie ein Anwenderdatensatz aus der Anwendertabelle \[sys_user\] gelöscht wird.

    curl "https://instance-servicenow.com/api/now/scim/Users/b7c5015f778330102e8cc5179e5a9992" \
    --request DELETE \
    --header "Accept:application/scim+json"  \

## SCIM -- GET /scim/Users {#ariaid-title9}

Gibt einen oder mehrere Anwenderdatensätze aus der Anwendertabelle \[sys_user\] in zurück ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.
Hinweis:  
Eine Abfrage, die keine Übereinstimmungen zurückgibt, gibt Erfolg (HTTP-Statuscode 200) mit zurück totalResultsAuf 0 festlegen.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Anwender

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

{#scim-GET-Users__entry__2}{#scim-GET-Users__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 |
[Tabelle : 55. Pfad-Parameter]

{#scim-GET-Users__entry__6}{#scim-GET-Users__attributes-SCIM-entry}{#scim-GET-Users__count-SCIM-entry}{#scim-GET-Users__excludedAttributes-SCIM-entry}{#scim-GET-Users__user_filter-SCIM-entry}{#scim-GET-Users__user_sortBy-SCIM-entry}{#scim-GET-Users__sortOrder-SCIM-entry}{#scim-GET-Users__user_startIndex-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| count | Anzahl der zurückzugebenden Datensätze. Ein negativer Wert wird als Null interpretiert. Datentyp: Zahl Maximum: 500 -- Ein Wert größer als dieser führt zu einem Fehler bei ungültigen Anforderungen. Standard: 10 |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
| Filter | Filterausdruck, der auf die Rückgabeergebnisse angewendet werden soll. Feldfilter werden als ausgedrückt `<field_name> <operator> <„value"> `. Siehe [RFC7644](https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2)Für eine Liste der gültigen Operatoren. Hinweis: Die `NICHT `Operator wird nicht unterstützt. Um beispielsweise nach allen Anwendern zu filtern, deren Name mit „Jo" beginnt, geben Sie ein `Anwendername SW „Jo" `(Groß-/Kleinschreibung wird nicht beachtet). Um mehr als einen Feldfilter anzugeben, verketten Sie die Filter mit `UND `Operand. Um beispielsweise nach allen Anwendern zu filtern, deren Name mit „Jo" beginnt und deren Nachname „smi" enthält, geben Sie ein `Anwendername SW „john" UND Name.FAMILYNAME CO „smi" `. Verwenden Sie Dot-Walking, um geschachtelte Attribute anzugeben. Nur die folgenden SCIM-Anwenderfelder sind für die Verwendung in Filtern verfügbar, und einige unterstützen, wie bereits erwähnt, nur ein festes Format: * aktiv * Adressen: Nur festes Format, z. B.: * \[Geben Sie eq „Home" und streetAddress eq „xxxx" ein\] * \[Geben Sie eq „Home" und Ort eq „xxxx" ein\] * \[Geben Sie eq „Startseite" und Region eq „xxxx" ein\] * \[Geben Sie eq „Home" und postalCode eq „xxxx" ein\] * \[Geben Sie eq „Home" und Country eq „xxxx" ein\] {#scim-GET-Users__ul_img_kgm_hrb} * displayName * E-Mails -- nur festes Format, z. B.: \[Geben Sie eq „work" und value eq „emailValue" ein\] * Externe ID: Nur `EQ `Operator wird unterstützt. * ID * Meta.erstellt * Meta.lastModifiziert * Name.FAMILYNAME * Name.givenName * Name.Mittelname * Bevorzugte Sprache * Telefonnummern: Nur festes Format, z. B.: * \[Geben Sie eq „Arbeit" und Wert eq „xxxx" ein\] * \[Geben Sie eq „mobil" und Wert eq „xxxx" ein\] * \[Geben Sie eq „Home" und Wert eq „xxxx" ein\] {#scim-GET-Users__ul_yg1_cgm_hrb} * Feld * Titel * userName * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Anwender:Mitarbeiternummer * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Anwender:Geschlecht * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Anwender:department.name * URN:ietf:Parameter:scim:Schemas:Erweiterung:servicenow:2,0:Anwender:Abteilung.Wert * URN:ietf:params:scim:Schemas:Extension:servicenow:2,0:User:Manager.displayName * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Anwender:Manager.value * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Anwender:costCenter.name * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Anwender:CostCenter.value * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Anwender:company.name * URN:ietf:Parameter:scim:Schemas:Erweiterung:servicenow:2,0:Anwender:Unternehmen.Wert * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Anwender:location.name * URN:ietf:Parameters:scim:Schemas:Extension:servicenow:2,0:Anwender:location.value {#scim-GET-Users__ul_w3k_bcc_grb} Datentyp: Zeichenfolge Standard: Keine Filterung |
| sortBy | Muss mit angegeben werden sortOrderParameter. Feld, nach dem die Rückgabeergebnisse sortiert werden sollen. Bei der Sortierung wird zwischen Groß- und Kleinschreibung unterschieden. Sie können nur die Parameter verwenden, die zum Filtern für verfügbar sind sortByParameter, mit Ausnahme von externalId, Was nicht zulässig ist. Außerdem werden nur die folgenden Dot-Walking-Parameter unterstützt: * addressess -- Nur die folgenden Werte sind zulässig: * addresses.streetAddress -- Ordnet der Hausnummer zu. * addresses.home.streetAddress * addresses.locality -- Ordnet dem Heimatort zu. * addresses.home.locality * addresses.region -- Zuordnungen zur Startregion. * addresses.home.region * addresses.postalCode -- Zuordnung zur Postleitzahl (privat). * addresses.home.postalCode * addresses.country -- Zuordnungen zum Heimatland. * addresses.home.country {#scim-GET-Users__ul_g32_5lm_hrb} * emails -- Nur die folgenden Werte sind zulässig: * emails.value -- Ordnet dem E-Mail-Typ „Arbeit" zu. * emails.work.value {#scim-GET-Users__ul_dnq_wjm_hrb} * phoneNumbers -- Nur die folgenden Werte sind zulässig: * phoneNumbers.value -- Ordnet dem Telefonnummerntyp „Arbeit" zu. * phoneNumbers.home.value * phoneNumbers.mobile.value * phoneNumbers.work.value {#scim-GET-Users__ul_gtf_fkm_hrb} {#scim-GET-Users__ul_emm_33m_hrb} Für Werte, die null sind: * Aufsteigend sortiert: Null-Werte werden nach oben sortiert. * Absteigend sortiert: Null-Werte werden nach unten sortiert. {#scim-GET-Users__ul_ts1_lhm_hrb} Datentyp: Zeichenfolge Standard: Keine Sortierung durchgeführt |
| sortOrder | Muss mit angegeben werden sortByParameter. Reihenfolge, in der sortByParameter wird auf die Rückgabeergebnisse angewendet. Gültige Werte: * Aufsteigend * Absteigend {#scim-GET-Users__ul_mmn_zrc_grb} Datentyp: Zeichenfolge Standard: Aufsteigend |
| startIndex | Einbasierter Index in der Anwendertabelle \[sys_user\], bei dem mit dem Abrufen von Datensätzen begonnen werden soll. Beispiel: Wenn Sie diesen Parameter auf 100 und festlegen countParameter für 20. Der Endpunkt gibt Datensätze 100 bis 119 zurück. Hinweis: Jeder Wert, der auf weniger als einen festgelegt ist, wird als einer interpretiert. Nicht gültig mit idPfadparameter. Datentyp: Zeichenfolge Standard: 1 |
[Tabelle : 56. Abfrageparameter]

{#scim-GET-Users__entry__22}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 57. 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.").
{#scim-GET-Users__entry__26}{#scim-GET-Users__Accept-SCIM-entry}

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

{#scim-GET-Users__entry__30}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 59. 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.").
{#scim-GET-Users__entry__34}{#scim-GET-Users__entry-200-status-code}{#scim-GET-Users__status_400-SCIM-entry}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben. * Stellen Sie sicher, dass countParameter ist nicht größer als 500. * Stellen Sie sicher, dass alle filterParameter sind gültig. {#scim-GET-Users__ul_vn1_gvz_nrb} |
[Tabelle : 60. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-GET-Users__entry__40}{#scim-GET-Users__itemsPerPage-SCIM-entry}{#scim-GET-Users__user_userName-SCIM-ph}{#scim-GET-Users__user_schemas-SCIM-entry}{#scim-GET-Users__totalResults-SCIM-entry}

| Name | Beschreibung |
|-|-|
| ItemsPerPage | Anzahl der in den Rückgabeergebnissen zurückgegebenen Datensätze. Datentyp: Zahl |
| Ressourcen | Liste der Anwenderdatensätze. Datentyp: Array von Objekten "Resources": [ { "active": Boolean, "addresses": {Object}, "displayName": "String", "emails": [Array], "externalId": "String", "groups": [Array], "id": "String", "meta": {Object}, "name": {Object}, "phoneNumbers": [Array], "preferredLanguage": "String", "schemas": [Array], "timezone": "String", "title": "String", "userName": "String", "userType": "String" } ] |
| Ressourcen.aktiv | Kennzeichnung, die angibt, ob der zugeordnete Anwender in aktiv ist ServiceNowInstanz. Mögliche Werte: * Wahr: Anwender ist aktiv. * Falsch: Anwender ist inaktiv. {#scim-GET-Users__ul_glm_qkj_grb} Datentyp: Boolescher Wert |
| Resources.adresses | Details zur aktuellen Postanschrift des Anwenders. Datentyp: Objekt "addresses": { "country": "String", "locality": "String", "postalCode": "String", "region": "String", "streetAddress": "String", "type": "String" } |
| Resources.addresses.country | Ländername. Datentyp: Zeichenfolge |
| Resources.address.locality | Name der Stadt oder des Orts. Datentyp: Zeichenfolge |
| Resources.address.postalCode | Postleitzahl. Datentyp: Zeichenfolge |
| Ressourcen.Adressen.Region | Bundesland oder Region. Datentyp: Zeichenfolge |
| Resources.address.streetAddress | Vollständige Straße und Hausnummer. Dies kann die Hausnummer, die Straße, das Postfach und mehrzeilige erweiterte Straßennutzungsinformationen umfassen. Datentyp: Zeichenfolge |
| Resources.address.type | Typ der Adresse. Derzeit nur unterstützt Startseite . Datentyp: Zeichenfolge |
| Resources.displayName | Anzeigename des Anwenders. Dieser Wert wird automatisch durch Verkettung von generiert nameFelder. Datentyp: Zeichenfolge |
| Resources.E-Mails | Liste der E-Mail-Accounts, die dem Anwender zugeordnet sind. Datentyp: Array von Objekten "emails:" [ { "type": "String", "value": "String" } ] |
| Resources.E-Mails.type | Anwender-E-Mail-Typ. Unterstützt derzeit nur den Typ „Arbeit". Datentyp: Zeichenfolge |
| Resources.E-Mails.Wert | E-Mail-Adresse des Anwenders. Dies ist ein eindeutiger Schlüssel für den zugeordneten Anwender. Datentyp: Zeichenfolge |
| Resources.externalId | Eindeutiger Bezeichner, der dem Anwender von der Entität zugewiesen wurde, die ihn bereitstellt. Datentyp: Zeichenfolge |
| Resources.groups | Liste der Gruppen, zu denen der Anwender gehört, entweder durch direkte Mitgliedschaft, geschachtelte Gruppen oder dynamisch berechnet. Datentyp: Array von Objekten "groups": [ { "display": "String", "type": "String", "value": "String", "$ref": "String" } ] |
| Resources.groups.display | Name der zugeordneten Gruppe. Datentyp: Zeichenfolge |
| Resources.groups.type | Typ der Gruppenzuordnung, z. B. direkt oder indirekt. Datentyp: Zeichenfolge |
| Resources.groups.value | SYS_ID eines zugeordneten Gruppendatensatzes. Datentyp: Zeichenfolge |
| Resources.groups.ref | URI der zugeordneten Gruppe. Datentyp: Zeichenfolge |
| Resources.ID | SYS_ID des zugeordneten Anwenderdatensatzes. Datentyp: Zeichenfolge |
| Ressourcen.Meta | Metadaten, die sich auf den Anwender beziehen. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": String", "resourceType": String" } |
| Resources.Meta.erstellt | Datum und Uhrzeit der Erstellung des Anwenderdatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des Anwenderdatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.location | URI des abgerufenen Anwenders. Datentyp: Zeichenfolge |
| Resources.Meta.resourceType | Ressourcentyp von SCIM-Anwendern. Datentyp: Zeichenfolge |
| Resources.name | Informationen zum Anwendernamen. Datentyp: Objekt "name": { "familyName": "String", "givenName": "String", "honorificPrefix": "String", "middleName": "String" } |
| Resources.name.familyName | Familie oder Nachname des Anwenders. Datentyp: Zeichenfolge |
| Resources.name.givenName | Vorname oder Vorname des Anwenders. Datentyp: Zeichenfolge |
| Resources.name.honorificPrefix | Ehrenvoller Name oder Titel des Anwenders, z. B. Dr., Bischof oder Baron. Datentyp: Zeichenfolge |
| Resources.name.middle | Zweiter Vorname des Anwenders. Datentyp: Zeichenfolge |
| Resources.Telefonnummern | Liste der Telefonnummern, die dem Anwender zugeordnet sind. Datentyp: Array von Objekten "phoneNumbers": [ { "type": "String", "value": "String" } ] |
| Resources.Telefonnummern.Typ | Typ der Telefonnummer. Mögliche Werte: * Startseite * Mobile * Arbeit {#scim-GET-Users__ul_idb_brj_grb} Datentyp: Zeichenfolge |
| Resources.Telefonnummern.Wert | Telefonnummer des Anwenders. Datentyp: Zeichenfolge |
| Ressourcen.bevorzugte Sprache | Bevorzugte gesprochene und schriftliche Sprache des Anwenders. Datentyp: Zeichenfolge |
| Resources.Schemas | Liste der URIs der SCIM-Anwenderschemata, die zur Verarbeitung der Anforderung verwendet werden. Datentyp: Array von Zeichenfolgen |
| Resources.Zeitzone | Zeitzone des Anwenders. Datentyp: Zeichenfolge |
| Resources.title | Titel des Anwenders, z. B. CEO oder Präsident. Datentyp: Zeichenfolge |
| Resources.userName | Eindeutiger Anwendername für den zugeordneten Anwender. Datentyp: Zeichenfolge |
| Resources.userType | Anwendertyp. Dieser Wert wird verwendet, um die Beziehung zwischen Organisation und Anwender zu identifizieren. Dies kann ein beliebiger Wert sein, typische Werte können jedoch Folgendes sein: * Vertragsunternehmen * Mitarbeiter * Praktikanten * Temp * Extern * Unbekannt {#scim-GET-Users__ul_kdr_nwz_nrb} Datentyp: Zeichenfolge |
| Schemas | Liste der URIs der SCIM-ListResponse-Schemas, die zur Verarbeitung der Anforderung verwendet werden. Datentyp: Array von Zeichenfolgen |
| startIndex | Einbasierter Index in der Anwendertabelle \[sys_user\], in der die Datensätze zurückgegeben wurden. Datentyp: Zeichenfolge |
| Gesamtergebnisse | Gesamtanzahl der Datensätze, die der Anforderung entsprechen. Datentyp: Zahl |
[ ]

### Erweiterungsparameter zurückgegeben {#scim-GET-Users__section_vb2_yny_jlb}

{#scim-GET-Users__id_hmw_fjk_grb__entry__2}{#scim-GET-Users__user_company-SCIM-entry}{#scim-GET-Users__user_company_display-SCIM-entry}{#scim-GET-Users__user_company_value-SCIM-ph}{#scim-GET-Users__user_company_ref-SCIM-entry}{#scim-GET-Users__user_costCenter-SCIM-entry}{#scim-GET-Users__user_costCenter_display-SCIM-entry}{#scim-GET-Users__user_costCenter_value-SCIM-ph}{#scim-GET-Users__user_costCenter_ref-SCIM-entry}{#scim-GET-Users__user_department-SCIM-entry}{#scim-GET-Users__user_department_display-SCIM-entry}{#scim-GET-Users__user_department_value-SCIM-ph}{#scim-GET-Users__user_department_ref-SCIM-entry}{#scim-GET-Users__user_employeeNumber-SCIM-entry}{#scim-GET-Users__user_gender-SCIM-entry}{#scim-GET-Users__user_location-SCIM-entry}{#scim-GET-Users__user_location_display-SCIM-entry}{#scim-GET-Users__user_location_value-SCIM-ph}{#scim-GET-Users__user_location_ref-SCIM-entry}{#scim-GET-Users__user_manager-SCIM-entry}{#scim-GET-Users__user_manager_display-SCIM-entry}{#scim-GET-Users__user_manager_value-SCIM-ph}{#scim-GET-Users__user_manager_ref-SCIM-entry}

| Name | Beschreibung |
|-|-|
| Unternehmen | Details zum zugeordneten Unternehmen des Anwenders. Datentyp: Objekt "company": { "display": "String", "value": "String", "$ref": "String" } |
| Unternehmen.Anzeige | Name des Unternehmens. Datentyp: Zeichenfolge |
| Unternehmen.Wert | SYS_ID des Unternehmensdatensatzes. Datentyp: Zeichenfolge |
| Unternehmen.$ref | Referenz-URI für das Unternehmen. Datentyp: Zeichenfolge |
| Kostenstelle | Details zur zugeordneten Kostenstelle des Anwenders. Datentyp: Objekt "costCenter": { "display": "String", "value": "String", "$ref": "String" } |
| Kostenstelle.Anzeige | Name der Kostenstelle. Datentyp: Zeichenfolge |
| Kostenstelle.Wert | SYS_ID des Kostenstellendatensatzes. Datentyp: Zeichenfolge |
| Kostenstelle.$ref | Referenz-URI für die Kostenstelle. Datentyp: Zeichenfolge |
| department | Details zur zugeordneten Abteilung des Anwenders. Datentyp: Objekt "department": { "display": "String", "value": "String", "$ref": "String" } |
| Abteilung.Anzeige | Name der Abteilung. Datentyp: Zeichenfolge |
| Abteilung.Wert | SYS_ID des Abteilungsdatensatzes. Datentyp: Zeichenfolge |
| Abteilung.$ref | Referenz-URI für die Abteilung. Datentyp: Zeichenfolge |
| Employee-Nummer | Numerische oder alphanumerische Personalnummer. Datentyp: Zeichenfolge |
| Geschlecht | Geschlecht des Anwenders, z. B. männlich oder weiblich. Datentyp: Zeichenfolge |
| location | Details zum zugeordneten Standort des Anwenders. Datentyp: Objekt "location": { "display": "String", "value": "String", "$ref": "String" } |
| Standort.Anzeige | Name des Standorts. Datentyp: Zeichenfolge |
| Standort.Wert | SYS_ID des Standortdatensatzes. Datentyp: Zeichenfolge |
| Standort.$ref | Referenz-URI für den Standort. Datentyp: Zeichenfolge |
| Manager | Details zum zugeordneten Manager des Anwenders. Datentyp: Objekt "manager": { "display": "String", "value": "String", "$ref": "String" } |
| manager.Anzeige | Name des Managers. Datentyp: Zeichenfolge |
| manager.Wert | SYS_ID des Managerdatensatzes. Datentyp: Zeichenfolge |
| manager.$ref | Referenz-URI für den Manager. Datentyp: Zeichenfolge |
[ ]

{#scim-GET-Users__id_hmw_fjk_grb}  

### Curl-Anforderung mit Attributen {#scim-GET-Users__example_kkl_rjj_grb}

Das folgende Beispiel zeigt, wie zwei Anwender ab dem sechsten Datensatz abgerufen werden und nur den Anzeigenamen zurückgeben.

    curl "https://instance-servicenow.com/api/now/scim/Users?attributes=displayName&startIndex=6&count=2" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {"schemas":
      ["urn:ietf:params:scim:api:messages:2.0:ListResponse"],
      "totalResults":619,
      "Resources":
        [
          {
            "schemas":
              [
                "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User",
                "urn:ietf:params:scim:schemas:core:2.0:User"
              ],
            "id":"02826bf03710200044e0bfc8bcbe5d6d",
            "displayName":"Sean Bonnet"
          },
          {
            "schemas":
              [
                "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User",
                "urn:ietf:params:scim:schemas:core:2.0:User"
               ],
             "id":"02826bf03710200044e0bfc8bcbe5d76",
             "displayName":"Jacinto Gawron"
          }
        ],
      "startIndex":6,
      "itemsPerPage":2
    }

### Curl-Anforderung mithilfe eines Filters {#scim-GET-Users__example_lkl_rjj_grb}

Das folgende Beispiel zeigt, wie verwendet wird filterParameter zur Rückgabe der ersten beiden Anwenderdatensätze, deren angegebener Name mit „a" beginnt.

    curl "https://instance-servicenow.com/api/now/scim/Users?filter=name.givenName%20SW%20%22a%22&count=2" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {"schemas":
      ["urn:ietf:params:scim:api:messages:2.0:ListResponse"],
      "totalResults":42,
      "Resources":
        [
          {
            "schemas":
              [
                "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User",
                "urn:ietf:params:scim:schemas:core:2.0:User"
              ],
            "id":"06826bf03710200044e0bfc8bcbe5d8a",
            "meta":
              {
                "resourceType":"User",
                "created":"2012-02-18T03:04:50Z",
                "lastModified":"2021-10-01T14:23:32Z",
                "location":"https://instance-servicenow.com/api/now/scim/Users/06826bf03710200044e0bfc8bcbe5d8a"
              },
              "userName":"allyson.gillispie",
              "name":
                {
                  "familyName":"Gillispie",
                  "givenName":"Allyson"
                },
              "displayName":"Allyson Gillispie",
              "active":true,
              "emails":
                [
                  {
                    "value":"allyson.gillispie@example.com",
                    "type":"work"
                  }
                ],
              "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User":
                {
                  "gender":"Female",
                  "costCenter":
                    {
                      "value":"d9d07bddc0a80a647cf932056ed24652",
                      "name":"Engineering"
                    },
                  "company":
                    {
                      "value":"31bea3d53790200044e0bfc8bcbe5dec",
                      "name":"ACME North America"
                    },
                  "department":
                    {
                      "value":"221f3db5c6112284009f4becd3039cc9",
                      "name":"Development"
                    },
                  "location":
                    {
                      "value":"f9084ba00a0a0b910060ba2ce83f882b",
                      "name":"946 Donax Avenue, Imperial Beach,CA"
                    }
                }
             },
          {
            "schemas":
              [
                "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User",
                "urn:ietf:params:scim:schemas:core:2.0:User"
              ],
            "id":"0a826bf03710200044e0bfc8bcbe5d7a"
            "meta":
              {
                "resourceType":"User",
                "created":"2012-02-18T03:04:50Z",
                "lastModified":"2021-10-01T14:23:32Z",
                "location":"https://instance-servicenow.com/api/now/scim/Users/0a826bf03710200044e0bfc8bcbe5d7a"
              },
            "userName":"adela.cervantsz",
            "name":
              {
                "familyName":"Cervantsz",
                "givenName":"Adela"
              },
            "displayName":"Adela Cervantsz",
            "active":true,
            "emails":
              [
                {
                  "value":"adela.cervantsz@example.com",
                  "type":"work"
                }
              ],
            "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User":
              {
                "gender":"Female",
                "costCenter":
                  {
                    "value":"91e8bbf43710200044e0bfc8bcbe5daa",
                    "name":"Customer Support"
                  },
                "company":
                  {
                    "value":"31bea3d53790200044e0bfc8bcbe5dec",
                    "name":"ACME North America"
                  },
                "department":
                  {
                    "value":"5d7f17f03710200044e0bfc8bcbe5d43",
                    "name":"Customer Support"
                  },
                "location":
                  {
                    "value":"25ab93750a0a0bb30067bd2ef3d4a5c9",
                    "name":"8306 Mills Drive, Miami,FL"
                  }
              }
        }
      ],
      "startIndex":1,
      "itemsPerPage":2
    }

## SCIM: /scim/Users/{user_ID} ABRUFEN {#ariaid-title10}

Gibt den angegebenen Anwenderdatensatz aus der Anwendertabelle \[sys_user\] in zurück ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Users/{user_ID}

Standard-URL: /api/now/scim/Users/{user_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

{#scim-GET-Users-user_id__entry__2}{#scim-GET-Users-user_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 |
| user_id | SYS_ID des zurückzugebenden Anwenderdatensatzes. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
[Tabelle : 61. Pfad-Parameter]

{#scim-GET-Users-user_id__entry__8}{#scim-GET-Users-user_id__attributes-SCIM-entry}{#scim-GET-Users-user_id__excludedAttributes-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
[Tabelle : 62. Abfrageparameter]

{#scim-GET-Users-user_id__entry__14}

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

### Header

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

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

{#scim-GET-Users-user_id__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 65. 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.").
{#scim-GET-Users-user_id__entry__26}{#scim-GET-Users-user_id__entry-200-status-code}{#scim-GET-Users-user_id__status_400-SCIM-entry}{#scim-GET-Users-user_id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben. * Stellen Sie sicher, dass countParameter ist nicht größer als 500. * Stellen Sie sicher, dass alle filterParameter sind gültig. {#scim-GET-Users-user_id__ul_vn1_gvz_nrb} |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 66. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-GET-Users-user_id__id_x11_hyj_grb__entry__2}{#scim-GET-Users-user_id__user_active-SCIM-entry}{#scim-GET-Users-user_id__user_addresses-SCIM-entry}{#scim-GET-Users-user_id__user_addresses_country-SCIM-entry}{#scim-GET-Users-user_id__user_addresses_locality-SCIM-entry}{#scim-GET-Users-user_id__user_addresses_postalCode-SCIM-entry}{#scim-GET-Users-user_id__user_addresses_region-SCIM-entry}{#scim-GET-Users-user_id__user_addresses_streetAddress-SCIM-entry}{#scim-GET-Users-user_id__user_addresses_type-SCIM-entry}{#scim-GET-Users-user_id__user_displayName-SCIM-entry}{#scim-GET-Users-user_id__user_emails-SCIM-entry}{#scim-GET-Users-user_id__user_emails_type-SCIM-entry}{#scim-GET-Users-user_id__user_emails_value-SCIM-entry}{#scim-GET-Users-user_id__user_emails_externalId-SCIM-entry}{#scim-GET-Users-user_id__user_groups-SCIM-entry}{#scim-GET-Users-user_id__user_groups_display-SCIM-entry}{#scim-GET-Users-user_id__user_groups_type-SCIM-entry}{#scim-GET-Users-user_id__user_groups_value-SCIM-entry}{#scim-GET-Users-user_id__user_groups_ref-SCIM-entry}{#scim-GET-Users-user_id__user_id-SCIM-entry}{#scim-GET-Users-user_id__user_meta-SCIM-entry}{#scim-GET-Users-user_id__user_meta_created-SCIM-entry}{#scim-GET-Users-user_id__user_meta_lastModified-SCIM-entry}{#scim-GET-Users-user_id__user_meta_location-SCIM-entry}{#scim-GET-Users-user_id__user_meta_resourceType-SCIM-entry}{#scim-GET-Users-user_id__user_name-SCIM-entry}{#scim-GET-Users-user_id__user_name_familyName-SCIM-entry}{#scim-GET-Users-user_id__user_name_givenName-SCIM-entry}{#scim-GET-Users-user_id__user_name_honorificPrefix-SCIM-entry}{#scim-GET-Users-user_id__user_name_middle-SCIM-entry}{#scim-GET-Users-user_id__user_phoneNumbers-SCIM-entry}{#scim-GET-Users-user_id__user_phoneNumbers_type-SCIM-entry}{#scim-GET-Users-user_id__user_phoneNumbers_value-SCIM-entry}{#scim-GET-Users-user_id__user_preferredLanguage-SCIM-entry}{#scim-GET-Users-user_id__user_schemas-SCIM-entry}{#scim-GET-Users-user_id__user_timezone-SCIM-entry}{#scim-GET-Users-user_id__user_title-SCIM-entry}{#scim-GET-Users-user_id__user_userName-SCIM-ph}{#scim-GET-Users-user_id__user_userType-SCIM-entry}

| Name | Beschreibung |
|-|-|
| aktiv | Kennzeichnung, die angibt, ob der zugeordnete Anwender in aktiv ist ServiceNowInstanz. Mögliche Werte: * Wahr: Anwender ist aktiv. * Falsch: Anwender ist inaktiv. {#scim-GET-Users-user_id__ul_glm_qkj_grb} Datentyp: Boolescher Wert |
| Adressen | Details zur aktuellen Postanschrift des Anwenders. Datentyp: Objekt "addresses": { "country": "String", "locality": "String", "postalCode": "String", "region": "String", "streetAddress": "String", "type": "String" } |
| Adressen.Land | Ländername. Datentyp: Zeichenfolge |
| Adressen.Ort | Name der Stadt oder des Orts. Datentyp: Zeichenfolge |
| Address.postalCode | Postleitzahl. Datentyp: Zeichenfolge |
| Adressen.Region | Bundesland oder Region. Datentyp: Zeichenfolge |
| Adressen.streetAddress | Vollständige Straße und Hausnummer. Dies kann die Hausnummer, die Straße, das Postfach und mehrzeilige erweiterte Straßennutzungsinformationen umfassen. Datentyp: Zeichenfolge |
| Address.type | Typ der Adresse. Derzeit nur unterstützt Startseite . Datentyp: Zeichenfolge |
| displayName | Anzeigename des Anwenders. Dieser Wert wird automatisch durch Verkettung von generiert nameFelder. Datentyp: Zeichenfolge |
| E-Mails | Liste der E-Mail-Accounts, die dem Anwender zugeordnet sind. Datentyp: Array von Objekten "emails:" [ { "type": "String", "value": "String" } ] |
| E-Mails.Typ | Anwender-E-Mail-Typ. Unterstützt derzeit nur den Typ „Arbeit". Datentyp: Zeichenfolge |
| E-Mails.Wert | E-Mail-Adresse des Anwenders. Dies ist ein eindeutiger Schlüssel für den zugeordneten Anwender. Datentyp: Zeichenfolge |
| externalId | Eindeutiger Bezeichner, der dem Anwender von der Entität zugewiesen wurde, die ihn bereitstellt. Datentyp: Zeichenfolge |
| groups | Liste der Gruppen, zu denen der Anwender gehört, entweder durch direkte Mitgliedschaft, geschachtelte Gruppen oder dynamisch berechnet. Datentyp: Array von Objekten "groups": [ { "display": "String", "type": "String", "value": "String", "$ref": "String" } ] |
| Gruppen.Anzeige | Name der zugeordneten Gruppe. Datentyp: Zeichenfolge |
| Groups.type | Typ der Gruppenzuordnung, z. B. direkt oder indirekt. Datentyp: Zeichenfolge |
| Gruppen.Wert | SYS_ID eines zugeordneten Gruppendatensatzes. Datentyp: Zeichenfolge |
| Gruppen.$ref | URI der zugeordneten Gruppe. Datentyp: Zeichenfolge |
| ID | SYS_ID des zugeordneten Anwenderdatensatzes. Datentyp: Zeichenfolge |
| Meta | Metadaten, die sich auf den Anwender beziehen. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": String", "resourceType": String" } |
| Meta.erstellt | Datum und Uhrzeit der Erstellung des Anwenderdatensatzes. Datentyp: Zeichenfolge |
| Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des Anwenderdatensatzes. Datentyp: Zeichenfolge |
| Meta.Standort | URI des abgerufenen Anwenders. Datentyp: Zeichenfolge |
| Meta.resourceType | Ressourcentyp von SCIM-Anwendern. Datentyp: Zeichenfolge |
| name | Informationen zum Anwendernamen. Datentyp: Objekt "name": { "familyName": "String", "givenName": "String", "honorificPrefix": "String", "middleName": "String" } |
| Name.FAMILYNAME | Familie oder Nachname des Anwenders. Datentyp: Zeichenfolge |
| Name.givenName | Vorname oder Vorname des Anwenders. Datentyp: Zeichenfolge |
| Name.HonorificPräfix | Ehrenvoller Name oder Titel des Anwenders, z. B. Dr., Bischof oder Baron. Datentyp: Zeichenfolge |
| Name.Mitte | Zweiter Vorname des Anwenders. Datentyp: Zeichenfolge |
| phoneNumbers | Liste der Telefonnummern, die dem Anwender zugeordnet sind. Datentyp: Array von Objekten "phoneNumbers": [ { "type": "String", "value": "String" } ] |
| Telefonnummern.Typ | Typ der Telefonnummer. Mögliche Werte: * Startseite * Mobile * Arbeit {#scim-GET-Users-user_id__ul_idb_brj_grb} Datentyp: Zeichenfolge |
| Telefonnummern.Wert | Telefonnummer des Anwenders. Datentyp: Zeichenfolge |
| Bevorzugte Sprache | Bevorzugte gesprochene und schriftliche Sprache des Anwenders. Datentyp: Zeichenfolge |
| Schemas | Liste der URIs der SCIM-Anwenderschemata, die zur Verarbeitung der Anforderung verwendet werden. Datentyp: Array von Zeichenfolgen |
| Feld | Zeitzone des Anwenders. Datentyp: Zeichenfolge |
| Titel | Titel des Anwenders, z. B. CEO oder Präsident. Datentyp: Zeichenfolge |
| userName | Eindeutiger Anwendername für den zugeordneten Anwender. Datentyp: Zeichenfolge |
| Anwendertyp | Anwendertyp. Dieser Wert wird verwendet, um die Beziehung zwischen Organisation und Anwender zu identifizieren. Dies kann ein beliebiger Wert sein, typische Werte können jedoch Folgendes sein: * Vertragsunternehmen * Mitarbeiter * Praktikanten * Temp * Extern * Unbekannt {#scim-GET-Users-user_id__ul_kdr_nwz_nrb} Datentyp: Zeichenfolge |
[ ]

{#scim-GET-Users-user_id__id_x11_hyj_grb}

### Erweiterungsparameter zurückgegeben {#scim-GET-Users-user_id__section_vb2_yny_jlb}

{#scim-GET-Users-user_id__id_hmw_fjk_grb__entry__2}{#scim-GET-Users-user_id__user_company-SCIM-entry}{#scim-GET-Users-user_id__user_company_display-SCIM-entry}{#scim-GET-Users-user_id__user_company_value-SCIM-ph}{#scim-GET-Users-user_id__user_company_ref-SCIM-entry}{#scim-GET-Users-user_id__user_costCenter-SCIM-entry}{#scim-GET-Users-user_id__user_costCenter_display-SCIM-entry}{#scim-GET-Users-user_id__user_costCenter_value-SCIM-ph}{#scim-GET-Users-user_id__user_costCenter_ref-SCIM-entry}{#scim-GET-Users-user_id__user_department-SCIM-entry}{#scim-GET-Users-user_id__user_department_display-SCIM-entry}{#scim-GET-Users-user_id__user_department_value-SCIM-ph}{#scim-GET-Users-user_id__user_department_ref-SCIM-entry}{#scim-GET-Users-user_id__user_employeeNumber-SCIM-entry}{#scim-GET-Users-user_id__user_gender-SCIM-entry}{#scim-GET-Users-user_id__user_location-SCIM-entry}{#scim-GET-Users-user_id__user_location_display-SCIM-entry}{#scim-GET-Users-user_id__user_location_value-SCIM-ph}{#scim-GET-Users-user_id__user_location_ref-SCIM-entry}{#scim-GET-Users-user_id__user_manager-SCIM-entry}{#scim-GET-Users-user_id__user_manager_display-SCIM-entry}{#scim-GET-Users-user_id__user_manager_value-SCIM-ph}{#scim-GET-Users-user_id__user_manager_ref-SCIM-entry}

| Name | Beschreibung |
|-|-|
| Unternehmen | Details zum zugeordneten Unternehmen des Anwenders. Datentyp: Objekt "company": { "display": "String", "value": "String", "$ref": "String" } |
| Unternehmen.Anzeige | Name des Unternehmens. Datentyp: Zeichenfolge |
| Unternehmen.Wert | SYS_ID des Unternehmensdatensatzes. Datentyp: Zeichenfolge |
| Unternehmen.$ref | Referenz-URI für das Unternehmen. Datentyp: Zeichenfolge |
| Kostenstelle | Details zur zugeordneten Kostenstelle des Anwenders. Datentyp: Objekt "costCenter": { "display": "String", "value": "String", "$ref": "String" } |
| Kostenstelle.Anzeige | Name der Kostenstelle. Datentyp: Zeichenfolge |
| Kostenstelle.Wert | SYS_ID des Kostenstellendatensatzes. Datentyp: Zeichenfolge |
| Kostenstelle.$ref | Referenz-URI für die Kostenstelle. Datentyp: Zeichenfolge |
| department | Details zur zugeordneten Abteilung des Anwenders. Datentyp: Objekt "department": { "display": "String", "value": "String", "$ref": "String" } |
| Abteilung.Anzeige | Name der Abteilung. Datentyp: Zeichenfolge |
| Abteilung.Wert | SYS_ID des Abteilungsdatensatzes. Datentyp: Zeichenfolge |
| Abteilung.$ref | Referenz-URI für die Abteilung. Datentyp: Zeichenfolge |
| Employee-Nummer | Numerische oder alphanumerische Personalnummer. Datentyp: Zeichenfolge |
| Geschlecht | Geschlecht des Anwenders, z. B. männlich oder weiblich. Datentyp: Zeichenfolge |
| location | Details zum zugeordneten Standort des Anwenders. Datentyp: Objekt "location": { "display": "String", "value": "String", "$ref": "String" } |
| Standort.Anzeige | Name des Standorts. Datentyp: Zeichenfolge |
| Standort.Wert | SYS_ID des Standortdatensatzes. Datentyp: Zeichenfolge |
| Standort.$ref | Referenz-URI für den Standort. Datentyp: Zeichenfolge |
| Manager | Details zum zugeordneten Manager des Anwenders. Datentyp: Objekt "manager": { "display": "String", "value": "String", "$ref": "String" } |
| manager.Anzeige | Name des Managers. Datentyp: Zeichenfolge |
| manager.Wert | SYS_ID des Managerdatensatzes. Datentyp: Zeichenfolge |
| manager.$ref | Referenz-URI für den Manager. Datentyp: Zeichenfolge |
[ ]

{#scim-GET-Users-user_id__id_hmw_fjk_grb}  

### Curl-Anforderung mit sys_ID des Anwenders

Das folgende Beispiel zeigt, wie Sie einen bestimmten Anwenderdatensatz erhalten, indem Sie seine sys_ID übergeben

    curl "https://instance-servicenow.com/api/now/scim/Users/62826bf03710200044e0bfc8bcbe5df1" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {"schemas":
      [
        "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User",
        "urn:ietf:params:scim:schemas:core:2.0:User"
      ],
        "id":"62826bf03710200044e0bfc8bcbe5df1",
        "meta":
          {
            "resourceType":"User",
            "created":"2012-02-18T03:04:52Z",
            "lastModified":"2021-10-01T14:23:34Z",
            "location":"https://instance-servicenow.com/api/now/scim/Users/62826bf03710200044e0bfc8bcbe5df1"
          },
        "userName":"abel.tuter",
        "name":
          {
            "familyName":"Tuter",
            "givenName":"Abel"
          },
        "displayName":"Abel Tuter",
        "active":true,
        "emails":[
          {
            "value":"abel.tuter@example.com",
            "type":"work"
          }
        ],
        "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User":
          {
            "gender":"Male",
            "costCenter":
              {
                "value":"d9d07bddc0a80a647cf932056ed24652",
                "name":"Engineering"
              },
            "company":
              {
                "value":"227cdfb03710200044e0bfc8bcbe5d6b",
                "name":"ACME South America"
              },
            "department":
              {
                "value":"9a7ed3f03710200044e0bfc8bcbe5db7",
                "name":"Product Management"
               },
            "location":
              {
                "value":"25b3d04b0a0a0bb300176b546c22db27",
                "name":"SHS quadra 5, Bloco E., Brasilia"}
              }
          }

## SCIM -- PATCH /scim/Users/{user_ID} {#ariaid-title11}

Ermöglicht Ihnen das Hinzufügen, Ersetzen und Entfernen angegebener Felder in einem Anwenderdatensatz in der Anwendertabelle \[sys_user\] von ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Users/{user_ID}

Standard-URL: /api/now/scim/Users/{user_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

{#scim-PATCH-Users-user_id__entry__2}{#scim-PATCH-Users-user_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 |
| user_id | SYS_ID des zu ändernden Anwenderdatensatzes. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
[Tabelle : 67. Pfad-Parameter]

{#scim-PATCH-Users-user_id__entry__8}{#scim-PATCH-Users-user_id__attributes-SCIM-entry}{#scim-PATCH-Users-user_id__excludedAttributes-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
[Tabelle : 68. Abfrageparameter]

{#scim-PATCH-Users-user_id__entry__14}

| Name | Beschreibung |
|-|-|
| Vorgänge | Erforderlich. Liste der Vorgangsobjekte, mit denen der angegebene Anwenderdatensatz gepatcht werden soll. Datentyp: Array "Operations": [ { "op": "String", "path": "String", "value": Any } ] |
| Vorgänge.OP | Erforderlich. Auszuführender Vorgang. Gültige Werte: * Hinzufügen: Fügen Sie dem Anwenderdatensatz das angegebene Feld und den angegebenen Wert hinzu. * Entfernen: Entfernen Sie den Wert aus dem angegebenen Feld. * Ersetzen: Ersetzen Sie den Wert des angegebenen Felds. {#scim-PATCH-Users-user_id__ul_zcf_ydv_frb} Datentyp: Zeichenfolge |
| Vorgänge.Pfad | Erforderlich für `Entfernen `Vorgänge. Name/Pfad des zu ändernden Felds. Die pathParameter kann eines der folgenden Formate haben: * Ein direktes Feld, z. B. `Titel ` * Geschachtelte Felder, z. B. `Name.givenName ` * Im Falle eines komplexen Arrays kann es mit einem Filter auf ein bestimmtes Element verweisen, z. B.: `E-Mails[type eq „work"] ` {#scim-PATCH-Users-user_id__ul_zpv_ls5_frb} { "schemas": [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ], "Operations": [ { "op": "add", "path": "title", "value": "xyz" }, { "op": "replace", "path": "name.givenName", "value": "Jennifer" }, { "op": "replace", "path": "emails[type eq \"work\"]", "value": "xyz@test.com" } ] } Datentyp: Zeichenfolge Standard: Betrachtet das Feld als Anwenderressource. |
| Vorgänge.Wert | Wert des Felds, das in angegeben ist Operations.pathParameter. Das Format dieses Parameters hängt vom Datentyp des zugehörigen Felds ab. Beispiel: Wenn Sie eine einfache Zeichenfolge aktualisieren, z. B. den Titel, die valueFeld wird als Zeichenfolge ausgedrückt. "Operations": [ { "op": "add", "path": "title", "value": "xyz" } ] Sie können auch einfache Zeichenfolgenwerte deklarieren, ohne zu verwenden valueOder pathParameter, z. B.: "Operations": [ { "op": "add", "title": "xyz" } ] Beim Aktualisieren einer Telefonnummer, bei der es sich um ein Array handelt, das Objekte enthält, die zusätzliche Felder definieren, die dem Anwenderdatensatz und den zugehörigen Werten hinzugefügt werden sollen, wird jedoch die aktualisiert valueFeld wird als Array von Objekten ausgedrückt. "Operations": [ { "op": "add", "path": "phoneNumbers", "value": [ { "type": "work", "value": "9876543210" }, { "type": "home", "value": "9876783216" } ] } ] Wenn Sie Attributknoten angeben, kann der Eintrag die Verschachtelung wie folgt enthalten: { "op": "replace", "value": { "name": { "familyName": "Jones", "givenName": "Jennifer" } } } Oder Sie können die Verschachtelung in angeben Operations.path: { "op": "replace", "path": "name.givenName", "value": "Jennifer" } Wenn sich das zu aktualisierende Feld nicht im Basisschema befindet, müssen Sie das Name-Wert-Paar in ein Objekt einschließen, das die URN des zugeordneten Schemas angibt. "value": { "<schema_urn>": { "<field_name>": "<new_value>" }, } Zum Beispiel: "value": { "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User": { "employeeNumber": "13454" }, } Datentyp: Beliebig |
| Vorgänge.Wert.Typ | Name des zu aktualisierenden Felds. Datentyp: Zeichenfolge |
| Vorgänge.Wert.Wert | Wert, mit dem das Feld aktualisiert werden soll. Datentyp: Zeichenfolge |
| Schemas | Erforderlich. SCIM-Schema-URI des Patchvorgangs `URN:ietf:params:scim:api:messages:2,0:PatchOp `. Datentyp: Zeichenfolge |
[Tabelle : 69. Anforderungstext-Parameter (JSON)]

### Header

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

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

{#scim-PATCH-Users-user_id__entry__36}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 71. 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.").
{#scim-PATCH-Users-user_id__entry__40}{#scim-PATCH-Users-user_id__entry-200-status-code}{#scim-PATCH-Users-user_id__entry-404-status-code}{#scim-PATCH-Users-user_id__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. * Auf ungültige Werte prüfen: * Fehlerhafter Anforderungstext. * Pflichtfeld ist nicht angegeben oder leer. * Ungültige Anwender- oder Gruppen-sys_ID angegeben. {#scim-PATCH-Users-user_id__ul_dwt_rtd_grb} * Überprüfen Sie, ob ein schreibgeschütztes oder unveränderliches Feld versucht, geändert zu werden. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben, oder dass die Anforderung die maximale Anzahl von Mitgliedern nicht überschreitet. {#scim-PATCH-Users-user_id__ul_ypm_ptd_grb} |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 409 | Anwender ist bereits vorhanden. Die userNameParameter muss eindeutig sein. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 72. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-PATCH-Users-user_id__table_mjy_k1l_grb__entry__2}{#scim-PATCH-Users-user_id__user_active-SCIM-entry}{#scim-PATCH-Users-user_id__user_addresses-SCIM-entry}{#scim-PATCH-Users-user_id__user_addresses_country-SCIM-entry}{#scim-PATCH-Users-user_id__user_addresses_locality-SCIM-entry}{#scim-PATCH-Users-user_id__user_addresses_postalCode-SCIM-entry}{#scim-PATCH-Users-user_id__user_addresses_region-SCIM-entry}{#scim-PATCH-Users-user_id__user_addresses_streetAddress-SCIM-entry}{#scim-PATCH-Users-user_id__user_addresses_type-SCIM-entry}{#scim-PATCH-Users-user_id__user_displayName-SCIM-entry}{#scim-PATCH-Users-user_id__user_emails-SCIM-entry}{#scim-PATCH-Users-user_id__user_emails_type-SCIM-entry}{#scim-PATCH-Users-user_id__user_emails_value-SCIM-entry}{#scim-PATCH-Users-user_id__errors-SCIM-entry}{#scim-PATCH-Users-user_id__errors_details-SCIM-entry}{#scim-PATCH-Users-user_id__errors_scimType-SCIM-entry}{#scim-PATCH-Users-user_id__errors_schemas-SCIM-entry}{#scim-PATCH-Users-user_id__errors_status-SCIM-entry}{#scim-PATCH-Users-user_id__user_emails_externalId-SCIM-entry}{#scim-PATCH-Users-user_id__user_groups-SCIM-entry}{#scim-PATCH-Users-user_id__user_groups_display-SCIM-entry}{#scim-PATCH-Users-user_id__user_groups_type-SCIM-entry}{#scim-PATCH-Users-user_id__user_groups_value-SCIM-entry}{#scim-PATCH-Users-user_id__user_groups_ref-SCIM-entry}{#scim-PATCH-Users-user_id__user_id-SCIM-entry}{#scim-PATCH-Users-user_id__user_meta-SCIM-entry}{#scim-PATCH-Users-user_id__user_meta_created-SCIM-entry}{#scim-PATCH-Users-user_id__user_meta_lastModified-SCIM-entry}{#scim-PATCH-Users-user_id__user_meta_location-SCIM-entry}{#scim-PATCH-Users-user_id__user_meta_resourceType-SCIM-entry}{#scim-PATCH-Users-user_id__user_name-SCIM-entry}{#scim-PATCH-Users-user_id__user_name_familyName-SCIM-entry}{#scim-PATCH-Users-user_id__user_name_givenName-SCIM-entry}{#scim-PATCH-Users-user_id__user_name_honorificPrefix-SCIM-entry}{#scim-PATCH-Users-user_id__user_name_middle-SCIM-entry}{#scim-PATCH-Users-user_id__user_phoneNumbers-SCIM-entry}{#scim-PATCH-Users-user_id__user_phoneNumbers_type-SCIM-entry}{#scim-PATCH-Users-user_id__user_phoneNumbers_value-SCIM-entry}{#scim-PATCH-Users-user_id__user_preferredLanguage-SCIM-entry}{#scim-PATCH-Users-user_id__user_schemas-SCIM-entry}{#scim-PATCH-Users-user_id__user_timezone-SCIM-entry}{#scim-PATCH-Users-user_id__user_title-SCIM-entry}{#scim-PATCH-Users-user_id__user_userName-SCIM-ph}{#scim-PATCH-Users-user_id__user_userType-SCIM-entry}

| Name | Beschreibung |
|-|-|
| aktiv | Kennzeichnung, die angibt, ob der zugeordnete Anwender in aktiv ist ServiceNowInstanz. Mögliche Werte: * Wahr: Anwender ist aktiv. * Falsch: Anwender ist inaktiv. {#scim-PATCH-Users-user_id__ul_glm_qkj_grb} Datentyp: Boolescher Wert |
| Adressen | Details zur aktuellen Postanschrift des Anwenders. Datentyp: Objekt "addresses": { "country": "String", "locality": "String", "postalCode": "String", "region": "String", "streetAddress": "String", "type": "String" } |
| Adressen.Land | Ländername. Datentyp: Zeichenfolge |
| Adressen.Ort | Name der Stadt oder des Orts. Datentyp: Zeichenfolge |
| Address.postalCode | Postleitzahl. Datentyp: Zeichenfolge |
| Adressen.Region | Bundesland oder Region. Datentyp: Zeichenfolge |
| Adressen.streetAddress | Vollständige Straße und Hausnummer. Dies kann die Hausnummer, die Straße, das Postfach und mehrzeilige erweiterte Straßennutzungsinformationen umfassen. Datentyp: Zeichenfolge |
| Address.type | Typ der Adresse. Derzeit nur unterstützt Startseite . Datentyp: Zeichenfolge |
| displayName | Anzeigename des Anwenders. Dieser Wert wird automatisch durch Verkettung von generiert nameFelder. Datentyp: Zeichenfolge |
| E-Mails | Liste der E-Mail-Accounts, die dem Anwender zugeordnet sind. Datentyp: Array von Objekten "emails:" [ { "type": "String", "value": "String" } ] |
| E-Mails.Typ | Anwender-E-Mail-Typ. Unterstützt derzeit nur den Typ „Arbeit". Datentyp: Zeichenfolge |
| E-Mails.Wert | E-Mail-Adresse des Anwenders. Dies ist ein eindeutiger Schlüssel für den zugeordneten Anwender. Datentyp: Zeichenfolge |
| Fehler | Antwort, die alle Fehler beschreibt, die während der Verarbeitung der Anforderung aufgetreten sind. Datentyp: Objekt "errors": { "details": "String", "schemas": "String", "scimType": "String", "status": "String" } |
| errors.detail | Detaillierte Fehlermeldung, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Fehler.scimType | SCIM-Fehlerdetailstichwort. Datentyp: Zeichenfolge |
| Fehler.Schemas | URI der SCIM-Schemata, die zur Verarbeitung der Fehlerantwort verwendet werden. Datentyp: Array von Zeichenfolgen |
| Fehler.Status | HTTP-Statuscode für die Fehlerantwort. Datentyp: Zeichenfolge |
| externalId | Eindeutiger Bezeichner, der dem Anwender von der Entität zugewiesen wurde, die ihn bereitstellt. Datentyp: Zeichenfolge |
| groups | Liste der Gruppen, zu denen der Anwender gehört, entweder durch direkte Mitgliedschaft, geschachtelte Gruppen oder dynamisch berechnet. Datentyp: Array von Objekten "groups": [ { "display": "String", "type": "String", "value": "String", "$ref": "String" } ] |
| Gruppen.Anzeige | Name der zugeordneten Gruppe. Datentyp: Zeichenfolge |
| Groups.type | Typ der Gruppenzuordnung, z. B. direkt oder indirekt. Datentyp: Zeichenfolge |
| Gruppen.Wert | SYS_ID eines zugeordneten Gruppendatensatzes. Datentyp: Zeichenfolge |
| Gruppen.$ref | URI der zugeordneten Gruppe. Datentyp: Zeichenfolge |
| ID | SYS_ID des zugeordneten Anwenderdatensatzes. Datentyp: Zeichenfolge |
| Meta | Metadaten, die sich auf den Anwender beziehen. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": String", "resourceType": String" } |
| Meta.erstellt | Datum und Uhrzeit der Erstellung des Anwenderdatensatzes. Datentyp: Zeichenfolge |
| Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des Anwenderdatensatzes. Datentyp: Zeichenfolge |
| Meta.Standort | URI des abgerufenen Anwenders. Datentyp: Zeichenfolge |
| Meta.resourceType | Ressourcentyp von SCIM-Anwendern. Datentyp: Zeichenfolge |
| name | Informationen zum Anwendernamen. Datentyp: Objekt "name": { "familyName": "String", "givenName": "String", "honorificPrefix": "String", "middleName": "String" } |
| Name.FAMILYNAME | Familie oder Nachname des Anwenders. Datentyp: Zeichenfolge |
| Name.givenName | Vorname oder Vorname des Anwenders. Datentyp: Zeichenfolge |
| Name.HonorificPräfix | Ehrenvoller Name oder Titel des Anwenders, z. B. Dr., Bischof oder Baron. Datentyp: Zeichenfolge |
| Name.Mitte | Zweiter Vorname des Anwenders. Datentyp: Zeichenfolge |
| phoneNumbers | Liste der Telefonnummern, die dem Anwender zugeordnet sind. Datentyp: Array von Objekten "phoneNumbers": [ { "type": "String", "value": "String" } ] |
| Telefonnummern.Typ | Typ der Telefonnummer. Mögliche Werte: * Startseite * Mobile * Arbeit {#scim-PATCH-Users-user_id__ul_idb_brj_grb} Datentyp: Zeichenfolge |
| Telefonnummern.Wert | Telefonnummer des Anwenders. Datentyp: Zeichenfolge |
| Bevorzugte Sprache | Bevorzugte gesprochene und schriftliche Sprache des Anwenders. Datentyp: Zeichenfolge |
| Schemas | Liste der URIs der SCIM-Anwenderschemata, die zur Verarbeitung der Anforderung verwendet werden. Datentyp: Array von Zeichenfolgen |
| Feld | Zeitzone des Anwenders. Datentyp: Zeichenfolge |
| Titel | Titel des Anwenders, z. B. CEO oder Präsident. Datentyp: Zeichenfolge |
| userName | Eindeutiger Anwendername für den zugeordneten Anwender. Datentyp: Zeichenfolge |
| Anwendertyp | Anwendertyp. Dieser Wert wird verwendet, um die Beziehung zwischen Organisation und Anwender zu identifizieren. Dies kann ein beliebiger Wert sein, typische Werte können jedoch Folgendes sein: * Vertragsunternehmen * Mitarbeiter * Praktikanten * Temp * Extern * Unbekannt {#scim-PATCH-Users-user_id__ul_kdr_nwz_nrb} Datentyp: Zeichenfolge |
[ ]

{#scim-PATCH-Users-user_id__table_mjy_k1l_grb}

### Erweiterungsparameter zurückgegeben {#scim-PATCH-Users-user_id__section_vb2_yny_jlb}

{#scim-PATCH-Users-user_id__id_hmw_fjk_grb__entry__2}{#scim-PATCH-Users-user_id__user_company-SCIM-entry}{#scim-PATCH-Users-user_id__user_company_display-SCIM-entry}{#scim-PATCH-Users-user_id__user_company_value-SCIM-ph}{#scim-PATCH-Users-user_id__user_company_ref-SCIM-entry}{#scim-PATCH-Users-user_id__user_costCenter-SCIM-entry}{#scim-PATCH-Users-user_id__user_costCenter_display-SCIM-entry}{#scim-PATCH-Users-user_id__user_costCenter_value-SCIM-ph}{#scim-PATCH-Users-user_id__user_costCenter_ref-SCIM-entry}{#scim-PATCH-Users-user_id__user_department-SCIM-entry}{#scim-PATCH-Users-user_id__user_department_display-SCIM-entry}{#scim-PATCH-Users-user_id__user_department_value-SCIM-ph}{#scim-PATCH-Users-user_id__user_department_ref-SCIM-entry}{#scim-PATCH-Users-user_id__user_employeeNumber-SCIM-entry}{#scim-PATCH-Users-user_id__user_gender-SCIM-entry}{#scim-PATCH-Users-user_id__user_location-SCIM-entry}{#scim-PATCH-Users-user_id__user_location_display-SCIM-entry}{#scim-PATCH-Users-user_id__user_location_value-SCIM-ph}{#scim-PATCH-Users-user_id__user_location_ref-SCIM-entry}{#scim-PATCH-Users-user_id__user_manager-SCIM-entry}{#scim-PATCH-Users-user_id__user_manager_display-SCIM-entry}{#scim-PATCH-Users-user_id__user_manager_value-SCIM-ph}{#scim-PATCH-Users-user_id__user_manager_ref-SCIM-entry}

| Name | Beschreibung |
|-|-|
| Unternehmen | Details zum zugeordneten Unternehmen des Anwenders. Datentyp: Objekt "company": { "display": "String", "value": "String", "$ref": "String" } |
| Unternehmen.Anzeige | Name des Unternehmens. Datentyp: Zeichenfolge |
| Unternehmen.Wert | SYS_ID des Unternehmensdatensatzes. Datentyp: Zeichenfolge |
| Unternehmen.$ref | Referenz-URI für das Unternehmen. Datentyp: Zeichenfolge |
| Kostenstelle | Details zur zugeordneten Kostenstelle des Anwenders. Datentyp: Objekt "costCenter": { "display": "String", "value": "String", "$ref": "String" } |
| Kostenstelle.Anzeige | Name der Kostenstelle. Datentyp: Zeichenfolge |
| Kostenstelle.Wert | SYS_ID des Kostenstellendatensatzes. Datentyp: Zeichenfolge |
| Kostenstelle.$ref | Referenz-URI für die Kostenstelle. Datentyp: Zeichenfolge |
| department | Details zur zugeordneten Abteilung des Anwenders. Datentyp: Objekt "department": { "display": "String", "value": "String", "$ref": "String" } |
| Abteilung.Anzeige | Name der Abteilung. Datentyp: Zeichenfolge |
| Abteilung.Wert | SYS_ID des Abteilungsdatensatzes. Datentyp: Zeichenfolge |
| Abteilung.$ref | Referenz-URI für die Abteilung. Datentyp: Zeichenfolge |
| Employee-Nummer | Numerische oder alphanumerische Personalnummer. Datentyp: Zeichenfolge |
| Geschlecht | Geschlecht des Anwenders, z. B. männlich oder weiblich. Datentyp: Zeichenfolge |
| location | Details zum zugeordneten Standort des Anwenders. Datentyp: Objekt "location": { "display": "String", "value": "String", "$ref": "String" } |
| Standort.Anzeige | Name des Standorts. Datentyp: Zeichenfolge |
| Standort.Wert | SYS_ID des Standortdatensatzes. Datentyp: Zeichenfolge |
| Standort.$ref | Referenz-URI für den Standort. Datentyp: Zeichenfolge |
| Manager | Details zum zugeordneten Manager des Anwenders. Datentyp: Objekt "manager": { "display": "String", "value": "String", "$ref": "String" } |
| manager.Anzeige | Name des Managers. Datentyp: Zeichenfolge |
| manager.Wert | SYS_ID des Managerdatensatzes. Datentyp: Zeichenfolge |
| manager.$ref | Referenz-URI für den Manager. Datentyp: Zeichenfolge |
[ ]

{#scim-PATCH-Users-user_id__id_hmw_fjk_grb}  

### Curl-Anforderung

Das folgende Beispiel zeigt, wie Werte in einem Anwenderdatensatz hinzugefügt, entfernt und ersetzt werden.

    curl -X PATCH \
      https://instance-servicenow.com/api/now/scim/Users/005d500b536073005e0addeeff7b12f4 \
      -d '{
      "schemas": [
        "urn:ietf:params:scim:api:messages:2.0:PatchOp"
      ],
      "Operations": [
        {
          "op" : "remove",
          "path" : "title" 
        },
        {
          "op" : "add",
          "path" : "phoneNumbers",
          "value" : [
            {
              "type" : "work",
              "value" : "9876543210"
            }
          ]
        },
        {
          "op": "replace",
          "value": {
            "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User": {
                "employeeNumber": "13454"
            },
            "name": {
                "familyName": "John",
                "givenName": "Smith"
            }
          }
        }
      ]
    }'

Antwort:

    {
      "schemas":[
        "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User",
        "urn:ietf:params:scim:schemas:core:2.0:User"
      ],
      "id":"005d500b536073005e0addeeff7b12f4",
      "meta":{
        "resourceType":"User",
        "created":"2019-04-05T21:09:12Z",
        "lastModified":"2021-10-12T18:29:27Z",
        "location":"https://instance-servicenow.com/api/now/scim/Users/005d500b536073005e0addeeff7b12f4"
      },
      "userName":"survey.user",
      "name":{
        "familyName":"John",
        "givenName":"Smith"
      },
      "displayName":"Smith John",
      "active":true,
      "emails":[
        {
          "value":"survey.user@email.com",
          "type":"work"
        }
      ],
      "phoneNumbers":[
        {
          "value":"9876543210",
          "type":"work"
        }
      ],
      "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User":{
        "employeeNumber":"13454"
      }
    }

## SCIM: /scim/Users VERÖFFENTLICHEN {#ariaid-title12}

Erstellt einen Anwenderdatensatz in der Anwendertabelle \[sys_user\] von ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.
Hinweis:  
Die in der RFC7643-Spezifikation angegebenen Such- und Massenänderungen werden von diesem Endpunkt nicht unterstützt.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Anwender

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

{#scim-POST-Users__entry__2}{#scim-POST-Users__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 |
[Tabelle : 73. Pfad-Parameter]

{#scim-POST-Users__entry__6}{#scim-POST-Users__attributes-SCIM-entry}{#scim-POST-Users__excludedAttributes-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
[Tabelle : 74. Abfrageparameter]

{#scim-POST-Users__entry__12}{#scim-POST-Users__user_active-SCIM-entry}{#scim-POST-Users__user_addresses-SCIM-entry}{#scim-POST-Users__user_addresses_country-SCIM-entry}{#scim-POST-Users__user_addresses_locality-SCIM-entry}{#scim-POST-Users__user_addresses_postalCode-SCIM-entry}{#scim-POST-Users__user_addresses_region-SCIM-entry}{#scim-POST-Users__user_addresses_streetAddress-SCIM-entry}{#scim-POST-Users__user_addresses_type-SCIM-entry}{#scim-POST-Users__user_displayName-SCIM-entry}{#scim-POST-Users__user_emails-SCIM-entry}{#scim-POST-Users__user_emails_type-SCIM-entry}{#scim-POST-Users__user_emails_value-SCIM-entry}{#scim-POST-Users__user_emails_externalId-SCIM-entry}{#scim-POST-Users__user_name-SCIM-entry}{#scim-POST-Users__user_name_familyName-SCIM-entry}{#scim-POST-Users__user_name_givenName-SCIM-entry}{#scim-POST-Users__user_name_honorificPrefix-SCIM-entry}{#scim-POST-Users__user_name_middle-SCIM-entry}{#scim-POST-Users__user_phoneNumbers-SCIM-entry}{#scim-POST-Users__user_phoneNumbers_type-SCIM-entry}{#scim-POST-Users__user_phoneNumbers_value-SCIM-entry}{#scim-POST-Users__user_preferredLanguage-SCIM-entry}{#scim-POST-Users__user_timezone-SCIM-entry}{#scim-POST-Users__user_title-SCIM-entry}{#scim-POST-Users__user_userType-SCIM-entry}{#scim-POST-Users__user_employeeNumber-SCIM-entry}{#scim-POST-Users__user_gender-SCIM-entry}

| Name | Beschreibung |
|-|-|
| aktiv | Kennzeichnung, die angibt, ob der zugeordnete Anwender in aktiv ist ServiceNowInstanz. Mögliche Werte: * Wahr: Anwender ist aktiv. * Falsch: Anwender ist inaktiv. {#scim-POST-Users__ul_glm_qkj_grb} Datentyp: Boolescher Wert |
| Adressen | Details zur aktuellen Postanschrift des Anwenders. Datentyp: Objekt "addresses": { "country": "String", "locality": "String", "postalCode": "String", "region": "String", "streetAddress": "String", "type": "String" } |
| Adressen.Land | Ländername. Datentyp: Zeichenfolge |
| Adressen.Ort | Name der Stadt oder des Orts. Datentyp: Zeichenfolge |
| Address.postalCode | Postleitzahl. Datentyp: Zeichenfolge |
| Adressen.Region | Bundesland oder Region. Datentyp: Zeichenfolge |
| Adressen.streetAddress | Vollständige Straße und Hausnummer. Dies kann die Hausnummer, die Straße, das Postfach und mehrzeilige erweiterte Straßennutzungsinformationen umfassen. Datentyp: Zeichenfolge |
| Address.type | Typ der Adresse. Derzeit nur unterstützt Startseite . Datentyp: Zeichenfolge |
| displayName | Anzeigename des Anwenders. Dieser Wert wird automatisch durch Verkettung von generiert nameFelder. Datentyp: Zeichenfolge |
| E-Mails | Liste der E-Mail-Accounts, die dem Anwender zugeordnet sind. Datentyp: Array von Objekten "emails:" [ { "type": "String", "value": "String" } ] |
| E-Mails.Typ | Anwender-E-Mail-Typ. Unterstützt derzeit nur den Typ „Arbeit". Datentyp: Zeichenfolge |
| E-Mails.Wert | E-Mail-Adresse des Anwenders. Dies ist ein eindeutiger Schlüssel für den zugeordneten Anwender. Datentyp: Zeichenfolge |
| externalId | Eindeutiger Bezeichner, der dem Anwender von der Entität zugewiesen wurde, die ihn bereitstellt. Datentyp: Zeichenfolge |
| name | Informationen zum Anwendernamen. Datentyp: Objekt "name": { "familyName": "String", "givenName": "String", "honorificPrefix": "String", "middleName": "String" } |
| Name.FAMILYNAME | Familie oder Nachname des Anwenders. Datentyp: Zeichenfolge |
| Name.givenName | Vorname oder Vorname des Anwenders. Datentyp: Zeichenfolge |
| Name.HonorificPräfix | Ehrenvoller Name oder Titel des Anwenders, z. B. Dr., Bischof oder Baron. Datentyp: Zeichenfolge |
| Name.Mitte | Zweiter Vorname des Anwenders. Datentyp: Zeichenfolge |
| phoneNumbers | Liste der Telefonnummern, die dem Anwender zugeordnet sind. Datentyp: Array von Objekten "phoneNumbers": [ { "type": "String", "value": "String" } ] |
| Telefonnummern.Typ | Typ der Telefonnummer. Mögliche Werte: * Startseite * Mobile * Arbeit {#scim-POST-Users__ul_idb_brj_grb} Datentyp: Zeichenfolge |
| Telefonnummern.Wert | Telefonnummer des Anwenders. Datentyp: Zeichenfolge |
| Bevorzugte Sprache | Bevorzugte gesprochene und schriftliche Sprache des Anwenders. Datentyp: Zeichenfolge |
| Feld | Zeitzone des Anwenders. Datentyp: Zeichenfolge |
| Titel | Titel des Anwenders, z. B. CEO oder Präsident. Datentyp: Zeichenfolge |
| userName | Erforderlich. Eindeutiger Anwendername für den zugeordneten Anwender. Datentyp: Zeichenfolge |
| Anwendertyp | Anwendertyp. Dieser Wert wird verwendet, um die Beziehung zwischen Organisation und Anwender zu identifizieren. Dies kann ein beliebiger Wert sein, typische Werte können jedoch Folgendes sein: * Vertragsunternehmen * Mitarbeiter * Praktikanten * Temp * Extern * Unbekannt {#scim-POST-Users__ul_kdr_nwz_nrb} Datentyp: Zeichenfolge |
| Erweitertes Schema |   |
| Unternehmen | Details zum zugeordneten Unternehmen des Anwenders. Datentyp: Objekt "company": { "value": "String" } |
| Unternehmen.Wert | Erforderlich, wenn das Unternehmen im Post enthalten ist. SYS_ID des Unternehmensdatensatzes. Datentyp: Zeichenfolge |
| Kostenstelle | Details zur zugeordneten Kostenstelle des Anwenders. Datentyp: Objekt "costCenter": { "value": "String" } |
| Kostenstelle.Wert | Erforderlich, wenn Kostenstelle im Post enthalten ist. SYS_ID des Kostenstellendatensatzes. Datentyp: Zeichenfolge |
| department | Details zur zugeordneten Abteilung des Anwenders. Datentyp: Objekt "department": { "value": "String" } |
| Abteilung.Wert | Erforderlich, wenn die Abteilung in der Post enthalten ist. SYS_ID des Abteilungsdatensatzes. Datentyp: Zeichenfolge |
| Employee-Nummer | Numerische oder alphanumerische Personalnummer. Datentyp: Zeichenfolge |
| Geschlecht | Geschlecht des Anwenders, z. B. männlich oder weiblich. Datentyp: Zeichenfolge |
| location | Details zum zugeordneten Standort des Anwenders. Datentyp: Objekt "location": { "value": "String" } |
| Standort.Wert | Erforderlich, wenn der Standort in der Post enthalten ist. SYS_ID des Standortdatensatzes. Datentyp: Zeichenfolge |
| Manager | Details zum zugeordneten Manager des Anwenders. Datentyp: Objekt "manager": { "value": "String" } |
| manager.Wert | Erforderlich, wenn der Manager im Post enthalten ist. SYS_ID des Managerdatensatzes. Datentyp: Zeichenfolge |
[Tabelle : 75. 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.").
{#scim-POST-Users__entry__92}{#scim-POST-Users__Accept-SCIM-entry}{#scim-POST-Users__Content_Type-SCIM-entry}

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

{#scim-POST-Users__entry__98}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 77. 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.").
{#scim-POST-Users__entry__102}{#scim-POST-Users__entry-400-status-code}{#scim-POST-Users__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 201 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 409 | Anwender ist bereits vorhanden. Die userNameParameter muss eindeutig sein. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 78. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#scim-POST-Users__entry__112}{#scim-POST-Users__d2953e1061}{#scim-POST-Users__d2953e1085}{#scim-POST-Users__d2953e1098}{#scim-POST-Users__d2953e1109}{#scim-POST-Users__d2953e1120}{#scim-POST-Users__d2953e1132}{#scim-POST-Users__d2953e1143}{#scim-POST-Users__d2953e1154}{#scim-POST-Users__d2953e1168}{#scim-POST-Users__d2953e1182}{#scim-POST-Users__d2953e1195}{#scim-POST-Users__d2953e1207}{#scim-POST-Users__errors-SCIM-entry}{#scim-POST-Users__errors_details-SCIM-entry}{#scim-POST-Users__errors_scimType-SCIM-entry}{#scim-POST-Users__errors_schemas-SCIM-entry}{#scim-POST-Users__errors_status-SCIM-entry}{#scim-POST-Users__d2953e1218}{#scim-POST-Users__user_groups-SCIM-entry}{#scim-POST-Users__user_groups_display-SCIM-entry}{#scim-POST-Users__user_groups_type-SCIM-entry}{#scim-POST-Users__user_groups_value-SCIM-entry}{#scim-POST-Users__user_groups_ref-SCIM-entry}{#scim-POST-Users__user_id-SCIM-entry}{#scim-POST-Users__user_meta-SCIM-entry}{#scim-POST-Users__user_meta_created-SCIM-entry}{#scim-POST-Users__user_meta_lastModified-SCIM-entry}{#scim-POST-Users__user_meta_location-SCIM-entry}{#scim-POST-Users__user_meta_resourceType-SCIM-entry}{#scim-POST-Users__d2953e1356}{#scim-POST-Users__d2953e1369}{#scim-POST-Users__d2953e1380}{#scim-POST-Users__d2953e1391}{#scim-POST-Users__d2953e1402}{#scim-POST-Users__d2953e1414}{#scim-POST-Users__d2953e1427}{#scim-POST-Users__d2953e1451}{#scim-POST-Users__d2953e1462}{#scim-POST-Users__user_schemas-SCIM-entry}{#scim-POST-Users__d2953e1484}{#scim-POST-Users__d2953e1496}{#scim-POST-Users__user_userName-SCIM-ph}{#scim-POST-Users__d2953e1520}

| Name | Beschreibung |
|-|-|
| aktiv | Kennzeichnung, die angibt, ob der zugeordnete Anwender in aktiv ist ServiceNowInstanz. Mögliche Werte: * Wahr: Anwender ist aktiv. * Falsch: Anwender ist inaktiv. {#scim-POST-Users__d2953e1068} Datentyp: Boolescher Wert |
| Adressen | Details zur aktuellen Postanschrift des Anwenders. Datentyp: Objekt "addresses": { "country": "String", "locality": "String", "postalCode": "String", "region": "String", "streetAddress": "String", "type": "String" } |
| Adressen.Land | Ländername. Datentyp: Zeichenfolge |
| Adressen.Ort | Name der Stadt oder des Orts. Datentyp: Zeichenfolge |
| Address.postalCode | Postleitzahl. Datentyp: Zeichenfolge |
| Adressen.Region | Bundesland oder Region. Datentyp: Zeichenfolge |
| Adressen.streetAddress | Vollständige Straße und Hausnummer. Dies kann die Hausnummer, die Straße, das Postfach und mehrzeilige erweiterte Straßennutzungsinformationen umfassen. Datentyp: Zeichenfolge |
| Address.type | Typ der Adresse. Derzeit nur unterstützt Startseite . Datentyp: Zeichenfolge |
| displayName | Anzeigename des Anwenders. Dieser Wert wird automatisch durch Verkettung von generiert nameFelder. Datentyp: Zeichenfolge |
| E-Mails | Liste der E-Mail-Accounts, die dem Anwender zugeordnet sind. Datentyp: Array von Objekten "emails:" [ { "type": "String", "value": "String" } ] |
| E-Mails.Typ | Anwender-E-Mail-Typ. Unterstützt derzeit nur den Typ „Arbeit". Datentyp: Zeichenfolge |
| E-Mails.Wert | E-Mail-Adresse des Anwenders. Dies ist ein eindeutiger Schlüssel für den zugeordneten Anwender. Datentyp: Zeichenfolge |
| Fehler | Antwort, die alle Fehler beschreibt, die während der Verarbeitung der Anforderung aufgetreten sind. Datentyp: Objekt "errors": { "details": "String", "schemas": "String", "scimType": "String", "status": "String" } |
| errors.detail | Detaillierte Fehlermeldung, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Fehler.scimType | SCIM-Fehlerdetailstichwort. Datentyp: Zeichenfolge |
| Fehler.Schemas | URI der SCIM-Schemata, die zur Verarbeitung der Fehlerantwort verwendet werden. Datentyp: Array von Zeichenfolgen |
| Fehler.Status | HTTP-Statuscode für die Fehlerantwort. Datentyp: Zeichenfolge |
| externalId | Eindeutiger Bezeichner, der dem Anwender von der Entität zugewiesen wurde, die ihn bereitstellt. Datentyp: Zeichenfolge |
| groups | Liste der Gruppen, zu denen der Anwender gehört, entweder durch direkte Mitgliedschaft, geschachtelte Gruppen oder dynamisch berechnet. Datentyp: Array von Objekten "groups": [ { "display": "String", "type": "String", "value": "String", "$ref": "String" } ] |
| Gruppen.Anzeige | Name der zugeordneten Gruppe. Datentyp: Zeichenfolge |
| Groups.type | Typ der Gruppenzuordnung, z. B. direkt oder indirekt. Datentyp: Zeichenfolge |
| Gruppen.Wert | SYS_ID eines zugeordneten Gruppendatensatzes. Datentyp: Zeichenfolge |
| Gruppen.$ref | URI der zugeordneten Gruppe. Datentyp: Zeichenfolge |
| ID | SYS_ID des zugeordneten Anwenderdatensatzes. Datentyp: Zeichenfolge |
| Meta | Metadaten, die sich auf den Anwender beziehen. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": String", "resourceType": String" } |
| Meta.erstellt | Datum und Uhrzeit der Erstellung des Anwenderdatensatzes. Datentyp: Zeichenfolge |
| Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des Anwenderdatensatzes. Datentyp: Zeichenfolge |
| Meta.Standort | URI des abgerufenen Anwenders. Datentyp: Zeichenfolge |
| Meta.resourceType | Ressourcentyp von SCIM-Anwendern. Datentyp: Zeichenfolge |
| name | Informationen zum Anwendernamen. Datentyp: Objekt "name": { "familyName": "String", "givenName": "String", "honorificPrefix": "String", "middleName": "String" } |
| Name.FAMILYNAME | Familie oder Nachname des Anwenders. Datentyp: Zeichenfolge |
| Name.givenName | Vorname oder Vorname des Anwenders. Datentyp: Zeichenfolge |
| Name.HonorificPräfix | Ehrenvoller Name oder Titel des Anwenders, z. B. Dr., Bischof oder Baron. Datentyp: Zeichenfolge |
| Name.Mitte | Zweiter Vorname des Anwenders. Datentyp: Zeichenfolge |
| phoneNumbers | Liste der Telefonnummern, die dem Anwender zugeordnet sind. Datentyp: Array von Objekten "phoneNumbers": [ { "type": "String", "value": "String" } ] |
| Telefonnummern.Typ | Typ der Telefonnummer. Mögliche Werte: * Startseite * Mobile * Arbeit {#scim-POST-Users__d2953e1431} Datentyp: Zeichenfolge |
| Telefonnummern.Wert | Telefonnummer des Anwenders. Datentyp: Zeichenfolge |
| Bevorzugte Sprache | Bevorzugte gesprochene und schriftliche Sprache des Anwenders. Datentyp: Zeichenfolge |
| Schemas | Liste der URIs der SCIM-Anwenderschemata, die zur Verarbeitung der Anforderung verwendet werden. Datentyp: Array von Zeichenfolgen |
| Feld | Zeitzone des Anwenders. Datentyp: Zeichenfolge |
| Titel | Titel des Anwenders, z. B. CEO oder Präsident. Datentyp: Zeichenfolge |
| userName | Eindeutiger Anwendername für den zugeordneten Anwender. Datentyp: Zeichenfolge |
| Anwendertyp | Anwendertyp. Dieser Wert wird verwendet, um die Beziehung zwischen Organisation und Anwender zu identifizieren. Dies kann ein beliebiger Wert sein, typische Werte können jedoch Folgendes sein: * Vertragsunternehmen * Mitarbeiter * Praktikanten * Temp * Extern * Unbekannt {#scim-POST-Users__d2953e1524} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung zum POSTEN DES Anwenders

Dieses Beispiel zeigt, wie der Anwender Jack Sparrow in der Anwendertabelle \[sys_user\] VERÖFFENTLICHT wird.

    curl -X POST \
      https://instance-servicenow.com/api/now/scim/Users \
      -d '{
        "schemas": [
            "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User",
            "urn:ietf:params:scim:schemas:core:2.0:User"
        ],
        "externalId": "123456",
        "userName": "jack.sparrow",
        "name": {
            "familyName": "Sparrow",
            "givenName": "Jack"
        },
        "title": "Senior Developer",
        "preferredLanguage": "en",
        "timezone": "ET",
        "active": true,
        "emails": [
          {
            "value": "jack.sparrow@abc.com",
            "display": null,
            "type": "work",
            "primary": true
          }
        ],
        "phoneNumbers": [
          {
            "value": "9977553312",
            "type": "mobile",
            "primary": true
          }
        ]
    }'

Antwort:

    {"schemas":
      [
        "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User",
        "urn:ietf:params:scim:schemas:core:2.0:User"
      ],
      "id":"d6287d7b1bbe3010593876a61a4bcbc3",
      "externalId":"123456",
      "meta":{
        "resourceType":"User",
        "created":"2021-10-01T16:46:48Z",
        "lastModified":"2021-10-01T16:46:48Z",
        "location":"https://instance-servicenow.com/api/now/scim/Users/d6287d7b1bbe3010593876a61a4bcbc3"
      },
      "userName":"jack.sparrow",
      "name":{
        "familyName":"Sparrow",
        "givenName":"Jack"
      },
      "displayName":"Jack Sparrow",
      "title":"Senior Developer",
      "preferredLanguage":"en",
      "timezone":"ET",
      "active":true,
      "emails":[
        {
          "value":"jack.sparrow@abc.com",
          "type":"work"
        }
      ],
      "phoneNumbers":[
        {
          "value":"9977553312",
          "type":"mobile"
        }
      ]
    }

## SCIM -- PUT /scim/Users/{user_ID} {#ariaid-title13}

Aktualisiert den angegebenen Anwenderdatensatz in der Anwendertabelle \[sys_user\] von ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Users/{user_ID}

Standard-URL: /api/now/scim/Users/{user_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

{#scim-PUT-Users-user_id__entry__2}{#scim-PUT-Users-user_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 |
| user_id | SYS_ID des zu aktualisierenden Anwenderdatensatzes. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
[Tabelle : 79. Pfad-Parameter]

{#scim-PUT-Users-user_id__entry__8}{#scim-PUT-Users-user_id__attributes-SCIM-entry}{#scim-PUT-Users-user_id__excludedAttributes-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
[Tabelle : 80. Abfrageparameter]

{#scim-PUT-Users-user_id__entry__14}{#scim-PUT-Users-user_id__user_active-SCIM-entry}{#scim-PUT-Users-user_id__user_addresses-SCIM-entry}{#scim-PUT-Users-user_id__user_addresses_country-SCIM-entry}{#scim-PUT-Users-user_id__user_addresses_locality-SCIM-entry}{#scim-PUT-Users-user_id__user_addresses_postalCode-SCIM-entry}{#scim-PUT-Users-user_id__user_addresses_region-SCIM-entry}{#scim-PUT-Users-user_id__user_addresses_streetAddress-SCIM-entry}{#scim-PUT-Users-user_id__user_addresses_type-SCIM-entry}{#scim-PUT-Users-user_id__user_displayName-SCIM-entry}{#scim-PUT-Users-user_id__user_emails-SCIM-entry}{#scim-PUT-Users-user_id__user_emails_type-SCIM-entry}{#scim-PUT-Users-user_id__user_emails_value-SCIM-entry}{#scim-PUT-Users-user_id__user_emails_externalId-SCIM-entry}{#scim-PUT-Users-user_id__user_name-SCIM-entry}{#scim-PUT-Users-user_id__user_name_familyName-SCIM-entry}{#scim-PUT-Users-user_id__user_name_givenName-SCIM-entry}{#scim-PUT-Users-user_id__user_name_honorificPrefix-SCIM-entry}{#scim-PUT-Users-user_id__user_name_middle-SCIM-entry}{#scim-PUT-Users-user_id__user_phoneNumbers-SCIM-entry}{#scim-PUT-Users-user_id__user_phoneNumbers_type-SCIM-entry}{#scim-PUT-Users-user_id__user_phoneNumbers_value-SCIM-entry}{#scim-PUT-Users-user_id__user_preferredLanguage-SCIM-entry}{#scim-PUT-Users-user_id__user_timezone-SCIM-entry}{#scim-PUT-Users-user_id__user_title-SCIM-entry}{#scim-PUT-Users-user_id__user_userType-SCIM-entry}{#scim-PUT-Users-user_id__user_employeeNumber-SCIM-entry}{#scim-PUT-Users-user_id__user_gender-SCIM-entry}

| Name | Beschreibung |
|-|-|
| aktiv | Kennzeichnung, die angibt, ob der zugeordnete Anwender in aktiv ist ServiceNowInstanz. Mögliche Werte: * Wahr: Anwender ist aktiv. * Falsch: Anwender ist inaktiv. {#scim-PUT-Users-user_id__ul_glm_qkj_grb} Datentyp: Boolescher Wert |
| Adressen | Details zur aktuellen Postanschrift des Anwenders. Datentyp: Objekt "addresses": { "country": "String", "locality": "String", "postalCode": "String", "region": "String", "streetAddress": "String", "type": "String" } |
| Adressen.Land | Ländername. Datentyp: Zeichenfolge |
| Adressen.Ort | Name der Stadt oder des Orts. Datentyp: Zeichenfolge |
| Address.postalCode | Postleitzahl. Datentyp: Zeichenfolge |
| Adressen.Region | Bundesland oder Region. Datentyp: Zeichenfolge |
| Adressen.streetAddress | Vollständige Straße und Hausnummer. Dies kann die Hausnummer, die Straße, das Postfach und mehrzeilige erweiterte Straßennutzungsinformationen umfassen. Datentyp: Zeichenfolge |
| Address.type | Typ der Adresse. Derzeit nur unterstützt Startseite . Datentyp: Zeichenfolge |
| displayName | Anzeigename des Anwenders. Dieser Wert wird automatisch durch Verkettung von generiert nameFelder. Datentyp: Zeichenfolge |
| E-Mails | Liste der E-Mail-Accounts, die dem Anwender zugeordnet sind. Datentyp: Array von Objekten "emails:" [ { "type": "String", "value": "String" } ] |
| E-Mails.Typ | Anwender-E-Mail-Typ. Unterstützt derzeit nur den Typ „Arbeit". Datentyp: Zeichenfolge |
| E-Mails.Wert | E-Mail-Adresse des Anwenders. Dies ist ein eindeutiger Schlüssel für den zugeordneten Anwender. Datentyp: Zeichenfolge |
| externalId | Eindeutiger Bezeichner, der dem Anwender von der Entität zugewiesen wurde, die ihn bereitstellt. Datentyp: Zeichenfolge |
| name | Informationen zum Anwendernamen. Datentyp: Objekt "name": { "familyName": "String", "givenName": "String", "honorificPrefix": "String", "middleName": "String" } |
| Name.FAMILYNAME | Familie oder Nachname des Anwenders. Datentyp: Zeichenfolge |
| Name.givenName | Vorname oder Vorname des Anwenders. Datentyp: Zeichenfolge |
| Name.HonorificPräfix | Ehrenvoller Name oder Titel des Anwenders, z. B. Dr., Bischof oder Baron. Datentyp: Zeichenfolge |
| Name.Mitte | Zweiter Vorname des Anwenders. Datentyp: Zeichenfolge |
| phoneNumbers | Liste der Telefonnummern, die dem Anwender zugeordnet sind. Datentyp: Array von Objekten "phoneNumbers": [ { "type": "String", "value": "String" } ] |
| Telefonnummern.Typ | Typ der Telefonnummer. Mögliche Werte: * Startseite * Mobile * Arbeit {#scim-PUT-Users-user_id__ul_idb_brj_grb} Datentyp: Zeichenfolge |
| Telefonnummern.Wert | Telefonnummer des Anwenders. Datentyp: Zeichenfolge |
| Bevorzugte Sprache | Bevorzugte gesprochene und schriftliche Sprache des Anwenders. Datentyp: Zeichenfolge |
| Feld | Zeitzone des Anwenders. Datentyp: Zeichenfolge |
| Titel | Titel des Anwenders, z. B. CEO oder Präsident. Datentyp: Zeichenfolge |
| userName | Erforderlich. Eindeutiger Anwendername für den zugeordneten Anwender. Datentyp: Zeichenfolge |
| Anwendertyp | Anwendertyp. Dieser Wert wird verwendet, um die Beziehung zwischen Organisation und Anwender zu identifizieren. Dies kann ein beliebiger Wert sein, typische Werte können jedoch Folgendes sein: * Vertragsunternehmen * Mitarbeiter * Praktikanten * Temp * Extern * Unbekannt {#scim-PUT-Users-user_id__ul_kdr_nwz_nrb} Datentyp: Zeichenfolge |
| Erweitertes Schema |   |
| Unternehmen | Details zum zugeordneten Unternehmen des Anwenders. Datentyp: Objekt "company": { "value": "String" } |
| Unternehmen.Wert | Erforderlich, wenn das Unternehmen im Post enthalten ist. SYS_ID des Unternehmensdatensatzes. Datentyp: Zeichenfolge |
| Kostenstelle | Details zur zugeordneten Kostenstelle des Anwenders. Datentyp: Objekt "costCenter": { "value": "String" } |
| Kostenstelle.Wert | Erforderlich, wenn Kostenstelle im Post enthalten ist. SYS_ID des Kostenstellendatensatzes. Datentyp: Zeichenfolge |
| department | Details zur zugeordneten Abteilung des Anwenders. Datentyp: Objekt "department": { "value": "String" } |
| Abteilung.Wert | Erforderlich, wenn die Abteilung in der Post enthalten ist. SYS_ID des Abteilungsdatensatzes. Datentyp: Zeichenfolge |
| Employee-Nummer | Numerische oder alphanumerische Personalnummer. Datentyp: Zeichenfolge |
| Geschlecht | Geschlecht des Anwenders, z. B. männlich oder weiblich. Datentyp: Zeichenfolge |
| location | Details zum zugeordneten Standort des Anwenders. Datentyp: Objekt "location": { "value": "String" } |
| Standort.Wert | Erforderlich, wenn der Standort in der Post enthalten ist. SYS_ID des Standortdatensatzes. Datentyp: Zeichenfolge |
| Manager | Details zum zugeordneten Manager des Anwenders. Datentyp: Objekt "manager": { "value": "String" } |
| manager.Wert | Erforderlich, wenn der Manager im Post enthalten ist. SYS_ID des Managerdatensatzes. Datentyp: Zeichenfolge |
[Tabelle : 81. Anforderungstext-Parameter (JSON)]

### Header

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

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

{#scim-PUT-Users-user_id__entry__100}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 83. 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.").
{#scim-PUT-Users-user_id__entry__104}{#scim-PUT-Users-user_id__entry-200-status-code}{#scim-PUT-Users-user_id__entry-404-status-code}{#scim-PUT-Users-user_id__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 409 | Anwender ist bereits vorhanden. Die userNameParameter muss eindeutig sein. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 84. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-PUT-Users-user_id__table_mjy_k1l_grb__entry__2}{#scim-PUT-Users-user_id__d2953e1061}{#scim-PUT-Users-user_id__d2953e1085}{#scim-PUT-Users-user_id__d2953e1098}{#scim-PUT-Users-user_id__d2953e1109}{#scim-PUT-Users-user_id__d2953e1120}{#scim-PUT-Users-user_id__d2953e1132}{#scim-PUT-Users-user_id__d2953e1143}{#scim-PUT-Users-user_id__d2953e1154}{#scim-PUT-Users-user_id__d2953e1168}{#scim-PUT-Users-user_id__d2953e1182}{#scim-PUT-Users-user_id__d2953e1195}{#scim-PUT-Users-user_id__d2953e1207}{#scim-PUT-Users-user_id__errors-SCIM-entry}{#scim-PUT-Users-user_id__errors_details-SCIM-entry}{#scim-PUT-Users-user_id__errors_scimType-SCIM-entry}{#scim-PUT-Users-user_id__errors_schemas-SCIM-entry}{#scim-PUT-Users-user_id__errors_status-SCIM-entry}{#scim-PUT-Users-user_id__d2953e1218}{#scim-PUT-Users-user_id__user_groups-SCIM-entry}{#scim-PUT-Users-user_id__user_groups_display-SCIM-entry}{#scim-PUT-Users-user_id__user_groups_type-SCIM-entry}{#scim-PUT-Users-user_id__user_groups_value-SCIM-entry}{#scim-PUT-Users-user_id__user_groups_ref-SCIM-entry}{#scim-PUT-Users-user_id__user_id-SCIM-entry}{#scim-PUT-Users-user_id__user_meta-SCIM-entry}{#scim-PUT-Users-user_id__user_meta_created-SCIM-entry}{#scim-PUT-Users-user_id__user_meta_lastModified-SCIM-entry}{#scim-PUT-Users-user_id__user_meta_location-SCIM-entry}{#scim-PUT-Users-user_id__user_meta_resourceType-SCIM-entry}{#scim-PUT-Users-user_id__d2953e1356}{#scim-PUT-Users-user_id__d2953e1369}{#scim-PUT-Users-user_id__d2953e1380}{#scim-PUT-Users-user_id__d2953e1391}{#scim-PUT-Users-user_id__d2953e1402}{#scim-PUT-Users-user_id__d2953e1414}{#scim-PUT-Users-user_id__d2953e1427}{#scim-PUT-Users-user_id__d2953e1451}{#scim-PUT-Users-user_id__d2953e1462}{#scim-PUT-Users-user_id__user_schemas-SCIM-entry}{#scim-PUT-Users-user_id__d2953e1484}{#scim-PUT-Users-user_id__d2953e1496}{#scim-PUT-Users-user_id__user_userName-SCIM-ph}{#scim-PUT-Users-user_id__d2953e1520}

| Name | Beschreibung |
|-|-|
| aktiv | Kennzeichnung, die angibt, ob der zugeordnete Anwender in aktiv ist ServiceNowInstanz. Mögliche Werte: * Wahr: Anwender ist aktiv. * Falsch: Anwender ist inaktiv. {#scim-PUT-Users-user_id__d2953e1068} Datentyp: Boolescher Wert |
| Adressen | Details zur aktuellen Postanschrift des Anwenders. Datentyp: Objekt "addresses": { "country": "String", "locality": "String", "postalCode": "String", "region": "String", "streetAddress": "String", "type": "String" } |
| Adressen.Land | Ländername. Datentyp: Zeichenfolge |
| Adressen.Ort | Name der Stadt oder des Orts. Datentyp: Zeichenfolge |
| Address.postalCode | Postleitzahl. Datentyp: Zeichenfolge |
| Adressen.Region | Bundesland oder Region. Datentyp: Zeichenfolge |
| Adressen.streetAddress | Vollständige Straße und Hausnummer. Dies kann die Hausnummer, die Straße, das Postfach und mehrzeilige erweiterte Straßennutzungsinformationen umfassen. Datentyp: Zeichenfolge |
| Address.type | Typ der Adresse. Derzeit nur unterstützt Startseite . Datentyp: Zeichenfolge |
| displayName | Anzeigename des Anwenders. Dieser Wert wird automatisch durch Verkettung von generiert nameFelder. Datentyp: Zeichenfolge |
| E-Mails | Liste der E-Mail-Accounts, die dem Anwender zugeordnet sind. Datentyp: Array von Objekten "emails:" [ { "type": "String", "value": "String" } ] |
| E-Mails.Typ | Anwender-E-Mail-Typ. Unterstützt derzeit nur den Typ „Arbeit". Datentyp: Zeichenfolge |
| E-Mails.Wert | E-Mail-Adresse des Anwenders. Dies ist ein eindeutiger Schlüssel für den zugeordneten Anwender. Datentyp: Zeichenfolge |
| Fehler | Antwort, die alle Fehler beschreibt, die während der Verarbeitung der Anforderung aufgetreten sind. Datentyp: Objekt "errors": { "details": "String", "schemas": "String", "scimType": "String", "status": "String" } |
| errors.detail | Detaillierte Fehlermeldung, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Fehler.scimType | SCIM-Fehlerdetailstichwort. Datentyp: Zeichenfolge |
| Fehler.Schemas | URI der SCIM-Schemata, die zur Verarbeitung der Fehlerantwort verwendet werden. Datentyp: Array von Zeichenfolgen |
| Fehler.Status | HTTP-Statuscode für die Fehlerantwort. Datentyp: Zeichenfolge |
| externalId | Eindeutiger Bezeichner, der dem Anwender von der Entität zugewiesen wurde, die ihn bereitstellt. Datentyp: Zeichenfolge |
| groups | Liste der Gruppen, zu denen der Anwender gehört, entweder durch direkte Mitgliedschaft, geschachtelte Gruppen oder dynamisch berechnet. Datentyp: Array von Objekten "groups": [ { "display": "String", "type": "String", "value": "String", "$ref": "String" } ] |
| Gruppen.Anzeige | Name der zugeordneten Gruppe. Datentyp: Zeichenfolge |
| Groups.type | Typ der Gruppenzuordnung, z. B. direkt oder indirekt. Datentyp: Zeichenfolge |
| Gruppen.Wert | SYS_ID eines zugeordneten Gruppendatensatzes. Datentyp: Zeichenfolge |
| Gruppen.$ref | URI der zugeordneten Gruppe. Datentyp: Zeichenfolge |
| ID | SYS_ID des zugeordneten Anwenderdatensatzes. Datentyp: Zeichenfolge |
| Meta | Metadaten, die sich auf den Anwender beziehen. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": String", "resourceType": String" } |
| Meta.erstellt | Datum und Uhrzeit der Erstellung des Anwenderdatensatzes. Datentyp: Zeichenfolge |
| Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des Anwenderdatensatzes. Datentyp: Zeichenfolge |
| Meta.Standort | URI des abgerufenen Anwenders. Datentyp: Zeichenfolge |
| Meta.resourceType | Ressourcentyp von SCIM-Anwendern. Datentyp: Zeichenfolge |
| name | Informationen zum Anwendernamen. Datentyp: Objekt "name": { "familyName": "String", "givenName": "String", "honorificPrefix": "String", "middleName": "String" } |
| Name.FAMILYNAME | Familie oder Nachname des Anwenders. Datentyp: Zeichenfolge |
| Name.givenName | Vorname oder Vorname des Anwenders. Datentyp: Zeichenfolge |
| Name.HonorificPräfix | Ehrenvoller Name oder Titel des Anwenders, z. B. Dr., Bischof oder Baron. Datentyp: Zeichenfolge |
| Name.Mitte | Zweiter Vorname des Anwenders. Datentyp: Zeichenfolge |
| phoneNumbers | Liste der Telefonnummern, die dem Anwender zugeordnet sind. Datentyp: Array von Objekten "phoneNumbers": [ { "type": "String", "value": "String" } ] |
| Telefonnummern.Typ | Typ der Telefonnummer. Mögliche Werte: * Startseite * Mobile * Arbeit {#scim-PUT-Users-user_id__d2953e1431} Datentyp: Zeichenfolge |
| Telefonnummern.Wert | Telefonnummer des Anwenders. Datentyp: Zeichenfolge |
| Bevorzugte Sprache | Bevorzugte gesprochene und schriftliche Sprache des Anwenders. Datentyp: Zeichenfolge |
| Schemas | Liste der URIs der SCIM-Anwenderschemata, die zur Verarbeitung der Anforderung verwendet werden. Datentyp: Array von Zeichenfolgen |
| Feld | Zeitzone des Anwenders. Datentyp: Zeichenfolge |
| Titel | Titel des Anwenders, z. B. CEO oder Präsident. Datentyp: Zeichenfolge |
| userName | Eindeutiger Anwendername für den zugeordneten Anwender. Datentyp: Zeichenfolge |
| Anwendertyp | Anwendertyp. Dieser Wert wird verwendet, um die Beziehung zwischen Organisation und Anwender zu identifizieren. Dies kann ein beliebiger Wert sein, typische Werte können jedoch Folgendes sein: * Vertragsunternehmen * Mitarbeiter * Praktikanten * Temp * Extern * Unbekannt {#scim-PUT-Users-user_id__d2953e1524} Datentyp: Zeichenfolge |
[ ]

{#scim-PUT-Users-user_id__table_mjy_k1l_grb}

### Erweiterungsparameter zurückgegeben {#scim-PUT-Users-user_id__section_vb2_yny_jlb}

{#scim-PUT-Users-user_id__id_hmw_fjk_grb__entry__2}{#scim-PUT-Users-user_id__user_company-SCIM-entry}{#scim-PUT-Users-user_id__user_company_display-SCIM-entry}{#scim-PUT-Users-user_id__user_company_value-SCIM-ph}{#scim-PUT-Users-user_id__user_company_ref-SCIM-entry}{#scim-PUT-Users-user_id__user_costCenter-SCIM-entry}{#scim-PUT-Users-user_id__user_costCenter_display-SCIM-entry}{#scim-PUT-Users-user_id__user_costCenter_value-SCIM-ph}{#scim-PUT-Users-user_id__user_costCenter_ref-SCIM-entry}{#scim-PUT-Users-user_id__user_department-SCIM-entry}{#scim-PUT-Users-user_id__user_department_display-SCIM-entry}{#scim-PUT-Users-user_id__user_department_value-SCIM-ph}{#scim-PUT-Users-user_id__user_department_ref-SCIM-entry}{#scim-PUT-Users-user_id__d2953e1725}{#scim-PUT-Users-user_id__d2953e1736}{#scim-PUT-Users-user_id__user_location-SCIM-entry}{#scim-PUT-Users-user_id__user_location_display-SCIM-entry}{#scim-PUT-Users-user_id__user_location_value-SCIM-ph}{#scim-PUT-Users-user_id__user_location_ref-SCIM-entry}{#scim-PUT-Users-user_id__user_manager-SCIM-entry}{#scim-PUT-Users-user_id__user_manager_display-SCIM-entry}{#scim-PUT-Users-user_id__user_manager_value-SCIM-ph}{#scim-PUT-Users-user_id__user_manager_ref-SCIM-entry}

| Name | Beschreibung |
|-|-|
| Unternehmen | Details zum zugeordneten Unternehmen des Anwenders. Datentyp: Objekt "company": { "display": "String", "value": "String", "$ref": "String" } |
| Unternehmen.Anzeige | Name des Unternehmens. Datentyp: Zeichenfolge |
| Unternehmen.Wert | SYS_ID des Unternehmensdatensatzes. Datentyp: Zeichenfolge |
| Unternehmen.$ref | Referenz-URI für das Unternehmen. Datentyp: Zeichenfolge |
| Kostenstelle | Details zur zugeordneten Kostenstelle des Anwenders. Datentyp: Objekt "costCenter": { "display": "String", "value": "String", "$ref": "String" } |
| Kostenstelle.Anzeige | Name der Kostenstelle. Datentyp: Zeichenfolge |
| Kostenstelle.Wert | SYS_ID des Kostenstellendatensatzes. Datentyp: Zeichenfolge |
| Kostenstelle.$ref | Referenz-URI für die Kostenstelle. Datentyp: Zeichenfolge |
| department | Details zur zugeordneten Abteilung des Anwenders. Datentyp: Objekt "department": { "display": "String", "value": "String", "$ref": "String" } |
| Abteilung.Anzeige | Name der Abteilung. Datentyp: Zeichenfolge |
| Abteilung.Wert | SYS_ID des Abteilungsdatensatzes. Datentyp: Zeichenfolge |
| Abteilung.$ref | Referenz-URI für die Abteilung. Datentyp: Zeichenfolge |
| Employee-Nummer | Numerische oder alphanumerische Personalnummer. Datentyp: Zeichenfolge |
| Geschlecht | Geschlecht des Anwenders, z. B. männlich oder weiblich. Datentyp: Zeichenfolge |
| location | Details zum zugeordneten Standort des Anwenders. Datentyp: Objekt "location": { "display": "String", "value": "String", "$ref": "String" } |
| Standort.Anzeige | Name des Standorts. Datentyp: Zeichenfolge |
| Standort.Wert | SYS_ID des Standortdatensatzes. Datentyp: Zeichenfolge |
| Standort.$ref | Referenz-URI für den Standort. Datentyp: Zeichenfolge |
| Manager | Details zum zugeordneten Manager des Anwenders. Datentyp: Objekt "manager": { "display": "String", "value": "String", "$ref": "String" } |
| manager.Anzeige | Name des Managers. Datentyp: Zeichenfolge |
| manager.Wert | SYS_ID des Managerdatensatzes. Datentyp: Zeichenfolge |
| manager.$ref | Referenz-URI für den Manager. Datentyp: Zeichenfolge |
[ ]

{#scim-PUT-Users-user_id__id_hmw_fjk_grb}  

### Curl-Anforderung zum Aktualisieren von Anwenderinformationen mithilfe von PUT

Dieses Beispiel zeigt, wie die Informationen eines vorhandenen Anwenders mithilfe des PUT-Endpunkts aktualisiert werden.

    curl -X PUT \
      https://instance-servicenow.com/api/now/scim/Users/cdfef423e0423010f8778ac6d674f5ae \
      -d '{
      "schemas": [
        "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User",
        "urn:ietf:params:scim:schemas:core:2.0:User"
      ],
      "externalId": "123457",
      "userName": "john.Doe",
      "name": {
        "familyName": "Doe",
        "givenName": "John"
      },
      "title": "Sir",
      "preferredLanguage": "en",
      "timezone": "ET",
      "active": true,
      "emails": [
        {
          "value": "john.doe@abc.com",
          "display": null,
          "type": "work",
          "primary": true
        }
      ],
      "phoneNumbers": [
        {
          "value": "9977553312",
          "type": "mobile",
          "primary": true
        }
      ],
      "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User": {
        "gender": "Male",
        "employeeNumber" : "13453",
        "location" : {
          "value" : "0002c0a93790200044e0bfc8bcbe5df5"
        },
        "company" : {
          "value" : "81fd65ecac1d55eb42a426568fc87a63"
        },
        "costCenter" : {
          "value" : "7fb1cc99c0a80a6d30c04574d14c0acf"
        },
        "department" : {
          "value":"221db0edc611228401760aec06c9d929"
        }
      }
    }'

Antwort:

    {
      "schemas": [
        "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User",
        "urn:ietf:params:scim:schemas:core:2.0:User"
      ],
      "id": "b7c5015f778330102e8cc5179e5a9992",
      "externalId": "123457",
      "meta": {
        "resourceType": "User",
        "created": "2021-10-12T10:05:32Z",
        "lastModified": "2021-10-12T10:08:04Z",
        "location":
          "http://instance-servicenow.com/api/now/scim/Users/b7c5015f778330102e8cc5179e5a9992"
      },
      "userName": "john.doe",
      "name": {
        "familyName": "Doe",
        "givenName": "John"
      },
      "displayName": "John Doe",
      "title": "Sir",
      "preferredLanguage": "en",
      "timezone": "ET",
      "active": true,
      "emails": [
        {
          "value": "tony.stark@abc.com",
          "type": "work"
        }
      ],
      "phoneNumbers": [
        {
          "value": "9977553312",
          "type": "mobile"
        }
      ],
      "urn:ietf:params:scim:schemas:extension:servicenow:2.0:User": {
        "employeeNumber": "13453",
        "gender": "Male",
        "costCenter": {
          "value": "7fb1cc99c0a80a6d30c04574d14c0acf",
          "name": "Sales",
          "$ref":
           "http://instance-servicenow.com/api/now/scim/CostCenters/7fb1cc99c0a80a6d30c04574d14c0acf"
        },
        "company": {
          "value": "81fd65ecac1d55eb42a426568fc87a63",
          "name": "ACME Japan",
          "$ref":
           "http://instance-servicenow.com/api/now/scim/Companies/81fd65ecac1d55eb42a426568fc87a63"
        },
        "department": {
          "value": "221db0edc611228401760aec06c9d929",
          "name": "Sales",
          "$ref":
            "http://instance-servicenow.com/api/now/scim/Departments/221db0edc611228401760aec06c9d929"
        },
        "manager": {
          "value": "7027fda8773230102e8cc5179e5a99ea",
          "displayName": "Jack Sparrow",
          "$ref":
            "http://instance-servicenow.com/api/now/scim/Users/7027fda8773230102e8cc5179e5a99ea"
        },
        "location": {
          "value": "0002c0a93790200044e0bfc8bcbe5df5",
          "name": "2-10-1 Yurakucho, Chiyoda-ku, Tokyo",
          "$ref":
            "http://instance-servicenow.com/api/now/scim/Locations/0002c0a93790200044e0bfc8bcbe5df5"
        }
      }
    }

## SCIM -- GET /scim/ResourceTypes AB {#ariaid-title14}

Ruft Informationen zu allen Ressourcentypen „System für domänenübergreifendes Identitätsmanagement" (SCIM) ab, die von der zugeordneten unterstützt werden ServiceNowInstanz.
Dies ist ein öffentlicher Endpunkt und erfordert keine Rollen für den Zugriff.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/ResourceTypes

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

{#scim-GET-ResourceTypes__entry__2}{#scim-GET-ResourceTypes__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 |
[Tabelle : 85. Pfad-Parameter]

{#scim-GET-ResourceTypes__entry__6}

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

{#scim-GET-ResourceTypes__entry__10}

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

### Header

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

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

{#scim-GET-ResourceTypes__entry__18}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 89. 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.").
{#scim-GET-ResourceTypes__entry__22}{#scim-GET-ResourceTypes__entry-200-status-code}

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

### Antworttext-Parameter (JSON)

{#scim-GET-ResourceTypes__id_avz_rp3_3rb__entry__2}{#scim-GET-ResourceTypes__itemsPerPage-SCIM-entry}{#scim-GET-ResourceTypes__description-SCIM-entry}{#scim-GET-ResourceTypes__endpoint-SCIM-entry}{#scim-GET-ResourceTypes__id-SCIM-entry}{#scim-GET-ResourceTypes__meta-SCIM-entry}{#scim-GET-ResourceTypes__meta_location-SCIM-entry}{#scim-GET-ResourceTypes__meta_resourceType-SCIM-entry}{#scim-GET-ResourceTypes__name-SCIM-entry}{#scim-GET-ResourceTypes__schema-SCIM-entry}{#scim-GET-ResourceTypes__schemas-SCIM-entry}{#scim-GET-ResourceTypes__schemaExtensions-SCIM-entry}{#scim-GET-ResourceTypes__schemaExtensions_required-SCIM-entry}{#scim-GET-ResourceTypes__schemaExtensions_schema-SCIM-entry}{#scim-GET-ResourceTypes__schemas2-SCIM-entry}{#scim-GET-ResourceTypes__startIndex-SCIM-entry}{#scim-GET-ResourceTypes__totalResults-SCIM-entry}

| Name | Beschreibung |
|-|-|
| ItemsPerPage | Anzahl der in den Rückgabeergebnissen zurückgegebenen Datensätze. Datentyp: Zahl |
| Ressourcen | Liste der verfügbaren Ressourcentypen. Datentyp: Array von Objekten "Resources": [ { "description": "String", "endpoint": "String", "id": "String", "meta": {Object}, "name": "String", "schema": "String" "schemas": [Array], "schemaExtensions": [Array] } ] |
| Resources.description | Kurze Beschreibung des Ressourcentyps. Datentyp: Zeichenfolge |
| Resources.Endpunkt | Name des HTTP-adressierbaren Endpunkts relativ zur Basis-URL des Service Providers, z. B. „Anwender". Datentyp: Zeichenfolge |
| Resources.ID | Eindeutiger Bezeichner für die Ressource. Verwenden Sie dieses Attribut beim Aufrufen des Endpunkts GET /scim/ResourceType/{resource_ID}. Datentyp: Zeichenfolge |
| Ressourcen.Meta | Informationen, die die zugeordnete Ressource weiter beschreiben. Datentyp: Objekt "metadata": { "location": "String", "resourceType": "String" } |
| Resources.Meta.location | URI des zugeordneten Ressourcentyps auf dem zugeordneten ServiceNowInstanz. Datentyp: Zeichenfolge |
| Resources.Meta.resourceType | Immer „ResourceType". Datentyp: Zeichenfolge |
| Resources.name | Name des Ressourcentyps, z. B. Anwender oder Gruppe. Datentyp: Zeichenfolge |
| Resources.Schema | Primärer/Basisschema-URI des Ressourcentyps. Beispiel: `„URN:ietf:Parameters:scim:Schemas:Core:2,0:Anwender" `. Datentyp: Zeichenfolge |
| Resources.Schemas | Schema, das zum Verarbeiten von verwendet wird `/ResourceType `Anforderung. Beispiel: `„URN:ietf:Parameters:scim:Schemas:Core:2,0:ResourceType" `. Datentyp: Zeichenfolge |
| Resources.schemaErweiterungen | Liste der Schemaerweiterungen, die für den zugeordneten Ressourcentyp gelten. Beispiel: `„URN:ietf:Parameters:scim:Schemas:Erweiterung: servicenow:2,0:Anwender" `. Datentyp: Array des Objekts "schemaExtensions": { "required": Boolean, "schema": "String" } |
| Resources.schemaErweiterungen.erforderlich | Kennzeichnung, die angibt, ob die Schemaerweiterung für den Ressourcentyp erforderlich ist. Mögliche Werte: * Wahr: Eine Ressource dieses Typs muss diese Schemaerweiterung und auch alle Attribute enthalten, die in dieser Schemaerweiterung als erforderlich deklariert sind. * Falsch: Eine Ressource dieses Typs kann diese Schemaerweiterung auslassen. {#scim-GET-ResourceTypes__ul_nng_2p3_3rb} Datentyp: Boolescher Wert |
| Resources.schemaErweiterungen.Schema | URI eines erweiterten Schemas. Beispiel: `„URN:ietf:Parameters:scim:Schemas:Erweiterung: servicenow:2,0:Anwender" `. Datentyp: Zeichenfolge |
| Schemas | Schema, das zum Verarbeiten der Listenantwort auf die Anforderung verwendet wird. Beispiel: `„URN:ietf:Parameters:scim:api:Messages:2,0:ListResponse" ` Datentyp: Zeichenfolge |
| startIndex | Einbasierter Index in der Ressourcentabelle, mit dem Datensätze abgerufen wurden. Datentyp: Zeichenfolge |
| Gesamtergebnisse | Gesamtanzahl der Datensätze, die der Anforderung entsprechen. Datentyp: Zahl |
[ ]

{#scim-GET-ResourceTypes__id_avz_rp3_3rb}  

### Curl-Anforderung

Das folgende Beispiel zeigt, wie Sie die SCIM-Ressourcentypen abrufen, die von unterstützt werden ServiceNowInstanz.

    curl "https://instance-servicenow.com/api/now/scim/ResourceTypes \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {
      "schemas":[
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
      ],
      "totalResults":6,
      "Resources":[
        {
          "schemas":[
            "urn:ietf:params:scim:schemas:core:2.0:ResourceType"
          ],
          "id":"User",
          "name":"User",
          "description":"User Account",
          "endpoint":"/Users",
          "schema":"urn:ietf:params:scim:schemas:core:2.0:User",
          "schemaExtensions":[
            {
              "schema":"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User",
              "required":false
            },
            {
              "schema":"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User",
              "required":false
            }
          ],
          "meta":{
            "resourceType":"ResourceType",
            "location":"https://instance-servicenow.com/api/now/scim/ResourceTypes/User"
          }
        },
        {
          "schemas":[
            "urn:ietf:params:scim:schemas:core:2.0:ResourceType"
          ],
          "id":"Group",
          "name":"Group",
          "description":"Group",
          "endpoint":"/Groups",
          "schema":"urn:ietf:params:scim:schemas:core:2.0:Group",
          "meta":{
            "resourceType":"ResourceType",
            "location":"https://instance-servicenow.service-now.com/api/now/scim/ResourceTypes/Group"
          }
        },
        {
          "schemas":[
            "urn:ietf:params:scim:schemas:core:2.0:ResourceType"
          ],
          "id":"Company",
          "name":"Company",
          "description":"Company",
          "endpoint":"/Companies",
          "schema":"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Company",
          "meta":{
            "resourceType":"ResourceType",
            "location":"https://instance-servicenow.com/api/now/scim/ResourceTypes/Company"
          }
        },
        {
          "schemas":[
            "urn:ietf:params:scim:schemas:core:2.0:ResourceType"
          ],
          "id":"Department",
          "name":"Department",
          "description":"Department",
          "endpoint":"/Departments",
          "schema":"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Department",
          "meta":{
            "resourceType":"ResourceType",
            "location":"https://instance-servicenow.com/api/now/scim/ResourceTypes/Department"
          }
        },
        {
          "schemas":[
            "urn:ietf:params:scim:schemas:core:2.0:ResourceType"
          ],
          "id":"CostCenter",
          "name":"CostCenter",
          "description":"CostCenter",
          "endpoint":"/CostCenters",
          "schema":"urn:ietf:params:scim:schemas:custom:servicenow:2.0:CostCenter",
          "meta":{
            "resourceType":"ResourceType",
            "location":"https://instance-servicenow.com/api/now/scim/ResourceTypes/CostCenter"
          }
        },
        {
          "schemas":[
            "urn:ietf:params:scim:schemas:core:2.0:ResourceType"
          ],
          "id":"Location",
          "name":"Location",
          "description":"Location",
          "endpoint":"/Locations",
          "schema":"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Location",
          "meta":{
            "resourceType":"ResourceType",
            "location":"https://instance-servicenow.com/api/now/scim/ResourceTypes/Location"
          }
        }
      ],
      "startIndex":1,
      "itemsPerPage":6
    }

## SCIM -- GET /scim/ResourceTypes/{ResourceName} AB {#ariaid-title15}

Ruft Informationen zum angegebenen System für den Ressourcentyp „domänenübergreifendes Identitätsmanagement" (SCIM) ab.
Dies ist ein öffentlicher Endpunkt und erfordert keine Rollen für den Zugriff.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/ResourceTypes/{ResourceName}

Standard-URL: /api/now/scim/ResourceTypes/{ResourceName}  
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

{#scim-GET-ResourceTypes-ResourceName__entry__2}{#scim-GET-ResourceTypes-ResourceName__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 |
| Ressourcenname | Eindeutige ID des abzurufenden Ressourcentyps. Gültige Werte: * Unternehmen * CostCenter * Abteilung * Gruppe * Standort * Anwender {#scim-GET-ResourceTypes-ResourceName__ul_vml_qr3_3rb} Datentyp: Zeichenfolge |
[Tabelle : 91. Pfad-Parameter]

{#scim-GET-ResourceTypes-ResourceName__entry__8}

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

{#scim-GET-ResourceTypes-ResourceName__entry__12}

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

### Header

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

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

{#scim-GET-ResourceTypes-ResourceName__entry__20}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 95. 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.").
{#scim-GET-ResourceTypes-ResourceName__entry__24}{#scim-GET-ResourceTypes-ResourceName__entry-200-status-code}{#scim-GET-ResourceTypes-ResourceName__entry-404-status-code}

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

### Antworttext-Parameter (JSON)

{#scim-GET-ResourceTypes-ResourceName__id_avz_rp3_3rb__entry__2}

| Name | Beschreibung |
|-|-|
| Beschreibung | Kurze Beschreibung des Ressourcentyps. Datentyp: Zeichenfolge |
| endpoint | Name des HTTP-adressierbaren Endpunkts relativ zur Basis-URL des Service Providers, z. B. „Unternehmen". Datentyp: Zeichenfolge |
| ID | Eindeutiger Bezeichner für die Ressource. Verwenden Sie dieses Attribut beim Aufrufen des Endpunkts GET /scim/ResourceType/{resource_ID}. Datentyp: Zeichenfolge |
| Meta | Informationen, die die zugeordnete Ressource weiter beschreiben. Datentyp: Objekt "metadata": { "location": "String", "resourceType": "String" } |
| Meta.Standort | URI des zugeordneten Ressourcentyps auf dem zugeordneten ServiceNowInstanz. Datentyp: Zeichenfolge |
| Meta.resourceType | Immer „ResourceType". Datentyp: Zeichenfolge |
| name | Name des Ressourcentyps, z. B. Anwender oder Gruppe. Datentyp: Zeichenfolge |
| Schema | Primärer/Basisschema-URI des Ressourcentyps. Beispiel: `„URN:ietf:Parameters:scim:Schemas:Core:2,0:Anwender" `. Datentyp: Zeichenfolge |
| Schemas | Schema, das zum Verarbeiten von verwendet wird `/ResourceType `Anforderung. Beispiel: `„URN:ietf:Parameters:scim:Schemas:Core:2,0:ResourceType" `. Datentyp: Zeichenfolge |
| SchemaErweiterungen | Liste der Schemaerweiterungen, die für den zugeordneten Ressourcentyp gelten. Beispiel: `„URN:ietf:Parameters:scim:Schemas:Erweiterung: servicenow:2,0:Anwender" `. Datentyp: Array des Objekts "schemaExtensions": { "required": Boolean, "schema": "String" } |
| SchemaErweiterungen.erforderlich | Kennzeichnung, die angibt, ob die Schemaerweiterung für den Ressourcentyp erforderlich ist. Mögliche Werte: * Wahr: Eine Ressource dieses Typs muss diese Schemaerweiterung und auch alle Attribute enthalten, die in dieser Schemaerweiterung als erforderlich deklariert sind. * Falsch: Eine Ressource dieses Typs kann diese Schemaerweiterung auslassen. {#scim-GET-ResourceTypes-ResourceName__ul_nng_2p3_3rb} Datentyp: Boolescher Wert |
| SchemaExtensions.Schema | URI eines erweiterten Schemas. Beispiel: `„URN:ietf:Parameters:scim:Schemas:Erweiterung: servicenow:2,0:Anwender" `. Datentyp: Zeichenfolge |
| Schemas | Schema, das zum Verarbeiten der Listenantwort auf die Anforderung verwendet wird. Beispiel: `„URN:ietf:Parameters:scim:api:Messages:2,0:ListResponse" ` Datentyp: Zeichenfolge |
[ ]

{#scim-GET-ResourceTypes-ResourceName__id_avz_rp3_3rb}  

### Curl-Anforderung

Das folgende Beispiel zeigt, wie der Ressourcentyp „Anwender-SCIM" von abgerufen wird ServiceNowInstanz.

    curl "https://instance-servicenow.com/api/now/scim/ResourceTypes/"User" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {
      "schemas":[
        "urn:ietf:params:scim:schemas:core:2.0:ResourceType"
      ],
      "id":"User",
      "name":"User",
      "description":"User Account",
      "endpoint":"/Users",
      "schema":"urn:ietf:params:scim:schemas:core:2.0:User",
      "schemaExtensions":[
        {
          "schema":"urn:ietf:params:scim:schemas:extension:servicenow:2.0:User",
          "required":false
        },
        {
          "schema":"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User",
          "required":false
        }
      ],
      "meta":{
        "resourceType":"ResourceType",
        "location":"https://instance-servicenow.com/api/now/scim/ResourceTypes/User"
      }
    }

## SCIM: /scim/Schemas ABRUFEN {#ariaid-title16}

Ruft Informationen zu allen Ressourcenschemas für das domänenübergreifende Identitätsmanagement (SCIM) ab, die von unterstützt werden ServiceNowInstanz. Diese Schemas definieren die Attribute, die für jeden Ressourcentyp verfügbar sind.
Dies ist ein öffentlicher Endpunkt und erfordert keine Rollen für den Zugriff.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Schemas

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

{#scim-GET-Schemas__entry__2}{#scim-GET-Schemas__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 |
[Tabelle : 97. Pfad-Parameter]

{#scim-GET-Schemas__entry__6}

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

{#scim-GET-Schemas__entry__10}

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

### Header

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

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

{#scim-GET-Schemas__entry__18}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 101. 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.").
{#scim-GET-Schemas__entry__22}{#scim-GET-Schemas__entry-200-status-code}

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

### Antworttext-Parameter (JSON)

{#scim-GET-Schemas__entry__26}

| Name | Beschreibung |
|-|-|
| Standard-RFC7643 gibt Ergebnisse zurück | Die Methode gibt Ergebnisse zurück, die dem RFC7643-Standard entsprechen. Weitere Informationen finden Sie unter [Schemadefinition](https://datatracker.ietf.org/doc/html/rfc7643#section-7)In der Spezifikation RFC7643. |
[ ]

### Curl-Anforderung

Das folgende Beispiel zeigt, wie Sie die von unterstützten SCIM-Schemas abrufen ServiceNowInstanz.

    curl "https://instance-servicenow.com/api/now/scim/Schemas \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {
      "schemas":[
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
      ],
      "totalResults":8,
      "Resources":[
        {
          "schemas":[
            "urn:ietf:params:scim:schemas:core:2.0:Schema"
          ],
          "id":"urn:ietf:params:scim:schemas:core:2.0:User",
          "name":"User",
          "description":"User Account",
          "attributes":[
            {
              "name":"active",
              "type":"boolean",
              "multiValued":false,
              "description":"A Boolean value indicating the User's administrative status.",
              "required":false,
              "caseExact":true,
              "mutability":"readWrite",
              "returned":"default",
              "uniqueness":"none"
            },
            {
              "name":"addresses",
              "type":"complex",
              "subAttributes":[
                {
                  "name":"country",
                  "type":"string",
                  "multiValued":false,
                  "description":"The country name component.",
                  "required":false,
                  "caseExact":false,
                  "mutability":"readWrite",
                  "returned":"default",
                  "uniqueness":"none"
                },
                {
                  "name":"formatted",
                  "type":"string",
                  "multiValued":false,
                  "description":"The full mailing address, formatted for display or use with a mailing label. This attribute MAY contain newlines.",
                  "required":false,
                  "caseExact":false,
                  "mutability":"readWrite",
                  "returned":"default",
                  "uniqueness":"none"
                },
                {
                  "name":"locality",
                  "type":"string",
                  "multiValued":false,
                  "description":"The city or locality component.",
                  "required":false,
                  "caseExact":false,
                  "mutability":"readWrite",
                  "returned":"default",
                  "uniqueness":"none"
                },
                {
                  "name":"postalCode",
                  "type":"string",
                  "multiValued":false,
                  "description":"The zipcode or postal code component.",
                  "required":false,
                  "caseExact":false,
                  "mutability":"readWrite",
                  "returned":"default",
                  "uniqueness":"none"
                },
                {
                  "name":"primary",
                  "type":"boolean",
                  "multiValued":false,
                  "description":"A Boolean value indicating the 'primary' or 
                    preferred attribute value for this attribute, e.g., the preferred address. 
                    The primary attribute value 'true' MUST appear no more than once.",
                  "required":false,
                  "caseExact":true,
                  "mutability":"readWrite",
                  "returned":"default",
                  "uniqueness":"none"
                },
                {
                  "name":"region",
                  "type":"string",
                  "multiValued":false,
                  "description":"The state or region component.",
                  "required":false,
                  "caseExact":false,
                  "mutability":"readWrite",
                  "returned":"default",
                  "uniqueness":"none"
                },
                {
                  "name":"streetAddress",
                  "type":"string",
                  "multiValued":false,
                  "description":"The full street address component, which may include house number, 
                    street name, PO BOX, and multi-line extended street address information. This 
                    attribute MAY contain newlines.",
                  "required":false,
                  "caseExact":false,
                  "mutability":"readWrite",
                  "returned":"default",
                  "uniqueness":"none"
                },
                {
                  "name":"type",
                  "type":"string",
                  "multiValued":false,
                  "description":"A label indicating the attribute's function; e.g., 'work' or 'home'.",
                  "required":false,
                  "canonicalValues":["other","work","home"],
                  "caseExact":false,
                  "mutability":"readWrite",
                  "returned":"default",
                  "uniqueness":"none"
                }
              ],
              "multiValued":true,
              "description":"Physical mailing addresses for this User.",
              "required":false,
              "caseExact":true,
              "mutability":"readWrite",
              "returned":"default",
              "uniqueness":"none"
            },
    .
    .
    .
          {
            "schemas":[
              "urn:ietf:params:scim:schemas:core:2.0:Schema"
            ],
            "id":"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Department",
            "name":"Department",
            "description":"Department",
            "attributes":[
              {
                "name":"name",
                "type":"string",
                "multiValued":false,
                "description":"The name of the department.",
                "required":false,
                "caseExact":false,
                "mutability":"readOnly",
                "returned":"default",
                "uniqueness":"none"
              }
            ],
            "meta":{
              "resourceType":"Schema",
              "location":"https://instance-servicenow.com/api/now/scim/Schemas/urn:ietf:params:scim:schemas:custom:servicenow:2.0:Department"
            }
          },
          {
            "schemas":[
              "urn:ietf:params:scim:schemas:core:2.0:Schema"
            ],
            "id":"urn:ietf:params:scim:schemas:custom:servicenow:2.0:CostCenter",
            "name":"CostCenter",
            "description":"CostCenter",
            "attributes":[
              {
                "name":"name",
                "type":"string",
                "multiValued":false,
                "description":"The name of the cost center.",
                "required":false,
                "caseExact":false,
                "mutability":"readOnly",
                "returned":"default",
                "uniqueness":"none"
              }
            ],
            "meta":
              {
                "resourceType":"Schema",
                "location":"https://instance.servicenow.com/api/now/scim/Schemas/urn:ietf:params:scim:schemas:custom:servicenow:2.0:CostCenter"
             }
            },
            {
              "schemas":[
                "urn:ietf:params:scim:schemas:core:2.0:Schema"
              ],
            "id":"urn:ietf:params:scim:schemas:custom:servicenow:2.0:Location",
            "name":"Location",
            "description":"Location",
            "attributes":[
              {
                "name":"name",
                "type":"string",
                "multiValued":false,
                "description":"The location name.",
                "required":false,
                "caseExact":false,
                "mutability":"readOnly",
                "returned":"default",
                "uniqueness":"none"
              }
            ],
            "meta":{
              "resourceType":"Schema",
              "location":"https://instance.servicenow.com/api/now/scim/Schemas/urn:ietf:params:scim:schemas:custom:servicenow:2.0:Location"
            }
          }
        ],
        "startIndex":1,
      "itemsPerPage":8
    }

## SCIM -- GET /scim/Schemas/{SchemaName} AB {#ariaid-title17}

Ruft Informationen zum angegebenen System für Ressourcenschemas für domänenübergreifendes Identitätsmanagement (SCIM) ab, die von unterstützt werden ServiceNowInstanz. Diese Schemas definieren die Attribute, die für jeden Ressourcentyp verfügbar sind.
Dies ist ein öffentlicher Endpunkt und erfordert keine Rollen für den Zugriff.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Schemas/{SchemaName}

Standard-URL: /api/now/scim/Schemas/{SchemaName}  
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

{#scim-GET-Schemas-SchemaName__entry__2}{#scim-GET-Schemas-SchemaName__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 |
| Schemaname | URI des zurückzugebenden Ressourcenschemas. Gültige Werte: * URN:ietf:params:scim:Schemas:Core:2,0:Anwender * URN:ietf:params:scim:Schemas:Extension: enterprise:2,0:Anwender * URN:ietf:params:scim:Schemas:Extension: servicenow:2,0:Anwender * URN:ietf:params:scim:Schemas:Core:2,0:Group * URN:ietf:params:scim:Schemas:anwenderdefiniert: servicenow:2,0:Unternehmen * URN:ietf:Parameters:scim:Schemas:anwenderdefiniert: servicenow:2,0:Abteilung * URN:ietf:Parameters:scim:Schemas:anwenderdefiniert: servicenow:2,0:CostCenter * URN:ietf:Parameters:scim:Schemas:anwenderdefiniert: servicenow:2,0:Standort Datentyp: Zeichenfolge |
[Tabelle : 103. Pfad-Parameter]

{#scim-GET-Schemas-SchemaName__entry__8}

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

{#scim-GET-Schemas-SchemaName__entry__12}

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

### Header

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

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

{#scim-GET-Schemas-SchemaName__entry__20}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 107. 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.").
{#scim-GET-Schemas-SchemaName__entry__24}{#scim-GET-Schemas-SchemaName__entry-200-status-code}{#scim-GET-Schemas-SchemaName__entry-404-status-code}

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

### Antworttext-Parameter (JSON)

{#scim-GET-Schemas-SchemaName__entry__30}

| Name | Beschreibung |
|-|-|
| Standard-RFC7643 gibt Ergebnisse zurück | Die Methode gibt Ergebnisse zurück, die dem RFC7643-Standard entsprechen. Weitere Informationen finden Sie unter [Schemadefinition](https://datatracker.ietf.org/doc/html/rfc7643#section-7)In der Spezifikation RFC7643. |
[ ]

### Curl-Anforderung

Das folgende Beispiel zeigt, wie Sie das Core-Gruppen-SCIM-Schema von einem abrufen ServiceNowInstanz.

    curl "https://instance-servicenow.com/api/now/scim/Schemas/"urn:ietf:params:scim:schemas:core:2.0:Group" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {
      "schemas":[
        "urn:ietf:params:scim:schemas:core:2.0:Schema"
      ],
      "id":"urn:ietf:params:scim:schemas:core:2.0:Group",
      "name":"Group",
      "description":"Group",
      "attributes":[
        {
          "name":"displayName",
          "type":"string",
          "multiValued":false,
          "description":"A human-readable name for the Group.",
          "required":true,
          "caseExact":false,
          "mutability":"readWrite",
          "returned":"default",
          "uniqueness":"none"
        },
        {
          "name":"members",
          "type":"complex",
          "subAttributes":[
            {
              "name":"display",
              "type":"string",
              "multiValued":false,
              "description":"A human readable name, primarily used for display purposes.",
              "required":false,
              "caseExact":false,
              "mutability":"immutable",
              "returned":"default",
              "uniqueness":"none"
            },
            {
              "name":"value",
              "type":"string",
              "multiValued":false,
              "description":"The identifier of a group member.",
              "required":true,
              "caseExact":false,
              "mutability":"immutable",
              "returned":"default",
              "uniqueness":"none"
            },
            {
              "name":"$ref",
              "type":"reference",
              "multiValued":false,
              "description":"The URI of the member resource.",
              "required":false,
              "caseExact":true,
              "mutability":"immutable",
              "returned":"default",
              "uniqueness":"none",
              "referenceTypes":["Group","User"]
            }
          ],
          "multiValued":true,
          "description":"A list of members of the Group.",
          "required":false,
          "caseExact":true,
          "mutability":"readWrite",
          "returned":"default",
          "uniqueness":"none"
        }
      ],
      "meta":{
        "resourceType":"Schema",
        "location":"https://instance-servicenow.com/api/now/scim/Schemas/urn:ietf:params:scim:schemas:core:2.0:Group"
      }
    }

## SCIM -- GET /scim/ServiceProviderConfig {#ariaid-title18}

Gibt die Konfigurationsmetadaten zurück, die zum Abrufen von Informationen zu den Servicefähigkeiten, Konfigurationen, Schemas und Ressourcentypen für die SCIM-Endpunkte (System for Domain Identity Management) verwendet werden sollen, die in verfügbar sind ServiceNowInstanz.
Dies ist ein öffentlicher Endpunkt und erfordert keine Rollen für den Zugriff.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/ServiceProviderConfig

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

{#scim-GET-ServiceProviderConfig__entry__2}{#scim-GET-ServiceProviderConfig__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 |
[Tabelle : 109. Pfad-Parameter]

{#scim-GET-ServiceProviderConfig__entry__6}

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

{#scim-GET-ServiceProviderConfig__entry__10}

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

### Header

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

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

{#scim-GET-ServiceProviderConfig__entry__18}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 113. 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.").
{#scim-GET-ServiceProviderConfig__entry__22}{#scim-GET-ServiceProviderConfig__entry-200-status-code}

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

### Antworttext-Parameter (JSON)

{#scim-GET-ServiceProviderConfig__entry__26}

| Name | Beschreibung |
|-|-|
| Standard-RFC7643 gibt Ergebnisse zurück | Die Methode gibt Ergebnisse zurück, die dem RFC7643-Standard entsprechen. Weitere Informationen finden Sie unter [Konfigurationsschema Des Service Providers](https://datatracker.ietf.org/doc/html/rfc7643#section-5)In der Spezifikation RFC7643. |
[ ]

### Curl-Anforderung

Das folgende Beispiel zeigt, wie die SCIM-Konfigurationsmetadaten für abgerufen werden ServiceNowInstanz.

    curl "https://instance-servicenow.com/api/now/scim/ServiceProviderConfig \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {
      "schemas": [
        "urn:ietf:params:scim:schemas:core:2.0:ServiceProviderConfig"
      ],
      "patch": {
        "supported": true
      },
      "bulk": {
        "supported": false,
        "maxOperations": 0,
        "maxPayloadSize": 1000000
      },
      "filter": {
        "supported": true,
        "maxResults": 500
      },
      "changePassword": {
        "supported": false
      },
      "sort": {
        "supported": false
      },
      "etag": {
        "supported": false
      },
      "authenticationSchemes": [
        {
          "name": "OAuth 2.0 Bearer Token",
          "description": "The OAuth 2.0 Bearer Token Authentication scheme. OAuth
            enables clients to access protected resources by obtaining an access token, which is
            defined in RFC 6750 as \"a string representing an access authorization issued to the
            client\", rather than using the resource owner's credentials directly.",
          "specUri": "http://tools.ietf.org/html/rfc6750",
          "type": "oauthbearertoken",
          "primary": true
        }
      ]
    }

## SCIM -- GET /scim/companies {#ariaid-title19}

Gibt einen oder mehrere Unternehmensdatensätze aus der Tabelle „Unternehmen" \[Core_Company\] in einem zurück ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.
Hinweis:  
Eine Abfrage, die keine Übereinstimmungen zurückgibt, gibt Erfolg (HTTP-Statuscode 200) mit zurück totalResultsAuf 0 festlegen.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Companies

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

{#scim-GET-Companies__entry__2}{#scim-GET-Companies__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 |
[Tabelle : 115. Pfad-Parameter]

{#scim-GET-Companies__entry__6}{#scim-GET-Companies__attributes-SCIM-entry}{#scim-GET-Companies__count-SCIM-entry}{#scim-GET-Companies__excludedAttributes-SCIM-entry}{#scim-GET-Companies__group_sortBy-SCIM-entry}{#scim-GET-Companies__sortOrder-SCIM-entry}{#scim-GET-Companies__group_startIndex-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| count | Anzahl der zurückzugebenden Datensätze. Ein negativer Wert wird als Null interpretiert. Datentyp: Zahl Maximum: 500 -- Ein Wert größer als dieser führt zu einem Fehler bei ungültigen Anforderungen. Standard: 10 |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
| Filter | Filterausdruck, der auf die Rückgabeergebnisse angewendet werden soll. Feldfilter werden als ausgedrückt `<field_name> <operator> <„value"> `. Siehe [RFC7644](https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2)Für eine Liste der gültigen Operatoren. Hinweis: Die `NICHT `Operator wird von dieser Methode nicht unterstützt. Um beispielsweise nach allen Unternehmen zu filtern, deren Name mit „Acme" beginnt, geben Sie ein `DisplayName SW „Acme" `. Um mehr als einen Feldfilter anzugeben, verketten Sie die Filter mit `UND `Operand. Um beispielsweise nach allen Unternehmen zu filtern, deren Name mit „Acme" beginnt und zuletzt vor dem 3. Oktober 2021 geändert wurden, geben Sie ein `DisplayName SW „Acme" UND Meta.lastModified LT „2021-10-03T00:00:00Z" `. Verwenden Sie Dot-Walking, um geschachtelte Attribute anzugeben. Datentyp: Zeichenfolge Standard: Keine Filterung |
| sortBy | Muss mit angegeben werden sortOrderParameter. Feld, nach dem die Rückgabeergebnisse sortiert werden sollen. Bei der Sortierung wird zwischen Groß- und Kleinschreibung unterschieden. Sie können nur die Parameter verwenden, die zum Filtern für verfügbar sind sortByParameter, außer dem externalIdIst nicht zulässig. Für Werte, die null sind: * Aufsteigend sortiert: Null-Werte werden nach oben sortiert. * Sortiert nach absteigend: Null-Werte werden nach unten sortiert. {#scim-GET-Companies__ul_xsb_zmm_hrb} Datentyp: Zeichenfolge Standard: Keine Sortierung |
| sortOrder | Muss mit angegeben werden sortByParameter. Reihenfolge, in der sortByParameter wird auf die Rückgabeergebnisse angewendet. Gültige Werte: * Aufsteigend * Absteigend {#scim-GET-Companies__ul_mmn_zrc_grb} Datentyp: Zeichenfolge Standard: Aufsteigend |
| startIndex | Einbasierter Index in der Tabelle, bei der mit dem Abrufen von Datensätzen begonnen werden soll. Beispiel: Wenn Sie diesen Parameter auf 100 und festlegen countParameter für 20. Der Endpunkt gibt Datensätze 100 bis 119 zurück. Hinweis: Jeder Wert, der auf weniger als einen festgelegt ist, wird als einer interpretiert. Datentyp: Zeichenfolge Standard: 1 |
[Tabelle : 116. Abfrageparameter]

{#scim-GET-Companies__entry__22}

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

### Header

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

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

{#scim-GET-Companies__entry__30}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 119. 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.").
{#scim-GET-Companies__entry__34}{#scim-GET-Companies__entry-200-status-code}{#scim-GET-Companies__status_400-SCIM-entry}{#scim-GET-Companies__entry-401-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. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben. * Stellen Sie sicher, dass countParameter ist nicht größer als 500. * Stellen Sie sicher, dass alle filterParameter sind gültig. {#scim-GET-Companies__ul_vn1_gvz_nrb} |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
[Tabelle : 120. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-GET-Companies__id_uwg_55q_3rb__entry__2}{#scim-GET-Companies__itemsPerPage-SCIM-entry}{#scim-GET-Companies__totalResults-SCIM-entry}

| Name | Beschreibung |
|-|-|
| ItemsPerPage | Anzahl der in den Rückgabeergebnissen zurückgegebenen Datensätze. Datentyp: Zahl |
| Ressourcen | Liste der zurückgegebenen Kostenstellendatensätze. Datentyp: Objekt "Resources": { "id": "String", "meta": {Object}, "name": "String", "schemas": "String" } |
| Resources.ID | SYS_ID des Unternehmensdatensatzes. Datentyp: Zeichenfolge |
| Ressourcen.Meta | Informationen zum Unternehmensdatensatz. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": "String", "resourcType": "String" } |
| Resources.Meta.erstellt | Datum und Uhrzeit der Erstellung des zugehörigen Unternehmensdatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des zugehörigen Unternehmensdatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.location | URI des zugehörigen Unternehmensdatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.resourceType | SCIM-Ressourcentyp: Immer Unternehmen. Datentyp: Zeichenfolge |
| Resources.name | Unternehmensname. Datentyp: Zeichenfolge |
| Resources.Schemas | Schema, das bei der Verarbeitung der Anforderung verwendet wird. Datentyp: Zeichenfolge |
| Schemas | Schema, das zum Verarbeiten der Listenantwort auf die Anforderung verwendet wird. Beispiel: `„URN:ietf:Parameters:scim:api:Messages:2,0:ListResponse" ` Datentyp: Zeichenfolge |
| startIndex | Einbasierter Index in der Tabelle „Unternehmen" \[Core_Company\], in der die Datensätze zurückgegeben wurden. Datentyp: Zeichenfolge |
| Gesamtergebnisse | Gesamtanzahl der Datensätze, die der Anforderung entsprechen. Datentyp: Zahl |
[ ]

{#scim-GET-Companies__id_uwg_55q_3rb}  

### Curl-Anforderung

Dieses Beispiel zeigt, wie die ersten beiden Unternehmensdatensätze abgerufen werden.

    curl "https://instance-servicenow.com/api/now/scim/Companies?count=2" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {
      "schemas":[
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
      ],
      "totalResults":182,
      "Resources":[
        {
          "schemas":[
            "urn:ietf:params:scim:schemas:custom:servicenow:2.0:Company"
          ],
          "id":"0c43af40c6112275011a4bd4c0143fbf",
          "meta":{
            "resourceType":"Company",
            "created":"2005-05-24T01:14:19Z",
            "lastModified":"2013-05-06T23:44:48Z",
            "location":"https://instance-servicenow.com/api/now/scim/Companies/0c43af40c6112275011a4bd4c0143fbf"
          },
          "name":"ABC Company"
        },
        {
          "schemas":[
            "urn:ietf:params:scim:schemas:custom:servicenow:2.0:Company"
          ],
          "id":"0c43b088c6112275011a4bd46a4e6cc4",
          "meta":{
            "resourceType":"Company",
            "created":"2005-05-24T01:14:19Z",
            "lastModified":"2013-06-05T17:53:26Z",
            "location":"https://instance-servicenow.com/api/now/scim/Companies/0c43b088c6112275011a4bd46a4e6cc4"
          },
          "name":"Acme Co"
        }
      ],
      "startIndex":1,
      "itemsPerPage":2
    }

## SCIM -- GET /scim/companies/{Company_ID} {#ariaid-title20}

Gibt den angegebenen Unternehmensdatensatz aus der Tabelle „Unternehmen" \[Core_Company\] in einem zurück ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.
<br />

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Companies/{Company_ID}

Standard-URL: /api/now/scim/Groups/{Company_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

{#scim-GET-Companies-company_id__entry__2}{#scim-GET-Companies-company_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 |
| Unternehmens-ID | SYS_ID des zurückzugebenden Unternehmensdatensatzes. Datentyp: Zeichenfolge |
[Tabelle : 121. Pfad-Parameter]

{#scim-GET-Companies-company_id__entry__8}{#scim-GET-Companies-company_id__attributes-SCIM-entry}{#scim-GET-Companies-company_id__excludedAttributes-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
[Tabelle : 122. Abfrageparameter]

{#scim-GET-Companies-company_id__entry__14}

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

### Header

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

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

{#scim-GET-Companies-company_id__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 125. 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.").
{#scim-GET-Companies-company_id__entry__26}{#scim-GET-Companies-company_id__entry-200-status-code}{#scim-GET-Companies-company_id__status_400-SCIM-entry}{#scim-GET-Companies-company_id__entry-401-status-code}{#scim-GET-Companies-company_id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben. * Stellen Sie sicher, dass countParameter ist nicht größer als 500. * Stellen Sie sicher, dass alle filterParameter sind gültig. {#scim-GET-Companies-company_id__ul_vn1_gvz_nrb} |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 126. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-GET-Companies-company_id__id_mvt_mbq_3rb__entry__2}{#scim-GET-Companies-company_id__id-company-SCIM-entry}{#scim-GET-Companies-company_id__meta-company-SCIM-entry}{#scim-GET-Companies-company_id__meta_created-company-SCIM-entry}{#scim-GET-Companies-company_id__meta_lastModified-company-SCIM-entry}{#scim-GET-Companies-company_id__meta_location-company-SCIM-entry}{#scim-GET-Companies-company_id__meta_resourceType-company-SCIM-entry}{#scim-GET-Companies-company_id__name-company-SCIM-entry}{#scim-GET-Companies-company_id__schemas-company-SCIM-entry}

| Name | Beschreibung |
|-|-|
| ID | SYS_ID des Unternehmensdatensatzes. Datentyp: Zeichenfolge |
| Meta | Informationen zum Unternehmensdatensatz. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": "String", "resourcType": "String" } |
| Meta.erstellt | Datum und Uhrzeit der Erstellung des zugehörigen Unternehmensdatensatzes. Datentyp: Zeichenfolge |
| Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des zugehörigen Unternehmensdatensatzes. Datentyp: Zeichenfolge |
| Meta.Standort | URI des zugehörigen Unternehmensdatensatzes. Datentyp: Zeichenfolge |
| Meta.resourceType | SCIM-Ressourcentyp: Immer Unternehmen. Datentyp: Zeichenfolge |
| name | Unternehmensname. Datentyp: Zeichenfolge |
| Schemas | Schema, das bei der Verarbeitung der Anforderung verwendet wird. Datentyp: Zeichenfolge |
[ ]

{#scim-GET-Companies-company_id__id_mvt_mbq_3rb}  

### Curl-Anforderung

Dieses Beispiel zeigt, wie ein bestimmter Unternehmensdatensatz abgerufen wird.

    curl "https://instance-servicenow.com/api/now/scim/Companies/0c43af40c6112275011a4bd4c0143fbf" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort

    {
      "schemas":[
        "urn:ietf:params:scim:schemas:custom:servicenow:2.0:Company"
      ],
      "id":"0c43af40c6112275011a4bd4c0143fbf",
      "meta":{
        "resourceType":"Company",
        "created":"2005-05-24T01:14:19Z",
        "lastModified":"2013-05-06T23:44:48Z",
        "location":"https://instance-servicenow.com/api/now/scim/Companies/0c43af40c6112275011a4bd4c0143fbf"
      },
      "name":"ABC Company"
    }

## SCIM: /scim/CostCenter ABRUFEN {#ariaid-title21}

Gibt einen oder mehrere Kostenstellendatensätze aus der Tabelle „Kostenstelle" \[cmn_Cost_Center\] in einem zurück ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.
Hinweis:  
Eine Abfrage, die keine Übereinstimmungen zurückgibt, gibt Erfolg (HTTP-Statuscode 200) mit zurück totalResultsAuf 0 festlegen.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/CostCenter

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

{#scim-GET-CostCenters__entry__2}{#scim-GET-CostCenters__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 |
[Tabelle : 127. Pfad-Parameter]

{#scim-GET-CostCenters__entry__6}{#scim-GET-CostCenters__attributes-SCIM-entry}{#scim-GET-CostCenters__count-SCIM-entry}{#scim-GET-CostCenters__excludedAttributes-SCIM-entry}{#scim-GET-CostCenters__group_sortBy-SCIM-entry}{#scim-GET-CostCenters__sortOrder-SCIM-entry}{#scim-GET-CostCenters__group_startIndex-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| count | Anzahl der zurückzugebenden Datensätze. Ein negativer Wert wird als Null interpretiert. Datentyp: Zahl Maximum: 500 -- Ein Wert größer als dieser führt zu einem Fehler bei ungültigen Anforderungen. Standard: 10 |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
| Filter | Filterausdruck, der auf die Rückgabeergebnisse angewendet werden soll. Feldfilter werden als ausgedrückt `<field_name> <operator> <„value"> `. Siehe [RFC7644](https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2)Für eine Liste der gültigen Operatoren. Hinweis: Die `NICHT `Operator wird von dieser Methode nicht unterstützt. Um beispielsweise nach allen Kostenstellen zu filtern, deren Name mit „HR" beginnt, geben Sie ein `DisplayName SW „HR" `. Um mehr als einen Feldfilter anzugeben, verketten Sie die Filter mit `UND `Operand. Um beispielsweise nach allen Kostenstellen zu filtern, deren Name mit „HR" beginnt und zuletzt vor dem 3. Oktober 2021 geändert wurden, geben Sie ein `DisplayName SW „HR" UND Meta.lastModified LT „2021-10-03T00:00:00Z" `. Verwenden Sie Dot-Walking, um geschachtelte Attribute anzugeben. Datentyp: Zeichenfolge Standard: Keine Filterung |
| sortBy | Muss mit angegeben werden sortOrderParameter. Feld, nach dem die Rückgabeergebnisse sortiert werden sollen. Bei der Sortierung wird zwischen Groß- und Kleinschreibung unterschieden. Sie können nur die Parameter verwenden, die zum Filtern für verfügbar sind sortByParameter, außer dem externalIdIst nicht zulässig. Für Werte, die null sind: * Aufsteigend sortiert: Null-Werte werden nach oben sortiert. * Sortiert nach absteigend: Null-Werte werden nach unten sortiert. {#scim-GET-CostCenters__ul_xsb_zmm_hrb} Datentyp: Zeichenfolge Standard: Keine Sortierung |
| sortOrder | Muss mit angegeben werden sortByParameter. Reihenfolge, in der sortByParameter wird auf die Rückgabeergebnisse angewendet. Gültige Werte: * Aufsteigend * Absteigend {#scim-GET-CostCenters__ul_mmn_zrc_grb} Datentyp: Zeichenfolge Standard: Aufsteigend |
| startIndex | Einbasierter Index in der Tabelle, bei der mit dem Abrufen von Datensätzen begonnen werden soll. Beispiel: Wenn Sie diesen Parameter auf 100 und festlegen countParameter für 20. Der Endpunkt gibt Datensätze 100 bis 119 zurück. Hinweis: Jeder Wert, der auf weniger als einen festgelegt ist, wird als einer interpretiert. Datentyp: Zeichenfolge Standard: 1 |
[Tabelle : 128. Abfrageparameter]

{#scim-GET-CostCenters__entry__22}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 129. Anforderungstext-Parameter (SON)]

### 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.").
{#scim-GET-CostCenters__entry__26}{#scim-GET-CostCenters__Accept-SCIM-entry}

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

{#scim-GET-CostCenters__entry__30}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 131. 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.").
{#scim-GET-CostCenters__entry__34}{#scim-GET-CostCenters__entry-200-status-code}{#scim-GET-CostCenters__status_400-SCIM-entry}{#scim-GET-CostCenters__entry-401-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. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben. * Stellen Sie sicher, dass countParameter ist nicht größer als 500. * Stellen Sie sicher, dass alle filterParameter sind gültig. {#scim-GET-CostCenters__ul_vn1_gvz_nrb} |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
[Tabelle : 132. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-GET-CostCenters__id_tld_hxq_3rb__entry__2}{#scim-GET-CostCenters__itemsPerPage-SCIM-entry}{#scim-GET-CostCenters__totalResults-SCIM-entry}

| Name | Beschreibung |
|-|-|
| ItemsPerPage | Anzahl der in den Rückgabeergebnissen zurückgegebenen Datensätze. Datentyp: Zahl |
| Ressourcen | Liste der zurückgegebenen Kostenstellendatensätze. Datentyp: Objekt "Resources": { "id": "String", "meta": {Object}, "name": "String", "schemas": "String" } |
| Resources.ID | SYS_ID des Kostenstellendatensatzes. Datentyp: Zeichenfolge |
| Ressourcen.Meta | Informationen zum Kostenstellendatensatz. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": "String", "resourcType": "String" } |
| Resources.Meta.erstellt | Datum und Uhrzeit der Erstellung des zugehörigen Kostenstellendatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des zugehörigen Kostenstellendatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.location | URI des zugehörigen Kostenstellendatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.resourceType | SCIM-Ressourcentyp: Immer Kostenstelle. Datentyp: Zeichenfolge |
| Resources.name | Name der Kostenstelle. Datentyp: Zeichenfolge |
| Resources.Schemas | Schema, das bei der Verarbeitung der Anforderung verwendet wird. Datentyp: Zeichenfolge |
| Schemas | Schema, das zum Verarbeiten der Listenantwort auf die Anforderung verwendet wird. Beispiel: `„URN:ietf:Parameters:scim:api:Messages:2,0:ListResponse" ` Datentyp: Zeichenfolge |
| startIndex | Einbasierter Index in der Kostenstellentabelle \[cmn_Cost_Center\], in der die Datensätze zurückgegeben wurden. Datentyp: Zeichenfolge |
| Gesamtergebnisse | Gesamtanzahl der Datensätze, die der Anforderung entsprechen. Datentyp: Zahl |
[ ]

{#scim-GET-CostCenters__id_tld_hxq_3rb}  

### Curl-Anforderung

Dieses Beispiel zeigt, wie die ersten beiden Kostenstellendatensätze abgerufen werden.

    curl "https://instance-servicenow.com/api/now/scim/CostCenters?count=2" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {
      "schemas":[
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
      ],
      "totalResults":8,
      "Resources":[
        {
          "schemas":[
            "urn:ietf:params:scim:schemas:custom:servicenow:2.0:CostCenter"
          ],
          "id":"7fb1cc99c0a80a6d30c04574d14c0acf",
          "meta":{
            "resourceType":"CostCenter",
            "created":"2012-01-19T21:02:39Z",
            "lastModified":"2012-02-25T23:06:36Z",
            "location":"https://instance-servicenow.com/api/now/scim/CostCenters/7fb1cc99c0a80a6d30c04574d14c0acf"
          },
          "name":"Sales"
        },
        {
          "schemas":[
            "urn:ietf:params:scim:schemas:custom:servicenow:2.0:CostCenter"
          ],
          "id":"91e8bbf43710200044e0bfc8bcbe5daa",
          "meta":{
            "resourceType":"CostCenter",
            "created":"2012-02-18T04:40:24Z",
            "lastModified":"2012-02-25T23:05:58Z",
            "location":"https://instance-servicenow.com/api/now/scim/CostCenters/91e8bbf43710200044e0bfc8bcbe5daa"
          },
          "name":"Customer Support"
        }
      ],
      "startIndex":1,
      "itemsPerPage":2
    }

## SCIM: /scim/CostCenter/{Cost_Center_ID} ABRUFEN {#ariaid-title22}

Gibt den angegebenen Kostenstellendatensatz aus der Kostenstellentabelle \[cmn_Cost_Center\] in einem zurück ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.
Hinweis:  
Eine Abfrage, die keine Übereinstimmungen zurückgibt, gibt Erfolg (HTTP-Statuscode 200) mit zurück totalResultsAuf 0 festlegen.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/CostCenter/{Cost_Center_ID}

Standard-URL: /api/now/scim/CoostCenters/{Cost_Center_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

{#scim-GET-CostCenters-cost_center_id__entry__2}{#scim-GET-CostCenters-cost_center_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 |
| Cost_Center_ID | SYS_ID des zurückzugebenden Kostenstellendatensatzes. Datentyp: Zeichenfolge |
[Tabelle : 133. Pfad-Parameter]

{#scim-GET-CostCenters-cost_center_id__entry__8}{#scim-GET-CostCenters-cost_center_id__attributes-SCIM-entry}{#scim-GET-CostCenters-cost_center_id__excludedAttributes-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
[Tabelle : 134. Abfrageparameter]

{#scim-GET-CostCenters-cost_center_id__entry__14}

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

### Header

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

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

{#scim-GET-CostCenters-cost_center_id__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 137. 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.").
{#scim-GET-CostCenters-cost_center_id__entry__26}{#scim-GET-CostCenters-cost_center_id__entry-200-status-code}{#scim-GET-CostCenters-cost_center_id__status_400-SCIM-entry}{#scim-GET-CostCenters-cost_center_id__entry-401-status-code}{#scim-GET-CostCenters-cost_center_id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben. * Stellen Sie sicher, dass countParameter ist nicht größer als 500. * Stellen Sie sicher, dass alle filterParameter sind gültig. {#scim-GET-CostCenters-cost_center_id__ul_vn1_gvz_nrb} |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 138. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-GET-CostCenters-cost_center_id__id_tld_hxq_3rb__entry__2}{#scim-GET-CostCenters-cost_center_id__id-costcenter-SCIM-entry}{#scim-GET-CostCenters-cost_center_id__meta-costcenter-SCIM-entry}{#scim-GET-CostCenters-cost_center_id__meta_created-costcenter-SCIM-entry}{#scim-GET-CostCenters-cost_center_id__meta_lastModified-costcenter-SCIM-entry}{#scim-GET-CostCenters-cost_center_id__meta_location-costcenter-SCIM-entry}{#scim-GET-CostCenters-cost_center_id__meta_resourceType-costcenter-SCIM-entry}{#scim-GET-CostCenters-cost_center_id__name-costcenter-SCIM-entry}{#scim-GET-CostCenters-cost_center_id__schemas-costcenter-SCIM-entry}

| Name | Beschreibung |
|-|-|
| ID | SYS_ID des Kostenstellendatensatzes. Datentyp: Zeichenfolge |
| Meta | Informationen zum Kostenstellendatensatz. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": "String", "resourcType": "String" } |
| Meta.erstellt | Datum und Uhrzeit der Erstellung des zugehörigen Kostenstellendatensatzes. Datentyp: Zeichenfolge |
| Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des zugehörigen Kostenstellendatensatzes. Datentyp: Zeichenfolge |
| Meta.Standort | URI des zugehörigen Kostenstellendatensatzes. Datentyp: Zeichenfolge |
| Meta.resourceType | SCIM-Ressourcentyp: Immer Kostenstelle. Datentyp: Zeichenfolge |
| name | Name der Kostenstelle. Datentyp: Zeichenfolge |
| Schemas | Schema, das bei der Verarbeitung der Anforderung verwendet wird. Datentyp: Zeichenfolge |
[ ]

{#scim-GET-CostCenters-cost_center_id__id_tld_hxq_3rb}  

### Curl-Anforderung

Dieses Beispiel zeigt, wie ein bestimmter Kostenstellendatensatz abgerufen wird.

    curl "https://instance-servicenow.com/api/now/scim/CostCenters/7fb1cc99c0a80a6d30c04574d14c0acf" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {
      "schemas":[
        "urn:ietf:params:scim:schemas:custom:servicenow:2.0:CostCenter"
      ],
      "id":"7fb1cc99c0a80a6d30c04574d14c0acf",
      "meta":{
        "resourceType":"CostCenter",
        "created":"2012-01-19T21:02:39Z",
        "lastModified":"2012-02-25T23:06:36Z",
        "location":"https://instance-servicenow.com/api/now/scim/CostCenters/7fb1cc99c0a80a6d30c04574d14c0acf"
      },
      "name":"Sales"
    }

## SCIM -- GET /scim/Departments {#ariaid-title23}

Gibt einen oder mehrere Abteilungsdatensätze aus der Tabelle „Abteilung \[cmn_Department\]" in einem zurück ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.
Hinweis:  
Eine Abfrage, die keine Übereinstimmungen zurückgibt, gibt Erfolg (HTTP-Statuscode 200) mit zurück totalResultsAuf 0 festlegen.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Departments

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

{#scim-GET-Departments__entry__2}{#scim-GET-Departments__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 |
[Tabelle : 139. Pfad-Parameter]

{#scim-GET-Departments__entry__6}{#scim-GET-Departments__attributes-SCIM-entry}{#scim-GET-Departments__count-SCIM-entry}{#scim-GET-Departments__excludedAttributes-SCIM-entry}{#scim-GET-Departments__group_sortBy-SCIM-entry}{#scim-GET-Departments__sortOrder-SCIM-entry}{#scim-GET-Departments__group_startIndex-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| count | Anzahl der zurückzugebenden Datensätze. Ein negativer Wert wird als Null interpretiert. Datentyp: Zahl Maximum: 500 -- Ein Wert größer als dieser führt zu einem Fehler bei ungültigen Anforderungen. Standard: 10 |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
| Filter | Filterausdruck, der auf die Rückgabeergebnisse angewendet werden soll. Feldfilter werden als ausgedrückt `<field_name> <operator> <„value"> `. Siehe [RFC7644](https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2)Für eine Liste der gültigen Operatoren. Hinweis: Die `NICHT `Operator wird von dieser Methode nicht unterstützt. Um beispielsweise nach allen Abteilungen zu filtern, deren Name mit „Ingenieur" beginnt, geben Sie ein `DisplayName SW „Ingenieur" `. Um mehr als einen Feldfilter anzugeben, verketten Sie die Filter mit `UND `Operand. Um beispielsweise nach allen Abteilungen zu filtern, deren Name mit „Ingenieur" beginnt und zuletzt vor dem 3. Oktober 2021 geändert wurden, geben Sie ein `DisplayName SW „Ingenieur" UND Meta.lastModified LT „2021-10-03T00:00:00Z" `. Verwenden Sie Dot-Walking, um geschachtelte Attribute anzugeben. Datentyp: Zeichenfolge Standard: Keine Filterung |
| sortBy | Muss mit angegeben werden sortOrderParameter. Feld, nach dem die Rückgabeergebnisse sortiert werden sollen. Bei der Sortierung wird zwischen Groß- und Kleinschreibung unterschieden. Sie können nur die Parameter verwenden, die zum Filtern für verfügbar sind sortByParameter, außer dem externalIdIst nicht zulässig. Für Werte, die null sind: * Aufsteigend sortiert: Null-Werte werden nach oben sortiert. * Sortiert nach absteigend: Null-Werte werden nach unten sortiert. {#scim-GET-Departments__ul_xsb_zmm_hrb} Datentyp: Zeichenfolge Standard: Keine Sortierung |
| sortOrder | Muss mit angegeben werden sortByParameter. Reihenfolge, in der sortByParameter wird auf die Rückgabeergebnisse angewendet. Gültige Werte: * Aufsteigend * Absteigend {#scim-GET-Departments__ul_mmn_zrc_grb} Datentyp: Zeichenfolge Standard: Aufsteigend |
| startIndex | Einbasierter Index in der Tabelle, bei der mit dem Abrufen von Datensätzen begonnen werden soll. Beispiel: Wenn Sie diesen Parameter auf 100 und festlegen countParameter für 20. Der Endpunkt gibt Datensätze 100 bis 119 zurück. Hinweis: Jeder Wert, der auf weniger als einen festgelegt ist, wird als einer interpretiert. Datentyp: Zeichenfolge Standard: 1 |
[Tabelle : 140. Abfrageparameter]

{#scim-GET-Departments__entry__22}

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

### Header

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

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

{#scim-GET-Departments__entry__30}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 143. 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.").
{#scim-GET-Departments__entry__34}{#scim-GET-Departments__entry-200-status-code}{#scim-GET-Departments__status_400-SCIM-entry}{#scim-GET-Departments__entry-401-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. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben. * Stellen Sie sicher, dass countParameter ist nicht größer als 500. * Stellen Sie sicher, dass alle filterParameter sind gültig. {#scim-GET-Departments__ul_vn1_gvz_nrb} |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
[Tabelle : 144. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-GET-Departments__id_sqc_3br_3rb__entry__2}{#scim-GET-Departments__itemsPerPage-SCIM-entry}{#scim-GET-Departments__totalResults-SCIM-entry}

| Name | Beschreibung |
|-|-|
| ItemsPerPage | Anzahl der in den Rückgabeergebnissen zurückgegebenen Datensätze. Datentyp: Zahl |
| Ressourcen | Liste der zurückgegebenen Abteilungsdatensätze. Datentyp: Objekt "Resources": { "id": "String", "meta": {Object}, "name": "String", "schemas": "String" } |
| Resources.ID | SYS_ID des Abteilungsdatensatzes. Datentyp: Zeichenfolge |
| Ressourcen.Meta | Informationen zum Abteilungsdatensatz. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": "String", "resourcType": "String" } |
| Resources.Meta.erstellt | Datum und Uhrzeit der Erstellung des zugehörigen Abteilungsdatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des zugehörigen Abteilungsdatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.location | URI des zugehörigen Abteilungsdatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.resourceType | SCIM-Ressourcentyp: Immer Abteilung. Datentyp: Zeichenfolge |
| Resources.name | Abteilungsname. Datentyp: Zeichenfolge |
| Resources.Schemas |   |
| Schemas |   |
| startIndex | Einbasierter Index in der Abteilungstabelle \[cmn_Department\], in der die Datensätze zurückgegeben wurden. Datentyp: Zeichenfolge |
| Gesamtergebnisse | Gesamtanzahl der Datensätze, die der Anforderung entsprechen. Datentyp: Zahl |
[ ]

{#scim-GET-Departments__id_sqc_3br_3rb}  

### Curl-Anforderung

Dieses Beispiel zeigt, wie die ersten beiden Abteilungsdatensätze abgerufen werden.

    curl "https://instance-servicenow.com/api/now/scim/Departments?count=2" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {
      "schemas":[
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
      ],
      "totalResults":7,
      "Resources":[
        {
          "schemas":[
            "urn:ietf:params:scim:schemas:custom:servicenow:2.0:Department"
          ],
          "id":"221db0edc611228401760aec06c9d929",
          "meta":{
            "resourceType":"Department",
            "created":"2006-01-31T20:18:24Z",
            "lastModified":"2012-02-18T07:01:40Z",
            "location":"https://instance-servicenow.com/api/now/scim/Departments/221db0edc611228401760aec06c9d929"
          },
          "name":"Sales"
        },
        {
          "schemas":[
            "urn:ietf:params:scim:schemas:custom:servicenow:2.0:Department"
          ],
          "id":"221f3db5c6112284009f4becd3039cc9",
          "meta":{
            "resourceType":"Department",
            "created":"2008-03-20T20:20:06Z",
            "lastModified":"2012-02-18T07:01:22Z",
            "location":"https://instance-servicenow.com/api/now/scim/Departments/221f3db5c6112284009f4becd3039cc9"
          },
          "name":"Development"
        }
      ],
      "startIndex":1,
      "itemsPerPage":2
    }

## SCIM -- GET /scim/Deparment/{Déparment_ID} {#ariaid-title24}

Gibt den angegebenen Abteilungsdatensatz aus der Tabelle „Abteilung \[cmn_Department\]" in einem zurück ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/Departments/{Department_ID}

Standard-URL: /api/now/scim/Departments/{Department_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

{#scim-GET-Departments-department_id__entry__2}{#scim-GET-Departments-department_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 |
| Abteilungs-ID | SYS_ID des zurückzugebenden Abteilungsdatensatzes. Datentyp: Zeichenfolge |
[Tabelle : 145. Pfad-Parameter]

{#scim-GET-Departments-department_id__entry__8}{#scim-GET-Departments-department_id__attributes-SCIM-entry}{#scim-GET-Departments-department_id__excludedAttributes-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
[Tabelle : 146. Abfrageparameter]

{#scim-GET-Departments-department_id__entry__14}

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

### Header

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

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

{#scim-GET-Departments-department_id__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 149. 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.").
{#scim-GET-Departments-department_id__entry__26}{#scim-GET-Departments-department_id__entry-200-status-code}{#scim-GET-Departments-department_id__status_400-SCIM-entry}{#scim-GET-Departments-department_id__entry-401-status-code}{#scim-GET-Departments-department_id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben. * Stellen Sie sicher, dass countParameter ist nicht größer als 500. * Stellen Sie sicher, dass alle filterParameter sind gültig. {#scim-GET-Departments-department_id__ul_vn1_gvz_nrb} |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 150. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-GET-Departments-department_id__id_g3b_jdr_3rb__entry__2}{#scim-GET-Departments-department_id__id-dept-SCIM-entry}{#scim-GET-Departments-department_id__meta-dept-SCIM-entry}{#scim-GET-Departments-department_id__meta_created-dept-SCIM-entry}{#scim-GET-Departments-department_id__meta_lastModified-dept-SCIM-entry}{#scim-GET-Departments-department_id__meta_location-dept-SCIM-entry}{#scim-GET-Departments-department_id__meta_resourceType-dept-SCIM-entry}{#scim-GET-Departments-department_id__name-dept-SCIM-entry}{#scim-GET-Departments-department_id__schemas-dept-SCIM-entry}

| Name | Beschreibung |
|-|-|
| ID | SYS_ID des Abteilungsdatensatzes. Datentyp: Zeichenfolge |
| Meta | Informationen zum Abteilungsdatensatz. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": "String", "resourcType": "String" } |
| Meta.erstellt | Datum und Uhrzeit der Erstellung des zugehörigen Abteilungsdatensatzes. Datentyp: Zeichenfolge |
| Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des zugehörigen Abteilungsdatensatzes. Datentyp: Zeichenfolge |
| Meta.Standort | URI des zugehörigen Abteilungsdatensatzes. Datentyp: Zeichenfolge |
| Meta.resourceType | SCIM-Ressourcentyp: Immer Abteilung. Datentyp: Zeichenfolge |
| name | Abteilungsname. Datentyp: Zeichenfolge |
| Schemas | Schema, das bei der Verarbeitung der Anforderung verwendet wird. Datentyp: Zeichenfolge |
[ ]

{#scim-GET-Departments-department_id__id_g3b_jdr_3rb}  

### Curl-Anforderung

Dieses Beispiel zeigt, wie ein bestimmter Abteilungsdatensatz abgerufen wird.

    curl "https://instance-servicenow.com/api/now/scim/Departments/221db0edc611228401760aec06c9d929" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {
      "schemas":[
        "urn:ietf:params:scim:schemas:custom:servicenow:2.0:Department"
      ],
      "id":"221db0edc611228401760aec06c9d929",
      "meta":{
        "resourceType":"Department",
        "created":"2006-01-31T20:18:24Z",
        "lastModified":"2012-02-18T07:01:40Z",
        "location":"https://instance-servicenow.com/api/now/scim/Departments/221db0edc611228401760aec06c9d929"
      },
      "name":"Sales"
    }

## SCIM -- GET /scim/locations {#ariaid-title25}

Gibt einen oder mehrere Standortdatensätze aus der Tabelle „Standort" \[cmn_location\] in einem zurück ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.
Hinweis:  
Eine Abfrage, die keine Übereinstimmungen zurückgibt, gibt Erfolg (HTTP-Statuscode 200) mit zurück totalResultsAuf 0 festlegen.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/locations

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

{#scim-GET-Locations__entry__2}{#scim-GET-Locations__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 |
[Tabelle : 151. Pfad-Parameter]

{#scim-GET-Locations__entry__6}{#scim-GET-Locations__attributes-SCIM-entry}{#scim-GET-Locations__count-SCIM-entry}{#scim-GET-Locations__excludedAttributes-SCIM-entry}{#scim-GET-Locations__group_sortBy-SCIM-entry}{#scim-GET-Locations__sortOrder-SCIM-entry}{#scim-GET-Locations__group_startIndex-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| count | Anzahl der zurückzugebenden Datensätze. Ein negativer Wert wird als Null interpretiert. Datentyp: Zahl Maximum: 500 -- Ein Wert größer als dieser führt zu einem Fehler bei ungültigen Anforderungen. Standard: 10 |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
| Filter | Filterausdruck, der auf die Rückgabeergebnisse angewendet werden soll. Feldfilter werden als ausgedrückt `<field_name> <operator> <„value"> `. Siehe [RFC7644](https://datatracker.ietf.org/doc/html/rfc7644#section-3.4.2)Für eine Liste der gültigen Operatoren. Hinweis: Die `NICHT `Operator wird von dieser Methode nicht unterstützt. Um beispielsweise nach allen Standorten zu filtern, deren Name mit „CH" beginnt, geben Sie ein `DisplayName SW „CH" `. Um mehr als einen Feldfilter anzugeben, verketten Sie die Filter mit `UND `Operand. Um beispielsweise nach allen Standorten zu filtern, deren Name mit „CH" beginnt und zuletzt vor dem 3. Oktober 2021 geändert wurden, geben Sie ein `DisplayName SW „CH" UND Meta.lastModified LT „2021-10-03T00:00:00Z" `. Verwenden Sie Dot-Walking, um geschachtelte Attribute anzugeben. Datentyp: Zeichenfolge Standard: Keine Filterung |
| sortBy | Muss mit angegeben werden sortOrderParameter. Feld, nach dem die Rückgabeergebnisse sortiert werden sollen. Bei der Sortierung wird zwischen Groß- und Kleinschreibung unterschieden. Sie können nur die Parameter verwenden, die zum Filtern für verfügbar sind sortByParameter, außer dem externalIdIst nicht zulässig. Für Werte, die null sind: * Aufsteigend sortiert: Null-Werte werden nach oben sortiert. * Sortiert nach absteigend: Null-Werte werden nach unten sortiert. {#scim-GET-Locations__ul_xsb_zmm_hrb} Datentyp: Zeichenfolge Standard: Keine Sortierung |
| sortOrder | Muss mit angegeben werden sortByParameter. Reihenfolge, in der sortByParameter wird auf die Rückgabeergebnisse angewendet. Gültige Werte: * Aufsteigend * Absteigend {#scim-GET-Locations__ul_mmn_zrc_grb} Datentyp: Zeichenfolge Standard: Aufsteigend |
| startIndex | Einbasierter Index in der Tabelle, bei der mit dem Abrufen von Datensätzen begonnen werden soll. Beispiel: Wenn Sie diesen Parameter auf 100 und festlegen countParameter für 20. Der Endpunkt gibt Datensätze 100 bis 119 zurück. Hinweis: Jeder Wert, der auf weniger als einen festgelegt ist, wird als einer interpretiert. Datentyp: Zeichenfolge Standard: 1 |
[Tabelle : 152. Abfrageparameter]

{#scim-GET-Locations__entry__22}

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

### Header

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

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

{#scim-GET-Locations__entry__30}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 155. 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.").
{#scim-GET-Locations__entry__34}{#scim-GET-Locations__entry-200-status-code}{#scim-GET-Locations__status_400-SCIM-entry}{#scim-GET-Locations__entry-401-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. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben. * Stellen Sie sicher, dass countParameter ist nicht größer als 500. * Stellen Sie sicher, dass alle filterParameter sind gültig. {#scim-GET-Locations__ul_vn1_gvz_nrb} |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
[Tabelle : 156. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-GET-Locations__id_qt1_xfr_3rb__entry__2}{#scim-GET-Locations__itemsPerPage-SCIM-entry}{#scim-GET-Locations__totalResults-SCIM-entry}

| Name | Beschreibung |
|-|-|
| ItemsPerPage | Anzahl der in den Rückgabeergebnissen zurückgegebenen Datensätze. Datentyp: Zahl |
| Ressourcen | Liste der zurückgegebenen Standortdatensätze. Datentyp: Objekt "Resources": { "id": "String", "meta": {Object}, "name": "String", "schemas": "String" } |
| Resources.ID | SYS_ID des Standortdatensatzes. Datentyp: Zeichenfolge |
| Ressourcen.Meta | Informationen zum Standortdatensatz. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": "String", "resourceType": "String" } |
| Resources.Meta.erstellt | Datum und Uhrzeit der Erstellung des zugehörigen Standortdatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des zugeordneten Standortdatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.location | URI des zugeordneten Standortdatensatzes. Datentyp: Zeichenfolge |
| Resources.Meta.resourceType | SCIM-Ressourcentyp: Immer Standort. Datentyp: Zeichenfolge |
| Resources.name | Standortname. Datentyp: Zeichenfolge |
| Resources.Schemas | Schema, das bei der Verarbeitung der Anforderung verwendet wird. Datentyp: Zeichenfolge |
| Schemas | Schema, das zum Verarbeiten der Listenantwort auf die Anforderung verwendet wird. Beispiel: `„URN:ietf:Parameters:scim:api:Messages:2,0:ListResponse" ` Datentyp: Zeichenfolge |
| startIndex | Einbasierter Index in der Tabelle „Standort" \[cmn_location\], an dem die Datensätze zurückgegeben wurden. Datentyp: Zeichenfolge |
| Gesamtergebnisse | Gesamtanzahl der Datensätze, die der Anforderung entsprechen. Datentyp: Zahl |
[ ]

{#scim-GET-Locations__id_qt1_xfr_3rb}  

### Curl-Anforderung

Dieses Beispiel zeigt, wie die ersten beiden Unternehmensdatensätze abgerufen werden.

    curl "https://instance-servicenow.com/api/now/scim/Locations?count=2" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort

    {
      "schemas":[
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
      ],
      "totalResults":426,
      "Resources":[
        {
          "schemas":["urn:ietf:params:scim:schemas:custom:servicenow:2.0:Location"],
          "id":"0002c0a93790200044e0bfc8bcbe5df5",
          "meta":{
            "resourceType":"Location",
            "created":"2012-02-19T18:39:00Z",
            "lastModified":"2012-02-19T18:39:00Z",
            "location":"https://instance-servicenow.com/api/now/scim/Locations/0002c0a93790200044e0bfc8bcbe5df5"
          },
          "name":"2-10-1 Yurakucho, Chiyoda-ku, Tokyo"
        },
        {
          "schemas":["urn:ietf:params:scim:schemas:custom:servicenow:2.0:Location"],
          "id":"0594ed7437d0200044e0bfc8bcbe5df0",
          "meta":{
            "resourceType":"Location",
            "created":"2012-02-17T17:54:15Z",
            "lastModified":"2021-08-31T14:13:11Z",
            "location":"https://instance-servicenow.com/api/now/scim/Locations/0594ed7437d0200044e0bfc8bcbe5df0"
          },
          "name":"Colombia"
        }
      ],
      "startIndex":1,
      "itemsPerPage":2
    }

## SCIM -- GET /scim/locations/{location_ID} AB {#ariaid-title26}

Gibt den angegebenen Standortdatensatz aus der Tabelle „Standort" \[cmn_location\] in einem zurück ServiceNowInstanz, die das SCIM-Protokoll (System for Domain Identity Management) verwendet.

### URL-Format

Versionierte URL: /api/now/{api_Version}/scim/locations/{location_ID}

Standard-URL: /api/now/scim/locations/{location_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

{#scim-GET-Locations-location_id__entry__2}{#scim-GET-Locations-location_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 |
| Standort_ID | SYS_ID des zurückzugebenden Standortdatensatzes. Datentyp: Zeichenfolge |
[Tabelle : 157. Pfad-Parameter]

{#scim-GET-Locations-location_id__entry__8}{#scim-GET-Locations-location_id__attributes-SCIM-entry}{#scim-GET-Locations-location_id__excludedAttributes-SCIM-entry}

| Name | Beschreibung |
|-|-|
| attributes | Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Es werden keine anderen Felder zurückgegeben. Kann nicht mit verwendet werden excludedAttributesParameter. Datentyp: Zeichenfolge Standard: Alle Felder zurückgeben, es sei denn excludedAttributesIst angegeben. |
| Exklusive Attribute | Kommagetrennte Liste von Feldern, die aus den in der Antwort zurückgegebenen Datensätzen ausgeschlossen werden sollen. Alle anderen Felder werden zurückgegeben. Kann nicht mit verwendet werden attributesParameter. Datentyp: Zeichenfolge Standard: Schließen Sie keine Felder aus. |
[Tabelle : 158. Abfrageparameter]

{#scim-GET-Locations-location_id__entry__14}

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

### Header

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

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

{#scim-GET-Locations-location_id__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 161. 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.").
{#scim-GET-Locations-location_id__entry__26}{#scim-GET-Locations-location_id__entry-200-status-code}{#scim-GET-Locations-location_id__status_400-SCIM-entry}{#scim-GET-Locations-location_id__entry-401-status-code}{#scim-GET-Locations-location_id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. * Stellen Sie sicher, dass beide attributesUnd excludedAttributesAbfrageparameter wurden in der Anforderung nicht übergeben. * Stellen Sie sicher, dass countParameter ist nicht größer als 500. * Stellen Sie sicher, dass alle filterParameter sind gültig. {#scim-GET-Locations-location_id__ul_vn1_gvz_nrb} |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 162. Statuscodes]

### Antworttext-Parameter (JSON)

{#scim-GET-Locations-location_id__id_s2d_33r_3rb__entry__2}{#scim-GET-Locations-location_id__id-location-SCIM-entry}{#scim-GET-Locations-location_id__meta-location-SCIM-entry}{#scim-GET-Locations-location_id__meta_created-location-SCIM-entry}{#scim-GET-Locations-location_id__meta_lastModified-location-SCIM-entry}{#scim-GET-Locations-location_id__meta_location-location-SCIM-entry}{#scim-GET-Locations-location_id__meta_resourceType-location-SCIM-entry}{#scim-GET-Locations-location_id__name-location-SCIM-entry}{#scim-GET-Locations-location_id__schemas-location-SCIM-entry}

| Name | Beschreibung |
|-|-|
| ID | SYS_ID des Standortdatensatzes. Datentyp: Zeichenfolge |
| Meta | Informationen zum Standortdatensatz. Datentyp: Objekt "meta": { "created": "String", "lastModified": "String", "location": "String", "resourceType": "String" } |
| Meta.erstellt | Datum und Uhrzeit der Erstellung des zugehörigen Standortdatensatzes. Datentyp: Zeichenfolge |
| Meta.lastModifiziert | Datum und Uhrzeit der letzten Änderung des zugeordneten Standortdatensatzes. Datentyp: Zeichenfolge |
| Meta.Standort | URI des zugeordneten Standortdatensatzes. Datentyp: Zeichenfolge |
| Meta.resourceType | SCIM-Ressourcentyp: Immer Standort. Datentyp: Zeichenfolge |
| name | Standortname. Datentyp: Zeichenfolge |
| Schemas | Schema, das bei der Verarbeitung der Anforderung verwendet wird. Datentyp: Zeichenfolge |
[ ]

{#scim-GET-Locations-location_id__id_s2d_33r_3rb}  

### Curl-Anforderung

Dieses Beispiel zeigt, wie ein bestimmter Standortdatensatz abgerufen wird.

    curl "https://instance-servicenow.com/api/now/scim/Locations/0c43af40c6112275011a4bd4c0143fbf" \
    --request GET \
    --header "Accept:application/scim+json" \

Antwort:

    {
      "schemas":["urn:ietf:params:scim:schemas:custom:servicenow:2.0:Location"],
      "id":"0594ed7437d0200044e0bfc8bcbe5df0",
      "meta":{
        "resourceType":"Location",
        "created":"2012-02-17T17:54:15Z",
        "lastModified":"2021-08-31T14:13:11Z",
        "location":"https://instance-servicenow.com/api/now/scim/Locations/0594ed7437d0200044e0bfc8bcbe5df0"
      },
      "name":"Colombia"
    }


