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

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DevOps Config-API

# DevOps Config-API {#ariaid-title1}

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

Die DevOps Config- API bietet Endpunkte zum Verwalten Ihrer Anwendungen.
Diese API erfordert die Anwendung DevOps Config und wird im Namespace `sn_devops_config` bereitgestellt.

Für DELETE-, PATCH- und POST-Vorgänge muss der aufrufende Benutzer über die Rolle sn_devops_config.admin verfügen. Für GET-Vorgänge muss der aufrufende Benutzer über die Rolle sn_devops_config.viewer oder sn_devops_config.admin verfügen.

Verwenden Sie die DevOps Config -API für die Lebenszyklusverwaltung von Anwendungen. Weitere Informationen zum Verwalten von Anwendungen mit DevOps Configfinden Sie unter [DevOps Config konfigurieren](https://www.servicenow.com/docs/access?context=setting-up-devops-config-validation&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US).

## DevOps Config -- DELETE /devops_config/application/{appid} {#ariaid-title2}

Löscht eine Anwendung.

### URL-Format

URL mit Versionsnummer: /api/sn_devops_config/v1/devops_config/application/{appid}

Standard-URL: /api/sn_devops_config/devops_config/application/{appid}

### Unterstützte Anforderungsparameter

{#devops-config-DELETE-app__entry__2}{#devops-config-DELETE-app__version-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel <kbd class="ph userinput">v1</kbd> oder <kbd class="ph userinput">v2</kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| appid | Sys_id der zu löschenden Anwendung. Befindet sich in der Tabelle „CDM-Anwendung" \[sn_cdm_application\]. Datentyp: Zeichenfolge |
[Tabelle : 1. Pfadparameter]

{#devops-config-DELETE-app__entry__8}

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

{#devops-config-DELETE-app__entry__12}

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

### Kopfzeilen

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

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
[Tabelle : 4. Anforderungskopfzeilen]

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

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

### Statuscodes

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

### Parameter des Antwort-Haupttexts (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": { "message": "String", "detail": "String" } |
| Fehler.detail | Zusätzliche Details dazu, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Fehlernachricht | Fehlermeldung, die den Grund für das Fehlschlagen der Anforderung enthält. Datentyp: Zeichenfolge |
| Ergebnis | Ergebnisobjekt, das Informationen zur Anforderung enthält. Datentyp: Objekt "result": { "errors": [Array], "success": [Array] } |
| result.errors | Array von Fehlern aus der Anforderung. Bei erfolgreichen Anforderungen ist das Array leer. Datentyp: Array |
| Ergebnis.Erfolg | Erfolgsnachricht für die Anforderung. Bei fehlgeschlagenen Anforderungen ist das Array 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

In diesem Beispiel wird eine -Anwendung gelöscht.

    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 nicht berechtigt ist, auf die API zuzugreifen.

    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 Config -- GET /devops_config/application/{appid} {#ariaid-title3}

Ruft eine Anwendung ab.

### URL-Format

URL mit Versionsnummer: /api/sn_devops_config/v1/devops_config/application/{appid}

Standard-URL: /api/sn_devops_config/devops_config/application/{appid}

### Unterstützte Anforderungsparameter

{#devops-config-GET-app__entry__2}{#devops-config-GET-app__version-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel <kbd class="ph userinput">v1</kbd> oder <kbd class="ph userinput">v2</kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| appid | Sys_id der abzurufenden Anwendung. Befindet sich in der Tabelle „CDM-Anwendung" \[sn_cdm_application\]. Datentyp: Zeichenfolge |
[Tabelle : 7. Pfadparameter]

{#devops-config-GET-app__entry__8}

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

{#devops-config-GET-app__entry__12}

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

### Kopfzeilen

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

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
[Tabelle : 10. Anforderungskopfzeilen]

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

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

### Statuscodes

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

### Parameter des Antwort-Haupttexts (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": { "message": "String", "detail": "String" } |
| Fehler.detail | Zusätzliche Details dazu, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Fehlernachricht | Fehlermeldung, die den Grund für das Fehlschlagen der Anforderung enthält. Datentyp: Zeichenfolge |
| Ergebnis | Ergebnisobjekt, das Informationen zur Anforderung enthält. Datentyp: Objekt "result": { "data": {Object}, "message": "String", "status": Number } |
| result.data | 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" } |
| result.data.appDescription | Beschreibung der Anwendung. Datentyp: Zeichenfolge |
| result.data.appId | Sys_id der Anwendung. Befindet sich in der Tabelle „CDM-Anwendung" \[sn_cdm_application\]. Datentyp: Zeichenfolge |
| result.data.appManagedByGroups | Kommagetrennte Liste der sys_ids der Gruppen, die die Anwendung verwalten. Befindet sich in der Tabelle „Gruppe" \[sys_user_group\]. Datentyp: Zeichenfolge |
| result.data.appManufacturerId | Sys_id des Herstellers. Befindet sich in der Tabelle „Unternehmen" \[core_company\]. Datentyp: Zeichenfolge |
| result.data.appManufacturerName | Name des Herstellers. Datentyp: Zeichenfolge |
| result.data.appModelId | Sys_id des Anwendungsmodells. Befindet sich in der Tabelle „Anwendungsmodell" \[cmdb_application_product_model\]. Datentyp: Zeichenfolge |
| result.data.appModelName | Name des Anwendungsmodells. Befindet sich in der Tabelle „Anwendungsmodell" \[cmdb_application_product_model\]. Datentyp: Zeichenfolge |
| result.data.appModelOwnerId | Sys_id des Besitzers des Anwendungsmodells. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Zeichenfolge |
| result.data.appModelOwnerName | Name des Besitzers des Anwendungsmodells. Datentyp: Zeichenfolge |
| result.data.appName | Name der Anwendung. Datentyp: Zeichenfolge |
| Ergebnis.Daten.Fehler | Fehlerinformationen. Dieser Parameter wird nur zurückgegeben, wenn die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| result.data.sdlcType | Der Typ der Anwendung. Mögliche Werte: * Anwendung * Infrastruktur {#devops-config-GET-app__ul_rt4_x3q_dvb} Datentyp: Zeichenfolge |
| result.message | Informationen über das erfolgreiche oder nicht erfolgreiche Ergebnis der Anforderung. Datentyp: Zeichenfolge |
| result.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

In diesem Beispiel wird eine -Anwendung abgerufen.

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

    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 Config -- PATCH /devops_config/application/{appid} {#ariaid-title4}

Aktualisiert eine Anwendung.

### URL-Format

URL mit Versionsnummer: /api/sn_devops_config/v1/devops_config/application/{appid}

Standard-URL: /api/sn_devops_config/devops_config/application/{appid}

### Unterstützte Anforderungsparameter

{#devops-config-PATCH-app__entry__2}{#devops-config-PATCH-app__version-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel <kbd class="ph userinput">v1</kbd> oder <kbd class="ph userinput">v2</kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| appid | Sys_id der zu aktualisierenden Anwendung. Befindet sich in der Tabelle „CDM-Anwendung" \[sn_cdm_application\]. Datentyp: Zeichenfolge |
[Tabelle : 13. Pfadparameter]

{#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 |
|-|-|
| appDescription | Beschreibung der Anwendung. Datentyp: Zeichenfolge |
| appManagedByGroups | Kommagetrennte Liste der sys_ids der Gruppen, die die Anwendung verwalten. Der anrufende Anwender muss zu diesen Gruppen gehören. Befindet sich in der Tabelle „Gruppe" \[sys_user_group\]. Datentyp: Zeichenfolge "appManagedByGroups": "sys_id, sys_id" |
| appManufacturerId | Sys_id des Herstellers. Befindet sich in der Tabelle „Unternehmen" \[core_company\]. Datentyp: Zeichenfolge |
| appModelOwnerId | Sys_id des Besitzers des Anwendungsmodells. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Zeichenfolge |
[Tabelle : 15. Parameter des Anforderungstexts (JSON)]

### Header

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

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
[Tabelle : 16. Anforderungskopfzeilen]

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

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

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 Eigenschaft messageresult im Objekt \[\] enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

{#devops-config-PATCH-app__table_jk3_y1r_fvb}

### Parameter des Antwort-Haupttexts (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": { "message": "String", "detail": "String" } |
| Fehlernachricht | Fehlermeldung, die den Grund für das Fehlschlagen der Anforderung enthält. Datentyp: Zeichenfolge |
| Fehler.detail | Zusätzliche Details dazu, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Ergebnis | Ergebnisobjekt, das Informationen zur Anwendung enthält. Datentyp: Objekt "result": { "message": "String", "data": "String" } |
| result.message | Informationen über das erfolgreiche oder nicht erfolgreiche Ergebnis der Anforderung. Datentyp: Zeichenfolge |
| result.data | Sys_id der Anwendung. Befindet sich in der Tabelle „CDM-Anwendung" \[sn_cdm_application\]. 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

In diesem Beispiel wird eine vorhandene -Anwendung aktualisiert.

    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 Config -- POST /devops_config/application {#ariaid-title5}

Erstellt eine Anwendung.

### URL-Format

URL mit Versionsnummer: /api/sn_devops_config/v1/devops_config/application

Standard-URL: /api/sn_devops_config/devops_config/application

### Unterstützte Anforderungsparameter

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

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

{#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 |
|-|-|
| appDescription | Beschreibung der Anwendung. Datentyp: Zeichenfolge |
| appManagedByGroups | Kommagetrennte Liste der sys_ids der Gruppen, die die Anwendung verwalten. Der anrufende Anwender muss zu diesen Gruppen gehören. Befindet sich in der Tabelle „Gruppe" \[sys_user_group\]. Datentyp: Zeichenfolge "appManagedByGroups": "sys_id, sys_id" |
| appManufacturerId | Sys_id des Herstellers. Befindet sich in der Tabelle „Unternehmen" \[core_company\]. Datentyp: Zeichenfolge |
| appModelId | Sys_id eines vorhandenen Anwendungsmodells, das zum Erstellen der Anwendung verwendet werden soll. Befindet sich in der Tabelle „Anwendungsmodell" \[cmdb_application_product_model\]. Wenn dieser Parameter angegeben wird, geben Sie nicht die Parameter appName, appModelName, appServiceName, appServiceIdoder technicalServiceId an. Datentyp: Zeichenfolge |
| appModelName | Name eines vorhandenen Anwendungsmodells, das zum Erstellen der Anwendung verwendet werden soll. Befindet sich in der Tabelle „Anwendungsmodell" \[cmdb_application_product_model\]. Wenn dieser Parameter angegeben wird, geben Sie nicht die Parameter appName, appModelId, appServiceName, appServiceIdoder technicalServiceId an. Datentyp: Zeichenfolge |
| appModelOwnerId | Sys_id des Besitzers des Anwendungsmodells. Befindet sich in der Tabelle „Benutzer" \[sys_user\]. Datentyp: Zeichenfolge |
| appName | Name der Anwendung. Verwenden Sie nicht den Namen einer anderen vorhandenen Anwendung. Wenn dieser Parameter angegeben wird, geben Sie nicht die Parameter appModelName, appModelId, appServiceName, appServiceIdoder technicalServiceId an. Datentyp: Zeichenfolge |
| appServiceId | Sys_id eines vorhandenen Anwendungsservice, der zum Erstellen der Anwendung verwendet werden soll. Befindet sich in der Tabelle „Anwendungsservice" \[cmdb_ci_service_auto\]. Verwenden Sie diesen Parameter nur, wenn type auf <kbd class="ph userinput">Anwendung</kbd>festgelegt ist. Wenn dieser Parameter angegeben wird, geben Sie nicht die Parameter appName, appModelName, appModelId, appServiceNameoder technicalServiceId an. Datentyp: Zeichenfolge |
| appServiceName | Name eines vorhandenen Anwendungsservice, der zum Erstellen der Anwendung verwendet werden soll. Befindet sich in der Tabelle „Anwendungsservice" \[cmdb_ci_service_auto\]. Verwenden Sie diesen Parameter nur, wenn type auf <kbd class="ph userinput">Anwendung</kbd>festgelegt ist. Wenn dieser Parameter angegeben wird, geben Sie nicht die Parameter appName, appModelName, appModelId, appServiceIdoder technicalServiceId an. Datentyp: Zeichenfolge |
| technischeServiceId | Sys_id einer vorhandenen dynamischen CI-Gruppe, die zum Erstellen der Anwendung verwendet werden soll. Befindet sich in der Tabelle „Dynamische CI-Gruppe" \[cmdb_ci_query_based_service\]. Verwenden Sie diesen Parameter nur, wenn type<kbd class="ph userinput">Infrastructure</kbd>(Infrastruktur) ist. Wenn dieser Parameter angegeben wird, geben Sie nicht die Parameter appName, appModelName, appModelId, appServiceNameoder appServiceId an. Datentyp: Zeichenfolge |
| type | Erforderlich. Der Typ der zu erstellenden Anwendung. Gültige Werte: * Anwendung * Infrastruktur {#devops-config-POST-app__ul_rt4_x3q_dvb} Datentyp: Zeichenfolge |
[Tabelle : 21. Parameter des Anforderungstexts (JSON)]

### Header

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

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
[Tabelle : 22. Anforderungskopfzeilen]

{#devops-config-POST-app__entry__40}

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

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST API verwendet werden, finden Sie unter [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 Eigenschaft messageresult im Objekt \[\] enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 24. Statuscodes]

### Parameter des Antwort-Haupttexts (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": { "message": "String", "detail": "String" } |
| Fehlernachricht | Fehlermeldung, die den Grund für das Fehlschlagen der Anforderung enthält. Datentyp: Zeichenfolge |
| Fehler.detail | Zusätzliche Details dazu, warum die Anforderung fehlgeschlagen ist. Datentyp: Zeichenfolge |
| Ergebnis | Ergebnisobjekt, das Informationen zur Anwendung enthält. Datentyp: Objekt "result": { "message": "String", "data": "String" } |
| result.message | Informationen über das erfolgreiche oder nicht erfolgreiche Ergebnis der Anforderung. Datentyp: Zeichenfolge |
| result.data | Sys_id der Anwendung. Befindet sich in der Tabelle „CDM-Anwendung" \[sn_cdm_application\]. 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

In diesem Beispiel wird eine neue -Anwendung erstellt.

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