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


---

# Kontinuierliche Integration und kontinuierliche Bereitstellung (CICD) Update-Satz-API

# Kontinuierliche Integration und kontinuierliche Bereitstellung (CICD) Update-Satz-API {#ariaid-title1}

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

Die CICD-Update-Satz Die API bietet Methoden zum Erstellen, Abrufen, Vorschauen, Commit und Zurücksetzen eines Update-Satzes.
Diese API ist den Aktionen zugeordnet, die Sie ausführen können [System-Update-Sätze](https://www.servicenow.com/docs/access?context=system-update-sets&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US)Und erfordert die sn_cicd.sys_ci_automation-Rolle und REST API für kontinuierliche Integration und kontinuierliche Bereitstellung (CICD)Plugin (com.Glide.continuousDelivery), um darauf zuzugreifen.

## CICD-Update-Satz -- POST /api/sn_cicd/Update_Set/Retrieve {#ariaid-title2}

Ruft einen Update-Satz mit einer bestimmten sys_ID ab und ermöglicht es Ihnen, den vorhandenen abgerufenen Update-Satz aus der Instanz zu entfernen.

### URL-Format

Versionierte URL: /api/sn_cicd/{api_Version}/Update_Set/Retrieve

Standard-URL: /api/sn_cicd/Update_Set/Retrieve  
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

{#cicd-update-set-POST-retrieve__entry__2}{#cicd-update-set-POST-retrieve__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]

{#cicd-update-set-POST-retrieve__entry__6}

| Name | Beschreibung |
|-|-|
| update_set_id | Erforderlich. SYS_ID des Update-Satzes in der Quellinstanz, aus der der Update-Satz abgerufen wurde. Tabelle: Update-Sätze \[sys_Update_Set\] Datentyp: Zeichenfolge |
| Update_Source_ID | SYS_ID des Remote-Instanzdatensatzes. Tabelle: Remote-Instanzen \[sys_update_set_source\] Datentyp: Zeichenfolge |
| update_source_instance_id | Instanz-ID der Remote-Instanz. Tabelle: Remote-Instanzen \[sys_update_set_source\] Datentyp: Zeichenfolge |
| auto_Preview | Kennzeichnung, die angibt, ob der Update-Satz nach dem Abruf automatisch in der Vorschau angezeigt werden soll. Gültige Werte: * Wahr: Vorschau des Update-Satzes beim Abruf anzeigen. * Falsch: Zeigen Sie beim Abrufen keine Vorschau des Update-Satzes an. {#cicd-update-set-POST-retrieve__ul_flv_lfx_qdc} Datentyp: Boolescher Wert Standard: Falsch |
| Cleanup_Retrieved | Kennzeichnung, die angibt, ob der vorhandene abgerufene Update-Satz aus der Instanz entfernt werden soll. Gültige Werte: * Wahr: Entfernen Sie den Update-Satz. * Falsch: Entfernen Sie den Update-Satz nicht {#cicd-update-set-POST-retrieve__ul_ysn_nfx_qdc} Datentyp: Boolescher Wert Standard: Falsch |
[Tabelle : 2. Abfrageparameter]

{#cicd-update-set-POST-retrieve__entry__18}

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

### Header

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

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

{#cicd-update-set-POST-retrieve__table_tq1_qdy_qdc}

### 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.").
{#cicd-update-set-POST-retrieve__entry__26}{#cicd-update-set-POST-retrieve__entry-200-status-code}{#cicd-update-set-POST-retrieve__entry-400-status-code}{#cicd-update-set-POST-retrieve__entry-401-status-code}{#cicd-update-set-POST-retrieve__entry-403-status-code}{#cicd-update-set-POST-retrieve__entry-404-status-code}{#cicd-update-set-POST-retrieve__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. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 403 | Unzulässig. Der Anwender hat keine Zugriffsrechte für den angegebenen Datensatz. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 5. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#cicd-update-set-POST-retrieve__table_lxy_pbx_qdc__entry__2}{#cicd-update-set-POST-retrieve__entry-error}{#cicd-update-set-POST-retrieve__entry-link}{#cicd-update-set-POST-retrieve__entry-links_progress}{#cicd-update-set-POST-retrieve__entry-progress_id}{#cicd-update-set-POST-retrieve__entry-progress_url}{#cicd-update-set-POST-retrieve__entry-percent_complete}{#cicd-update-set-POST-retrieve__entry-status}{#cicd-update-set-POST-retrieve__entry-status_detail}{#cicd-update-set-POST-retrieve__entry-status_label}{#cicd-update-set-POST-retrieve__entry-status_message}

| Name | Beschreibung |
|-|-|
| Fehler | Fehlermeldung mit Details zum Fehler. Datentyp: Zeichenfolge |
| Links | Informationen zu Links und sys_IDs, die dem Update-Satz zugeordnet sind. Datentyp: Objekt "links": { "progress": {Object} } |
| links.progress | Fortschrittsinformationen zum Vorgang, der für den Update-Satz ausgeführt wird. Datentyp: Objekt "progress": { "id": "String", "url": "String" } |
| links.progress.id | SYS_ID mit Fortschrittsdetails für den Vorgang. Sie können diesen Wert beim Aufrufen des Endpunkts verwenden [CI/CD -- GET /sn_cicd/Progress/{Progress_ID}](https://servicenow-prod.fluidtopics.net/wfuU1cAejhpsx_m6Ak2YCw#cicd-GET-progress "Gibt den aktuellen Fortschritt und Status von zurück Kontinuierliche Integration und kontinuierliche Bereitstellung (CICD)Funktion, die einer angegebenen Fortschritts-ID zugeordnet ist."). Datentyp: Zeichenfolge |
| links.progress.url | URL, die zum Abrufen der Fortschrittsdetails zum Vorgang verwendet werden soll, der für den Update-Satz ausgeführt wird. Datentyp: Zeichenfolge |
| percent_complete | Prozentsatz der abgeschlossenen Anforderung. Datentyp: Zahl |
| Status | Zahl, die den Ausführungsstatus der Aktion darstellt, die für den Update-Satz ausgeführt wird. Entspricht status_labelDeskriptor. Mögliche Werte: * 0: Ausstehend * 1: Wird Ausgeführt * 2: Erfolgreich * 3: Fehlgeschlagen * 4: Abgebrochen Datentyp: Zeichenfolge |
| status_detail | Detaillierte Nachricht zum Ausführungsstatus, falls verfügbar. Entspricht dem Feld „Detailed_message" in der Tabelle „Ausführungstracker" \[sys_Execution_Tracker\]. Datentyp: Zeichenfolge |
| status_label | Ausführungsstatus der Update-Satz-Aktion. Entspricht statusNummer. Mögliche Werte: * Abgebrochen * Fehlgeschlagen * Ausstehend * Wird ausgeführt * Erfolgreich Datentyp: Zeichenfolge |
| status_message | Zusätzliche Beschreibung des aktuellen Status der Aktion, falls verfügbar. Datentyp: Zeichenfolge |
[ ]

{#cicd-update-set-POST-retrieve__table_lxy_pbx_qdc}  

### Curl-Anforderung

Das folgende Beispiel ruft einen bestimmten Update-Satz mit einer bestimmten sys_ID und Instanz-ID ab.

    curl 
    "https://instance.servicenow.com/api/sn_cicd/update_set/retrieve?update_set_id=2ce715950d619e10f87785462179bd67&update_source_id=e66613a49d011210f877036c70ae59f7" \
    --request POST \
    --header "Accept:application/json" \
    --user 'username':'password'

Antworttext. Zeigt Details zum aktuellen Status des Update-Satzes und zum Ausführungsfortschritt an.

    {
      "result": {
        "links": {
          "progress": {
            "id": "e2ea3eedc92dde10f877184664aecd90",
            "url": "https://instance.servicenow.com/api/sn_cicd/progress/e2ea3eedc92dde10f877184664aecd90"
          }
        },
        "status": "0",
        "status_label": "Pending",
        "status_message": "",
        "status_detail": "",
        "error": "",
        "percent_complete": 0
      }
    }   

## CICD-Update-Satz -- POST /api/sn_cicd/Update_Set/commit Multiple {#ariaid-title3}

Commits mehrerer Update-Sätze in einer einzelnen Anforderung gemäß der angegebenen Reihenfolge.

### URL-Format

Versionierte URL: /api/sn_cicd/{api_Version}/Update_Set/commit Multiple

Standard-URL: /api/sn_cicd/Update_Set/commit Multiple  
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

{#cicd-update-set-POST-commitMultiple__entry__2}{#cicd-update-set-POST-commitMultiple__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 : 6. Pfad-Parameter]

{#cicd-update-set-POST-commitMultiple__entry__6}

| Name | Beschreibung |
|-|-|
| remote_update_set_ids | Erforderlich. Liste der sys_IDs, die allen zu bestätigenden Update-Sätzen zugeordnet sind. SYS_IDs werden in der in der Anforderung angegebenen Reihenfolge bestätigt. Hinweis: Sie können verwenden [CI/CD -- GET /sn_cicd/Progress/{Progress_ID}](https://servicenow-prod.fluidtopics.net/wfuU1cAejhpsx_m6Ak2YCw#cicd-GET-progress "Gibt den aktuellen Fortschritt und Status von zurück Kontinuierliche Integration und kontinuierliche Bereitstellung (CICD)Funktion, die einer angegebenen Fortschritts-ID zugeordnet ist.")Endpunkt zum Abrufen der Remote-Update-Satz-ID. Datentyp: Zeichenfolge Tabelle: Abgerufene Update-Sätze \[sys_remote_update_set\] |
[Tabelle : 7. Abfrageparameter]

{#cicd-update-set-POST-commitMultiple__entry__10}

| Name | Beschreibung |
|-|-|
| Force_commit | Kennzeichnung, die angibt, ob das Commit des Update-Satzes erzwungen werden soll. Diese Funktion ist nützlich, wenn einige in der Eingabe angegebene Remote-Update-Sätze bereits in einem früheren Vorgang bestätigt wurden. Diese Funktion stellt auch sicher, dass die Commit-Reihenfolge in der Reihenfolge befolgt wird, in der die Update-Sätze angegeben werden. Gültige Werte: * Wahr: Commits des Update-Satzes erzwingen. * Falsch: Erzwingt das Commit des Update-Satzes nicht. Wenn der Commit nicht erzwungen wird, schlägt der Commit fehl, wenn die Commit-Reihenfolge nicht befolgt wird. {#cicd-update-set-POST-commitMultiple__ul_uvd_hjk_12c} Datentyp: Zeichenfolge Standard: Falsch |
[Tabelle : 8. 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.").
{#cicd-update-set-POST-commitMultiple__entry__14}{#cicd-update-set-POST-commitMultiple__accept-RESTAPI}{#cicd-update-set-POST-commitMultiple__content_type-RESTAPI}

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

{#cicd-update-set-POST-commitMultiple__entry__20}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 10. Antwort-Header]

### Statuscodes

{#cicd-update-set-POST-commitMultiple__table_s54_4bx_qdc__entry__2}{#cicd-update-set-POST-commitMultiple__entry-200-status-code}{#cicd-update-set-POST-commitMultiple__entry-400-status-code}{#cicd-update-set-POST-commitMultiple__entry-401-status-code}{#cicd-update-set-POST-commitMultiple__entry-403-status-code}{#cicd-update-set-POST-commitMultiple__entry-404-status-code}{#cicd-update-set-POST-commitMultiple__entry-409-status-code}{#cicd-update-set-POST-commitMultiple__entry-500-status-code}

| Name | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Die Anwenderanmeldeinformationen sind falsch. |
| 403 | Unzulässig. Der Anwender ist kein Administrator oder hat keine sn_cicd.sys_ci_automation-Rolle. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 409 | Konflikt. Das angeforderte Element ist nicht eindeutig. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. |
[Tabelle : 11. Statuscodes]

{#cicd-update-set-POST-commitMultiple__table_s54_4bx_qdc}

### Antworttext-Parameter (JSON oder XML) {#cicd-update-set-POST-commitMultiple__section_kxy_pbx_qdc}

{#cicd-update-set-POST-commitMultiple__table_lxy_pbx_qdc__entry__2}{#cicd-update-set-POST-commitMultiple__entry-error}{#cicd-update-set-POST-commitMultiple__entry-link}{#cicd-update-set-POST-commitMultiple__entry-links_progress}{#cicd-update-set-POST-commitMultiple__entry-progress_id}{#cicd-update-set-POST-commitMultiple__entry-progress_url}{#cicd-update-set-POST-commitMultiple__entry-percent_complete}{#cicd-update-set-POST-commitMultiple__entry-status}{#cicd-update-set-POST-commitMultiple__entry-status_detail}{#cicd-update-set-POST-commitMultiple__entry-status_label}{#cicd-update-set-POST-commitMultiple__entry-status_message}

| Name | Beschreibung |
|-|-|
| Fehler | Fehlermeldung mit Details zum Fehler. Datentyp: Zeichenfolge |
| Links | Informationen zu Links und sys_IDs, die dem Update-Satz zugeordnet sind. Datentyp: Objekt "links": { "progress": {Object} } |
| links.progress | Fortschrittsinformationen zum Vorgang, der für den Update-Satz ausgeführt wird. Datentyp: Objekt "progress": { "id": "String", "url": "String" } |
| links.progress.id | SYS_ID mit Fortschrittsdetails für den Vorgang. Sie können diesen Wert beim Aufrufen des Endpunkts verwenden [CI/CD -- GET /sn_cicd/Progress/{Progress_ID}](https://servicenow-prod.fluidtopics.net/wfuU1cAejhpsx_m6Ak2YCw#cicd-GET-progress "Gibt den aktuellen Fortschritt und Status von zurück Kontinuierliche Integration und kontinuierliche Bereitstellung (CICD)Funktion, die einer angegebenen Fortschritts-ID zugeordnet ist."). Datentyp: Zeichenfolge |
| links.progress.url | URL, die zum Abrufen der Fortschrittsdetails zum Vorgang verwendet werden soll, der für den Update-Satz ausgeführt wird. Datentyp: Zeichenfolge |
| percent_complete | Prozentsatz der abgeschlossenen Anforderung. Datentyp: Zahl |
| Status | Zahl, die den Ausführungsstatus der Aktion darstellt, die für den Update-Satz ausgeführt wird. Entspricht status_labelDeskriptor. Mögliche Werte: * 0: Ausstehend * 1: Wird Ausgeführt * 2: Erfolgreich * 3: Fehlgeschlagen * 4: Abgebrochen Datentyp: Zeichenfolge |
| status_detail | Detaillierte Nachricht zum Ausführungsstatus, falls verfügbar. Entspricht dem Feld „Detailed_message" in der Tabelle „Ausführungstracker" \[sys_Execution_Tracker\]. Datentyp: Zeichenfolge |
| status_label | Ausführungsstatus der Update-Satz-Aktion. Entspricht statusNummer. Mögliche Werte: * Abgebrochen * Fehlgeschlagen * Ausstehend * Wird ausgeführt * Erfolgreich Datentyp: Zeichenfolge |
| status_message | Zusätzliche Beschreibung des aktuellen Status der Aktion, falls verfügbar. Datentyp: Zeichenfolge |
[ ]

{#cicd-update-set-POST-commitMultiple__table_lxy_pbx_qdc}  

### Curl-Anforderung

Das folgende Beispiel zeigt, wie ein Update mit einer bestimmten sys_ID bestätigt wird

    curl 
    "https://instance.servicenow.com/api/sn_cicd/update_set/commitMultiple?remote_update_set_ids=0a9f45ab9d415e10f877036c70ae5968%2Cc2e89999c9e19e10f877184664aecd40" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{\"force_commit\":\"true\"}" \
    --user 'username':'password'

Antworttext.

    {
      "result": {
        "links": {
          "progress": {
            "id": "3d174aa1c969de10f877184664aecdc0",
            "url": "https://instance.servicenow.com/api/sn_cicd/progress/3d174aa1c969de10f877184664aecdc0"
          }
        },
        "status": "0",
        "status_label": "Pending",
        "status_message": "",
        "status_detail": "",
        "error": "",
        "percent_complete": 0
      }
    }

## CICD-Update-Satz -- POST /api/sn_cicd/Update_Set/preview/{remote_update_set_id} {#ariaid-title4}

Zeigt eine Vorschau eines Update-Satzes an, um nach Konflikten zu suchen und Fortschrittsinformationen zum Update-Satz-Vorgang abzurufen.
Hinweis:  
Wenn der Update-Satz, den Sie in der Vorschau anzeigen möchten, in der Instanz nicht vorhanden ist, müssen Sie zuerst verwenden [CICD-Update-Satz -- POST /api/sn_cicd/Update_Set/Retrieve](https://servicenow-prod.fluidtopics.net/hxVTZ7M0gSBMpRnUL0MxVQ#cicd-update-set-POST-retrieve "Ruft einen Update-Satz mit einer bestimmten sys_ID ab und ermöglicht es Ihnen, den vorhandenen abgerufenen Update-Satz aus der Instanz zu entfernen.")Endpunkt zum Abrufen des Update-Satzes oder manuell in der Anwenderoberfläche.

### URL-Format

Versionierte URL: /api/sn_cicd/{api_Version}/Update_Set/preview/{remote_update_set_id}

Standard-URL: /api/sn_cicd/Update_Set/preview/{remote_update_set_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

{#cicd-update-set-POST-preview__entry__2}{#cicd-update-set-POST-preview__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 |
| remote_update_set_id | SYS_ID des Update-Satzes, der in der Vorschau angezeigt werden soll. Tabelle: Abgerufene Update-Sätze \[sys_remote_update_set\] Datentyp: Zeichenfolge |
[Tabelle : 12. Pfad-Parameter]

{#cicd-update-set-POST-preview__entry__8}

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

{#cicd-update-set-POST-preview__entry__12}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 14. 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.").
{#cicd-update-set-POST-preview__table_rbg_n2y_qdc__entry__2}{#cicd-update-set-POST-preview__accept-RESTAPI}{#cicd-update-set-POST-preview__content_type-RESTAPI}

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

{#cicd-update-set-POST-preview__table_rbg_n2y_qdc} {#cicd-update-set-POST-preview__entry__22}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 16. 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.").
{#cicd-update-set-POST-preview__entry__26}{#cicd-update-set-POST-preview__entry-200-status-code}{#cicd-update-set-POST-preview__entry-400-status-code}{#cicd-update-set-POST-preview__entry-401-status-code}{#cicd-update-set-POST-preview__entry-403-status-code}{#cicd-update-set-POST-preview__entry-404-status-code}{#cicd-update-set-POST-preview__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. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 403 | Unzulässig. Der Anwender hat keine Zugriffsrechte für den angegebenen Datensatz. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 17. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#cicd-update-set-POST-preview__table_lxy_pbx_qdc__entry__2}{#cicd-update-set-POST-preview__entry-error}{#cicd-update-set-POST-preview__entry-link}{#cicd-update-set-POST-preview__entry-links_progress}{#cicd-update-set-POST-preview__entry-progress_id}{#cicd-update-set-POST-preview__entry-progress_url}{#cicd-update-set-POST-preview__entry-percent_complete}{#cicd-update-set-POST-preview__entry-status}{#cicd-update-set-POST-preview__entry-status_detail}{#cicd-update-set-POST-preview__entry-status_label}{#cicd-update-set-POST-preview__entry-status_message}

| Name | Beschreibung |
|-|-|
| Fehler | Fehlermeldung mit Details zum Fehler. Datentyp: Zeichenfolge |
| Links | Informationen zu Links und sys_IDs, die dem Update-Satz zugeordnet sind. Datentyp: Objekt "links": { "progress": {Object} } |
| links.progress | Fortschrittsinformationen zum Vorgang, der für den Update-Satz ausgeführt wird. Datentyp: Objekt "progress": { "id": "String", "url": "String" } |
| links.progress.id | SYS_ID mit Fortschrittsdetails für den Vorgang. Sie können diesen Wert beim Aufrufen des Endpunkts verwenden [CI/CD -- GET /sn_cicd/Progress/{Progress_ID}](https://servicenow-prod.fluidtopics.net/wfuU1cAejhpsx_m6Ak2YCw#cicd-GET-progress "Gibt den aktuellen Fortschritt und Status von zurück Kontinuierliche Integration und kontinuierliche Bereitstellung (CICD)Funktion, die einer angegebenen Fortschritts-ID zugeordnet ist."). Datentyp: Zeichenfolge |
| links.progress.url | URL, die zum Abrufen der Fortschrittsdetails zum Vorgang verwendet werden soll, der für den Update-Satz ausgeführt wird. Datentyp: Zeichenfolge |
| percent_complete | Prozentsatz der abgeschlossenen Anforderung. Datentyp: Zahl |
| Status | Zahl, die den Ausführungsstatus der Aktion darstellt, die für den Update-Satz ausgeführt wird. Entspricht status_labelDeskriptor. Mögliche Werte: * 0: Ausstehend * 1: Wird Ausgeführt * 2: Erfolgreich * 3: Fehlgeschlagen * 4: Abgebrochen Datentyp: Zeichenfolge |
| status_detail | Detaillierte Nachricht zum Ausführungsstatus, falls verfügbar. Entspricht dem Feld „Detailed_message" in der Tabelle „Ausführungstracker" \[sys_Execution_Tracker\]. Datentyp: Zeichenfolge |
| status_label | Ausführungsstatus der Update-Satz-Aktion. Entspricht statusNummer. Mögliche Werte: * Abgebrochen * Fehlgeschlagen * Ausstehend * Wird ausgeführt * Erfolgreich Datentyp: Zeichenfolge |
| status_message | Zusätzliche Beschreibung des aktuellen Status der Aktion, falls verfügbar. Datentyp: Zeichenfolge |
[ ]

{#cicd-update-set-POST-preview__table_lxy_pbx_qdc}  

### Curl-Anforderung

Das folgende Beispiel zeigt, wie Sie eine Vorschau eines Remote-Update-Satzes mit einer bestimmten ID anzeigen.

    curl 
    curl "https://instance.servicenow.com/api/sn_cicd/update_set/preview/8f4608d39d89da10f877036c70ae5998" \
    --request POST \
    --header "Accept:application/json" \
    --user 'username':'password'

Antworttext.

    {
      "result": {
        "links": {
          "progress": {
            "id": "54e9c665c969de10f877184664aecd72",
            "url": "https://instance.servicenow.com/api/sn_cicd/progress/54e9c665c969de10f877184664aecd72"
          }
        },
        "status": "0",
        "status_label": "Pending",
        "status_message": "",
        "status_detail": "",
        "error": "",
        "percent_complete": 0
      }
    }

## CICD-Update-Satz -- POST /api/sn_cicd/Update_Set/back_out {#ariaid-title5}

Setzt einen Installationsvorgang zurück, der für einen Update-Satz mit einer bestimmten sys_ID ausgeführt wurde
Weitere Informationen darüber, wie sich der Zurücksetzvorgang auf einen Update-Satz auswirkt, finden Sie unter [Back out an update set](https://www.servicenow.com/docs/access?context=t_BackOutUpdateSet&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US).

### URL-Format

Versionierte URL: /api/sn_cicd/{api_Version}/Update_Set/back_out

Standard-URL: /api/sn_cicd/Update_Set/back_out  
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

{#cicd_update_set-POST-back_out__entry__2}{#cicd_update_set-POST-back_out__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 : 18. Pfad-Parameter]

{#cicd_update_set-POST-back_out__entry__6}

| Name | Beschreibung |
|-|-|
| Rollback_Installs | Kennzeichnung, die angibt, ob ein Rollback für die Batch-Installation durchgeführt werden soll, die während des Update-Satzes ausgeführt wurde. Mögliche Werte: * Wahr: Rollback der Installation durchführen. * Falsch: Setzen Sie die Installation nicht zurück. {#cicd_update_set-POST-back_out__ul_ypf_zdw_qdc} Datentyp: Boolescher Wert Standard: Wahr |
| update_set_id | Erforderlich. SYS_ID des Update-Satzes. Tabelle: Update-Sätze \[sys_Update_Set\] Datentyp: Zeichenfolge |
[Tabelle : 19. Abfrageparameter]

{#cicd_update_set-POST-back_out__entry__12}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 20. 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.").
{#cicd_update_set-POST-back_out__entry__16}{#cicd_update_set-POST-back_out__accept-RESTAPI}{#cicd_update_set-POST-back_out__content_type-RESTAPI}

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

{#cicd_update_set-POST-back_out__entry__22}{#cicd_update_set-POST-back_out__d2856e147}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 22. 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.").
{#cicd_update_set-POST-back_out__entry__26}{#cicd_update_set-POST-back_out__entry-200-status-code}{#cicd_update_set-POST-back_out__entry-400-status-code}{#cicd_update_set-POST-back_out__entry-401-status-code}{#cicd_update_set-POST-back_out__entry-403-status-code}{#cicd_update_set-POST-back_out__entry-404-status-code}{#cicd_update_set-POST-back_out__entry-405-status-code}{#cicd_update_set-POST-back_out__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. |
| 401 | Die Anwenderanmeldeinformationen sind falsch. |
| 403 | Unzulässig. Der Anwender ist kein Administrator oder hat keine sn_cicd.sys_ci_automation-Rolle. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 405 | Ungültige Methode. Die Funktionalität ist inaktiv. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. |
[Tabelle : 23. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#cicd_update_set-POST-back_out__entry__42}{#cicd_update_set-POST-back_out__entry-error}{#cicd_update_set-POST-back_out__entry-link}{#cicd_update_set-POST-back_out__entry-links_progress}{#cicd_update_set-POST-back_out__entry-progress_id}{#cicd_update_set-POST-back_out__entry-progress_url}{#cicd_update_set-POST-back_out__entry-percent_complete}{#cicd_update_set-POST-back_out__entry-status}{#cicd_update_set-POST-back_out__entry-status_detail}{#cicd_update_set-POST-back_out__entry-status_label}{#cicd_update_set-POST-back_out__entry-status_message}

| Name | Beschreibung |
|-|-|
| Fehler | Fehlermeldung mit Details zum Fehler. Datentyp: Zeichenfolge |
| Links | Informationen zu Links und sys_IDs, die dem Update-Satz zugeordnet sind. Datentyp: Objekt "links": { "progress": {Object} } |
| links.progress | Fortschrittsinformationen zum Vorgang, der für den Update-Satz ausgeführt wird. Datentyp: Objekt "progress": { "id": "String", "url": "String" } |
| links.progress.id | SYS_ID mit Fortschrittsdetails für den Vorgang. Sie können diesen Wert beim Aufrufen des Endpunkts verwenden [CI/CD -- GET /sn_cicd/Progress/{Progress_ID}](https://servicenow-prod.fluidtopics.net/wfuU1cAejhpsx_m6Ak2YCw#cicd-GET-progress "Gibt den aktuellen Fortschritt und Status von zurück Kontinuierliche Integration und kontinuierliche Bereitstellung (CICD)Funktion, die einer angegebenen Fortschritts-ID zugeordnet ist."). Datentyp: Zeichenfolge |
| links.progress.url | URL, die zum Abrufen der Fortschrittsdetails zum Vorgang verwendet werden soll, der für den Update-Satz ausgeführt wird. Datentyp: Zeichenfolge |
| percent_complete | Prozentsatz der abgeschlossenen Anforderung. Datentyp: Zahl |
| Status | Zahl, die den Ausführungsstatus der Aktion darstellt, die für den Update-Satz ausgeführt wird. Entspricht status_labelDeskriptor. Mögliche Werte: * 0: Ausstehend * 1: Wird Ausgeführt * 2: Erfolgreich * 3: Fehlgeschlagen * 4: Abgebrochen Datentyp: Zeichenfolge |
| status_detail | Detaillierte Nachricht zum Ausführungsstatus, falls verfügbar. Entspricht dem Feld „Detailed_message" in der Tabelle „Ausführungstracker" \[sys_Execution_Tracker\]. Datentyp: Zeichenfolge |
| status_label | Ausführungsstatus der Update-Satz-Aktion. Entspricht statusNummer. Mögliche Werte: * Abgebrochen * Fehlgeschlagen * Ausstehend * Wird ausgeführt * Erfolgreich Datentyp: Zeichenfolge |
| status_message | Zusätzliche Beschreibung des aktuellen Status der Aktion, falls verfügbar. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Beispiel zeigt, wie ein Installationsvorgang für eine bestimmte Update-sys_ID zurückgesetzt wird

    curl 
    "https://instance.servicenow.com/api/sn_cicd/update_set/back_out?update_set_id=73dd24e39dcd1e10f877036c70ae59ae&rollback_installs=false" \
    --request POST \
    --header "Accept:application/json" \
    --user 'username':'password'

Antwort:

    {
      "result": {
        "links": {
          "progress": {
            "id": "036bf811c9619e10f877184664aecdcb",
            "url": "https://instance.servicenow.com/api/sn_cicd/progress/036bf811c9619e10f877184664aecdcb"
          }
        },
        "status": "0",
        "status_label": "Pending",
        "status_message": "",
        "status_detail": "",
        "error": "",
        "percent_complete": 0
      }
    } 

## CICD-Update-Satz -- POST /api/sn_cicd/Update_Set/commit/{remote_update_set_id} {#ariaid-title6}

Commits für einen Update-Satz mit einer bestimmten sys_ID
Wenn Sie eine Vorschau eines Update-Satzes angezeigt und Probleme gelöst haben, können Sie den Update-Satz mit diesem Endpunkt bestätigen. Durch das Commit eines Update-Satzes werden alle Änderungen auf die Instanz angewendet und eine lokale Kopie des Update-Satzes erstellt, die einen Update-Datensatz für jeden Change enthält. Weitere Informationen zum Commit eines Update-Satzes finden Sie unter [Commit an update set](https://www.servicenow.com/docs/access?context=t_CommitAnUpdateSet&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US).

### URL-Format

Versionierte URL: /api/sn_cicd/{api_Version}/Update_Set/commit/{remote_update_set_id}

Standard-URL: /api/sn_cicd/Update_Set/ commit/{remote_update_set_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

{#cicd_update_set-POST-commit__entry__2}{#cicd_update_set-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 |
| remote_update_set_id | SYS_ID des zu bestätigenden Update-Satzes. Hinweis: Sie können verwenden [CI/CD -- GET /sn_cicd/Progress/{Progress_ID}](https://servicenow-prod.fluidtopics.net/wfuU1cAejhpsx_m6Ak2YCw#cicd-GET-progress "Gibt den aktuellen Fortschritt und Status von zurück Kontinuierliche Integration und kontinuierliche Bereitstellung (CICD)Funktion, die einer angegebenen Fortschritts-ID zugeordnet ist.")Endpunkt zum Abrufen der Remote-Update-Satz-ID. Tabelle: Abgerufene Update-Sätze \[sys_remote_update_set\] Datentyp: Zeichenfolge |
[Tabelle : 24. Pfad-Parameter]

{#cicd_update_set-POST-commit__entry__8}

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

{#cicd_update_set-POST-commit__entry__12}

| Name | Beschreibung |
|-|-|
| Force_commit | Kennzeichnung, die angibt, ob das Commit des Update-Satzes erzwungen werden soll. Gültige Werte: * Wahr: Commits des Update-Satzes erzwingen, auch wenn Sie ihn noch nicht in der Vorschau angezeigt haben, um nach Konflikten zu suchen. * Falsch: Erzwingt das Commit des Update-Satzes nicht. Sie müssen eine Vorschau des Update-Satzes anzeigen, bevor Sie mit dem Commit fortfahren. {#cicd_update_set-POST-commit__ul_sc4_y3k_12c} Datentyp: Zeichenfolge Standard: Falsch |
[Tabelle : 26. 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.").
{#cicd_update_set-POST-commit__entry__16}{#cicd_update_set-POST-commit__accept-RESTAPI}{#cicd_update_set-POST-commit__content_type-RESTAPI}

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

{#cicd_update_set-POST-commit__entry__22}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 28. 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.").
{#cicd_update_set-POST-commit__entry__26}{#cicd_update_set-POST-commit__entry-200-status-code}{#cicd_update_set-POST-commit__entry-400-status-code}{#cicd_update_set-POST-commit__entry-401-status-code}{#cicd_update_set-POST-commit__entry-403-status-code}{#cicd_update_set-POST-commit__entry-404-status-code}{#cicd_update_set-POST-commit__entry-409-status-code}{#cicd_update_set-POST-commit__entry-500-status-code}

| Name | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Die Anwenderanmeldeinformationen sind falsch. |
| 403 | Unzulässig. Der Anwender hat keine Zugriffsrechte für den angegebenen Datensatz. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 409 | Konflikt. Das angeforderte Element ist nicht eindeutig. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. |
[Tabelle : 29. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#cicd_update_set-POST-commit__entry__42}{#cicd_update_set-POST-commit__entry-error}{#cicd_update_set-POST-commit__entry-link}{#cicd_update_set-POST-commit__entry-links_progress}{#cicd_update_set-POST-commit__entry-progress_id}{#cicd_update_set-POST-commit__entry-progress_url}{#cicd_update_set-POST-commit__entry-percent_complete}{#cicd_update_set-POST-commit__entry-status}{#cicd_update_set-POST-commit__entry-status_detail}{#cicd_update_set-POST-commit__entry-status_label}{#cicd_update_set-POST-commit__entry-status_message}

| Name | Beschreibung |
|-|-|
| Fehler | Fehlermeldung mit Details zum Fehler. Datentyp: Zeichenfolge |
| Links | Informationen zu Links und sys_IDs, die dem Update-Satz zugeordnet sind. Datentyp: Objekt "links": { "progress": {Object} } |
| links.progress | Fortschrittsinformationen zum Vorgang, der für den Update-Satz ausgeführt wird. Datentyp: Objekt "progress": { "id": "String", "url": "String" } |
| links.progress.id | SYS_ID mit Fortschrittsdetails für den Vorgang. Sie können diesen Wert beim Aufrufen des Endpunkts verwenden [CI/CD -- GET /sn_cicd/Progress/{Progress_ID}](https://servicenow-prod.fluidtopics.net/wfuU1cAejhpsx_m6Ak2YCw#cicd-GET-progress "Gibt den aktuellen Fortschritt und Status von zurück Kontinuierliche Integration und kontinuierliche Bereitstellung (CICD)Funktion, die einer angegebenen Fortschritts-ID zugeordnet ist."). Datentyp: Zeichenfolge |
| links.progress.url | URL, die zum Abrufen der Fortschrittsdetails zum Vorgang verwendet werden soll, der für den Update-Satz ausgeführt wird. Datentyp: Zeichenfolge |
| percent_complete | Prozentsatz der abgeschlossenen Anforderung. Datentyp: Zahl |
| Status | Zahl, die den Ausführungsstatus der Aktion darstellt, die für den Update-Satz ausgeführt wird. Entspricht status_labelDeskriptor. Mögliche Werte: * 0: Ausstehend * 1: Wird Ausgeführt * 2: Erfolgreich * 3: Fehlgeschlagen * 4: Abgebrochen Datentyp: Zeichenfolge |
| status_detail | Detaillierte Nachricht zum Ausführungsstatus, falls verfügbar. Entspricht dem Feld „Detailed_message" in der Tabelle „Ausführungstracker" \[sys_Execution_Tracker\]. Datentyp: Zeichenfolge |
| status_label | Ausführungsstatus der Update-Satz-Aktion. Entspricht statusNummer. Mögliche Werte: * Abgebrochen * Fehlgeschlagen * Ausstehend * Wird ausgeführt * Erfolgreich Datentyp: Zeichenfolge |
| status_message | Zusätzliche Beschreibung des aktuellen Status der Aktion, falls verfügbar. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Im folgenden Beispiel wird der Update-Satz mit der zugehörigen sys_ID Commit ausgeführt

    curl 
    "https://instance.servicenow.com/api/sn_cicd/update_set/commit/4ee89999c9e19e10f877184664aecd42" \
    --request POST \
    --header "Accept:application/json" \
    --user 'username':'password'

Antworttext.

    {
      "result": {
        "links": {
          "progress": {
            "id": "bf380a11c9e59e10f877184664aecd0e",
            "url": "https://instance.servicenow.com/api/sn_cicd/progress/bf380a11c9e59e10f877184664aecd0e"
          }
        },
        "status": "0",
        "status_label": "Pending",
        "status_message": "",
        "status_detail": "",
        "error": "",
        "percent_complete": 0
      }
    }

## CICD-Update-Satz -- POST /api/sn_cicd/Update_Set/create {#ariaid-title7}

Erstellt einen neuen Update-Satz und fügt den neuen Datensatz in die Tabelle „Update-Sätze" \[sys_Update_Set\] ein.

### URL-Format

Versionierte URL: /api/sn_cicd/{api_Version}/Update_Set/create

Standard-URL: /api/sn_cicd/Update_Set/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

{#cicd_update_set-POST-create__entry__2}{#cicd_update_set-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 : 30. Pfad-Parameter]

{#cicd_update_set-POST-create__entry__6}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung des Update-Satzes. Datentyp: Zeichenfolge Standard: Null |
| scope | Erforderlich, wenn sys_idParameter wurde nicht übergeben. Der Bereichsname der Anwendung, in der der neue Update-Satz erstellt werden soll. Tabelle: Anwendungen \[sys_scope\] Datentyp: Zeichenfolge |
| sys_id | Erforderlich, wenn scopeParameter wurde nicht übergeben. SYS_ID der Anwendung, in der der neue Update-Satz erstellt werden soll. Tabelle: Anwendungen \[sys_scope\] Datentyp: Zeichenfolge |
| Update_Set_Name | Erforderlich. Name, der dem Update-Satz zugewiesen werden soll. Datentyp: Zeichenfolge |
[Tabelle : 31. Abfrageparameter]

{#cicd_update_set-POST-create__entry__16}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 32. 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.").
{#cicd_update_set-POST-create__entry__20}{#cicd_update_set-POST-create__accept-RESTAPI}{#cicd_update_set-POST-create__content_type-RESTAPI}

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

{#cicd_update_set-POST-create__entry__26}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 34. 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.").
{#cicd_update_set-POST-create__table_n5q_tn2_rdc__entry__2}{#cicd_update_set-POST-create__entry-403-status-code}{#cicd_update_set-POST-create__entry-409-status-code}{#cicd_update_set-POST-create__entry-500-status-code}

|   |   |
|-|-|
| 201 | Der Update-Satz wurde erfolgreich erstellt. |
| 400 | Ungültige Anforderung. Der Name des Update-Satzes ist null oder leer, oder sowohl die Eingabe-sys_ID als auch der Umfang sind null oder leer. |
| 403 | Unzulässig. Der Anwender ist kein Administrator oder hat keine sn_cicd.sys_ci_automation-Rolle. |
| 409 | Konflikt. Das angeforderte Element ist nicht eindeutig. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. |
[ ]

{#cicd_update_set-POST-create__table_n5q_tn2_rdc}

### Antworttext-Parameter (JSON oder XML)

{#cicd_update_set-POST-create__entry__42}{#cicd_update_set-POST-create__entry-error}{#cicd_update_set-POST-create__entry-status}{#cicd_update_set-POST-create__entry-status_detail}{#cicd_update_set-POST-create__entry-status_label}{#cicd_update_set-POST-create__entry-status_message}

| Name | Beschreibung |
|-|-|
| Fehler | Fehlermeldung mit Details zum Fehler. Datentyp: Zeichenfolge |
| Status | Zahl, die den Ausführungsstatus der Aktion darstellt, die für den Update-Satz ausgeführt wird. Entspricht status_labelDeskriptor. Mögliche Werte: * 0: Ausstehend * 1: Wird Ausgeführt * 2: Erfolgreich * 3: Fehlgeschlagen * 4: Abgebrochen Datentyp: Zeichenfolge |
| status_detail | Detaillierte Nachricht zum Ausführungsstatus, falls verfügbar. Entspricht dem Feld „Detailed_message" in der Tabelle „Ausführungstracker" \[sys_Execution_Tracker\]. Datentyp: Zeichenfolge |
| status_label | Ausführungsstatus der Update-Satz-Aktion. Entspricht statusNummer. Mögliche Werte: * Abgebrochen * Fehlgeschlagen * Ausstehend * Wird ausgeführt * Erfolgreich Datentyp: Zeichenfolge |
| status_message | Zusätzliche Beschreibung des aktuellen Status der Aktion, falls verfügbar. Datentyp: Zeichenfolge |
| update_set_id | SYS_ID des erstellten Update-Satzes. Tabelle: Update-Sätze \[sys_Update_Set\] Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Beispiel zeigt, wie ein neuer Update-Satz mit dem Namen erstellt wird `Testupdatensatz `Und der Bereich auf festgelegt `sn_Test `.

    curl 
    "https://instance.servicenow.com/api/sn_cicd/update_set/create?update_set_name=Testupdateset&scope=sn_test" \
    --request POST \
    --header "Accept:application/json" \
    --user 'username':'password'

Antworttext.

    {
      "result": {
        "status": "2",
        "status_label": "",
        "status_message": "Successfully created update set: Test update set 1",
        "status_detail": "",
        "error": "",
        "update_set_id": "a9a485d1c9a19e10f877184664aecd11"
      }
    }


