---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CdmVersionApi

# CdmVersionApi {#ariaid-title1}

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

Die CdmVersionApi bietet Endpunkte, mit denen Sie Versionen (Snapshots) in Konfigurationsdaten-Management (CDM) für gemeinsam genutzte Komponenten unter gemeinsam genutzten Bibliotheken veröffentlichen, die Veröffentlichung aufheben und sie exportieren können.
Sie veröffentlichen einen Snapshot, damit er exportiert werden kann. Dadurch kann die Pipeline Kontinuierliche Integration und kontinuierliche Bereitstellung (CICD) auf die zugehörigen gemeinsam genutzten Komponenten und Bibliotheken zugreifen und sie verwenden. Exporter können nur für veröffentlichte Snapshots ausgeführt werden. Wenn Snapshots nicht mehr benötigt werden, können Sie ihre Veröffentlichung aufheben, um die Gewissheit zu verringern, dass der Snapshot noch lebensfähig ist.  
Sie müssen eine der folgenden Rollen aufweisen, um auf diese API zugreifen zu können:

* Scripted REST CDM View ACL (sn_cdm.cdm.viewer)
* Scripted REST CDM Editor ACL (sn_cdm.cdm_editor)

Außerdem muss das Plugin Konfigurationsdaten-Management (CDM) aktiviert sein, damit diese API in einer -Instanz verfügbar ist.

