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


---

# DevOps-Konfigurations-API

# DevOps-Konfigurations-API {#ariaid-title1}

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

Die DevOps-Konfiguration Die API stellt Endpunkte zur Verwaltung Ihrer Anwendungen bereit.
Diese API erfordert DevOps ConfigAnwendung und wird in bereitgestellt `sn_devops_config `Namespace.

Für LÖSCHVORGÄNGE, PATCH- und POST-Vorgänge muss der aufrufende Anwender über die Rolle „sn_devops_config.admin" verfügen. Für GET-Vorgänge muss der aufrufende Anwender über die Rolle „sn_devops_config.Viewer" oder „sn_devops_config.admin" verfügen.

Verwenden Sie DevOps-Konfiguration API für das Lebenszyklus-Management von Anwendungen. Weitere Informationen zum Verwalten von Anwendungen mit DevOps Config, Siehe [DevOps-Konfiguration wird konfiguriert](https://www.servicenow.com/docs/access?context=setting-up-devops-config-validation&version=yokohama&pubname=yokohama-it-service-management&ft:locale=en-US).

## DevOps-Konfiguration: LÖSCHEN SIE /devops_config/Application/{appid} {#ariaid-title2}

Löscht eine Anwendung.

### URL-Format

Versionierte URL: /api/sn_devops_config/{api_Version}/devops_config/Application/{appid}

Standard-URL: /api/sn_devops_config/devops_config/Application/{appid}  
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

{#devops-config-DELETE-app__entry__2}{#devops-config-DELETE-app__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 |
| appid | SYS_ID der zu löschenden Anwendung. Datentyp: Zeichenfolge Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
[Tabelle : 1. Pfad-Parameter]

{#devops-config-DELETE-app__entry__8}

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

{#devops-config-DELETE-app__entry__12}

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

### Header

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

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

{#devops-config-DELETE-app__table_kwn_v1r_fvb} {#devops-config-DELETE-app__entry__20}

| 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.").
{#devops-config-DELETE-app__table_egh_yyl_gvb__entry__2}{#devops-config-DELETE-app__entry-200-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ungültige Anwendungs-ID |
| 403 | Unzulässig. Der Anwender hat keine Berechtigung zum Zugriff auf die API. |
[Tabelle : 6. Statuscodes]

{#devops-config-DELETE-app__table_egh_yyl_gvb}

### Antworttext-Parameter (JSON)

{#devops-config-DELETE-app__table_z3v_z5d_gvb__entry__2}

| Name | Beschreibung |
|-|-|
| Fehler | Fehlerinformationen. Dieser Parameter wird nur zurückgegeben, wenn die Anforderung fehlgeschlagen ist. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Details dazu, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Fehler.Nachricht | Fehlermeldung mit dem Grund, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Ergebnis | Ergebnisobjekt mit Informationen zur Anforderung. Datentyp: Objekt "result": { "errors": [Array], "success": [Array] } |
| Ergebnis.Fehler | Array von Fehlern aus der Anforderung. Das Array ist für erfolgreiche Anforderungen leer. Datentyp: Array |
| Ergebnis.Erfolg | Erfolgsmeldung für die Anforderung. Das Array ist für fehlgeschlagene Anforderungen leer. Datentyp: Array |
| Status | Status der Anforderung. Dieser Parameter wird nur zurückgegeben, wenn die Anforderung fehlgeschlagen ist. Möglicher Wert: Fehler Datentyp: Zeichenfolge |
[ ]

{#devops-config-DELETE-app__table_z3v_z5d_gvb}  

### Curl-Anforderung

Dieses Beispiel löscht eine Anwendung.

    curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application/38e17dc3473d111072566862736d43c7" \ 
    --request DELETE \ 
    --header "Accept:application/json" \ 
    --user 'username':'password' 

Antworttext.

    { 
      "result": { 
        "errors": [], 
        "success": [ 
          "CDM Application Demo Application 1234 has been deleted successfully." 
        ] 
      } 
    }

### Curl-Anforderung {#devops-config-DELETE-app__example_ssd_qph_hvb}

Dieses Beispiel zeigt eine Fehlerantwort, wenn ein Anwender keine Berechtigung zum Zugriff auf die API hat.

    curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application/38e17dc3473d111072566862736d43c7" \ 
    --request DELETE \ 
    --header "Accept:application/json" \ 
    --user 'username':'password' 

Fehlerantwort.

    { 
      "error": { 
        "message": "User Not Authorized", 
        "detail": "Failed API level ACL Validation" 
      }, 
      "status": "failure" 
    }

## DevOps-Konfiguration -- GET /devops_config/Application/{appid} {#ariaid-title3}

Ruft eine Anwendung ab.

### URL-Format

Versionierte URL: /api/sn_devops_config/{api_Version}/devops_config/Application/{appid}

Standard-URL: /api/sn_devops_config/devops_config/Application/{appid}  
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

{#devops-config-GET-app__entry__2}{#devops-config-GET-app__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 |
| appid | SYS_ID der abzurufenden Anwendung. Datentyp: Zeichenfolge Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
[Tabelle : 7. Pfad-Parameter]

{#devops-config-GET-app__entry__8}

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

{#devops-config-GET-app__entry__12}

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

### Header

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

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

{#devops-config-GET-app__table_kwn_v1r_fvb} {#devops-config-GET-app__entry__20}

| 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.").
{#devops-config-GET-app__entry__24}{#devops-config-GET-app__entry-200-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ungültige Anwendungs-ID |
| 403 | Unzulässig. Der Anwender hat keine Berechtigung zum Zugriff auf die API. |
[Tabelle : 12. Statuscodes]

### Antworttext-Parameter (JSON)

{#devops-config-GET-app__table_z3v_z5d_gvb__entry__2}

| Name | Beschreibung |
|-|-|
| Fehler | Fehlerinformationen. Dieser Parameter wird nur zurückgegeben, wenn die Anforderung fehlgeschlagen ist. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Details dazu, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Fehler.Nachricht | Fehlermeldung mit dem Grund, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Ergebnis | Ergebnisobjekt mit Informationen zur Anforderung. Datentyp: Objekt "result": { "data": {Object}, "message": "String", "status": Number } |
| Ergebnis.Daten | Daten für die Anwendung. Datentyp: Objekt "data": { "appDescription": "String", "appId": "String", "appManagedByGroups": [Array], "appManufacturerId": "String", "appManufacturerName": "String", "appModelId": "String", "appModelName": "String", "appModelOwnerId": "String", "appModelOwnerName": "String", "appName": "String", "sdlcType": "String" } |
| Ergebnis.Daten.appBeschreibung | Beschreibung der Anwendung. Datentyp: Zeichenfolge |
| Ergebnis.Daten.appId | SYS_ID der Anwendung. Datentyp: Zeichenfolge Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
| Ergebnis.Daten.appManagedByGroups | Kommagetrennte Liste der sys_IDs der Gruppen, die die Anwendung verwalten. Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
| Ergebnis.Daten.appManufacturerId | SYS_ID des Herstellers. Datentyp: Zeichenfolge Tabelle: Unternehmen \[Core_Company\] |
| Ergebnis.Daten.appManufacturerName | Name des Herstellers. Datentyp: Zeichenfolge |
| Ergebnis.Daten.appModelId | SYS_ID des Anwendungsmodells. Datentyp: Zeichenfolge Tabelle: Anwendungsmodell \[cmdb_application_product_model\] |
| Ergebnis.Daten.appModelName | Name des Anwendungsmodells. Datentyp: Zeichenfolge Tabelle: Anwendungsmodell \[cmdb_application_product_model\] |
| Ergebnis.Daten.appModelOwnerId | SYS_ID des Besitzers des Anwendungsmodells. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Ergebnis.Daten.appModelOwnerName | Name des Besitzers des Anwendungsmodells. Datentyp: Zeichenfolge |
| Ergebnis.Daten.appName | Name der Anwendung. Datentyp: Zeichenfolge |
| Ergebnis.Daten.Fehler | Fehlerinformationen. Dieser Parameter wird nur zurückgegeben, wenn die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Ergebnis.Daten.sdlcType | Typ der Anwendung. Mögliche Werte: * Anwendung * Infrastruktur {#devops-config-GET-app__ul_rt4_x3q_dvb} Datentyp: Zeichenfolge |
| Ergebnis.Nachricht | Informationen zum erfolgreichen oder nicht erfolgreichen Ergebnis der Anforderung. Datentyp: Zeichenfolge |
| Ergebnis.Status | Statuscode für die Anforderung. Mögliche Werte: * 200 * 400 * 403 {#devops-config-GET-app__ul_cvg_nkh_hvb} Datentyp: Zahl |
| Status | Status der Anforderung. Dieser Parameter wird nur zurückgegeben, wenn die Anforderung fehlgeschlagen ist. Möglicher Wert: Fehler Datentyp: Zeichenfolge |
[ ]

{#devops-config-GET-app__table_z3v_z5d_gvb}  

### Curl-Anforderung

Dieses Beispiel ruft eine Anwendung ab.

    curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application/38e17dc3473d111072566862736d43c7" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user 'username':'password' 

Antworttext.

    { 
      "result": { 
        "status": 200, 
        "message": "Success", 
        "data": { 
          "appName": "Demo Application 1234", 
          "appId": "38e17dc3473d111072566862736d43c7", 
          "appDescription": "Updated description of Demo Application created from REST API", 
          "sdlcType": "application", 
          "appModelId": "a4e13dc3473d111072566862736d4307", 
          "appModelName": "Demo Application 1234", 
          "appManufacturerId": "262702654725d950a34a3085d36d435e", 
          "appManufacturerName": "", 
          "appModelOwnerId": "6816f79cc0a8016401c5a33be04be441", 
          "appModelOwnerName": "System Administrator", 
          "appManagedByGroups": [] 
        } 
      } 
    }

### Curl-Anforderung {#devops-config-GET-app__example_wfs_2qh_hvb}

Dieses Beispiel zeigt eine Fehlerantwort, wenn ein Anwender eine ungültige Anwendungs-ID bereitstellt

    curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application/18a17de3283d15107256686277777777" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user 'username':'password' 

Fehlerantwort.

    { 
      "result": { 
        "status": 400, 
        "message": "No valid Application", 
        "data": { 
          "error": "No valid Application" 
        } 
      } 
    }

## DevOps-Konfiguration: PATCH /devops_config/Application/{appid} {#ariaid-title4}

Aktualisiert eine Anwendung.

### URL-Format

Versionierte URL: /api/sn_devops_config/{api_Version}/devops_config/Application/{appid}

Standard-URL: /api/sn_devops_config/devops_config/Application/{appid}  
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

{#devops-config-PATCH-app__entry__2}{#devops-config-PATCH-app__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 |
| appid | SYS_ID der zu aktualisierenden Anwendung. Datentyp: Zeichenfolge Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
[Tabelle : 13. Pfad-Parameter]

{#devops-config-PATCH-app__entry__8}

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

{#devops-config-PATCH-app__entry__12}{#devops-config-PATCH-app__app-descr}{#devops-config-PATCH-app__app-mfct}{#devops-config-PATCH-app__app-owner-id}

| Name | Beschreibung |
|-|-|
| AppBeschreibung | Beschreibung der Anwendung. Datentyp: Zeichenfolge |
| AppManagedByGroups | Kommagetrennte Liste der sys_IDs der Gruppen, die die Anwendung verwalten. Der aufrufende Anwender muss zu diesen Gruppen gehören. "appManagedByGroups": "sys_id, sys_id" Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
| AppManufacturerId | SYS_ID des Herstellers. Datentyp: Zeichenfolge Tabelle: Unternehmen \[Core_Company\] |
| AppModelOwnerId | SYS_ID des Besitzers des Anwendungsmodells. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
[Tabelle : 15. Anforderungstext-Parameter (JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#devops-config-PATCH-app__table_kwn_v1r_fvb__entry__2}{#devops-config-PATCH-app__accept-JSON-only-entry-RESTAPI}{#devops-config-PATCH-app__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 : 16. Anforderungskopfzeilen.]

{#devops-config-PATCH-app__table_kwn_v1r_fvb} {#devops-config-PATCH-app__entry__28}

| 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.").
{#devops-config-PATCH-app__table_jk3_y1r_fvb__entry__2}

| Statuscode | Beschreibung |
|-|-|
| 200 | Anwendung erfolgreich aktualisiert. |
| 403 | Unzulässig. Der Anwender hat keine Berechtigung zum Zugriff auf die API. |
| 404 | Anwendung nicht aktualisiert. Die messageEigenschaft in resultObjekt enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

{#devops-config-PATCH-app__table_jk3_y1r_fvb}

### Antworttext-Parameter (JSON) {#devops-config-PATCH-app__section_y3v_z5d_gvb}

{#devops-config-PATCH-app__table_z3v_z5d_gvb__entry__2}

| Name | Beschreibung |
|-|-|
| Fehler | Fehlerinformationen. Dieser Parameter wird nur zurückgegeben, wenn die Anforderung fehlgeschlagen ist. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Details dazu, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Fehler.Nachricht | Fehlermeldung mit dem Grund, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Ergebnis | Ergebnisobjekt mit Informationen zur Anwendung. Datentyp: Objekt "result": { "data": "String", "message": "String" } |
| Ergebnis.Daten | SYS_ID der Anwendung. Datentyp: Zeichenfolge Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
| Ergebnis.Nachricht | Informationen zum erfolgreichen oder nicht erfolgreichen Ergebnis der Anforderung. Datentyp: Zeichenfolge |
| Status | Status der Anforderung. Dieser Parameter wird nur zurückgegeben, wenn die Anforderung fehlgeschlagen ist. Möglicher Wert: Fehler Datentyp: Zeichenfolge |
[ ]

{#devops-config-PATCH-app__table_z3v_z5d_gvb}  

### Curl-Anforderung

Dieses Beispiel aktualisiert eine vorhandene Anwendung.

    curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application/38e17dc3473d111072566862736d43c7" \ 
    --request PATCH \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{ 
      \"appDescription\": \"Updated description of Demo Application created from REST API\", 
      \"appManufacturerId\": \"262702654725d950a34a3085d36d435e\", 
      \"appModelOwnerId\": \"6816f79cc0a8016401c5a33be04be441\" 
    }" \ 
    --user 'username':'password' 

Antworttext.

    { 
      "result": { 
        "message": "Application with name Demo Application 1234 updated successfully.", 
        "data": "38e17dc3473d111072566862736d43c7" 
      } 
    }

## DevOps-Konfiguration -- POST /devops_config/Application {#ariaid-title5}

Erstellt eine Anwendung.

### URL-Format

Versionierte URL: /api/sn_devops_config/{api_Version}/devops_config/Application

Standard-URL: /api/sn_devops_config/devops_config/Application  
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

{#devops-config-POST-app__entry__2}{#devops-config-POST-app__version-not_optional-RESTAPI}

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

{#devops-config-POST-app__entry__6}

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

{#devops-config-POST-app__entry__10}{#devops-config-POST-app__app-descr}{#devops-config-POST-app__app-mfct}{#devops-config-POST-app__app-owner-id}

| Name | Beschreibung |
|-|-|
| AppBeschreibung | Beschreibung der Anwendung. Datentyp: Zeichenfolge |
| AppManagedByGroups | Kommagetrennte Liste der sys_IDs der Gruppen, die die Anwendung verwalten. Der aufrufende Anwender muss zu diesen Gruppen gehören. "appManagedByGroups": "sys_id, sys_id" Datentyp: Zeichenfolge Tabelle: Gruppe \[sys_user_group\] |
| AppManufacturerId | SYS_ID des Herstellers. Datentyp: Zeichenfolge Tabelle: Unternehmen \[Core_Company\] |
| AppModelId | SYS_ID eines vorhandenen Anwendungsmodells, das zum Erstellen der Anwendung verwendet werden soll. Wenn dieser Parameter angegeben ist, geben Sie nicht an appName, appModelName, appServiceName, appServiceId, Oder technicalServiceIdParameter. Datentyp: Zeichenfolge Tabelle:Anwendungsmodell \[cmdb_application_product_model\] |
| AppModelName | Name eines vorhandenen Anwendungsmodells, das zum Erstellen der Anwendung verwendet werden soll. Wenn dieser Parameter angegeben ist, geben Sie nicht an appName, appModelId, appServiceName, appServiceId, Oder technicalServiceIdParameter. Datentyp: Zeichenfolge Tabelle:Anwendungsmodell \[cmdb_application_product_model\] |
| AppModelOwnerId | SYS_ID des Besitzers des Anwendungsmodells. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| appName | Name der Anwendung. Verwenden Sie nicht denselben Namen wie eine vorhandene Anwendung. Wenn dieser Parameter angegeben ist, geben Sie nicht an appModelName, appModelId, appServiceName, appServiceId, Oder technicalServiceIdParameter. Datentyp: Zeichenfolge |
| appServiceId | SYS_ID eines vorhandenen Anwendungsservice, der zum Erstellen der Anwendung verwendet werden soll. Verwenden Sie diesen Parameter nur, wenn typeIst <kbd class="ph userinput">Anwendung </kbd>. Wenn dieser Parameter angegeben ist, geben Sie nicht an appName, appModelName, appModelId, appServiceName, Oder technicalServiceIdParameter. Datentyp: Zeichenfolge Tabelle: Serviceinstanz \[cmdb_ci_service_auto\] |
| AppServiceName | Name eines vorhandenen Anwendungsservice, der zum Erstellen der Anwendung verwendet werden soll. Verwenden Sie diesen Parameter nur, wenn typeIst <kbd class="ph userinput">Anwendung </kbd>. Wenn dieser Parameter angegeben ist, geben Sie nicht an appName, appModelName, appModelId, appServiceId, Oder technicalServiceIdParameter. Datentyp: Zeichenfolge Tabelle: Serviceinstanz \[cmdb_ci_service_auto\] |
| TechnicalServiceId | SYS_ID einer vorhandenen dynamischen CI-Gruppe, die zum Erstellen der Anwendung verwendet werden soll. Verwenden Sie diesen Parameter nur, wenn typeIst <kbd class="ph userinput">Infrastruktur </kbd>. Wenn dieser Parameter angegeben ist, geben Sie nicht an appName, appModelName, appModelId, appServiceName, Oder appServiceIdParameter. Datentyp: Zeichenfolge Tabelle: Dynamische CI-Gruppe \[cmdb_ci_query_based_service\] |
| Typ | Erforderlich. Der Typ der zu erstellenden Anwendung. Gültige Werte: * Anwendung * Infrastruktur {#devops-config-POST-app__ul_rt4_x3q_dvb} Datentyp: Zeichenfolge |
[Tabelle : 21. Anforderungstext-Parameter (JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#devops-config-POST-app__entry__34}{#devops-config-POST-app__accept-JSON-only-entry-RESTAPI}{#devops-config-POST-app__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 : 22. Anforderungskopfzeilen.]

{#devops-config-POST-app__entry__40}

| 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.").
{#devops-config-POST-app__entry__44}

| Statuscode | Beschreibung |
|-|-|
| 201 | Anwendung erfolgreich erstellt. |
| 403 | Unzulässig. Der Anwender hat keine Berechtigung zum Zugriff auf die API. |
| 404 | Anwendung nicht erstellt. Die messageEigenschaft in resultObjekt enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 24. Statuscodes]

### Antworttext-Parameter (JSON) {#devops-config-POST-app__section_y3v_z5d_gvb}

{#devops-config-POST-app__table_z3v_z5d_gvb__entry__2}

| Name | Beschreibung |
|-|-|
| Fehler | Fehlerinformationen. Dieser Parameter wird nur zurückgegeben, wenn die Anforderung fehlgeschlagen ist. Datentyp: Objekt "error": { "detail": "String", "message": "String" } |
| error.detail | Zusätzliche Details dazu, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Fehler.Nachricht | Fehlermeldung mit dem Grund, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Ergebnis | Ergebnisobjekt mit Informationen zur Anwendung. Datentyp: Objekt "result": { "data": "String", "message": "String" } |
| Ergebnis.Daten | SYS_ID der Anwendung. Datentyp: Zeichenfolge Tabelle: CDM-Anwendung \[sn_cdm_Application\] |
| Ergebnis.Nachricht | Informationen zum erfolgreichen oder nicht erfolgreichen Ergebnis der Anforderung. Datentyp: Zeichenfolge |
| Status | Status der Anforderung. Dieser Parameter wird nur zurückgegeben, wenn die Anforderung fehlgeschlagen ist. Möglicher Wert: Fehler Datentyp: Zeichenfolge |
[ ]

{#devops-config-POST-app__table_z3v_z5d_gvb}  

### Curl-Anforderung

Dieses Beispiel zeigt, wie eine neue Anwendung erstellt wird.

    curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{ 
      \"type\": \"application\", 
      \"appName\": \"Demo Application 1234\", 
      \"appDescription\": \"Description of Demo Application created from REST API\", 
      \"appManufacturerId\": \"262702654725d950a34a3085d36d435e\", 
      \"appModelOwnerId\": \"6816f79cc0a8016401c5a33be04be441\" 
    }" \ 
    --user 'username':'password' 

Antworttext.

    { 
      "result": { 
        "message": "Application with name Demo Application 1234 created successfully.", 
        "data": "38e17dc3473d111072566862736d43c7" 
      } 
    } 


