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


---

# CdmChangesetsApi

# CdmChangesetsApi {#ariaid-title1}

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

Die CdmChangesetsApi Stellt Endpunkte bereit, mit denen Sie Changesets verwalten können.
Mit diesen Endpunkten können Sie:

* Erstellen Sie neue Changesets.
* Stellen Sie Changesets bereit.
* Ruft Listen von oder einzelnen Changesets ab.
* Ruft die Knotenänderungen in einem Changeset ab.
* Ruft eine Liste von Anwendungen oder bereitstellbaren Elementen ab, die von einem Changeset betroffen sind.
* Löschen Sie Changesets.
* Gibt eine Liste der gemeinsam genutzten Komponenten zurück, die einem angegebenen Changeset zugeordnet sind.

Die Endpunkte zum Erstellen von Changesets verwenden eine asynchrone Warteschlangenimplementierung. Bei dieser Art von Implementierung rufen Sie zuerst den Endpunkt der Anforderung „Changeset erstellen" auf. Dieser Endpunkt stellt Ihre Anforderung in die Warteschlange und gibt einen Commit-Bezeichner zurück. Sie verwenden dann diesen Commit-Bezeichner, um den entsprechenden Statusendpunkt aufzurufen, um den Status der Erstellungsanforderung abzurufen.  
Sie müssen über eine der folgenden Rollen verfügen, um auf diese API zuzugreifen:

* Geskriptete REST-CDM-Zugriffssteuerungsliste anzeigen (sn_cdm.cdm.Viewer)
* Geskriptete REST-CDM-Editor-ACL (sn_cdm.cdm_Editor)

Darüber hinaus wird Konfigurationsdaten-Management(CDM) Plugin muss aktiviert sein, damit diese API in einer Instanz verfügbar ist.

