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


---

# CdmFreigabelibraryApi

# CdmFreigabelibraryApi {#ariaid-title1}

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

Die CdmFreigabelibraryApi Stellt Endpunkte bereit, mit denen Sie gemeinsam genutzte Bibliotheken und gemeinsam genutzte Komponenten erstellen und verwalten können. Es verfügt auch über Endpunkte, mit denen Sie die Konfigurationsdaten einer gemeinsam genutzten Komponente hochladen und exportieren können.
Diese API erfordert Konfigurationsdaten-Management(CDM) Plugin, das aktiviert werden soll, damit diese APIs in der Instanz verfügbar sind. Darüber hinaus müssen Sie über eine der folgenden Rollen verfügen, um auf diese API zuzugreifen:

* CDM-Editorrolle
* CDM-Administratorrolle

Weitere Informationen zu gemeinsam genutzten Bibliotheken und gemeinsam genutzten Komponenten finden Sie unter [Freigeben von Komponenten zwischen Anwendungen -- Komponentenbibliotheken](https://www.servicenow.com/docs/access?context=cdm-component-libraries&version=yokohama&pubname=yokohama-it-service-management&ft:locale=en-US).

## CdmSharedLibraryApi: LÖSCHEN SIE /sn_cdm/Shared_LibraryApi {#ariaid-title2}

Löscht die gemeinsame Bibliothek mit dem angegebenen Namen.
Für den Zugriff auf diesen Endpunkt ist die CDM-Administratorrolle erforderlich.

### URL-Format {#sl-DELETE-shared_libs__section_evn_zmx_dwb}

Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries

Standard-URL: /api/sn_cdm/Shared_Libraries  
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

{#sl-DELETE-shared_libs__entry__2}{#sl-DELETE-shared_libs__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 : 1. Pfad-Parameter]

{#sl-DELETE-shared_libs__entry__6}

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

{#sl-DELETE-shared_libs__entry__10}

| Name | Beschreibung |
|-|-|
| name | Erforderlich. Name der zu löschenden gemeinsamen Bibliothek. Datentyp: Zeichenfolge Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

### Header

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

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

{#sl-DELETE-shared_libs__entry__18}

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

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sl-DELETE-shared_libs__entry__22}{#sl-DELETE-shared_libs__entry-200-status-code}{#sl-DELETE-shared_libs__entry-400-status-code}{#sl-DELETE-shared_libs__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. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#sl-DELETE-shared_libs__entry__30}

| Name | Beschreibung |
|-|-|
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehler.Nachricht | Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge |
| Status | Fehlerstatus der Anforderung. Mögliche Werte: Fehler Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie die gemeinsame Bibliothek „Javalib" gelöscht wird.

    curl "http://instance.servicenow.com/sn_cdm/shared_libraries?name='javalib'\ 
    --request DELETE\ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

Antwort:

    ""

## CdmSharedLibraryApi: LÖSCHEN SIE /sn_cdm/Shared_LibraryApi/components {#ariaid-title3}

Löscht die angegebene gemeinsam genutzte Komponente aus der angegebenen Bibliothek.
Für den Zugriff auf diesen Endpunkt ist die CDM-Editorrolle erforderlich.  
Hinweis:  
Sie können eine Komponente nur löschen, wenn sie derzeit nicht verwendet wird. Außerdem können Sie eine Komponente nicht löschen, wenn die zugehörige gemeinsame Bibliothek nicht aktiv ist.

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries/components

Standard-URL: /api/sn_cdm/Shared_Libraries/components  
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

{#sl-DELETE-shared_libs-comps__entry__2}{#sl-DELETE-shared_libs-comps__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 : 7. Pfad-Parameter]

{#sl-DELETE-shared_libs-comps__entry__6}

| Name | Beschreibung |
|-|-|
| changesetNumber | Erforderlich. Nummer des Changesets, das der Komponente zugeordnet ist. Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| name | Erforderlich. Name der freigegebenen Komponente, die gelöscht werden soll. Datentyp: Zeichenfolge Tabelle: Gemeinsam genutzte CDM-Komponente \[sn_cdm_shared_component\] |
| sharedLibraryName | Erforderlich. Name der gemeinsamen Bibliothek, in der sich die zu löschende Komponente befindet. Datentyp: Zeichenfolge Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
[Tabelle : 8. Abfrageparameter]

{#sl-DELETE-shared_libs-comps__entry__14}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. Anforderungstext-Parameter]

### 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.").
{#sl-DELETE-shared_libs-comps__entry__18}{#sl-DELETE-shared_libs-comps__cdm_apps-sl_req_headers-accept-entry}

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

{#sl-DELETE-shared_libs-comps__entry__22}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Mögliche Probleme: * Gemeinsame Bibliothek ist nicht vorhanden. * Gemeinsame Bibliothek ist nicht aktiv. * Gemeinsam genutzte Komponente wird verwendet. Kann nicht gelöscht werden. * Anwender darf die gemeinsam genutzte Komponente nicht löschen. {#sl-DELETE-shared_libs-comps__ul_x5v_4vp_dwb} |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 12. Statuscodes]

### Antworttext-Parameter

{#sl-DELETE-shared_libs-comps__entry__34}

| Name | Beschreibung |
|-|-|
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehler.Nachricht | Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge |
| Status | Fehlerstatus der Anforderung. Mögliche Werte: Fehler Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie die Komponente „Testkomponente" in der gemeinsamen Bibliothek „Javalib" gelöscht wird.

    curl "http://instance.servicenow.com/sn_cdm/shared_libraries/components?sharedLibraryName='javalib&changesetNumber='chset-8'&name='TestComponent'\ 
    --request DELETE\ 
    --header "Accept:application/json" \ 
    --user 'username':'password' 

Antwort:

    ""

## CdmSharedLibraryApi -- GET /sn_cdm/Shared_Libraries/Upload-Status/{Upload-ID} {#ariaid-title4}

Gibt den aktuellen Status der angegebenen Anforderung zum Hochladen der gemeinsamen Bibliothek zurück.
<br />

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries/Upload-Status/{Upload-ID}

Standard-URL: /api/sn_cdm/Shared_Libraries/Upload-Status/{Upload-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

{#sl-GET-shared_libs-upload-status__entry__2}{#sl-GET-shared_libs-upload-status__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 |
| Upload-ID | SYS_ID der Upload-Anforderung, deren Status zurückgegeben werden soll. Dieser Wert wird von verschiedenen Endpunkten der CdmSharedLibrary-Upload-Anforderung zurückgegeben. Datentyp: Zeichenfolge |
[Tabelle : 13. Pfad-Parameter]

{#sl-GET-shared_libs-upload-status__entry__8}

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

{#sl-GET-shared_libs-upload-status__entry__12}

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

### 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.").
{#sl-GET-shared_libs-upload-status__entry__16}{#sl-GET-shared_libs-upload-status__cdm_apps-sl_req_headers-accept-entry}

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

{#sl-GET-shared_libs-upload-status__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.").
{#sl-GET-shared_libs-upload-status__entry__24}{#sl-GET-shared_libs-upload-status__entry-200-status-code}{#sl-GET-shared_libs-upload-status__entry-400-status-code}{#sl-GET-shared_libs-upload-status__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. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#sl-GET-shared_libs-upload-status__entry__32}

| Name | Beschreibung |
|-|-|
| Fehler | Beschreibung der Fehler, die beim Hochladen aufgetreten sind. Datentyp: Zeichenfolge |
| Ausgabe | Beschreibung der hochgeladenen Daten oder, wenn während des Uploads ein Fehler aufgetreten ist, eine Fehlermeldung, die den aufgetretenen Fehler beschreibt. Datentyp: Array von Zeichenfolge "output": { "auto_validate": "String", "cdm_application": "String", "committed_at": "String", "committed_by": "String", "description": "String", "last_conflict_detection_time": "String", "number": "String", "publish_option": "String", "sharedLibraryName": "String", "snapshot_description": "String", "snapshot_name": "String", "state": "String", "sys_created_by": "String", "sys_id": "String", "title": "String" } |
| output.auto_validate | Gibt an, ob die Validierung nach dem Commit aufgerufen werden soll. Datentyp: Zeichenfolge |
| Output.cdm_Application | Name der Anwendung, unter der der Upload durchgeführt wurde. Datentyp: Zeichenfolge |
| output.committed_at | Datum und Uhrzeit der Commit des hochgeladenen Inhalts. Datentyp: Zeichenfolge |
| output.committed_by | SYS_ID des Datensatzes der Entität, die den Commit ausgeführt hat. Datentyp: Zeichenfolge |
| output.description | Derzeit nicht verwendet. Datentyp: Zeichenfolge |
| output.last_conflict_detection_time | Aufruf der Konflikterkennung für Datum und Uhrzeit. Datentyp: Zeichenfolge |
| Ausgabe.Nummer | Eindeutiger Changeset-Identifizierungswert, z. B. Chset-124. Datentyp: Zeichenfolge |
| Ausgabe.Publish_Option | Wert der Veröffentlichungsoption, die im zugehörigen Upload-Aufruf übergeben wurde. Weitere Informationen zum Veröffentlichen von Snapshots finden Sie unter [Veröffentlichen oder heben Sie die Veröffentlichung eines Snapshots auf](https://www.servicenow.com/docs/access?context=cdm-snapshot-publish&version=yokohama&pubname=yokohama-it-service-management&ft:locale=en-US). Datentyp: Zeichenfolge |
| Ausgabe.SharedLibraryName | Name der gemeinsamen Bibliothek, wie im ursprünglichen Upload-Aufruf übergeben. Datentyp: Zeichenfolge |
| Ausgabe.Snapshot_description | Beschreibung des zugeordneten Snapshots. Datentyp: Zeichenfolge |
| Ausgabe.Snapshot_Name | Name des zugeordneten Snapshots. Datentyp: Zeichenfolge |
| Ausgabe.Status | Status des Uploads. Mögliche Werte: * ABGESCHLOSSEN: Upload wurde abgeschlossen. * EXPIREDERROR: Fehler beim Verarbeiten der Upload-Anforderung. Der Auftrag wurde mehr als 15 Minuten lang ausgeführt und vom System beendet. * IN_PROGRESS: Upload wird ausgeführt. * NEU: Verarbeitung wurde noch nicht gestartet. * BEREIT: Anforderung wurde in die Warteschlange gestellt. Datentyp: Zeichenfolge |
| Ausgabe.sys_created_by | SYS_ID der Entität, die den Datensatz erstellt hat. Datentyp: Zeichenfolge |
| Ausgabe.sys_ID | SYS_ID des Datensatzes, der das Changeset enthält. Datentyp: Zeichenfolge |
| Ausgabe.Titel | Titel des Changesets, das als Teil des Uploads erstellt wurde. Datentyp: Zeichenfolge |
| Processing_State | Aktueller Verarbeitungsstatus der Upload-Anforderung. Mögliche Werte: VERARBEITET Datentyp: Zeichenfolge |
| Staat | Aktueller Status der Upload-Anforderung. Mögliche Werte: * Abgeschlossen * Fehler |
| Typ | Typ der Upload-Anforderung. Mögliche Werte: Upload_and_commit Datentyp: Zeichenfolge |
| Upload_ID | SYS_ID des Datensatzes, der die hochgeladene Konfigurationsnutzlast enthält. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Dieses Codebeispiel zeigt, wie der Status für die Upload-ID 0d91d9891b2b19109524cae0604bcbe6 angefordert wird.

    curl "http://instance.servicenow.com/api/sn_cdm/shared_libraries/upload-status/0d91d9891b2b19109524cae0604bcbe6" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

Antwort:

    // Successful response
    {
      "result": {
        "type": "upload_and_commit",
        "state": "completed",
        "output": {
          "sys_id": "0002ea107768a1109ac0cf0bbb5a9963",
          "number": "Chset-457",
          "title": "admin8802ea107768a1109ac0cf0bbb5a9962",
          "description": null,
          "committed_at": "",
          "committed_by": null,
          "sys_created_by": "admin",
          "state": "open",
          "publish_option": "publish_none",
          "auto_validate": false,
          "snapshot_name": null,
          "snapshot_description": null,
          "cdm_application": "OracleG-Library-15",
          "last_conflict_detection_time": null
        },
        "processing_state": "PROCESSED",
        "upload_id": "00b226547768a1109ac0cf0bbb5a99f2"
      }
    }

    // Error response
    {
      "result": {
        "type": "upload_and_commit",
        "state": "error",
        "output": "Error: Application with sys_id 87fb1ecb1be3111050fc21b0604bcb95 is in State Deleted. No data can be modified on deleted applications",
        "processing_state": "PROCESSED",
        "upload_id": "fcdfaf7f1b88211050fc21b0604bcb79"
      }
    }

## CdmSharedLibraryApi -- POST /sn_cdm/Shared_Libraries {#ariaid-title5}

Erstellt eine neue gemeinsame Bibliothek mit dem angegebenen Namen.
Für den Zugriff auf diesen Endpunkt ist die CDM-Administratorrolle erforderlich.

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries

Standard-URL: /api/sn_cdm/Shared_Libraries  
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

{#sl-POST-shared_libs__entry__2}{#sl-POST-shared_libs__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]

{#sl-POST-shared_libs__entry__6}{#sl-POST-shared_libs__appName-userGroupIds-entry}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung der gemeinsamen Bibliothek. Datentyp: Zeichenfolge Standard: Leer |
| name | Erforderlich. Name der zu erstellenden gemeinsamen Bibliothek. Dieser Name muss für alle CDM-Anwendungen und -Bibliotheken eindeutig sein. Datentyp: Zeichenfolge |
| returnFields | Kommagetrennte Liste von Feldern, die als Teil der Antwort zurückgegeben werden sollen. Datentyp: Zeichenfolge Standard: Alle nicht-Systemfelder werden zurückgegeben. Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
| UserGroupIds | Kommagetrennte Liste der sys_IDs der Anwendergruppen, die die zugehörige gemeinsame Bibliothek bearbeiten können. Alle Anwender mit den richtigen Rollen können die gemeinsame Bibliothek anzeigen. Datentyp: Zeichenfolge Standard: Alle Anwender mit der Rolle „CDM-Editor" können Daten in der gemeinsamen Bibliothek bearbeiten. Tabelle: Gruppe \[sys_user_group\] |
[Tabelle : 20. Abfrageparameter]

{#sl-POST-shared_libs__entry__16}

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

### Header

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

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

{#sl-POST-shared_libs__entry__24}

| 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.").
{#sl-POST-shared_libs__entry__28}{#sl-POST-shared_libs__entry-200-status-code}{#sl-POST-shared_libs__entry-400-status-code}{#sl-POST-shared_libs__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. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 24. Statuscodes]

### Antworttext-Parameter

{#sl-POST-shared_libs__entry__36}

| Name | Beschreibung |
|-|-|
| \<fields\> | Angeforderte Felder. Datentyp: Variable Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehler.Nachricht | Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge |
| Status | Fehlerstatus der Anforderung. Mögliche Werte: Fehler Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie dieser Endpunkt aufgerufen wird, um die gemeinsam genutzte Bibliothek „Java11Lib" zu erstellen, mit der alle Anwendergruppen auf die Bibliothek zugreifen können.

    curl "http://instance.servicenow.com/api/sn_cdm/shared_libraries?name=Java11Lib&description=The%20new%20java%20library" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --user 'userName':'password

Antwort:

    {
      "result": {
        "sdlc_component": null,
        "cdi_count": "0",
        "available": false,
        "description": "Description of LibraryA",
        "managed_by_group": null,
        "sys_updated_on": "2023-01-18 11:34:43",
        "type": "shared_library",
        "node": {
          "value": "d852b15877a4a1109ac0cf0bbb5a99aa",
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_node/d852b15877a4a1109ac0cf0bbb5a99aa"
        },
        "sys_id": "185235dc77a4a1109ac0cf0bbb5a994e",
        "sys_updated_by": "admin",
        "node_main": {
          "value": "1852b15877a4a1109ac0cf0bbb5a99aa",
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_node_main/1852b15877a4a1109ac0cf0bbb5a99aa"
        },
        "sys_created_on": "2023-01-18 11:34:43",
        "cdi_usage": "0",
        "name": "LibraryA",
        "last_committed_changeset": {
          "value": "9052b15877a4a1109ac0cf0bbb5a99aa",
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/9052b15877a4a1109ac0cf0bbb5a99aa"
        },
        "state": "active",
        "sys_created_by": "admin"
      }
    }

## CdmSharedLibraryApi -- POST /sn_cdm/Shared_LibraryApi/components {#ariaid-title6}

Erstellt die angegebene gemeinsam genutzte Komponente unter der angegebenen Bibliothek.
Für den Zugriff auf diesen Endpunkt ist die CDM-Editorrolle erforderlich.

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries/components

Standard-URL: /api/sn_cdm/Shared_Libraries/components  
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

{#sl-POST-shared_libs-comps__entry__2}{#sl-POST-shared_libs-comps__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 : 25. Pfad-Parameter]

{#sl-POST-shared_libs-comps__entry__6}{#sl-POST-shared_libs-comps__changesetNumber-changeset-entry}

| Name | Beschreibung |
|-|-|
| changesetNumber | Erforderlich. Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| Beschreibung | Beschreibung der gemeinsam genutzten Komponente. Datentyp: Zeichenfolge |
| name | Erforderlich. Name der gemeinsam genutzten Komponente, die in der gemeinsamen Bibliothek erstellt werden soll. Dieser Name muss eindeutig sein. Datentyp: Zeichenfolge |
| returnFields | Kommagetrennte Liste von Feldern in der Tabelle „CDM-Knoten" \[sn_cdm_node\], die als Teil der Antwort zurückgegeben werden sollen. Datentyp: Zeichenfolge Standard: Alle nicht internen Felder werden zurückgegeben. |
| sharedLibraryName | Erforderlich. Name der gemeinsamen Bibliothek, unter der die Komponente erstellt werden soll. Diese Bibliothek muss bereits vorhanden sein und sich im Status „aktiv" befinden. Datentyp: Zeichenfolge |
[Tabelle : 26. Abfrageparameter]

{#sl-POST-shared_libs-comps__entry__18}

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

### 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.").
{#sl-POST-shared_libs-comps__entry__22}{#sl-POST-shared_libs-comps__cdm_apps-sl_req_headers-accept-entry}

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

{#sl-POST-shared_libs-comps__entry__26}

| 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.").
{#sl-POST-shared_libs-comps__entry__30}{#sl-POST-shared_libs-comps__entry-200-status-code}{#sl-POST-shared_libs-comps__entry-400-status-code}{#sl-POST-shared_libs-comps__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. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 30. Statuscodes]

### Antworttext-Parameter

{#sl-POST-shared_libs-comps__entry__38}{#sl-POST-shared_libs-comps__cdm_apps-error-entry}{#sl-POST-shared_libs-comps__cdm_apps-error_detail-entry}{#sl-POST-shared_libs-comps__cdm_apps-error_message-entry}

| Name | Beschreibung |
|-|-|
| \<requested fields\> | Angeforderte Felder. Datentyp: Verschiedene Tabelle: CDM-Knoten \[sn_cdm_node\] |
| Fehler | Wird nur zurückgegeben, wenn während der Verarbeitung ein Fehler aufgetreten ist. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Details zum aufgetretenen Fehler. Datentyp: Zeichenfolge |
| Fehler.Nachricht | Nachricht, die einen Überblick über den Fehler bietet. Datentyp: Zeichenfolge |
| Status | Fehlerstatus der Anforderung. Mögliche Werte: Fehler Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel speichert die Komponente mit dem Namen „SharedComponent" unter der gemeinsamen Bibliothek „Javalib".

    curl "http://instance.servicenow.com/sn_cdm/shared_libraries/components/?sharedLibraryName=javalib&changeSetNumber='Chset-9'&name='SharedComponent'\  
    --request POST\  
    --header "Accept:application/json" \  
    --user 'username':'password'

Antwort:

    {
      "result": {
        "changeset_id": {
          "value": "ca7e6a501b202110636e0fe0604bcb71",
          "link": "https://instance.servicenow.com/api/now/table/sn_cdm_changeset/ca7e6a501b202110636e0fe0604bcb71"
        },
        "node_path": "!2!3!:",
        "description": null,
        "sys_updated_on": "2023-01-18 16:04:52",
        "type": "sn_cdm_node_shared_component",
        "sys_class_name": "sn_cdm_node",
        "sys_id": "6d2072901b602110636e0fe0604bcbec",
        "sys_updated_by": "admin",
        "previous_version": null,
        "sys_created_on": "2023-01-18 16:04:52",
        "value": null,
        "effective_from": null,
        "linked_to": null,
        "sys_created_by": "admin",
        "restricted_to": null,
        "linked_to_version": null,
        "level": "2",
        "conflict_type": null,
        "main_id": "19",
        "effective_to": null,
        "secure_value": null,
        "node_classifier": "/shared_library/shared_components",
        "main_id_encoded": ":",
        "name": "testSharedComponent",
        "position": null,
        "reason_for_conflict": null,
        "system_folder": false,
        "status": "new",
        "conflict": false
      }
    }

## CdmSharedLibraryApi -- POST /sn_cdm/Shared_Libraries/uploads/components {#ariaid-title7}

Ermöglicht Ihnen das Erstellen und Verwalten von gemeinsam genutzten Bibliotheken und gemeinsam genutzten Komponenten. Dieser Endpunkt erstellt einen Knoten der gemeinsam genutzten Komponente in der Tabelle „CDM-Knoten" \[sn_cdm_node\] und einen Datensatz einer gemeinsam genutzten Komponente in der Tabelle „gemeinsam genutzte CDM-Komponente" \[sn_cdm_shared_component\].
Für den Zugriff auf diesen Endpunkt ist die CDM-Editorrolle erforderlich.  
Hinweis:  
Standardmäßig beträgt die maximale Größe des Inhalts-Uploads 2 MB. Sie können diesen Standard ändern, indem Sie die Eigenschaft „sn_cdm.max_allowed_upload_file_size" aktualisieren.  
Hinweis:  
Diese Upload-Methode kann nicht zum Ändern von Knoten verwendet werden. Verwenden Sie die Alternative [CdmSharedLibraryApi -- POST /sn_cdm/Shared_Libraries/uploads/components/file](https://servicenow-prod.fluidtopics.net/y5FljRH5BP8DHqXCsdEZkA#csl-POST-shared_libs-upld-comp-file "Lädt Dateien als Teil des Konfigurationsdatenmodells (CDM) im Komponentenordner in einer gemeinsamen Bibliothek hoch.")Methode zum Ändern von Knoten.

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries/uploads/components

Standard-URL: /api/sn_cdm/Shared_Libraries/uploads/components  
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

{#sl-POST-shared_libs-uploads-comp__entry__2}{#sl-POST-shared_libs-uploads-comp__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 : 31. Pfad-Parameter]

{#sl-POST-shared_libs-uploads-comp__entry__6}

| Name | Beschreibung |
|-|-|
| Automatisches Commit | Kennzeichnung, die angibt, ob das Changeset in identifiziert wurde changesetNumberParameter wird nach dem Hochladen an das Datenmodell übergeben. Gültige Werte: * Wahr: Changeset wird nach dem Hochladen bestätigt. * Falsch: Changeset wird nach dem Hochladen nicht bestätigt. Datentyp: Boolescher Wert Standard: Falsch |
| autoDelete | Kennzeichnung, die angibt, ob die vorhandenen Knoten, die nicht Teil des Upload-Inhalts sind, nach Abschluss der Verarbeitung gelöscht werden. Gültige Werte: * Wahr: Vorhandene Knoten automatisch löschen. * Falsch: Vorhandene Knoten nicht automatisch löschen. Datentyp: Boolescher Wert Standard: Falsch |
| changesetNumber | Erforderlich. Zeichenfolge, die das der Anwendung zugeordnete Changeset eindeutig identifiziert, z. B. Chset-102. Dieses Changeset muss sich im Status „Offen" befinden. Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| Datenformat | Erforderlich. Format der Konfigurationsdaten. Gültige Werte: * CSV * ini * json * Eigenschaften * roh * XML * yaml Datentyp: Zeichenfolge |
| DeleteRedundantÜberschreibungen | Kennzeichnung, die angibt, ob eine Überschreibung erstellt werden soll, bei der redundante Werte vorhanden sind. Gültige Werte: * Wahr: Wenn redundante Werte vorhanden sind, wird keine Überschreibung erstellt. * Falsch: Wenn redundante Werte vorhanden sind, wird mit einer Überschreibung fortgefahren. Standard: Wahr |
| IdentifierKeys | Liste der Namen, die angeben, welcher Schlüssel in einem untergeordneten Array zur Identifizierung desselben Knotens verwendet werden soll. Beispiel: Wenn Sie hochladen: [ {"name" : "Allan, "city" : "Paris"}, {"name" : "Karen, "city" : "Sydney"} ] Im folgenden vorhandenen Modell: [ {"name" : "Karen, "city" : "Manila"}, {"name" : "Allan, "city" : "Brussels"} ] Und Sie haben festgelegt identifierKeysBis <kbd class="ph userinput">Name </kbd>, Erzeugt die folgende Ausgabe: [ {"name" : "Karen, "city" : "Sydney"}, {"name" : "Allan, "city" : "Paris"} ] Andernfalls wird die folgende Ausgabe erzeugt: [ {"name" : "Karen, "city" : "Manila"}, {"name" : "Allan, "city" : "Brussels"}, {"name" : "Allan, "city" : "Paris"}, {"name" : "Karen, "city" : "Sydney"} ] Datentyp: Array von Zeichenfolgen |
| IgnorierAttribute | Kennzeichnung, die angibt, ob das angegebene Datenformat Attribute unterstützt (derzeit nur XML). Gültige Werte: * Wahr: Wenn das angegebene Datenformat Attribute unterstützt, werden alle Attribute in den Eingabedaten während des Uploads übersprungen. * Falsch: Wenn das angegebene Datenformat Attribute unterstützt, werden alle Attribute in den Eingabedaten in den Upload aufgenommen. {#sl-POST-shared_libs-uploads-comp__ul_egn_4q4_1yb} Datentyp: Boolescher Wert Standard: Falsch |
| namePath | Pfad des Zielknotens, unter dem die Konfigurationsdaten hochgeladen werden sollen. Dieser Pfad bezieht sich relativ zu den Komponenten, der Sammlung oder dem bereitstellbaren Ordner (abhängig vom aufgerufenen Endpunkt). Sie können den Namenspfad in einem der folgenden Formate übergeben. Beispiel: Um den Namenspfad für den Knoten zu definieren `TestApp/bereitstellbare Elemente/Entwickler1/cdi1 `: * Backslash-Format: TestApp/bereitstellbare Elemente/Entwickler1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich ("/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersatzzeichen: TestApp bereitstellbareEntwickler1 cdi1 * Array: \['TestApp','bereitstellbare Elemente','Development1','cdi1'\] {#sl-POST-shared_libs-uploads-comp__cdm_apps-namePath-ul} Hinweis: Wenn die angegebene Komponente im angegebenen Pfad nicht vorhanden ist, erstellt das System die Komponente automatisch im angegebenen Pfad und lädt die Daten hoch. Datentyp: Zeichenfolge |
| PublishOption | Veröffentlichungsoption für die zugehörigen konfigurierten Snapshots. Gültige Werte: * publish_new_and_unpublish_old: veröffentlicht den neuen Snapshot, der nach dem Commit erstellt wurde, und hebt die Veröffentlichung des vorhandenen Snapshots auf. * Publish_none: Veröffentlichen Sie keine Snapshots. Weitere Informationen zum Veröffentlichen von Snapshots finden Sie unter [Veröffentlichen oder heben Sie die Veröffentlichung eines Snapshots auf](https://www.servicenow.com/docs/access?context=cdm-snapshot-publish&version=yokohama&pubname=yokohama-it-service-management&ft:locale=en-US). Datentyp: Zeichenfolge Standard: Publish_none |
| sharedLibraryName | Erforderlich. Name der gemeinsamen Bibliothek, die erstellt oder verwaltet werden soll. Datentyp: Zeichenfolge Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
[Tabelle : 32. Abfrageparameter]

{#sl-POST-shared_libs-uploads-comp__entry__28}{#sl-POST-shared_libs-uploads-comp__cdm_apps-var_up_data-entry}

| Name | Beschreibung |
|-|-|
| Variablen-Upload-Daten | Hochzuladende Konfigurationsdaten. Dies können beliebige Daten in dem von definierten Format sein dataFormatParameter der Abfrageparameter. |
[Tabelle : 33. Anforderungstext-Parameter]

### 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.").
{#sl-POST-shared_libs-uploads-comp__id_fyp_pmb_fwb__entry__2}{#sl-POST-shared_libs-uploads-comp__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: text/plainUnd application/x-www-form-urlencoded. Standard: text/plain |
[Tabelle : 34. Anforderungskopfzeilen.]

{#sl-POST-shared_libs-uploads-comp__id_fyp_pmb_fwb} {#sl-POST-shared_libs-uploads-comp__entry__38}

| 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.").
{#sl-POST-shared_libs-uploads-comp__entry__42}{#sl-POST-shared_libs-uploads-comp__entry-200-status-code}{#sl-POST-shared_libs-uploads-comp__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Die Upload-Anforderung wurde abgelehnt. Mögliche Probleme: * Die Größe der Konfigurationsnutzlast ist größer als der zulässige Höchstwert -- standardmäßig 2 MB. * Erforderliche Parameter fehlen im Aufruf. |
| 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

{#sl-POST-shared_libs-uploads-comp__entry__50}

| Name | Beschreibung |
|-|-|
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehler.Nachricht | Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge |
| Upload_ID | SYS_ID der Upload-Anforderung. Verwenden Sie diese ID, um den Endpunkt aufzurufen, um den Status des Uploads abzurufen. Datentyp: Zeichenfolge |
| Status | Fehlerstatus der Anforderung. Mögliche Werte: Fehler Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Beispiel zeigt, wie die gemeinsame Bibliothek „Demo_App1631126164773" hochgeladen wird, wobei die Konfigurationsdaten nur-Text sind.

    curl "http://instance.servicenow.com/api/sn_cdm/sharedlibrary/component/upload?namePath=%2FSettings%2FdbSettings&dataFormat=json&appName=Demo_App1631126164773&changesetNumber=Chset-8&autoCommit=false&publishOption=publish_none&autoDelete=true" \ 
    --request POST \  
    --header "Accept:application/json" \  
    --header "Content-Type:text/plain" \  
    --data "{  
      \"dbIPAddress\": \"10.10.10.110\",  
    \"dbPort\": \"8080\",  
    \"dbConnectionString\": \"admin:admin server1.xyz.com:8080 dbName_payments\",  
    \"dbConnectionStringBackup\": \"admin:admin server2.xyz.com dbName_payments_backup\ "}" \  
    --user 'username':'password' 

Die folgenden Rückgabeergebnisse zeigen sowohl eine erfolgreiche als auch eine Fehlerantwort auf diese Anforderung.

    // Successful response 
    {  
    "result": {  
        "upload_id": "ec1f71f45322301096edddeeff7b12b3"  
      }  
    }
     
    // Error response 

    {  
    "error": {  
       "message": "Size of uploaded data:6853632.0(bytes) is greater than max allowed upload limit of 2097152.0(bytes)",  
       "detail": ""  
    },  
    "status": "failure" 
    } 

## CdmSharedLibraryApi -- POST /sn_cdm/Shared_Libraries/uploads/components/file {#ariaid-title8}

Lädt Dateien als Teil des Konfigurationsdatenmodells (CDM) im Komponentenordner in einer gemeinsamen Bibliothek hoch.

### URL-Format {#csl-POST-shared_libs-upld-comp-file__section_abk_fyr_byb}

Versionierte URL: /api/sn_cdm/{api_Version}Shared_Libraries/uploads/components/file

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

### Unterstützte Anforderungsparameter

{#csl-POST-shared_libs-upld-comp-file__entry__2}{#csl-POST-shared_libs-upld-comp-file__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]

{#csl-POST-shared_libs-upld-comp-file__table_hxt_rmm_2yb__entry__2}

|   |   |
|-|-|
| Automatisches Commit | Kennzeichnung, die angibt, ob das Changeset in identifiziert wurde changesetNumberParameter wird nach dem Hochladen an das Datenmodell übergeben. Gültige Werte: * Wahr: Changeset wird nach dem Hochladen bestätigt. * Falsch: Changeset wird nach dem Hochladen nicht bestätigt. Datentyp: Boolescher Wert Standard: Falsch |
| Automatisch validieren | Kennzeichnung, die angibt, ob die Snapshots, die beim Commit erstellt wurden, validiert werden. Gültige Werte: * Wahr: Validieren Sie die Snapshots. * Falsch: Snapshots nicht validieren. Hinweis: Diese Option ist nur verfügbar, wenn autoCommitParameter ist <kbd class="ph userinput">Wahr </kbd>. Datentyp: Boolescher Wert Standard: Falsch |
| changesetNumber | Zeichenfolge, die eindeutig identifiziert [änderungssatz](https://www.servicenow.com/docs/access?context=cdm-changesets-version-control&version=yokohama&pubname=yokohama-it-service-management&ft:locale=en-US)Der Anwendung zugeordnet, z. B. Chset-102. Dieses Changeset muss sich im Status „Offen" befinden. Datentyp: Zeichenfolge Standard: Erstellt ein zu verwendendes Changeset. Die Changeset-Details werden als Teil von zurückgegeben [CdmApplicationsApi -- GET /sn_cdm/Applications/Upload-Status/{Upload_ID}](https://servicenow-prod.fluidtopics.net/TBFNT6IO6hv_2W7LWu7FOQ#apps-GET-upload-status "Gibt den aktuellen Status der angegebenen Anforderung zum Hochladen von Konfigurationsdaten zurück.")Ergebnisse. Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| fileName | Name der hochzuladenden Datei. Dieser Name kann sich vom tatsächlichen Dateinamen unterscheiden und die Dateierweiterung enthalten. Beispiel: .Txt/.scv/.jar. Der Dateiname wird beim Herunterladen der Datei angewendet. Datentyp: Zeichenfolge |
| FileNodeName | Name des Dateiknotens. Dieser Dateiname wird beim Exportieren in den Konfigurationsdaten verwendet. Dieser Name erfordert keine Dateierweiterung und wirkt sich auch nicht auf den Download aus. Datentyp: Zeichenfolge |
| namePath | Pfad des Zielknotens, unter dem die Konfigurationsdaten hochgeladen werden sollen. Dieser Pfad bezieht sich relativ zu den Komponenten, der Sammlung oder dem bereitstellbaren Ordner (abhängig vom aufgerufenen Endpunkt). Sie können den Namenspfad in einem der folgenden Formate übergeben. Beispiel: Um den Namenspfad für den Knoten zu definieren `TestApp/bereitstellbare Elemente/Entwickler1/cdi1 `: * Backslash-Format: TestApp/bereitstellbare Elemente/Entwickler1/cdi1 Hinweis: Wenn Ihr Knotenname einen umgekehrten Schrägstrich ("/") enthält, können Sie dieses Format nicht verwenden. * Back-End-Namenspfad mit Ersatzzeichen: TestApp bereitstellbareEntwickler1 cdi1 * Array: \['TestApp','bereitstellbare Elemente','Development1','cdi1'\] {#csl-POST-shared_libs-upld-comp-file__cdm_apps-namePath-ul} Hinweis: Wenn die angegebene Komponente im angegebenen Pfad nicht vorhanden ist, erstellt das System die Komponente automatisch im angegebenen Pfad und lädt die Daten hoch. Datentyp: Zeichenfolge |
| sharedLibraryName | Erforderlich. Name der gemeinsamen Bibliothek, in der sich die zu löschende Komponente befindet. Datentyp: Zeichenfolge Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
[Tabelle : 38. Abfrageparameter]

{#csl-POST-shared_libs-upld-comp-file__table_hxt_rmm_2yb} {#csl-POST-shared_libs-upld-comp-file__table_j22_fgm_2yb__entry__2}

| Name | Beschreibung |
|-|-|
| Variablen-Upload-Daten | Hochzuladende Konfigurationsdaten. Standardmäßig ist die Dateigröße des Uploads auf 5 MB beschränkt. Informationen zum Anpassen der Größe und des Typs der Upload-Datei finden Sie hier [Now Support Artikel](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB0718101)an. Datentyp: Zeichenfolge/Stream |
[Tabelle : 39. Anforderungstext-Parameter (XML oder JSON)]

{#csl-POST-shared_libs-upld-comp-file__table_j22_fgm_2yb}

### 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.").
{#csl-POST-shared_libs-upld-comp-file__entry__26}{#csl-POST-shared_libs-upld-comp-file__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Inhaltstyp der hochzuladenden Datei. Beispiele: Application/zip, Text/plain, Application/JSON. |
[Tabelle : 40. Anforderungskopfzeilen.]

{#csl-POST-shared_libs-upld-comp-file__entry__32}

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

### Statuscodes {#csl-POST-shared_libs-upld-comp-file__section_mtw_2vr_byb}

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.").
{#csl-POST-shared_libs-upld-comp-file__id_cdq_fft_byb__entry__2}{#csl-POST-shared_libs-upld-comp-file__entry-200-status-code}{#csl-POST-shared_libs-upld-comp-file__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Upload-Anforderung wurde abgelehnt. Mögliche Probleme: * Die Größe der Konfigurationsnutzlast ist größer als das zulässige Maximum -- standardmäßig 2 MB. * Erforderliche Parameter fehlen im Aufruf. {#csl-POST-shared_libs-upld-comp-file__ul_kmn_gkh_psb} |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 42. Statuscodes]

{#csl-POST-shared_libs-upld-comp-file__id_cdq_fft_byb}

### Antworttext-Parameter (JSON oder XML) {#csl-POST-shared_libs-upld-comp-file__section_sbq_2bx_1yb}

{#csl-POST-shared_libs-upld-comp-file__id_af3_kft_byb__entry__2}{#csl-POST-shared_libs-upld-comp-file__cdm_apps-stat-error}{#csl-POST-shared_libs-upld-comp-file__cdm_apps-stat-error_detail-row}{#csl-POST-shared_libs-upld-comp-file__cdm_apps-stat-error_messaage-row}{#csl-POST-shared_libs-upld-comp-file__cdm_apps-stat-error_status-row}{#csl-POST-shared_libs-upld-comp-file__cdm_apps-upload_id-row}

| Name | Beschreibung |
|-|-|
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehler.Nachricht | Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge |
| Status | Fehlerstatus der Anforderung. Mögliche Werte: Fehler Datentyp: Zeichenfolge |
| Upload_ID | SYS_ID der Upload-Anforderung. Verwenden Sie diese ID, um anzurufen [CdmApplicationsApi -- GET /sn_cdm/Applications/Upload-Status/{Upload_ID}](https://servicenow-prod.fluidtopics.net/TBFNT6IO6hv_2W7LWu7FOQ#apps-GET-upload-status "Gibt den aktuellen Status der angegebenen Anforderung zum Hochladen von Konfigurationsdaten zurück.")Endpunkt zum Abrufen des Status des Uploads. Datentyp: Zeichenfolge |
[ ]

{#csl-POST-shared_libs-upld-comp-file__id_af3_kft_byb}  

### Curl-Anforderung

Der folgende Aufruf demonstriert, wie eine nur-Text-Datei in den Komponentenordner in der gemeinsamen Bibliothek hochgeladen wird.

    curl "http://instance.servicenow.com/api/sn_cdm/shared_libraries/uploads/components/file?autoValidate=true&sharedLibraryName=sharedLibA &namePath=testComponent%2FfilesFolder&fileName=testFileNodeName.txt&publishOption=publish_valid&changesetNumber=Chset-108&autoCommit=true&fileNodeName=testFile.txt" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:text/plain" \ 
    --data "This is sample content that will be uploaded to a plain text file."\ 
    --user 'username':'password' 

Die folgenden Rückgabeergebnisse zeigen sowohl eine erfolgreiche als auch eine Fehlerantwort auf diese Anforderung.

    // Successful completion of the upload request
    { 
      "result": { 
        "upload_id": "ec1f71f45322301096edddeeff7b12b3" 
      } 
    } 

    // Error response. Payload is too large.
    { 
      "error": { 
        "message": "Could not find active application with name: 'testApp' of type application", 
        "detail": "" 
      },
      "status": "failure"
    }

## CdmSharedLibraryApi -- PUT /sn_cdm/Shared_Libraries {#ariaid-title9}

Aktualisiert die Informationen der gemeinsamen Bibliothek. Verwenden Sie diesen Endpunkt, um den Namen, die Beschreibung, den Status einer gemeinsamen Bibliothek und die Anwendergruppen zu aktualisieren, die auf die Bibliothek zugreifen können.
Für den Zugriff auf diesen Endpunkt ist die CDM-Administratorrolle erforderlich.

### URL-Format {#sl-PUT-shared_libs__section_thy_4hj_dwb}

Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries

Standard-URL: /api/sn_cdm/Shared_Libraries  
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

{#sl-PUT-shared_libs__entry__2}{#sl-PUT-shared_libs__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 : 43. Pfad-Parameter]

{#sl-PUT-shared_libs__entry__6}

| Name | Beschreibung |
|-|-|
| name | Erforderlich. Name der zu aktualisierenden gemeinsamen Bibliothek. Datentyp: Zeichenfolge Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
| NewAvailableStatus | Kennzeichnung, die den Status der gemeinsamen Bibliothek angibt. Gültige Werte: * Wahr: Die gemeinsame Bibliothek ist aktiv. * Falsch: Die gemeinsame Bibliothek ist inaktiv. Keine Anwender dürfen auf diese Bibliothek zugreifen. Standard: Wahr |
| NeuBeschreibung | Aktualisierte Beschreibung der gemeinsamen Bibliothek. Datentyp: Zeichenfolge |
| NEWNAME | Neuer Name der gemeinsamen Bibliothek. Datentyp: Zeichenfolge |
| NewUserGroupIds | Kommagetrennte Liste der sys_IDs der Anwendergruppen, die auf die zugehörige gemeinsame Bibliothek zugreifen können. Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
| returnFields | Kommagetrennte Liste von Feldern in der Tabelle „CDM-Anwendung" \[sn_cdm_Application\], die als Teil der Antwort zurückgegeben werden sollen. Datentyp: Zeichenfolge Standard: Alle nicht-Systemfelder werden zurückgegeben. |
[Tabelle : 44. Abfrageparameter]

{#sl-PUT-shared_libs__entry__20}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 45. Anforderungstext-Parameter]

### 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.").
{#sl-PUT-shared_libs__entry__24}{#sl-PUT-shared_libs__cdm_apps-sl_req_headers-accept-entry}

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

{#sl-PUT-shared_libs__entry__28}

| 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.").
{#sl-PUT-shared_libs__entry__32}{#sl-PUT-shared_libs__entry-200-status-code}{#sl-PUT-shared_libs__entry-400-status-code}{#sl-PUT-shared_libs__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. |
| 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

{#sl-PUT-shared_libs__entry__40}

| Name | Beschreibung |
|-|-|
| \<fields\> | Angeforderte Felder. Datentyp: Variable Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehler.Nachricht | Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge |
| Status | Fehlerstatus der Anforderung. Mögliche Werte: Fehler Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie dieser Endpunkt für die gemeinsame Bibliothek „Java11Lib" aufgerufen und der Bibliotheksname und die Beschreibung aktualisiert werden.

    curl "http://instance.servicenow.com/sn_cdm/shared_libraries?name=' javalib'&newName='NewLibraryName'&newDescription='new%20description%20of%20library'\ 
    --request PUT\ 
    --header "Accept:application/json" \ 
    --user 'username':'password'  

Antwort:

    {
      "result": {
        "sdlc_component": null,
        "cdi_count": "0",
        "available": true,
        "description": "Set new description",
        "managed_by_group": null,
        "sys_updated_on": "2023-01-18 11:51:14",
        "type": "shared_library",
        "node": {
          "value": "021635dc77a4a1109ac0cf0bbb5a9952",
          "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_node/021635dc77a4a1109ac0cf0bbb5a9952"
        },
        "sys_id": "185235dc77a4a1109ac0cf0bbb5a994e",
        "sys_updated_by": "admin",
        "node_main": {
          "value": "1852b15877a4a1109ac0cf0bbb5a99aa",
          "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_node_main/1852b15877a4a1109ac0cf0bbb5a99aa"
        },
        "sys_created_on": "2023-01-18 11:34:43",
        "cdi_usage": "0",
        "name": "LibraryA",
        "last_committed_changeset": {
          "value": "4a1635dc77a4a1109ac0cf0bbb5a9951",
          "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_changeset/4a1635dc77a4a1109ac0cf0bbb5a9951"
        },
        "state": "active",
        "sys_created_by": "admin"
      }
    }

## CdmSharedLibraryApi -- PUT /sn_cdm/Shared_LibraryApi/components {#ariaid-title10}

Aktualisiert den Namen und die Beschreibung der angegebenen gemeinsam genutzten Komponente.
Für den Zugriff auf diesen Endpunkt ist die CDM-Editorrolle erforderlich.  
Hinweis:  
Das Umbenennen ist nur zulässig, wenn eine Komponente nie verwendet wurde, z. B. wenn der Snapshot der Komponente nie importiert wurde. Das Umbenennungsszenario dient hauptsächlich zum Beheben von Tippfehlern beim Erstellen neuer Komponenten.

### URL-Format {#sl-PUT-shared_libs-comps__section_nff_yxj_dwb}

Versionierte URL: /api/sn_cdm/{api_Version}/Shared_Libraries/components

Standard-URL: /api/sn_cdm/Shared_Libraries/components  
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

{#sl-PUT-shared_libs-comps__entry__2}{#sl-PUT-shared_libs-comps__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 : 49. Pfad-Parameter]

{#sl-PUT-shared_libs-comps__entry__6}

| Name | Beschreibung |
|-|-|
| changesetNumber | Erforderlich. Name des zugeordneten Changesets. Datentyp: Zeichenfolge Tabelle:CDM-Änderungssatz \[sn_cdm_Changeset\] |
| name | Erforderlich. Name der zu aktualisierenden gemeinsam genutzten Komponente. Datentyp: Zeichenfolge Tabelle: Gemeinsam genutzte CDM-Komponente \[sn_cdm_shared_component\] |
| NEWNAME | Erforderlich. Aktualisierter Name der gemeinsam genutzten Komponente. Datentyp: Zeichenfolge |
| NeuBeschreibung | Aktualisierte Beschreibung der gemeinsam genutzten Komponente. Datentyp: Zeichenfolge Standard: Leer |
| returnFields | Kommagetrennte Liste von Feldern in der Tabelle „gemeinsam genutzte CDM-Komponente" \[sn_cdm_shared_component\], die als Teil der Antwort zurückgegeben werden sollen. Datentyp: Zeichenfolge Standard: Alle nicht-Systemfelder werden zurückgegeben. |
[Tabelle : 50. Abfrageparameter]

{#sl-PUT-shared_libs-comps__entry__18}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 51. 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.").
{#sl-PUT-shared_libs-comps__entry__22}{#sl-PUT-shared_libs-comps__cdm_apps-sl_req_headers-accept-entry}

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

{#sl-PUT-shared_libs-comps__entry__26}

| 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.").
{#sl-PUT-shared_libs-comps__entry__30}{#sl-PUT-shared_libs-comps__entry-200-status-code}{#sl-PUT-shared_libs-comps__entry-400-status-code}{#sl-PUT-shared_libs-comps__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. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 54. Statuscodes]

### Antworttext-Parameter

{#sl-PUT-shared_libs-comps__entry__38}

| Name | Beschreibung |
|-|-|
| \<fields\> | Angeforderte Felder aus der Tabelle „gemeinsam genutzte CDM-Komponente" \[sn_cdm_shared_component\]. Datentyp: Variable |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehler.Nachricht | Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge |
| Status | Fehlerstatus der Anforderung. Mögliche Werte: Fehler Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie die Beschreibung der Komponente „SharedComponentTest" aktualisiert wird.

    curl "http://instance.servicenow.com/sn_cdm/shared_libraries/components/?sharedLibraryName=javalib&changeSetNumber='chset-9'&name='SharedComponentTest'&newDescription='The shared component description'\  
    --request POST\  
    --header "Accept:application/json" \  
    --user 'username':'password

Antwort:

    {
      "result": {
        "changeset_id": {
          "value": "5c33311077e4a1109ac0cf0bbb5a9902",
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/5c33311077e4a1109ac0cf0bbb5a9902"
        },
        "node_path": "!(1!(2!(3",
        "description": "Changing the description only",
        "sys_updated_on": "2023-01-18 12:09:05",
        "type": "sn_cdm_node_shared_component",
        "sys_class_name": "sn_cdm_node",
        "sys_id": "9953f99077a4a1109ac0cf0bbb5a99ec",
        "sys_updated_by": "admin",
        "previous_version": null,
        "sys_created_on": "2023-01-18 11:39:09",
        "value": null,
        "effective_from": null,
        "linked_to": null,
        "sys_created_by": "admin",
        "restricted_to": null,
        "linked_to_version": null,
        "level": "2",
        "conflict_type": null,
        "main_id": "183",
        "effective_to": null,
        "secure_value": null,
        "node_classifier": "/shared_library/shared_components",
        "main_id_encoded": "(3",
        "name": "sharedComponentName",
        "position": null,
        "reason_for_conflict": null,
        "system_folder": false,
        "status": "new",
        "conflict": false
      }
    }


