---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API de configuration DevOps

# API de configuration DevOps {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 12 minutes de lecture

L'API DevOps Config fournit des points de terminaison pour gérer vos applications.
Cette API nécessite l'application DevOps Config et est fournie dans l'espace de noms `sn_devops_config` .

Pour les opérations DELETE, PATCH et POST, l'utilisateur appelant doit avoir le rôle sn_devops_config.admin. Pour les opérations GET, l'utilisateur appelant doit avoir le rôle sn_devops_config.viewer ou sn_devops_config.admin.

Utilisez l'API DevOps Config pour la gestion du cycle de vie des applications. Pour plus d'informations sur la gestion des applications avec DevOps Config, consultez [Configuration DevOps](https://www.servicenow.com/docs/access?context=setting-up-devops-config-validation&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US).

## Configuration DevOps : SUPPRIMER /devops_config/application/{appid} {#ariaid-title2}

Supprime une application.

### Format d'URL

URL versionnée : /api/sn_devops_config/v1/devops_config/application/{appid}

URL par défaut : /api/sn_devops_config/devops_config/application/{appid}

### Paramètres de demande pris en charge

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

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
| appid | Sys_id de l'application à supprimer. Situé dans la table \[sn_cdm_application\] de l'application CDM. Type de données : chaîne |
[Tableau 1. Paramètres de chemin d'accès]

{#devops-config-DELETE-app__entry__8}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 2. Paramètres de requête]

{#devops-config-DELETE-app__entry__12}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 3. Paramètres du corps de la demande (JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#devops-config-DELETE-app__table_kwn_v1r_fvb__entry__2}{#devops-config-DELETE-app__accept-JSON-only-entry-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
[Tableau 4. En-têtes de demandes]

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

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 5. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#devops-config-DELETE-app__table_egh_yyl_gvb__entry__2}{#devops-config-DELETE-app__entry-200-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 400 | Demande incorrecte. ID d'application non valide. |
| 403 | Interdit. L'utilisateur n'a pas l'autorisation d'accéder à l'API. |
[Tableau 6. Codes d'état]

{#devops-config-DELETE-app__table_egh_yyl_gvb}

### Paramètres de corps de réponse (JSON)

{#devops-config-DELETE-app__table_z3v_z5d_gvb__entry__2}

| Nom | Description |
|-|-|
| erreur | Informations erronées. Ce paramètre n'est renvoyé qu'en cas d'échec de la demande. Type de données : objet "error": { "message": "String", "detail": "String" } |
| error.detail | Détails supplémentaires sur les raisons de l'échec de la demande. Type de données : chaîne |
| message.erreur | Message d'erreur indiquant le motif de l'échec de la demande. Type de données : chaîne |
| résultat | Objet de résultat contenant des informations sur la demande. Type de données : objet "result": { "errors": [Array], "success": [Array] } |
| Résultat.Erreurs | Tableau des erreurs de la demande. Le tableau est vide pour les demandes réussies. Type de données : tableau |
| résultat.succès | Message de réussite de la demande. Le tableau est vide pour les demandes ayant échoué. Type de données : tableau |
| statut | État de la demande. Ce paramètre n'est renvoyé qu'en cas d'échec de la demande. Valeur possible : échec Type de données : chaîne |
[ ]

{#devops-config-DELETE-app__table_z3v_z5d_gvb}  

### Demande cURL

Cet exemple supprime une application.

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

Corps de réponse.

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

### Demande cURL {#devops-config-DELETE-app__example_ssd_qph_hvb}

Cet exemple affiche une réponse d'erreur lorsqu'un utilisateur n'a pas l'autorisation d'accéder à l'API.

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

Réponse d'erreur.

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

## Configuration DevOps : GET /devops_config/application/{appid} {#ariaid-title3}

Récupère une application.

### Format d'URL

URL versionnée : /api/sn_devops_config/v1/devops_config/application/{appid}

URL par défaut : /api/sn_devops_config/devops_config/application/{appid}

### Paramètres de demande pris en charge

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

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
| appid | Sys_id de l'application à récupérer. Situé dans la table \[sn_cdm_application\] de l'application CDM. Type de données : chaîne |
[Tableau 7. Paramètres de chemin d'accès]

{#devops-config-GET-app__entry__8}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 8. Paramètres de requête]

{#devops-config-GET-app__entry__12}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 9. Paramètres du corps de la demande (JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#devops-config-GET-app__table_kwn_v1r_fvb__entry__2}{#devops-config-GET-app__accept-JSON-only-entry-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
[Tableau 10. En-têtes de demandes]

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

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 11. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#devops-config-GET-app__entry__24}{#devops-config-GET-app__entry-200-status-code}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 400 | Demande incorrecte. ID d'application non valide. |
| 403 | Interdit. L'utilisateur n'a pas l'autorisation d'accéder à l'API. |
[Tableau 12. Codes d'état]

### Paramètres de corps de réponse (JSON)

{#devops-config-GET-app__table_z3v_z5d_gvb__entry__2}

| Nom | Description |
|-|-|
| erreur | Informations erronées. Ce paramètre n'est renvoyé qu'en cas d'échec de la demande. Type de données : objet "error": { "message": "String", "detail": "String" } |
| error.detail | Détails supplémentaires sur les raisons de l'échec de la demande. Type de données : chaîne |
| message.erreur | Message d'erreur indiquant le motif de l'échec de la demande. Type de données : chaîne |
| résultat | Objet de résultat contenant des informations sur la demande. Type de données : objet "result": { "data": {Object}, "message": "String", "status": Number } |
| données.résultats | Données pour l'application. Type de données : objet "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 | Description de l'application. Type de données : chaîne |
| result.data.appId | Sys_id de l'application. Situé dans la table \[sn_cdm_application\] de l'application CDM. Type de données : chaîne |
| result.data.appManagedByGroups | Liste séparée par des virgules des sys_ids des groupes qui gèrent l'application. Situé dans la table Groupe \[sys_user_group\]. Type de données : chaîne |
| result.data.appManufacturerId | Sys_id du fabricant. Situé dans la table Société \[core_company\]. Type de données : chaîne |
| result.data.appManufacturerName | Nom du fabricant. Type de données : chaîne |
| result.data.appModelId | Sys_id du modèle d'application. Situé dans la table Modèle d'application \[cmdb_application_product_model\]. Type de données : chaîne |
| result.data.appModelName | Nom du modèle d'application. Situé dans la table Modèle d'application \[cmdb_application_product_model\]. Type de données : chaîne |
| result.data.appModelOwnerId | Sys_id du propriétaire du modèle d'application. Situé dans la table Utilisateur \[sys_user\]. Type de données : chaîne |
| result.data.appModelOwnerName | Nom du propriétaire du modèle d'application. Type de données : chaîne |
| result.data.appName | Nom de l'application. Type de données : chaîne |
| résultat.données.erreur | Informations erronées. Ce paramètre n'est renvoyé qu'en cas d'échec de la demande. Type de données : chaîne |
| result.data.sdlcType | Le type d'application. Valeurs possibles : * l'application * infrastructure {#devops-config-GET-app__ul_rt4_x3q_dvb} Type de données : chaîne |
| résultat.message | Informations sur le résultat réussi ou échoué de la demande. Type de données : chaîne |
| Résultat.État | Code d'état de la demande. Valeurs possibles : * 200 * 400 * 403 {#devops-config-GET-app__ul_cvg_nkh_hvb} Type de données : nombre |
| statut | État de la demande. Ce paramètre n'est renvoyé qu'en cas d'échec de la demande. Valeur possible : échec Type de données : chaîne |
[ ]

{#devops-config-GET-app__table_z3v_z5d_gvb}  

### Demande cURL

Cet exemple récupère une application.

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

Corps de réponse.

    { 
      "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": [] 
        } 
      } 
    }

### Demande cURL {#devops-config-GET-app__example_wfs_2qh_hvb}

Cet exemple affiche une réponse d'erreur lorsqu'un utilisateur fournit un ID d'application non valide.

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

Réponse d'erreur.

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

## Configuration DevOps : PATCH /devops_config/application/{appid} {#ariaid-title4}

Met à jour une application.

### Format d'URL

URL versionnée : /api/sn_devops_config/v1/devops_config/application/{appid}

URL par défaut : /api/sn_devops_config/devops_config/application/{appid}

### Paramètres de demande pris en charge

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

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
| appid | Sys_id de l'application à mettre à jour. Situé dans la table \[sn_cdm_application\] de l'application CDM. Type de données : chaîne |
[Tableau 13. Paramètres de chemin d'accès]

{#devops-config-PATCH-app__entry__8}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 14. Paramètres de requête]

{#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}

| Nom | Description |
|-|-|
| appDescription | Description de l'application. Type de données : chaîne |
| appManagedByGroups | Liste séparée par des virgules des sys_ids des groupes qui gèrent l'application. L'utilisateur appelant doit appartenir à ces groupes. Situé dans la table Groupe \[sys_user_group\]. Type de données : chaîne "appManagedByGroups": "sys_id, sys_id" |
| appManufacturerId (en anglais seulement) | Sys_id du fabricant. Situé dans la table Société \[core_company\]. Type de données : chaîne |
| appModelOwnerId (en anglais seulement) | Sys_id du propriétaire du modèle d'application. Situé dans la table Utilisateur \[sys_user\]. Type de données : chaîne |
[Tableau 15. Paramètres du corps de la demande (JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#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}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
| Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. |
[Tableau 16. En-têtes de demandes]

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

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 17. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#devops-config-PATCH-app__table_jk3_y1r_fvb__entry__2}

| Code d'état | Description |
|-|-|
| 200 | L'application a été mise à jour avec succès. |
| 403 | Interdit. L'utilisateur n'a pas l'autorisation d'accéder à l'API. |
| 404 | L'application n'a pas été mise à jour. La message propriété dans l'objet result contient des informations supplémentaires sur l'erreur. |
[Tableau 18. Codes d'état]

{#devops-config-PATCH-app__table_jk3_y1r_fvb}

### Paramètres de corps de réponse (JSON) {#devops-config-PATCH-app__section_y3v_z5d_gvb}

{#devops-config-PATCH-app__table_z3v_z5d_gvb__entry__2}

| Nom | Description |
|-|-|
| erreur | Informations erronées. Ce paramètre n'est renvoyé qu'en cas d'échec de la demande. Type de données : objet "error": { "message": "String", "detail": "String" } |
| message.erreur | Message d'erreur indiquant le motif de l'échec de la demande. Type de données : chaîne |
| error.detail | Détails supplémentaires sur les raisons de l'échec de la demande. Type de données : chaîne |
| résultat | Objet de résultat contenant des informations sur l'application. Type de données : objet "result": { "message": "String", "data": "String" } |
| résultat.message | Informations sur le résultat réussi ou échoué de la demande. Type de données : chaîne |
| données.résultats | Sys_id de l'application. Situé dans la table \[sn_cdm_application\] de l'application CDM. Type de données : chaîne |
| statut | État de la demande. Ce paramètre n'est renvoyé qu'en cas d'échec de la demande. Valeur possible : échec Type de données : chaîne |
[ ]

{#devops-config-PATCH-app__table_z3v_z5d_gvb}  

### Demande cURL

Cet exemple met à jour une application existante.

    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' 

Corps de réponse.

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

## Configuration DevOps : POST /devops_config/application {#ariaid-title5}

Crée une application.

### Format d'URL

URL versionnée : /api/sn_devops_config/v1/devops_config/application

URL par défaut : /api/sn_devops_config/devops_config/application

### Paramètres de demande pris en charge

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

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
[Tableau 19. Paramètres de chemin d'accès]

{#devops-config-POST-app__entry__6}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 20. Paramètres de requête]

{#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}

| Nom | Description |
|-|-|
| appDescription | Description de l'application. Type de données : chaîne |
| appManagedByGroups | Liste séparée par des virgules des sys_ids des groupes qui gèrent l'application. L'utilisateur appelant doit appartenir à ces groupes. Situé dans la table Groupe \[sys_user_group\]. Type de données : chaîne "appManagedByGroups": "sys_id, sys_id" |
| appManufacturerId (en anglais seulement) | Sys_id du fabricant. Situé dans la table Société \[core_company\]. Type de données : chaîne |
| appModelId (en anglais seulement) | Sys_id d'un modèle d'application existant à utiliser pour créer l'application. Situé dans la table Modèle d'application \[cmdb_application_product_model\]. Si ce paramètre est fourni, ne fournissez pas les appNameparamètres , appModelName, appServiceNameappServiceId, , ou technicalServiceId . Type de données : chaîne |
| Nom du modèle d'application | Nom d'un modèle d'application existant à utiliser pour créer l'application. Situé dans la table Modèle d'application \[cmdb_application_product_model\]. Si ce paramètre est fourni, ne fournissez pas les appNameparamètres , appModelId, appServiceNameappServiceId, , ou technicalServiceId . Type de données : chaîne |
| appModelOwnerId (en anglais seulement) | Sys_id du propriétaire du modèle d'application. Situé dans la table Utilisateur \[sys_user\]. Type de données : chaîne |
| appName | Nom de l'application. N'utilisez pas le même nom qu'une application existante. Si ce paramètre est fourni, ne fournissez pas les appModelNameparamètres , appModelId, appServiceNameappServiceId, , ou technicalServiceId . Type de données : chaîne |
| appServiceId | Sys_id d'un service d'application existant à utiliser pour créer l'application. Situé dans la table Service d'application \[cmdb_ci_service_auto\]. Utilisez ce paramètre uniquement lorsque <kbd class="ph userinput">l’application</kbd>type EST. Si ce paramètre est fourni, ne fournissez pas les appNameparamètres , appModelName, appModelIdappServiceName, , ou technicalServiceId . Type de données : chaîne |
| nom d'application | Nom d'un service d'application existant à utiliser pour créer l'application. Situé dans la table Service d'application \[cmdb_ci_service_auto\]. Utilisez ce paramètre uniquement lorsque <kbd class="ph userinput">l’application</kbd>type EST. Si ce paramètre est fourni, ne fournissez pas les appNameparamètres , appModelName, appModelIdappServiceId, , ou technicalServiceId . Type de données : chaîne |
| Id du service technique | Sys_id d'un groupe de CI dynamique existant à utiliser pour créer l'application. Situé dans la table Groupe de CI dynamique \[cmdb_ci_query_based_service\]. Utilisez ce paramètre uniquement lorsque le est <kbd class="ph userinput">une</kbd>type infrastructure. Si ce paramètre est fourni, ne fournissez pas les appNameparamètres , appModelName, appModelId appServiceName, , ou appServiceId . Type de données : chaîne |
| type | Requis. Type d'application à créer. Valeurs valides : * l'application * infrastructure {#devops-config-POST-app__ul_rt4_x3q_dvb} Type de données : chaîne |
[Tableau 21. Paramètres du corps de la demande (JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#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}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. |
| Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. |
[Tableau 22. En-têtes de demandes]

{#devops-config-POST-app__entry__40}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 23. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#devops-config-POST-app__entry__44}

| Code d'état | Description |
|-|-|
| 201 | Application créée avec succès. |
| 403 | Interdit. L'utilisateur n'a pas l'autorisation d'accéder à l'API. |
| 404 | Application non créée. La message propriété dans l'objet result contient des informations supplémentaires sur l'erreur. |
[Tableau 24. Codes d'état]

### Paramètres de corps de réponse (JSON) {#devops-config-POST-app__section_y3v_z5d_gvb}

{#devops-config-POST-app__table_z3v_z5d_gvb__entry__2}

| Nom | Description |
|-|-|
| erreur | Informations erronées. Ce paramètre n'est renvoyé qu'en cas d'échec de la demande. Type de données : objet "error": { "message": "String", "detail": "String" } |
| message.erreur | Message d'erreur indiquant le motif de l'échec de la demande. Type de données : chaîne |
| error.detail | Détails supplémentaires sur les raisons de l'échec de la demande. Type de données : chaîne |
| résultat | Objet de résultat contenant des informations sur l'application. Type de données : objet "result": { "message": "String", "data": "String" } |
| résultat.message | Informations sur le résultat réussi ou échoué de la demande. Type de données : chaîne |
| données.résultats | Sys_id de l'application. Situé dans la table \[sn_cdm_application\] de l'application CDM. Type de données : chaîne |
| statut | État de la demande. Ce paramètre n'est renvoyé qu'en cas d'échec de la demande. Valeur possible : échec Type de données : chaîne |
[ ]

{#devops-config-POST-app__table_z3v_z5d_gvb}  

### Demande cURL

Cet exemple crée une application.

    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' 

Corps de réponse.

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