Weitere Informationen zu Changesets finden Sie unter [Changesets und Versionssteuerung in CDM](https://www.servicenow.com/docs/access?context=cdm-changesets-version-control&version=yokohama&pubname=yokohama-it-service-management&ft:locale=en-US).

## CdmChangesetsApi: LÖSCHEN SIE /sn_cdm/Changesets {#ariaid-title2}

Löscht ein angegebenes Changeset.
Der Anrufer muss über die Rolle „CDM-Editor" verfügen, um auf diesen Endpunkt zuzugreifen.

### URL-Format

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

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

{#chngsets-DELETE-chgnsets__entry__2}{#chngsets-DELETE-chgnsets__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]

{#chngsets-DELETE-chgnsets__entry__6}{#chngsets-DELETE-chgnsets__changesetNumber-changeset-entry}

| Name | Beschreibung |
|-|-|
| changesetNumber | Erforderlich. Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
[Tabelle : 2. Abfrageparameter]

{#chngsets-DELETE-chgnsets__entry__10}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. 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.").
{#chngsets-DELETE-chgnsets__entry__14}{#chngsets-DELETE-chgnsets__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 4. Anforderungskopfzeilen.]

{#chngsets-DELETE-chgnsets__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.").
{#chngsets-DELETE-chgnsets__entry__22}{#chngsets-DELETE-chgnsets__entry-200-status-code}{#chngsets-DELETE-chgnsets__entry-400-status-code}{#chngsets-DELETE-chgnsets__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

{#chngsets-DELETE-chgnsets__entry__30}

| Name | Beschreibung |
|-|-|
| Keine |   |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie ein Changeset entfernt wird.

    curl "http://instance.servicenow.com/api/sn_cdm/changesets?changesetNumber=Chset-760" \ 
    --request DELETE \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

Für eine erfolgreiche Löschung des Changesets wird keine andere Antwort als der HTTP-Statuscode zurückgegeben.

    None - results defined by the HTTP status code

## CdmChangesetsApi -- /sn_cdm/Changesets ABRUFEN {#ariaid-title3}

Ruft alle Changesets ab, die einem zugeordnet sind Konfigurationsdaten-Management(CDM) Anwendung oder ein angegebener Changeset-Datensatz.
<br />

### URL-Format

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

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

{#chngsets-GET-changesets__entry__2}{#chngsets-GET-changesets__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]

{#chngsets-GET-changesets__entry__6}

| Name | Beschreibung |
|-|-|
| appName | Erforderlich. Name der CDM-Anwendung, deren Changesets Sie zurückgeben möchten. Dies muss eine aktive Anwendung sein. Datentyp: Zeichenfolge Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
| Nummer | Änderungssatznummer. Wenn Sie diesen Wert übergeben, wird nur das angegebene Changeset zurückgegeben. Es muss ein Changeset sein, das der in angegebenen CDM-Anwendung zugeordnet ist appNameParameter. Datentyp: Zeichenfolge Standard: Keine -- gibt alle Changesets zurück, die der CDM-Anwendung oder den von angegebenen Changesets zugeordnet sind stateParameter. Tabelle: CDMChangeset \[sn_cdm_Changeset\] |
| Staat | Status der zurückzugebenden Changesets. Gibt nur die Changesets zurück, die der angegebenen CDM-Anwendung für den angegebenen Status zugeordnet sind. Gültige Werte: * Blockiert * Überprüfung auf Konflikte * Commit fehlgeschlagen * Commit wird ausgeführt * Committet * Offen Datentyp: Zeichenfolge Standard: Gibt alle Changesets für alle status zurück |
[Tabelle : 8. Abfrageparameter]

{#chngsets-GET-changesets__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.").
{#chngsets-GET-changesets__entry__18}{#chngsets-GET-changesets__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 10. Anforderungskopfzeilen.]

{#chngsets-GET-changesets__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.").
{#chngsets-GET-changesets__entry__26}{#chngsets-GET-changesets__entry-200-status-code}{#chngsets-GET-changesets__entry-400-status-code}{#chngsets-GET-changesets__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 : 12. Statuscodes]

### Antworttext-Parameter

{#chngsets-GET-changesets__entry__34}{#chngsets-GET-changesets__cdm_apps-autoValidate-row}{#chngsets-GET-changesets__committed_at-changeset-entry}{#chngsets-GET-changesets__sys_created_by-changeset-entry}{#chngsets-GET-changesets__sys_created_on-changeset-entry}{#chngsets-GET-changesets__sys_id-changeset-entry}{#chngsets-GET-changesets__sys_updated_by-changeset-entry}{#chngsets-GET-changesets__sys_updated_on-changeset-entry}

| Name | Beschreibung |
|-|-|
| auto_validate | Kennzeichnung, die angibt, ob die beim Commit erstellten Changesets validiert werden. Gültige Werte: * Wahr: Validieren Sie die Changesets. * Falsch: Validieren Sie die Changesets nicht. Datentyp: Boolescher Wert |
| cdm_Application | Details der CDM-Anwendung, die dem Changeset zugeordnet ist. Datentyp: Objekt "cdm_application": { "link": "String", "value": "String" } |
| cdm_Application.Link | Abfrage, die zum Aufrufen von verwendet werden soll Tabelle REST-Endpunkt zum Abrufen der zugeordneten CDM-Anwendung. Datentyp: Zeichenfolge |
| cdm_Application.value | SYS_ID der zugeordneten CDM-Anwendung. Datentyp: Zeichenfolge Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
| Commit_at | Datum und Uhrzeit der letzten Commits des Changesets. Datentyp: Zeichenfolge Format: JJJJ-mm-TT hh:mm:ss |
| Commit_by | Details zum Anwender, der das Changeset bestätigt hat. Datentyp: Objekt "committed_by": { "link": "String", "value": "String" } |
| Commit_by.Link | Rufen Sie an, um den Datensatz des Anwenders abzurufen, der das Changeset mit dem REST festgeschrieben hat Tabelle API. Datentyp: Zeichenfolge |
| Commit_by.value | SYS_ID des Anwenders, der das Changeset festgelegt hat. Datentyp: Zeichenfolge |
| Beschreibung | Kurze Beschreibung des Zwecks des Changesets. Datentyp: Zeichenfolge |
| 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 |
| last_conflict_detection_time | Zeit seit Ausführung der letzten Konflikterkennung. Die Konflikterkennung wird immer dann durchgeführt, wenn ein Changeset bestätigt wird. Datentyp: Zahl Einheit: Millisekunden |
| last_updated | Datum und Uhrzeit, zu der eine Änderung an den zugehörigen Konfigurationsdaten über dieses Changeset vorgenommen wurde. Format: JJJJ-mm-TT hh:mm:ss Datentyp: Zeichenfolge |
| Nummer | Eindeutige Changeset-Nummer. Datentyp: Zeichenfolge |
| publish_option | Veröffentlichungsoption für die zugehörigen konfigurierten Snapshots. Gültige Werte: * Publish_none: Veröffentlichen Sie keine Snapshots. * Publish_valid: Veröffentlichen Sie nur die Snapshots, die die Validierung nach dem Commit bestehen. 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 |
| Staat | Aktueller Status des Changesets. Mögliche Werte: * Blockiert * Überprüfung auf Konflikte * Commit fehlgeschlagen * Commit wird ausgeführt * Committet * Offen Datentyp: Zeichenfolge |
| sys_created_by | Anwendername des Anwenders, der das Changeset erstellt hat. Beispiel: Able.tuter. Datentyp: Zeichenfolge |
| sys_created_on | Datum und Uhrzeit der Erstellung des Changesets. Datentyp: Zeichenfolge Format: JJJJ-mm-TT hh:mm:ss |
| sys_id | SYS_ID des Changesets. Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| sys_updated_by | Anwendername des Anwenders, der das Changeset zuletzt aktualisiert hat. Beispiel: Able.tuter. Datentyp: Zeichenfolge |
| sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung des Changesets. Datentyp: Zeichenfolge Format: JJJJ-mm-TT hh:mm:ss |
| Titel | Titel des Changesets. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Dieses Codebeispiel zeigt, wie ein bestimmtes Changeset abgerufen wird.

    curl "http://instance.servicenow.com/api/sn_cdm/changesets?appName=testApp&changesetNumber=Chset-946&state=committed" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

Ergebnisse zurückgeben:

    { 
      "result": [ 
        { 
          "description": "Auto generated for deletion of CDM Deployable Dep-12022-06-29 13:09:46", 
          "cdm_application": { 
            "value": "62b517a953b70110a1d3ddeeff7b128c", 
            "link": "http://instance.servicenow.com/api/now/table/sn_cdm_application/62b517a953b70110a1d3ddeeff7b128c" 
          }, 
          "sys_updated_on": "2022-06-29 13:09:47", 
          "title": "Auto generated for deletion of CDM Deployable Dep-12022-06-29 13:09:46", 
          "number": "Chset-946", 
          "sys_id": "955d6c0f53141110a1d3ddeeff7b1233", 
          "sys_updated_by": "admin", 
          "committed_at": "2022-06-29 13:09:46", 
          "sys_created_on": "2022-06-29 13:09:46", 
          "committed_by": { 
            "value": "6816f79cc0a8016401c5a33be04be441", 
            "link": "http://instance.servicenow.com/api/now/table/sys_user/6816f79cc0a8016401c5a33be04be441" 
          }, 
          "state": "committed", 
          "auto_validate": true, 
          "publish_option": "publish_none", 
          "last_conflict_detection_time": "1656508187450", 
          "sys_created_by": "admin", 
          "last_updated": "2022-06-29 13:09:46" 
        } 
      ] 
    } 

## CdmChangesetsApi -- GET /sn_cdm/Changesets/activity {#ariaid-title4}

Ruft die Knotenänderungen innerhalb eines angegebenen Changesets ab.
<br />

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Changesets/Activity

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

{#chngsets-GET-activity__entry__2}{#chngsets-GET-activity__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 : 13. Pfad-Parameter]

{#chngsets-GET-activity__entry__6}{#chngsets-GET-activity__changesetNumber-changeset-entry}{#chngsets-GET-activity__cdm_apps-returnFields-entry}

| Name | Beschreibung |
|-|-|
| changesetNumber | Erforderlich. Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| returnFields | Liste der Felder, die als Teil der Antwort zurückgegeben werden sollen. Übergeben Sie die Namen der Datensatzspalte, z. B. sys_ID, sys_updated_by oder Status. Datentyp: Array Standard: Alle Felder, wie vom Endpunkt bestimmt |
[Tabelle : 14. Abfrageparameter]

{#chngsets-GET-activity__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.").
{#chngsets-GET-activity__entry__16}{#chngsets-GET-activity__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 16. Anforderungskopfzeilen.]

{#chngsets-GET-activity__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.").
{#chngsets-GET-activity__entry__24}{#chngsets-GET-activity__entry-200-status-code}{#chngsets-GET-activity__entry-400-status-code}{#chngsets-GET-activity__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

{#chngsets-GET-activity__entry__32}

| Name | Beschreibung |
|-|-|
| änderungssatz_ID | Details des angeforderten Changesets. Datentyp: Objekt "changeset_id": { "link": "String", "value": "String" } |
| änderungssatz_ID.Link | Abfrage, die zum Aufrufen von verwendet werden soll Tabelle REST-Endpunkt zum Abrufen des zugeordneten Changesets. Datentyp: Zeichenfolge |
| änderungssatz_ID.Wert | SYS_ID des zugeordneten Changesets. Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| Konflikt | Kennzeichnung, die angibt, ob im zugeordneten Changeset ein Konflikt vorliegt. Gültige Werte: * Wahr: Konflikt erkannt. * Falsch: Kein Konflikt gefunden. Datentyp: Boolescher Wert |
| erstellt | Datum und Uhrzeit der Erstellung des Knotens. Format: JJJJ-mm-TT hh:mm:ss Datentyp: Zeichenfolge |
| Erstellt_von | Anwendername des Anwenders, der den Knoten erstellt. Beispiel: Able.tuter. Datentyp: Zeichenfolge |
| 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 |
| Name_Pfad | Knotenpfadname. Datentyp: Zeichenfolge |
| New_Name | Aktueller Name des Knotens. Datentyp: Zeichenfolge |
| new_value | Aktueller Wert des Knotens. Für Blattknoten und Array-Literale. Datentyp: Zeichenfolge |
| Old_Name | Vorheriger Name des Knotens. Datentyp: Zeichenfolge |
| old_value | Vorheriger Wert des Knotens. Für Blattknoten und Array-Literale. Datentyp: Zeichenfolge |
| aktualisiert | Datum und Uhrzeit der letzten Aktualisierung des Knotens. Format: JJJJ-mm-TT hh:mm:ss Datentyp: Zeichenfolge |
| Aktualisiert_von | Anwendername des Anwenders, der den Knoten zuletzt aktualisiert hat. Beispiel: Able.tuter. Datentyp: Zeichenfolge |
| Sicher | Kennzeichnung, die angibt, ob der zugehörige Blattknoten gesichert wurde. Gültige Werte: * Wahr: Knoten wurde gesichert. * Falsch: Knoten wurde nicht gesichert. Datentyp: Boolescher Wert |
| Typ | Knotentyp. Mögliche Werte: * sn_cdm_node_collection * sn_cdm_node_component * sn_cdm_node_folder * sn_cdm_node_cdi * sn_cdm_node_variable {#chngsets-GET-activity__ul_mlj_vdm_c5b} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Dieses Codebeispiel zeigt, wie die Knotenänderungen für ein bestimmtes Changeset abgerufen werden.

    curl "http://instance.servicenow.com/api/sn_cdm/changesets/activity?changesetNumber=Chset-783" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

Ergebnisse zurückgeben:

    { 
      "result": [ 
        { 
          "sys_id": "ed5d6c0f53141110a1d3ddeeff7b1233", 
          "changeset_id": "955d6c0f53141110a1d3ddeeff7b1233", 
          "new_value": null, 
          "new_state": "Deleted", 
          "new_name": "Dep-1", 
          "new_type": "Deployable", 
          "new_encrypted": false, 
          "updated_on": "2022-06-29 13:09:46", 
          "updated_by": "admin", 
          "resolution_method": "", 
          "conflict": null, 
          "path": "deployables/Dep-1", 
          "created_by": null, 
          "created_on": null, 
          "old_value": null, 
          "old_state": "Superseded", 
          "old_name": "Dep-1", 
          "old_type": "Deployable", 
          "old_encrypted": false 
        } 
    ] 
    } 

## CdmChangesetsApi -- /sn_cdm/Changesets/commit-Status/{commit_ID} ABRUFEN {#ariaid-title5}

Gibt den aktuellen Status der angegebenen Changeset-Commit-Anforderung zurück.

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Changesets/commit-Status/{commit_ID}

Standard-URL: /api/sn_cdm/Changesets/commit-Status/{commit_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

{#chngsets-GET-commit-status__entry__2}{#chngsets-GET-commit-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 |
| Commit_ID | SYS_ID für die Commit-Anforderung, deren Status zurückgegeben werden soll. Dieser Wert wird von zurückgegeben [CdmChangesetsApi -- POST /sn_cdm/changesets/{changeset_ID}/commit](https://servicenow-prod.fluidtopics.net/OinXVlJXxuV2pn7lEH2vFQ#chngsets-POST-commit "Commits des angegebenen Changesets. Nach dem Commit wird das Changeset in den CDM-Tabellen in der zugehörigen Instanz beibehalten.")Endpunkt. Datentyp: Zeichenfolge |
[Tabelle : 19. Pfad-Parameter]

{#chngsets-GET-commit-status__entry__8}

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

{#chngsets-GET-commit-status__entry__12}

| 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.").
{#chngsets-GET-commit-status__entry__16}{#chngsets-GET-commit-status__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 22. Anforderungskopfzeilen.]

{#chngsets-GET-commit-status__entry__20}

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

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#chngsets-GET-commit-status__entry__24}{#chngsets-GET-commit-status__entry-200-status-code}{#chngsets-GET-commit-status__entry-400-status-code}{#chngsets-GET-commit-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 : 24. Statuscodes]

### Antworttext-Parameter

{#chngsets-GET-commit-status__entry__32}{#chngsets-GET-commit-status__cdm_apps-request_id-row}{#chngsets-GET-commit-status__cdm_apps-export_id-row}{#chngsets-GET-commit-status__cdm_apps-state-row}

| Name | Beschreibung |
|-|-|
| Commit_ID | Sys_ID des Commit-Anforderungsdatensatzes Identisch mit dem, der an den Endpunkt übergeben wurde. Datentyp: Zeichenfolge |
| 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: Objekt "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", "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 | Eindeutige Nummer des Changesets. Datentyp: Zeichenfolge |
| Ausgabe.Publish_Option | Veröffentlichungsoption für die zugehörigen konfigurierten Snapshots. Gültige Werte: * Publish_none: Veröffentlichen Sie keine Snapshots. * Publish_valid: Veröffentlichen Sie nur die Snapshots, die die Validierung nach dem Commit bestehen. 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 |
| Ausgabe.Snapshot_description | Beschreibung des zugeordneten Snapshots. Datentyp: Zeichenfolge |
| Ausgabe.Snapshot_Name | Name des zugeordneten Snapshots. Datentyp: Zeichenfolge |
| Ausgabe.Status | Status des Upload-Inhalts. Mögliche Werte: * Bestätigt * Abgeschlossen * error * in_progress * neu * Bereit {#chngsets-GET-commit-status__ul_qhn_w4p_psb} 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 Commit-Anforderung. Mögliche Werte: * NOT_PROCREED * VERARBEITET {#chngsets-GET-commit-status__ul_gmt_2pp_psb} Datentyp: Zeichenfolge |
| request_id | Anforderungs-ID. Entspricht dem, der an den Endpunkt und übergeben wurde commit_id. Datentyp: Zeichenfolge |
| Staat | Aktueller Status des angegebenen Commit. Mögliche Werte: * Abgeschlossen * error * in_progress * neu * Bereit Datentyp: Zeichenfolge Tabelle: Wert aus Statusspalte der Tabelle „CDM-Anforderungswarteschlange" \[sn_cdm_request_queue\]. |
| Typ | Typ der Anforderung. Mögliche Werte: * Commit * Exportieren * Upload_and_Commit Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Beispiel zeigt, wie dieser Endpunkt aufgerufen wird, um den Status des angegebenen Commit abzurufen.

    curl "http://instance.servicenow.com/api/sn_cdm/changesets/commit-status/bf506e69537c3010a1d3ddeeff7b12c0"\ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user 'username':'password' 

Im Folgenden finden Sie Beispiele für eine Erfolgs- und Fehlerantwort.


    // Successful response 

    { 
      "result": { 
        "type": "commit", 
        "state": "completed", 
        "output": { 
          "sys_id": "4a4407e953124110da35ddeeff7b1235", 
          "number": "Chset-1207", 
          "title": "admin064407e953124110da35ddeeff7b1235", 
          "description": "A description of my changeset provided during creation", 
          "committed_at": "2022-03-17 22:19:33", 
          "committed_by": "6816f79cc0a8016401c5a33be04be441", 
          "sys_created_by": "admin", 
          "state": "committed", 
          "publish_option": "publish_none", 
          "auto_validate": false, 
          "snapshot_name": null, 
          "snapshot_description": null, 
          "cdm_application": "DemoApp", 
          "last_conflict_detection_time": null 
        }, 
        "processing_state": "PROCESSED", 
        "commit_id": "9cd583e953124110da35ddeeff7b128a" 
      } 
    } 

     

    // Example of an error response 

    { 
      "result": { 
        "state": "error", 
        "errors": "Invalid requestId '9cd583e953124110da35ddeeff7b128'", 
        "commit_id": "9cd583e953124110da35ddeeff7b128" 
      } 
    } 

## CdmChangesetsApi -- GET /sn_cdm/Changesets/Impact-proviyables {#ariaid-title6}

Gibt die Liste der bereitstellbaren Elemente zurück, die einem angegebenen Changeset zugeordnet sind.
Für den Zugriff auf diesen Endpunkt ist die CDM-Viewer-Rolle erforderlich.

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Changesets/Impact-provisionables

Standard-URL: /api/sn_cdm/Changesets/Impact-provisionables  
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

{#chngsets-GET-impact-deploys__entry__2}{#chngsets-GET-impact-deploys__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]

{#chngsets-GET-impact-deploys__entry__6}{#chngsets-GET-impact-deploys__changesetNumber-changeset-entry}{#chngsets-GET-impact-deploys__cdm_apps-returnFields-entry}

| Name | Beschreibung |
|-|-|
| changesetNumber | Erforderlich. Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| returnFields | Liste der Felder, die als Teil der Antwort zurückgegeben werden sollen. Übergeben Sie die Namen der Datensatzspalte, z. B. sys_ID, sys_updated_by oder Status. Datentyp: Array Standard: Alle Felder, wie vom Endpunkt bestimmt |
[Tabelle : 26. Abfrageparameter]

{#chngsets-GET-impact-deploys__entry__12}

| 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.").
{#chngsets-GET-impact-deploys__entry__16}{#chngsets-GET-impact-deploys__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 28. Anforderungskopfzeilen.]

{#chngsets-GET-impact-deploys__entry__20}

| 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.").
{#chngsets-GET-impact-deploys__entry__24}{#chngsets-GET-impact-deploys__entry-200-status-code}{#chngsets-GET-impact-deploys__entry-400-status-code}{#chngsets-GET-impact-deploys__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

{#chngsets-GET-impact-deploys__id_lcm_5dn_qtb__entry__2}{#chngsets-GET-impact-deploys__cdm_app_link-app-entry}{#chngsets-GET-impact-deploys__cdm_app_value-app-entry}{#chngsets-GET-impact-deploys__cdm_apps-error-entry}{#chngsets-GET-impact-deploys__cdm_dep-sys_created_by-row}{#chngsets-GET-impact-deploys__cdm_deps-sys_created_on-row}{#chngsets-GET-impact-deploys__cdm_dep-sys_updated_by-row}{#chngsets-GET-impact-deploys__cdm_dep-sys_updated_on-row}

| Name | Beschreibung |
|-|-|
| cdi_count | Anzahl der Konfigurationsdatenelemente (CDIs), die in der zugehörigen CDM-Anwendung enthalten sind. Datentyp: Zahl (Ganzzahl) |
| cdi_usage | Prozentsatz der CDIs, die vom bereitstellbaren Element verwendet werden. Datentyp: Zahl (Ganzzahl) |
| cdm_App | CDM-Anwendungsobjekt, das dem bereitstellbaren Element zugeordnet ist. Datentyp: Objekt "cdm_app": { "link": "String", "value": "String" } |
| cdm_App.Link | Aufruf zur Verwendung für den Zugriff auf den CDM-Anwendungsdatensatz mit dem REST Tabelle API. Datentyp: Zeichenfolge |
| cdm_App.value | SYS_ID des zugehörigen CDM-Anwendungsdatensatzes. Datentyp: Zeichenfolge Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
| cdm_ci | Anwendungsserviceobjekt, das dem bereitstellbaren Element zugeordnet ist. Datentyp: Objekt "cdm_ci": { "link": "String", "value": "String" } |
| cdm_ci.Link | Aufruf zur Verwendung für den Zugriff auf den Anwendungsservice-Datensatz mit dem REST Tabelle API. Datentyp: Zeichenfolge |
| cdm_ci.value | SYS_ID des zugehörigen Anwendungsservice-Datensatzes. Datentyp: Zeichenfolge Tabelle: Konfigurationselement \[cmdb_ci\] |
| Beschreibung | Beschreibung des generierten bereitstellbaren CDM. Datentyp: Zeichenfolge |
| Environment_type | Umgebungstyp des bereitstellbaren Elements. Mögliche Werte: * Entwicklung * Produktion * Test Datentyp: Zeichenfolge |
| Fehler | Wird nur zurückgegeben, wenn während der Verarbeitung ein Fehler aufgetreten ist. 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 |
| name | Name des bereitstellbaren CDM. Datentyp: Zeichenfolge |
| Knoten | Details zum bereitstellbaren Knoten. Datentyp: Objekt "node": { "link": "String", "value": "String" } |
| Node.Link | Aufruf zur Verwendung für den Zugriff auf den Datensatz des bereitstellbaren Knotens mit dem REST Tabelle API. Datentyp: Zeichenfolge |
| Knoten.Wert | SYS_ID des Datensatzes des bereitstellbaren Knotens. Datentyp: Zeichenfolge Tabelle: CDM bereitstellbar \[sn_cdm_bereitstellbar\] |
| Snapshot_Version_Counter | Anzahl der Snapshots, die für das bereitstellbare Element erstellt wurden. Datentyp: Zahl (Ganzzahl) |
| Staat | Aktueller Status des bereitstellbaren Elements. Mögliche Werte: * aktiv * gelöscht Datentyp: Zeichenfolge |
| sys_created_by | Anwendername des Anwenders, der das bereitstellbare CDM erstellt hat. Beispiel: Able.tuter. Datentyp: Zeichenfolge |
| sys_created_on | Datum und Uhrzeit der Erstellung des bereitstellbaren CDM-Elements. Datentyp: Zeichenfolge Format: JJJJ-mm-TT hh:mm:ss |
| sys_id | SYS_ID des erstellten bereitstellbaren Elements. Datentyp: Zeichenfolge Tabelle: CDM bereitstellbar \[sn_cdm_bereitstellbar\] |
| sys_updated_by | Anwendername des Anwenders, der das bereitstellbare CDM zuletzt aktualisiert hat. Beispiel: Able.tuter. Datentyp: Zeichenfolge |
| sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung des bereitstellbaren CDM-Elements. Datentyp: Zeichenfolge Format: JJJJ-mm-TT hh:mm:ss |
[ ]

{#chngsets-GET-impact-deploys__id_lcm_5dn_qtb}  

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie die betroffenen bereitstellbaren Elemente für ein angegebenes Changeset abgerufen werden.

    curl "http://instance.servicenow.com/api/sn_cdm/changesets/impacted-deployables?changesetNumber=Chset-783" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

Ergebnisse zurückgeben:

    { 
      "result": [ 
        { 
          "cmdb_ci": { 
            "value": "75c5d7a953b70110a1d3ddeeff7b12a2", 
            "link": "http://instance.servicenow.com/api/now/table/cmdb_ci_service_auto/75c5d7a953b70110a1d3ddeeff7b12a2" 
          }, 
          "cdi_count": "2", 
          "snapshot_version_counter": "3", 
          "description": null, 
          "sys_updated_on": "2022-06-29 16:19:05", 
          "environment_type": "Development", 
          "node": { 
            "value": "a1c517a953b70110a1d3ddeeff7b129b", 
            "link": "http://instance.servicenow.com/api/now/table/sn_cdm_node/a1c517a953b70110a1d3ddeeff7b129b" 
          }, 
          "sys_id": "6dc517a953b70110a1d3ddeeff7b129b", 
          "sys_updated_by": "admin", 
          "cdm_app": { 
            "value": "62b517a953b70110a1d3ddeeff7b128c", 
            "link": "http://instance.servicenow.com/api/now/table/sn_cdm_application/62b517a953b70110a1d3ddeeff7b128c" 
          }, 
          "sys_created_on": "2022-05-31 13:03:23", 
          "cdi_usage": "0.02", 
          "name": "Development_1", 
          "state": "active", 
          "sys_created_by": "admin" 
        } 
      ] 
    }

## CdmChangesetsApi -- GET /sn_cdm/changesets/impacted-Shared-components {#ariaid-title7}

Gibt eine Liste der gemeinsam genutzten Komponenten zurück, die einem angegebenen Changeset zugeordnet sind.
Für den Zugriff auf diesen Endpunkt ist die CDM-Viewer-Rolle erforderlich.

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Changesets/Impact-Shared-components

Standard-URL: /api/sn_cdm/Changesets/Impact-Shared-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

{#chngsets-GET-impact_shared_comp__entry__2}{#chngsets-GET-impact_shared_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]

{#chngsets-GET-impact_shared_comp__entry__6}{#chngsets-GET-impact_shared_comp__changesetNumber-changeset-entry}{#chngsets-GET-impact_shared_comp__cdm_apps-returnFields-entry}

| Name | Beschreibung |
|-|-|
| changesetNumber | Erforderlich. Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| returnFields | Liste der Felder, die als Teil der Antwort zurückgegeben werden sollen. Übergeben Sie die Namen der Datensatzspalte, z. B. sys_ID, sys_updated_by oder Status. Datentyp: Array Standard: Alle Felder, wie vom Endpunkt bestimmt |
[Tabelle : 32. Abfrageparameter]

{#chngsets-GET-impact_shared_comp__entry__12}

| Name | Beschreibung |
|-|-|
| Keine |   |
[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.").
{#chngsets-GET-impact_shared_comp__entry__16}{#chngsets-GET-impact_shared_comp__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 34. Anforderungskopfzeilen.]

{#chngsets-GET-impact_shared_comp__entry__20}

| 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.").
{#chngsets-GET-impact_shared_comp__entry__24}{#chngsets-GET-impact_shared_comp__entry-200-status-code}{#chngsets-GET-impact_shared_comp__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Das übergebene Changeset ist nicht vorhanden. |
| 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

{#chngsets-GET-impact_shared_comp__entry__32}{#chngsets-GET-impact_shared_comp__cdm_apps-error-entry}{#chngsets-GET-impact_shared_comp__cdm_apps-error_detail-entry}{#chngsets-GET-impact_shared_comp__cdm_apps-error_message-entry}{#chngsets-GET-impact_shared_comp__cdm_dep-sys_created_by-row}{#chngsets-GET-impact_shared_comp__cdm_deps-sys_created_on-row}{#chngsets-GET-impact_shared_comp__cdm_dep-sys_updated_by-row}{#chngsets-GET-impact_shared_comp__cdm_dep-sys_updated_on-row}

| Name | Beschreibung |
|-|-|
| cdm_Shared__Library | SYS_ID der gemeinsamen Bibliothek, unter der sich die Komponente befindet. Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung der gemeinsam genutzten CDM-Komponente. Datentyp: Zeichenfolge |
| 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 |
| name | Name der gemeinsam genutzten CDM-Komponente. Datentyp: Zeichenfolge |
| Knoten | SYS_ID des Knotens der gemeinsam genutzten Komponente. Datentyp: Zeichenfolge Tabelle: CDM-Knoten \[sn_cdm_node\] |
| Node_Main | SYS_ID der Main_ID des Knotendatensatzes der gemeinsam genutzten Komponente. Datentyp: Zeichenfolge Tabelle: CDM-Knotenhauptbereich \[sn_cdm_node_main\] |
| Staat | Aktueller Status der gemeinsam genutzten Komponente. Mögliche Werte: * aktiv * gelöscht Datentyp: Zeichenfolge |
| sys_created_by | Anwendername des Anwenders, der die gemeinsam genutzte CDM-Komponente erstellt. Beispiel: Able.tuter. Datentyp: Zeichenfolge |
| sys_created_on | Datum und Uhrzeit der Erstellung der gemeinsam genutzten CDM-Komponente. Format: JJJJ-mm-TT hh:mm:ss Datentyp: Zeichenfolge |
| sys_id | SYS_ID der gemeinsam genutzten Komponente. Datentyp: Zeichenfolge Tabelle: Gemeinsam genutzte CDM-Komponente \[sn_cdm_shared_component\] |
| sys_updated_by | Anwendername des Anwenders, der die gemeinsam genutzte CDM-Komponente zuletzt aktualisiert hat. Beispiel: Able.tuter. Datentyp: Zeichenfolge |
| sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung der gemeinsam genutzten CDM-Komponente. Format: JJJJ-mm-TT hh:mm:ss Datentyp: Zeichenfolge |
| Versionszähler | Anzahl der für die gemeinsam genutzte Komponente erstellten Versionen. Datentyp: Ganzzahl |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie die betroffenen gemeinsam genutzten Komponenten für das Changeset = „Chset-20" abgerufen werden.

    curl "https://instance.servicenow.com/sn_cdm/changesets/impacted-shared-components?changesetNumber=Chset-20" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user 'username':'password' 

Antwort:

    {
      "result": [
        {
          "version_counter": "1",
          "description": null,
          "cdm_shared_library": "acb905e097b3991052687b890353afcd",
          "sys_updated_on": "2022-12-12 20:28:49",
          "node": "3cb945e097b3991052687b890353af0d",
          "sys_id": "34b945e097b3991052687b890353af20",
          "sys_updated_by": "john.jones",
          "node_main": "74b945e097b3991052687b890353af0d",
          "sys_created_on": "2022-12-12 20:28:39",
          "name": "logonService-V2.1",
          "state": "active",
          "sys_created_by": "john.jones"
        },
        {
          "version_counter": "1",
          "description": null,
          "cdm_shared_library": "acb905e097b3991052687b890353afcd",
          "sys_updated_on": "2022-12-12 20:28:49",
          "node": "b0b945e097b3991052687b890353af11",
          "sys_id": "30b945e097b3991052687b890353af21",
          "sys_updated_by": "john.jones",
          "node_main": "f8b945e097b3991052687b890353af10",
          "sys_created_on": "2022-12-12 20:28:39",
          "name": "logonService-V2.2",
          "state": "active",
          "sys_created_by": "john.jones"
        },
        {
          "version_counter": "1",
          "description": null,
          "cdm_shared_library": "acb905e097b3991052687b890353afcd",
          "sys_updated_on": "2022-12-12 20:28:49",
          "node": "6cb905e097b3991052687b890353afd3",
          "sys_id": "b4b945e097b3991052687b890353af21",
          "sys_updated_by": "john.jones",
          "node_main": "a4b905e097b3991052687b890353afd3",
          "sys_created_on": "2022-12-12 20:28:39",
          "name": "paymentService-V1.0",
          "state": "active",
          "sys_created_by": "john.jones"
        },
        {
          "version_counter": "1",
          "description": null,
          "cdm_shared_library": "acb905e097b3991052687b890353afcd",
          "sys_updated_on": "2022-12-12 20:28:49",
          "node": "e0b905e097b3991052687b890353aff1",
          "sys_id": "3cb945e097b3991052687b890353af21",
          "sys_updated_by": "john.jones",
          "node_main": "2cb905e097b3991052687b890353aff0",
          "sys_created_on": "2022-12-12 20:28:39",
          "name": "paymentService-V1.1",
          "state": "active",
          "sys_created_by": "john.jones"
        }
      ]
    }

## CdmChangesetsApi -- GET /sn_cdm/changesets/{changeset_ID}/Impacted-proviyables {#ariaid-title8}

Gibt die Liste der bereitstellbaren Elemente zurück, die einem angegebenen Changeset zugeordnet sind.

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Changesets/{Changeset_ID}/Impact-provisionables

Standard-URL: /api/sn_cdm/Changesets/{Changeset_ID}/Impact-bereitstellbare Elemente  
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

{#chngsets-GET-impacted-deployables__entry__2}{#chngsets-GET-impacted-deployables__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 |
| änderungssatz_ID | SYS_ID des zu verarbeitenden Changeset-Datensatzes. Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
[Tabelle : 37. Pfad-Parameter]

{#chngsets-GET-impacted-deployables__entry__8}

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

{#chngsets-GET-impacted-deployables__entry__12}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 39. 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.").
{#chngsets-GET-impacted-deployables__entry__16}{#chngsets-GET-impacted-deployables__accept-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
[Tabelle : 40. Anforderungskopfzeilen.]

{#chngsets-GET-impacted-deployables__entry__20}

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

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#chngsets-GET-impacted-deployables__entry__24}{#chngsets-GET-impacted-deployables__entry-200-status-code}{#chngsets-GET-impacted-deployables__entry-400-status-code}{#chngsets-GET-impacted-deployables__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 : 42. Statuscodes]

### Antworttext-Parameter

{#chngsets-GET-impacted-deployables__entry__32}

| Name | Beschreibung |
|-|-|
| änderungssatz_ID | SYS_ID des letzten Changesets, das dem bereitstellbaren Knoten zugeordnet ist. Datentyp: Zeichenfolge |
| Konflikt | Kennzeichnung, die angibt, ob das zugeordnete bereitstellbare Element in Konflikt steht. Mögliche Werte: * 0: Nicht in Konflikt. * 1: In Konflikt -- siehe conflict_typeErgebnis zurückgeben, um zusätzliche Informationen zu erhalten. {#chngsets-GET-impacted-deployables__ul_enr_rxd_btb} Datentyp: Zahl |
| Conflict_type | Typ des bereitstellbaren Konflikts. Mögliche Werte: * Corrupted_node * Deleted_node * Duplicate_node * Unvollständig_gelöscht_übergeordnet * Unvollständig_gelöscht_ref * Unvollständig_umbenannt_ref * INVALID_include * Verwaiste_descendant * Related_conflict * Unlinked_include * Unenamed_include * Updated_node {#chngsets-GET-impacted-deployables__ul_okw_dyd_btb} Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung des bereitstellbaren Knotens. Datentyp: Zeichenfolge |
| Effektiv_von | Zeitstempel, wenn der Knoten gültig ist. Dieser Wert ist Null Bis Sie ein Changeset bestätigen, in dem der Knoten erstellt wurde. Datentyp: Zahl |
| Effektiv_bis | Zeitstempel, wenn der Knoten nicht mehr gültig ist. Wenn dieser Wert ist Null , Der Knoten bleibt aktiv, bis er durch eine neue Version ersetzt wird. Datentyp: Zahl |
| 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 |
| level | Tiefe des Knotens ab Anwendungsebene, die 0 ist. Datentyp: Zahl |
| Linked_to | ID des Referenzknotens innerhalb einer Sammlung und Komponente. Das folgende Knotenfragment zeigt beispielsweise einen Link zwischen der Sammlungssammlung und der Komponentenkompa an. Für dieses Beispiel ist linkedToWert ist 1 : { components : {compA:{} //MainId: 1}, Collections : { collA : { compA :{} //Include, linkedTo: 1 } } } Datentyp: Zeichenfolge |
| Main_ID | Eindeutiger Bezeichner des bereitstellbaren Knotens. Dieser Wert wird generiert, wenn der Knoten erstellt und zur Identifizierung des bereitstellbaren Knotens verwendet wird. Datentyp: Zahl |
| Main_ID_encoded | Codierter Wert von mainIdErgebnisse mithilfe der Radix 57-Zeichenfolgendarstellung zurückgeben. Datentyp: Zeichenfolge |
| name | Name des bereitstellbaren Elements. Datentyp: Zeichenfolge |
| Node_Classifier | Knotenklassifizierung, z. B. Entwicklung, Produktion oder Test. Im Format: * /Application/proviyables/env:Development * /Application/proviyables/env:Production * /Application/proviyables/env:Test {#chngsets-GET-impacted-deployables__ul_fg5_ghd_btb} Datentyp: Zeichenfolge |
| position | Position des bereitstellbaren Knotens. Gilt nur für Arrays. Beispiel: Für das Array: node1:{ arrayNode: [{}, "literal1", "literal2", []] } {} ist Position 1000, „Literal1" ist Position 2000, „Literal2" ist Position 3000, \[\] ist Position 4000 Datentyp: Zahl |
| Vorherige_Version | SYS_ID der vorherigen Version des zugeordneten bereitstellbaren Knotens. Datentyp: Zeichenfolge |
| Restricted_to | Liste der sys_IDs der Anwender, die auf den zugehörigen bereitstellbaren Knoten zugreifen dürfen. Dieser Wert ist Null Ob alle Gruppen auf das bereitstellbare Element zugreifen können. Datentyp: Zeichenfolge Tabelle: Eingeschränkte CDM-Gruppen \[sn_cdm_restricted_groups\] |
| Secure_value | Sicherer Wert der CDI oder Variable. Nur für Blattknoten und Array-Literale zurückgegeben. Dies ist mit identisch valueErgebnis zurückgeben, aber verschlüsselt. Datentyp: Zeichenfolge |
| Status | Status des bereitstellbaren Knotens oder Status einer fehlgeschlagenen Anforderung. Mögliche Werte: * gelöscht * Fehler (erfolgreich, wenn der Endpunktaufruf fehlschlägt.) * neu * Ersetzt * aktualisiert * gültig {#chngsets-GET-impacted-deployables__ul_yjp_3gd_btb} Datentyp: Zeichenfolge |
| Systemordner | Kennzeichnung, die angibt, ob der zugeordnete Ordner ein Systemordner ist. Mögliche Werte: * 0: Kein Systemordner. * 1: Systemordner. {#chngsets-GET-impacted-deployables__ul_e3d_hwd_btb} Datentyp: Zahl |
| sys_id | SYS_ID des betroffenen bereitstellbaren Elements. Datentyp: Zeichenfolge |
| Typ | Knotentyp, z. B. sn_cdm_node_deployable. Mit diesem Wert können Sie bestimmen, ob der Knoten eine Komponente, ein Konfigurationsdatenelement (CDI) oder ein bereitstellbares Element ist. Dieser Wert wird generiert, wenn der Knoten erstellt wird. Datentyp: Zeichenfolge |
| Wert | Wert der CDI oder Variable. Nur für Blattknoten und Array-Literale zurückgegeben. Wenn diese Informationen verschlüsselt sind, werden sie in zurückgegeben secure_valueErgebnis zurückgeben. Beispiel: Wenn dieser Knoten die CDI ist `NodeA:{cdi1: 1} `, valueRückgabeergebnis ist 1 . Wenn es sich um einen Array-Knoten wie handelt `knoten1: {ArrayNode: [{}, „literal1", „literal2", []]} `, valueRückgabeergebnis ist Literal1 . Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Beispiel zeigt, wie die bereitstellbaren Elemente angefordert werden, die dem Changeset zugeordnet sind, dessen sys_ID bf506e69537c3010a1d3ddeeff7b12c0 lautet.

    curl "http://instance.servicenow.com/api/sn_cdm/changesets/bf506e69537c3010a1d3ddeeff7b12c0/impacted-deployables"\ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user 'username':'password' 

Folgendes zeigt sowohl eine erfolgreiche als auch eine Fehlerantwort für diesen Endpunkt.

    // Successful response
    {
      "result": [
        {
          "sys_id": "833527a953924110da35ddeeff7b12c1",
          "type": "sn_cdm_node_deployable",
          "main_id": "150",
          "main_id_encoded": "&M",
          "node_path": "!&@!&D!&M",
          "level": 2,
          "status": "valid",
          "node_classifier": "/application/deployables/env:Development",
          "position": null,
          "restricted_to": null,
          "changeset_id": "cb3527a953924110da35ddeeff7b12c0",
          "previous_version": "e8946f6953924110da35ddeeff7b1264",
          "effective_from": "1647563806950",
          "effective_to": null,
          "name": "Development_1",
          "description": "dev deployable decription",
          "value": null,
          "secure_value": null,
          "system_folder": "0",
          "linked_to": null,
          "conflict": "0",
          "conflict_type": null
        },
        {
          "sys_id": "a245e7a953924110da35ddeeff7b1223",
          "type": "sn_cdm_node_deployable",
          "main_id": "153",
          "main_id_encoded": "&P",
          "node_path": "!&@!&D!&P",
          "level": 2,
          "status": "valid",
          "node_classifier": "/application/deployables/env:Test",
          "position": null,
          "restricted_to": null,
          "changeset_id": "ea45e7a953924110da35ddeeff7b1222",
          "previous_version": "9505ef6953924110da35ddeeff7b121a",
          "effective_from": "1647563821422",
          "effective_to": null,
          "name": "Test_1",
          "description": "test deployable decription",
          "value": null,
          "secure_value": null,
          "system_folder": "0",
          "linked_to": null,
          "conflict": "0",
          "conflict_type": null
        }
      ]
    } 

    // Example of an error response
    {
      "error": {
        "message": "Error: Unexpected error occurred in create request.Error:Application not found",
        "detail": ""
      },
      "status": "failure"
    }

## CdmChangesetsApi -- POST /sn_cdm/changesets/{changeset_ID}/commit {#ariaid-title9}

Commits des angegebenen Changesets. Nach dem Commit wird das Changeset in den CDM-Tabellen in der zugehörigen Instanz beibehalten.
Das System aktualisiert die Anwendung, um die Änderungen an den Konfigurationsdaten im Changeset beizubehalten. Der Changeset-Status ändert sich in Bestätigt . Das System generiert dann einen Snapshot jedes bereitstellbaren Elements, das vom Changeset betroffen ist.

Dieser Endpunkt gibt die ID der Commit-Anforderung zurück. Verwenden Sie diese ID, um anzurufen [CdmChangesetsApi -- /sn_cdm/Changesets/commit-Status/{commit_ID} ABRUFEN](https://servicenow-prod.fluidtopics.net/OinXVlJXxuV2pn7lEH2vFQ#chngsets-GET-commit-status "Gibt den aktuellen Status der angegebenen Changeset-Commit-Anforderung zurück.")Endpunkt zum Abrufen des aktuellen Status des Changeset-Commits.

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Changesets/{Changeset_ID}/commit

Standard-URL: /api/sn_cdm/Changesets/{Changeset_ID}/commit  
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

{#chngsets-POST-commit__entry__2}{#chngsets-POST-commit__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 |
| änderungssatz_ID | SYS_ID des zu verarbeitenden Changeset-Datensatzes. Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
[Tabelle : 43. Pfad-Parameter]

{#chngsets-POST-commit__entry__8}

| Name | Beschreibung |
|-|-|
| Automatisch validieren | Kennzeichnung, die angibt, ob die beim Commit erstellten Snapshots validiert werden, was bedeutet, dass alle zugehörigen Richtlinien für den Snapshot ausgeführt werden. Gültige Werte: * Wahr: Validieren Sie die Snapshots. * Falsch: Validieren Sie die Snapshots nicht. {#chngsets-POST-commit__ul_aqt_zmb_psb} Standard: Falsch |
| PublishOption | Veröffentlichungsoption für die zugehörigen Konfigurations-Snapshots. Gültige Werte: * Publish_none: Veröffentlichen Sie keine Snapshots. * Publish_valid: Veröffentlichen Sie nur die Snapshots, die die Validierung nach dem Commit bestehen. Hinweis: Diese Option ist nur verfügbar, wenn der Wert für autoCommitParameter ist „wahr". 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 |
[Tabelle : 44. Abfrageparameter]

{#chngsets-POST-commit__entry__14}

| 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.").
{#chngsets-POST-commit__entry__18}{#chngsets-POST-commit__accept-JSON-only-entry-RESTAPI}{#chngsets-POST-commit__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 46. Anforderungskopfzeilen.]

{#chngsets-POST-commit__entry__24}

| 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.").
{#chngsets-POST-commit__entry__28}{#chngsets-POST-commit__entry-200-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Fehler: \<Error message\> Validieren Sie, dass changeset_idDer von Ihnen übergebene Parameter war korrekt. Stellen Sie sicher, dass Sie über die erforderlichen Rollen für den Zugriff auf diesen Endpunkt verfügen. |
| 500 | Interner Serverfehler: Ungültiger boolescher Wert. Wenn Sie bestanden haben autoValidateParameter: Stellen Sie sicher, dass es sich um einen booleschen Wert handelt. |
[Tabelle : 48. Statuscodes]

### Antworttext-Parameter

{#chngsets-POST-commit__id_bgt_byy_ztb__entry__2}

| Name | Beschreibung |
|-|-|
| Commit_ID | SYS_ID der Commit-Anforderung. Verwenden Sie diese ID, wenn Sie aufrufen [CdmChangesetsApi -- /sn_cdm/Changesets/commit-Status/{commit_ID} ABRUFEN](https://servicenow-prod.fluidtopics.net/OinXVlJXxuV2pn7lEH2vFQ#chngsets-GET-commit-status "Gibt den aktuellen Status der angegebenen Changeset-Commit-Anforderung zurück.")Endpunkt zum Überprüfen des Status der Commit-Anforderung. Datentyp: Zeichenfolge |
| 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 | Status des Commits. Wird nur zurückgegeben, wenn ein Fehler auftritt. Mögliche Werte: Fehler Datentyp: Zeichenfolge |
[ ]

{#chngsets-POST-commit__id_bgt_byy_ztb}  

### Curl-Anforderung

Das folgende Beispiel zeigt, wie dieser Endpunkt aufgerufen wird, um einen Changeset-Datensatz zu bestätigen.

    curl "http://instance.servicenow.com/api/sn_cdm/changesets/29e24001533030104bacddeeff7b120c/commit?publishOption=publish_valid"\ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \
    --user 'username':'password' 

Im Folgenden wird die Antwort für eine erfolgreiche Changeset-Commit-Anforderung angezeigt.

    // Successful response
    { 
      "result": { 
        "commit_id": "64b5f79f5379301096edddeeff7b12eb" 
      } 
    }

    // Example of an error response
    {
      "error": {
        "message": "Error: Unexpected error occurred in commit request.Error:Failed to insert request in queue",
        "detail": ""
      },
      "status": "failure"
    }

## CdmChangesetsApi -- POST /sn_cdm/changesets/create {#ariaid-title10}

Erstellt ein neues Changeset im Status „Offen" für eine angegebene CDM-Anwendung oder gemeinsame Bibliothek.
Für den Zugriff auf diesen Endpunkt ist die CDM-Editorrolle erforderlich.

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Changesets/create/

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

{#chngsets-POST-create__entry__2}{#chngsets-POST-create__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]

{#chngsets-POST-create__entry__6}{#chngsets-POST-create__appName-changesets-entry}

| Name | Beschreibung |
|-|-|
| appName | Erforderlich. Name der CDM-Anwendung oder gemeinsamen Bibliothek, die diesem Changeset zugeordnet werden soll. Dies muss eine aktive Anwendung oder eine gemeinsame Bibliothek sein. Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung des Änderungssatzes. Geben Sie etwas ein, mit dem andere den Zweck des Changesets verstehen können. Datentyp: Zeichenfolge Standard: Keine |
| returnFields | Kommagetrennte Liste von Feldern in der Tabelle „CDM-Änderungssatz" \[sn_cdm_Changeset\], die als Teil der Antwort zurückgegeben werden sollen. Datentyp: Zeichenfolge |
[Tabelle : 50. Abfrageparameter]

{#chngsets-POST-create__entry__14}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 51. 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.").
{#chngsets-POST-create__entry__18}{#chngsets-POST-create__accept-JSON-only-entry-RESTAPI}{#chngsets-POST-create__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 52. Anforderungskopfzeilen.]

{#chngsets-POST-create__entry__24}

| 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.").
{#chngsets-POST-create__entry__28}{#chngsets-POST-create__entry-200-status-code}{#chngsets-POST-create__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Fehler: \<Error message\> Stellen Sie sicher, dass die angegebene CDM-Anwendung oder gemeinsame Bibliothek vorhanden ist und sich im Status „aktiv" befindet. |
| 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

{#chngsets-POST-create__entry__36}

| Name | Beschreibung |
|-|-|
| auto_validate | Kennzeichnung, die angibt, ob die automatische Validierung durchgeführt wurde. Mögliche Werte: * Wahr: Automatische Validierung wurde durchgeführt. * Falsch: Automatische Validierung wurde nicht vorformatiert. Datentyp: Boolescher Wert |
| cdm_Application | Details zur CDM-Anwendung, die dem Changeset zugeordnet ist. Datentyp: Objekt "cdm_application": { "link": "String", "value": "String" } Beispiel: `{"value": "<sysId>", "Link": "http://localhost:8081/api/now/table/*'}" ` |
| cdm_Application.Link | URL der zugeordneten CDM-Anwendung. Datentyp: Zeichenfolge |
| cdm_Application.value | SYS_ID der zugeordneten CDM-Anwendung. Datentyp: Zeichenfolge |
| Commit_at | Datum und Uhrzeit, zu der das Changeset im zugehörigen Repository festgeschrieben wurde. Datentyp: Zeichenfolge |
| Commit_by | SYS_ID der Entität, die das Changeset erstellt hat. Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung des Changesets, wie beim Aufruf des Endpunkts übergeben. Datentyp: Zeichenfolge |
| 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 |
| last_conflict_detection_time | Letztes Mal, als die Konflikterkennung ausgeführt wurde. Datentyp: Zahl Einheit: Millisekunden |
| Nummer | Eindeutiger Bezeichner für das neue Changeset. Datentyp: Zeichenfolge |
| publish_option | Veröffentlichungsoption für die zugehörigen konfigurierten Snapshots. Gültige Werte: * Publish_none: Veröffentlichen Sie keine Snapshots. * Publish_valid: Veröffentlichen Sie nur die Snapshots, die die Validierung nach dem Commit bestehen. 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 |
| snapshot_description | Beschreibung des Snapshots, der dem Changeset zugeordnet ist. Datentyp: Zeichenfolge |
| Staat | Status der Changeset-Erstellung. Mögliche Werte: * Blockiert * Überprüfung auf Konflikte * Commit fehlgeschlagen * Commit wird ausgeführt * Committet * Offen Datentyp: Zeichenfolge |
| Status | Status der Changeset-Erstellung. Wird nur zurückgegeben, wenn ein Fehler auftritt. Mögliche Werte: Fehler Datentyp: Zeichenfolge |
| sys_created_by | SYS_ID der Entität, die den Changeset-Datensatz erstellt hat. Datentyp: Zeichenfolge |
| sys_id | SYS_ID des neuen Changesets. Datentyp: Zeichenfolge |
| Titel | Titel des Changesets, das der Anwendung zugeordnet ist. Wird normalerweise vom System automatisch generiert. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Beispiel zeigt, wie ein Changeset erstellt wird, das der CDM-Anwendung „App Service1" zugeordnet ist.

    curl "http://instance.servicenow.com/api/sn_cdm/changesets/create?appName=App%20Service1&description=Sample%20Description \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \
    --user 'username':'password' 

Im Folgenden wird die Antwort für eine erfolgreiche Erstellung des Changesets angezeigt.

    // Example of a successful response
    {   
    "result": { 
        "sys_id": "42748779c370301054c1582e1340ddcd",
        "number": "Chset-8",
        "title": "admin2021-06-18 10:06:46",
        "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": "App%20Service1" 
      } 
    }

    // Example of an error response
    {
      "error": {
        "message": "Error: Unexpected error occurred in create request.Error:Application not found",
        "detail": ""
      },
      "status": "failure"
    }

### Curl-Anforderung

Das folgende Beispiel zeigt, wie ein Changeset für die gemeinsame Bibliothek „Javalib" erstellt wird.

    curl "http://instance.servicenow.com/api/sn_cdm/changesets/create?sharedLibraryName=javalib&description=description of changeset" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'  

Antwort:

```

```

## CdmChangesetsApi -- PUT /sn_cdm/Changesets/commit {#ariaid-title11}

Aktualisiert ein angegebenes Changeset und Commits.
Das System aktualisiert die Anwendung, um die Änderungen an den Konfigurationsdaten im Changeset beizubehalten. Der Changeset-Status ändert sich in Bestätigt . Das System generiert dann einen Snapshot jedes bereitstellbaren Elements, das vom Changeset betroffen ist.

Dieser Endpunkt gibt die ID der Commit-Anforderung zurück. Verwenden Sie diese ID, um anzurufen [CdmChangesetsApi -- /sn_cdm/Changesets/commit-Status/{commit_ID} ABRUFEN](https://servicenow-prod.fluidtopics.net/OinXVlJXxuV2pn7lEH2vFQ#chngsets-GET-commit-status "Gibt den aktuellen Status der angegebenen Changeset-Commit-Anforderung zurück.")Endpunkt zum Abrufen des aktuellen Status des Changeset-Commits.

### URL-Format

Versionierte URL: /api/sn_cdm/{api_Version}/Changesets/{Changeset_ID}/commit

Standard-URL: /api/sn_cdm/Changesets/{Changeset_ID}/commit  
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

{#chngsets-PUT-commit__entry__2}{#chngsets-PUT-commit__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 55. Pfad-Parameter]

{#chngsets-PUT-commit__entry__6}{#chngsets-PUT-commit__autoValidate-changeset-entry}{#chngsets-PUT-commit__changesetNumber-changeset-entry}

| Name | Beschreibung |
|-|-|
| Automatisch validieren | Kennzeichnung, die angibt, ob die während des Commits erstellten Snapshots validiert werden, was bedeutet, dass alle zugehörigen Richtlinien für den Snapshot ausgeführt werden. Gültige Werte: * Wahr: Validieren Sie die Snapshots. * Falsch: Snapshots nicht validieren. Datentyp: Boolescher Wert Standard: Falsch |
| changesetNumber | Erforderlich. Eindeutiger Bezeichner des zugeordneten Changesets, z. B. „Chset-10". Datentyp: Zeichenfolge Tabelle: CDM-Änderungssatz \[sn_cdm_Changeset\] |
| PublishOption | Veröffentlichungsoption für die zugehörigen konfigurierten Snapshots. Gültige Werte: * Publish_none: Veröffentlichen Sie keine Snapshots. * Publish_valid: Veröffentlichen Sie nur die Snapshots, die die Validierung nach dem Commit bestehen. 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 |
[Tabelle : 56. Abfrageparameter]

{#chngsets-PUT-commit__entry__14}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 57. 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.").
{#chngsets-PUT-commit__entry__18}{#chngsets-PUT-commit__accept-JSON-only-entry-RESTAPI}{#chngsets-PUT-commit__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 58. Anforderungskopfzeilen.]

{#chngsets-PUT-commit__entry__24}

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

### Statuscodes

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

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Fehler: \<Error message\> Validieren Sie, dass changeset_idDer von Ihnen übergebene Parameter war korrekt. Stellen Sie sicher, dass Sie über die erforderlichen Rollen für den Zugriff auf diesen Endpunkt verfügen. |
| 500 | Interner Serverfehler: Ungültiger boolescher Wert. Wenn Sie bestanden haben autoValidateParameter: Stellen Sie sicher, dass es sich um einen booleschen Wert handelt. |
[Tabelle : 60. Statuscodes]

### Antworttext-Parameter

{#chngsets-PUT-commit__id_cjx_1yy_ztb__entry__2}

| Name | Beschreibung |
|-|-|
| Commit_ID | SYS_ID der Commit-Anforderung. Verwenden Sie diese ID, wenn Sie aufrufen [CdmChangesetsApi -- /sn_cdm/Changesets/commit-Status/{commit_ID} ABRUFEN](https://servicenow-prod.fluidtopics.net/OinXVlJXxuV2pn7lEH2vFQ#chngsets-GET-commit-status "Gibt den aktuellen Status der angegebenen Changeset-Commit-Anforderung zurück.")Endpunkt zum Überprüfen des Status der Commit-Anforderung. Datentyp: Zeichenfolge |
| 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 | Status des Commits. Wird nur zurückgegeben, wenn ein Fehler auftritt. Mögliche Werte: Fehler Datentyp: Zeichenfolge |
[ ]

{#chngsets-PUT-commit__id_cjx_1yy_ztb}  

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie dieser Endpunkt zum Aktualisieren eines Changesets verwendet wird.

    curl "http://instance.servicenow.com/api/sn_cdm/changesets/commit?changesetNumber=Chset-146" \ 
    --request PUT \ 
    --header "Accept:application/json" \ 
    --user 'username':'password'

Ergebnisse zurückgeben:

    { 
      "result": { 
        "commit_id": "cca8190f53141110a1d3ddeeff7b129e" 
      } 
    }