Weitere Informationen zu Snapshots finden Sie unter [Snapshots anzeigen](https://www.servicenow.com/docs/access?context=cdm-snapshots-view-list&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US).

## CdmVersionApi: GET /sn_cdm/versions/export {#ariaid-title2}

Gibt die Konfigurationsdaten für eine angegebene gemeinsam genutzte Komponente in einer angegebenen gemeinsamen Bibliothek für eine angegebene veröffentlichte Version zurück.
Für den Zugriff auf diesen Endpunkt ist die Rolle „CDM-Editor" erforderlich.

### URL-Format

URL mit Versionsnummer: /api/sn_cdm/{api_version}/versions/export

Standard-URL: /api/sn_cdm/versions/export

### Unterstützte Anforderungsparameter

{#versions-GET-export__entry__2}{#versions-GET-export__version-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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. Pfadparameter]

{#versions-GET-export__entry__6}

| Name | Beschreibung |
|-|-|
| dataFormat | Erforderlich. Format der Konfigurationsdaten. Gültige Werte: * CSV * ini * json * Eigenschaften * roh * XML * YAML Datentyp: Zeichenfolge |
| decryptPassword | Kennzeichnung, die angibt, ob codierte oder entschlüsselte Passwortwerte angezeigt werden sollen. Gültige Werte: * „wahr": Passwort entschlüsseln und entschlüsselten Wert anzeigen. * „falsch": Verschlüsselten Passwortwert anzeigen. Standardwert: false |
| SharedComponentName | Erforderlich. Name der gemeinsam genutzten Komponente, deren Konfigurationsdaten exportiert werden sollen. Befindet sich in der Tabelle „Gemeinsam genutzte CDM-Komponente" \[sn_cdm_shared_component\]. Datentyp: Zeichenfolge |
| sharedLibraryName | Erforderlich. Name der gemeinsamen Bibliothek, die die Komponente enthält, deren Konfigurationsdaten Sie zurückgeben möchten. Befindet sich in der Tabelle „CDM-Anwendung" \[sn_cdm_application\]. Für die angegebene Anwendung muss das Typfeld auf „shared_library" festgelegt sein. Datentyp: Zeichenfolge |
| ersatzVariablen | Kennzeichnung, die angibt, ob die Variablen verfolgt werden sollen. Informationen zum Verfolgen der Variablen finden Sie unter [Konfigurationsdaten validieren und korrigieren](https://www.servicenow.com/docs/access?context=cdm-validating-cfg-data&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US). Gültige Werte: * „wahr": Verfolgt die Variablen. * „falsch": Variablen werden nicht verfolgt. Standardwert: true |
[Tabelle : 2. Abfrageparameter]

{#versions-GET-export__entry__18}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstextparameter]

### Kopfzeilen

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

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

{#versions-GET-export__entry__26}

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

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#versions-GET-export__entry__30}{#versions-GET-export__entry-200-status-code}{#versions-GET-export__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Möglicherweise ist eines der folgenden Probleme aufgetreten: * Die gemeinsame Bibliothek ist nicht aktiv. * Die gemeinsam genutzte Komponente ist nicht aktiv. * Version s nicht veröffentlicht. * Parameter fehlt im Aufruf. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Parameter des Antwort-Haupttexts

{#versions-GET-export__entry__38}

| Name | Beschreibung |
|-|-|
| Ergebnis | Konfigurationsdaten im angegebenen Format. |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| Fehler.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehlernachricht | 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 Konfigurationsdaten der Komponente „jdk8" in der gemeinsamen Bibliothek „JavaLib" exportiert werden.

    curl "http://instance.servicenow.com/api/sn_cdm/shared_libraries/components/exports?sharedLibraryName=JavaLib&componentName=jdk8 
    --request POST \  
    --header "Accept:application/json" \   
    --user 'username':'password'

Antwort:

    {  
    "result": {  
        "sharedComponentA": { "cdi": "val" } 
     }  
    } 

## CdmVersionApi: PUT /sn_cdm/versions/publish {#ariaid-title3}

Veröffentlicht eine Version einer gemeinsam genutzten Komponente unter einer angegebenen gemeinsamen Bibliothek.
Für den Zugriff auf diesen Endpunkt ist die Rolle „CDM-Editor" erforderlich.  
Hinweis:  
Snapshots und Versionen sind für diese Implementierung gleichbedeutend.

### URL-Format

URL mit Versionsnummer: /api/sn_cdm/{api_version}/versions/publish

Standard-URL: /api/sn_cdm/versions/publish

### Unterstützte Anforderungsparameter

{#versions-PUT-publish__entry__2}{#versions-PUT-publish__version-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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. Pfadparameter]

{#versions-PUT-publish__entry__6}

| Name | Beschreibung |
|-|-|
| name | Erforderlich. Name der Version der zu veröffentlichenden gemeinsam genutzten Komponente. Befindet sich in der Tabelle „Gemeinsam genutzte CDM-Komponente" \[sn_cdm_shared_component\]. Datentyp: Zeichenfolge |
| returnFields | Kommagetrennte Liste von Feldern in der CDM-Snapshot-Tabelle \[sn_cdm_snapshot\], die als Teil der Antwort zurückgegeben werden sollen. Datentyp: Zeichenfolge Standard: Gibt alle Nicht-Systemfelder zurück. |
| SharedComponentName | Erforderlich. Name der zu veröffentlichenden gemeinsam genutzten Komponente. Befindet sich in der Tabelle „Gemeinsam genutzte CDM-Komponente" \[sn_cdm_shared_component\]. Datentyp: Zeichenfolge |
| sharedLibraryName | Erforderlich. Name der gemeinsamen Bibliothek, in der sich die angegebene Komponente befindet. Befindet sich in der Tabelle „CDM-Anwendung" \[sn_cdm_application\]. Das Typfeld im zugeordneten Datensatz muss auf „shared_library" festgelegt werden. Datentyp: Zeichenfolge |
[Tabelle : 8. Abfrageparameter]

{#versions-PUT-publish__entry__16}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. Anforderungstextparameter]

### Kopfzeilen

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

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

{#versions-PUT-publish__entry__24}

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

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#versions-PUT-publish__entry__28}{#versions-PUT-publish__entry-200-status-code}{#versions-PUT-publish__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Beim Veröffentlichen von ist ein Fehler aufgetreten. Mögliche Probleme: * Versionsname nicht gefunden. * Komponentenversion wurde bereits veröffentlicht. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 12. Statuscodes]

### Parameter des Antwort-Haupttexts

{#versions-PUT-publish__id_rtv_wbb_fwb__entry__2}

| Name | Beschreibung |
|-|-|
| cdm_application_id | Details zur CDM-Anwendung, die dem Snapshot zugeordnet ist. Datentyp: Objekt "cdm_application_id": { "link": "String", "value": "String" } |
| cdm_application_id.link | Rufen Sie auf, um mit der REST- Tabellen -API auf den CDM-Anwendungsdatensatz zuzugreifen. Datentyp: Zeichenfolge |
| cdm_application_id.value | Sys_id des zugeordneten CDM-Anwendungsdatensatzes. Befindet sich in der Tabelle „CDM-Anwendung" \[sn_cdm_application\]. Datentyp: Zeichenfolge |
| cdm_deployable_id | Details zum bereitstellbaren CDM-Element, das dem Snapshot zugeordnet ist. Datentyp: Objekt "cdm_deployable_id": { "link": "String", "value": "String" } |
| cdm_deployable_id.link | Rufen Sie die Syntax zum Abfragen dieses bereitstellbaren Datensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge |
| cdm_deployable_id.value | Sys_id des bereitstellbaren Datensatzes. Befindet sich in der Tabelle „CDM -- Bereitstellbar" \[sn_cdm_deployable\]. Datentyp: Zeichenfolge |
| changeset_id | Details zum Changeset, das dem Snapshot zugeordnet ist. Datentyp: Objekt "changeset_id": { "link": "String", "value": "String" } |
| changeset_id.link | Rufen Sie die Syntax zum Abfragen dieses Changeset-Datensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge |
| changeset_id.value | Eindeutiger Bezeichner des Changeset-Datensatzes. Befindet sich in der Tabelle „CDM-Änderungssatz" \[sn_cdm_changeset\]. Datentyp: Zeichenfolge |
| Beschreibung | Kurze Beschreibung des Snapshots. Datentyp: Zeichenfolge |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| Fehler.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehlernachricht | Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge |
| last_published | Datum und Uhrzeit der letzten Veröffentlichung des Snapshots. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| last_validated | Datum und Uhrzeit der letzten Validierung des Snapshots. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| name | Name des Snapshots Datentyp: Zeichenfolge |
| Nummer | Eindeutige Nummer, die den Snapshot identifiziert. Dieser Wert stellt einen visuell lesbaren Bezeichner für die Zuordnung bereit. Datentyp: Zeichenfolge |
| Veröffentlicht | Kennzeichnung, die angibt, ob der Snapshot veröffentlicht wurde. Mögliche Werte: * wahr: Snapshot wurde veröffentlicht. * „falsch": Snapshot wurde nicht veröffentlicht. Datentyp: Boolesch |
| sys_created_by | Name des Benutzers, der den Snapshot erstellt hat. Datentyp: Zeichenfolge |
| sys_created_on | Datum und Uhrzeit der Erstellung des Snapshots. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| sys_id | Sys_id des Snapshots. Befindet sich in der CDM-Snapshot-Tabelle \[sn_cdm_snapshot\]. Datentyp: Zeichenfolge |
| sys_updated_by | Name des Benutzers, der den Snapshot aktualisiert hat. Datentyp: Zeichenfolge |
| sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung des Snapshots. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| Validierung | Aktueller Validierungsstatus des Snapshots. Mögliche Werte: * „execution_error" * Fehlgeschlagen * in_progress * not_validated * bestanden * bestanden_mit_Ausnahme * angefordert Datentyp: Zeichenfolge |
[ ]

{#versions-PUT-publish__id_rtv_wbb_fwb}  

### cURL-Anforderung

Dieses Codebeispiel zeigt, wie die gemeinsam genutzte Komponente „Development" mit dem Versionsnamen „Development-v1.shc" veröffentlicht wird.

    curl "http://instance.servicenow.com/api/sn_cdm/versions/publish?sharedLibraryName=LibraryJdk&componentName=Development&name=Development-v1.shc" \  
    --request PUT\  
    --header "Accept:application/json" \  
    --user 'username':'password

Antwort:

    {
      "result": {
        "changeset_id": {
          "value": "1a2bd15c7764a1109ac0cf0bbb5a99fc",
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/1a2bd15c7764a1109ac0cf0bbb5a99fc"
        },
        "cdm_deployable_id": null,
        "cdm_shared_component_node_id": {
          "value": "fe2b155c7764a1109ac0cf0bbb5a995d",
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_node/fe2b155c7764a1109ac0cf0bbb5a995d"
        },
        "cdm_shared_component_id": {
          "value": "362b155c7764a1109ac0cf0bbb5a9970",
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_shared_component/362b155c7764a1109ac0cf0bbb5a9970"
        },
        "description": null,
        "cdm_application_id": {
          "value": "122bd15c7764a1109ac0cf0bbb5a99fa",
          "link": "http://instance.servicenow.com/api/now/table/sn_cdm_application/122bd15c7764a1109ac0cf0bbb5a99fa"
        },
        "published": true,
        "sys_updated_on": "2023-01-18 14:15:44",
        "last_published": "2023-01-18 09:53:37",
        "sequence_number": "1",
        "number": "SNAP0001110",
        "sys_id": "df2b155c7764a1109ac0cf0bbb5a9949",
        "sys_updated_by": "admin",
        "sys_created_on": "2023-01-18 09:53:36",
        "name": "logonService-V2.1-v1.shc",
        "last_validated": "",
        "validation": "passed",
        "sys_created_by": "admin"
      }
    }

## CdmVersionApi: PUT /sn_cdm/versions/unpublish {#ariaid-title4}

Hebt die Veröffentlichung einer Version einer gemeinsam genutzten Komponente in einer angegebenen gemeinsamen Bibliothek auf.
Für den Zugriff auf diesen Endpunkt ist die Rolle „CDM-Editor" erforderlich.  
Hinweis:  
Snapshots und Versionen sind für diese Implementierung gleichbedeutend.

### URL-Format {#versions-PUT-unpublish__section_pcx_3cb_fwb}

URL mit Versionsnummer: /api/sn_cdm/{api_version}/versions/publish

Standard-URL: /api/sn_cdm/versions/publish

### Unterstützte Anforderungsparameter

{#versions-PUT-unpublish__entry__2}{#versions-PUT-unpublish__version-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum 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 : 13. Pfadparameter]

{#versions-PUT-unpublish__entry__6}

| Name | Beschreibung |
|-|-|
| name | Erforderlich. Name der Version der gemeinsam genutzten Komponente, deren Veröffentlichung aufgehoben werden soll. Befindet sich in der Tabelle „Gemeinsam genutzte CDM-Komponente" \[sn_cdm_shared_component\]. Datentyp: Zeichenfolge |
| returnFields | Kommagetrennte Liste von Feldern in der CDM-Snapshot-Tabelle \[sn_cdm_snapshot\], die als Teil der Antwort zurückgegeben werden sollen. Datentyp: Zeichenfolge Standard: Gibt alle Nicht-Systemfelder zurück. |
| SharedComponentName | Erforderlich. Name der gemeinsam genutzten Komponente, deren Veröffentlichung aufgehoben werden soll. Befindet sich in der Tabelle „Gemeinsam genutzte CDM-Komponente" \[sn_cdm_shared_component\]. Datentyp: Zeichenfolge |
| sharedLibraryName | Erforderlich. Name der gemeinsamen Bibliothek, in der sich die angegebene Komponente befindet. Befindet sich in der Tabelle „CDM-Anwendung" \[sn_cdm_application\]. Das Typfeld im zugeordneten Datensatz muss auf „shared_library" festgelegt werden. Datentyp: Zeichenfolge |
[Tabelle : 14. Abfrageparameter]

{#versions-PUT-unpublish__entry__16}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 15. Anforderungstextparameter]

### Kopfzeilen

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

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

{#versions-PUT-unpublish__entry__24}

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

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#versions-PUT-unpublish__entry__28}{#versions-PUT-unpublish__entry-200-status-code}{#versions-PUT-unpublish__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Fehler beim Aufheben der Veröffentlichung von. Mögliche Probleme: * Versionsname nicht gefunden. * Komponentenversion wurde bereits veröffentlicht. {#versions-PUT-unpublish__ul_h5h_pcb_fwb} |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

### Parameter des Antwort-Haupttexts

{#versions-PUT-unpublish__id_mbl_2cb_fwb__entry__2}

| Name | Beschreibung |
|-|-|
| cdm_application_id | Details zur CDM-Anwendung, die dem Snapshot zugeordnet ist. Datentyp: Objekt "cdm_application_id": { "link": "String", "value": "String" } |
| cdm_application_id.link | Rufen Sie auf, um mit der REST- Tabellen -API auf den CDM-Anwendungsdatensatz zuzugreifen. Datentyp: Zeichenfolge |
| cdm_application_id.value | Sys_id des zugeordneten CDM-Anwendungsdatensatzes. Befindet sich in der Tabelle „CDM-Anwendung" \[sn_cdm_application\]. Datentyp: Zeichenfolge |
| cdm_deployable_id | Details zum bereitstellbaren CDM-Element, das dem Snapshot zugeordnet ist. Datentyp: Objekt "cdm_deployable_id": { "link": "String", "value": "String" } |
| cdm_deployable_id.link | Rufen Sie die Syntax zum Abfragen dieses bereitstellbaren Datensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge |
| cdm_deployable_id.value | Sys_id des bereitstellbaren Datensatzes. Befindet sich in der Tabelle „CDM -- Bereitstellbar" \[sn_cdm_deployable\]. Datentyp: Zeichenfolge |
| changeset_id | Details zum Changeset, das dem Snapshot zugeordnet ist. Datentyp: Objekt "changeset_id": { "link": "String", "value": "String" } |
| changeset_id.link | Rufen Sie die Syntax zum Abfragen dieses Changeset-Datensatzes mit der Tabellen -REST-API auf. Datentyp: Zeichenfolge |
| changeset_id.value | Eindeutiger Bezeichner des Changeset-Datensatzes. Befindet sich in der Tabelle „CDM-Änderungssatz" \[sn_cdm_changeset\]. Datentyp: Zeichenfolge |
| Beschreibung | Kurze Beschreibung des Snapshots. Datentyp: Zeichenfolge |
| Fehler | Wenn während der Verarbeitung ein Fehler aufgetreten ist, die Details zum Fehler. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| Fehler.detail | Zusätzliche Informationen zum Fehler. Datentyp: Zeichenfolge |
| Fehlernachricht | Fehlermeldung, die beim Versuch, die Anforderung zu verarbeiten, generiert wurde. Datentyp: Zeichenfolge |
| last_published | Datum und Uhrzeit der letzten Veröffentlichung des Snapshots. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| last_validated | Datum und Uhrzeit der letzten Validierung des Snapshots. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| name | Name des Snapshots Datentyp: Zeichenfolge |
| Nummer | Eindeutige Nummer, die den Snapshot identifiziert. Dieser Wert stellt einen visuell lesbaren Bezeichner für die Zuordnung bereit. Datentyp: Zeichenfolge |
| Veröffentlicht | Kennzeichnung, die angibt, ob der Snapshot veröffentlicht wurde. Mögliche Werte: * wahr: Snapshot wurde veröffentlicht. * „falsch": Snapshot wurde nicht veröffentlicht. Datentyp: Boolesch |
| sys_created_by | Name des Benutzers, der den Snapshot erstellt hat. Datentyp: Zeichenfolge |
| sys_created_on | Datum und Uhrzeit der Erstellung des Snapshots. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| sys_id | Sys_id des Snapshots. Befindet sich in der CDM-Snapshot-Tabelle \[sn_cdm_snapshot\]. Datentyp: Zeichenfolge |
| sys_updated_by | Name des Benutzers, der den Snapshot aktualisiert hat. Datentyp: Zeichenfolge |
| sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung des Snapshots. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| Validierung | Aktueller Validierungsstatus des Snapshots. Mögliche Werte: * „execution_error" * Fehlgeschlagen * in_progress * not_validated * bestanden * bestanden_mit_Ausnahme * angefordert Datentyp: Zeichenfolge |
[ ]

{#versions-PUT-unpublish__id_mbl_2cb_fwb}  

### cURL-Anforderung

Im folgenden Codebeispiel wird gezeigt, wie die Veröffentlichung der gemeinsam genutzten Komponente „paymentService-V1" in der gemeinsamen Bibliothek „OracleG-Library-10" aufgehoben wird.

    curl "https://instance-name.service-now.com/api/sn_cdm/versions/unpublish?sharedLibraryName=OracleG-Library-10&sharedComponentName=paymentService-V1.1&name=paymentService-V1.1-v1.shc" \ 
    --request PUT \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

Antwort:

    {
      "result": {
        "changeset_id": {
          "value": "1a2bd15c7764a1109ac0cf0bbb5a99fc",
          "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_changeset/1a2bd15c7764a1109ac0cf0bbb5a99fc"
        },
        "cdm_deployable_id": null,
        "cdm_shared_component_node_id": {
          "value": "fe2b155c7764a1109ac0cf0bbb5a995d",
          "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_node/fe2b155c7764a1109ac0cf0bbb5a995d"
        },
        "cdm_shared_component_id": {
          "value": "362b155c7764a1109ac0cf0bbb5a9970",
          "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_shared_component/362b155c7764a1109ac0cf0bbb5a9970"
        },
        "description": null,
        "cdm_application_id": {
          "value": "122bd15c7764a1109ac0cf0bbb5a99fa",
          "link": "http://192.168.0.129:8080/api/now/table/sn_cdm_application/122bd15c7764a1109ac0cf0bbb5a99fa"
        },
        "published": false,
        "sys_updated_on": "2023-01-18 14:15:44",
        "last_published": "2023-01-18 09:53:37",
        "sequence_number": "1",
        "number": "SNAP0001110",
        "sys_id": "df2b155c7764a1109ac0cf0bbb5a9949",
        "sys_updated_by": "admin",
        "sys_created_on": "2023-01-18 09:53:36",
        "name": "logonService-V2.1-v1.shc",
        "last_validated": "",
        "validation": "passed",
        "sys_created_by": "admin"
      }
    }


