---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API de configuração de DevOps

# API de configuração de DevOps {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 12 min. de leitura

A API DevOps Config fornece endpoints para gerenciar suas aplicações.
Esta API requer a aplicação Configuração de DevOps e é fornecida no namespace `sn_devops_config`.

Para operações DELETE, PATCH e POST, o usuário de chamada deve ter a função sn_devops_config.admin. Para operações GET, o usuário de chamada deve ter a função sn_devops_config.viewer ou sn_devops_config.admin.

Use a API DevOps Config para gestão do ciclo de vida da aplicação. Para obter mais informações sobre como gerenciar aplicações com Configuração de DevOps, consulte [Como configurar o DevOps](https://www.servicenow.com/docs/access?context=setting-up-devops-config-validation&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US).

## Configuração de DevOps - DELETE /devops_config/application/{appid} {#ariaid-title2}

Exclui uma aplicação.

### Formato da URL

URL com controle de versão: /api/sn_devops_config/v1/devops_config/application/{appid}

URL padrão: /api/sn_devops_config/devops_config/application/{appid}

### Parâmetros de solicitação compatíveis

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

| Nome | Descrição |
|-|-|
| api_version | Opcional. Versão do endpoint a ser acessada. Por exemplo, <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Somente especifique este valor para usar uma versão de endpoint diferente da mais recente. Tipo de dados: cadeia de caracteres |
| appid | Sys_id da aplicação a ser excluída. Localizado na tabela Aplicação de CDM \[sn_cdm_application\]. Tipo de dados: cadeia de caracteres |
[Tabela 1. Parâmetros de caminho]

{#devops-config-DELETE-app__entry__8}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 2. Parâmetros de consulta]

{#devops-config-DELETE-app__entry__12}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 3. Parâmetros do corpo da solicitação (JSON)]

### Cabeçalhos

Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte [Cabeçalhos de REST API compatíveis](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#devops-config-DELETE-app__table_kwn_v1r_fvb__entry__2}{#devops-config-DELETE-app__accept-JSON-only-entry-RESTAPI}

| Cabeçalho | Descrição |
|-|-|
| Aceitar | Formato de dados do corpo da resposta. Oferece suporte somente a application/json. |
[Tabela 4. Cabeçalhos da solicitação]

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

| Cabeçalho | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 5. Cabeçalhos de resposta]

### Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte [Códigos de resposta HTTP de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#devops-config-DELETE-app__table_egh_yyl_gvb__entry__2}{#devops-config-DELETE-app__entry-200-status-code}

| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 400 | Solicitação incorreta. ID da aplicação inválida. |
| 403 | Proibido. O usuário não tem permissão para acessar a API. |
[Tabela 6. Códigos de status]

{#devops-config-DELETE-app__table_egh_yyl_gvb}

### Parâmetros do corpo da resposta (JSON)

{#devops-config-DELETE-app__table_z3v_z5d_gvb__entry__2}

| Nome | Descrição |
|-|-|
| erro | Informações do erro. Este parâmetro só será retornado se a solicitação falhar. Tipo de dados: objeto "error": { "message": "String", "detail": "String" } |
| erro.detalhe | Detalhes adicionais sobre o motivo da falha da solicitação. Tipo de dados: cadeia de caracteres |
| mensagem.erro | Mensagem de erro que contém o motivo da falha na solicitação. Tipo de dados: cadeia de caracteres |
| resultado | Objeto de resultado que contém informações sobre a solicitação. Tipo de dados: objeto "result": { "errors": [Array], "success": [Array] } |
| resultado.erros | Matriz de erros da solicitação. A matriz está vazia para solicitações bem-sucedidas. Tipo de dados: matriz |
| resultado.sucesso | Mensagem de sucesso da solicitação. A matriz está vazia para solicitações com falha. Tipo de dados: matriz |
| status | Status da solicitação. Este parâmetro só será retornado se a solicitação falhar. Valor possível: falha Tipo de dados: cadeia de caracteres |
[ ]

{#devops-config-DELETE-app__table_z3v_z5d_gvb}  

### Solicitação de cURL

Este exemplo exclui uma aplicação.

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

Corpo da resposta.

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

### Solicitação de cURL {#devops-config-DELETE-app__example_ssd_qph_hvb}

Este exemplo mostra uma resposta de erro quando um usuário não tem permissão para acessar a API.

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

Resposta de erro.

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

## Configuração de DevOps - GET /devops_config/application/{appid} {#ariaid-title3}

Recupera uma aplicação.

### Formato da URL

URL com controle de versão: /api/sn_devops_config/v1/devops_config/application/{appid}

URL padrão: /api/sn_devops_config/devops_config/application/{appid}

### Parâmetros de solicitação compatíveis

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

| Nome | Descrição |
|-|-|
| api_version | Opcional. Versão do endpoint a ser acessada. Por exemplo, <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Somente especifique este valor para usar uma versão de endpoint diferente da mais recente. Tipo de dados: cadeia de caracteres |
| appid | Sys_id da aplicação a ser recuperada. Localizado na tabela Aplicação de CDM \[sn_cdm_application\]. Tipo de dados: cadeia de caracteres |
[Tabela 7. Parâmetros de caminho]

{#devops-config-GET-app__entry__8}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 8. Parâmetros de consulta]

{#devops-config-GET-app__entry__12}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 9. Parâmetros do corpo da solicitação (JSON)]

### Cabeçalhos

Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte [Cabeçalhos de REST API compatíveis](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#devops-config-GET-app__table_kwn_v1r_fvb__entry__2}{#devops-config-GET-app__accept-JSON-only-entry-RESTAPI}

| Cabeçalho | Descrição |
|-|-|
| Aceitar | Formato de dados do corpo da resposta. Oferece suporte somente a application/json. |
[Tabela 10. Cabeçalhos da solicitação]

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

| Cabeçalho | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 11. Cabeçalhos de resposta]

### Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte [Códigos de resposta HTTP de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#devops-config-GET-app__entry__24}{#devops-config-GET-app__entry-200-status-code}

| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 400 | Solicitação incorreta. ID da aplicação inválida. |
| 403 | Proibido. O usuário não tem permissão para acessar a API. |
[Tabela 12. Códigos de status]

### Parâmetros do corpo da resposta (JSON)

{#devops-config-GET-app__table_z3v_z5d_gvb__entry__2}

| Nome | Descrição |
|-|-|
| erro | Informações do erro. Este parâmetro só será retornado se a solicitação falhar. Tipo de dados: objeto "error": { "message": "String", "detail": "String" } |
| erro.detalhe | Detalhes adicionais sobre o motivo da falha da solicitação. Tipo de dados: cadeia de caracteres |
| mensagem.erro | Mensagem de erro que contém o motivo da falha na solicitação. Tipo de dados: cadeia de caracteres |
| resultado | Objeto de resultado que contém informações sobre a solicitação. Tipo de dados: objeto "result": { "data": {Object}, "message": "String", "status": Number } |
| resultado.dados | Dados da aplicação. Tipo de dados: objeto "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 | Descrição da aplicação. Tipo de dados: cadeia de caracteres |
| result.data.appId | Sys_id da aplicação. Localizado na tabela Aplicação de CDM \[sn_cdm_application\]. Tipo de dados: cadeia de caracteres |
| result.data.appManagedByGroups | Lista separada por vírgulas de sys_ids dos grupos que gerenciam a aplicação. Localizado na tabela Grupo \[sys_user_group\]. Tipo de dados: cadeia de caracteres |
| result.data.appManufacturerId | Sys_id do fabricante. Localizado na tabela Empresa \[core_company\]. Tipo de dados: cadeia de caracteres |
| result.data.appManufacturerName | Nome do fabricante. Tipo de dados: cadeia de caracteres |
| result.data.appModelId | Sys_id do modelo da aplicação. Localizado na tabela Modelo de aplicação \[cmdb_application_product_model\]. Tipo de dados: cadeia de caracteres |
| result.data.appModelName | Nome do modelo da aplicação. Localizado na tabela Modelo de aplicação \[cmdb_application_product_model\]. Tipo de dados: cadeia de caracteres |
| result.data.appModelOwnerId | Sys_id do proprietário do modelo da aplicação. Localizado na tabela Usuário \[sys_user\]. Tipo de dados: cadeia de caracteres |
| result.data.appModelOwnerName | Nome do proprietário do modelo da aplicação. Tipo de dados: cadeia de caracteres |
| result.data.appName | Nome da aplicação. Tipo de dados: cadeia de caracteres |
| resultado.dados.erro | Informações do erro. Este parâmetro só será retornado se a solicitação falhar. Tipo de dados: cadeia de caracteres |
| resultado.dados.sdlcTipo | O tipo de aplicação. Valores possíveis: * aplicação * infraestrutura {#devops-config-GET-app__ul_rt4_x3q_dvb} Tipo de dados: cadeia de caracteres |
| resultado.mensagem | Informações sobre o resultado bem-sucedido ou malsucedido da solicitação. Tipo de dados: cadeia de caracteres |
| resultado.status | Código de status da solicitação. Valores possíveis: * 200 * 400 * 403 {#devops-config-GET-app__ul_cvg_nkh_hvb} Tipo de dados: número |
| status | Status da solicitação. Este parâmetro só será retornado se a solicitação falhar. Valor possível: falha Tipo de dados: cadeia de caracteres |
[ ]

{#devops-config-GET-app__table_z3v_z5d_gvb}  

### Solicitação de cURL

Este exemplo recupera uma aplicação.

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

Corpo da resposta.

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

### Solicitação de cURL {#devops-config-GET-app__example_wfs_2qh_hvb}

Este exemplo mostra uma resposta de erro quando um usuário fornece um ID de aplicação inválido.

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

Resposta de erro.

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

## Configuração de DevOps - PATCH /devops_config/application/{appid} {#ariaid-title4}

Atualiza uma aplicação.

### Formato da URL

URL com controle de versão: /api/sn_devops_config/v1/devops_config/application/{appid}

URL padrão: /api/sn_devops_config/devops_config/application/{appid}

### Parâmetros de solicitação compatíveis

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

| Nome | Descrição |
|-|-|
| api_version | Opcional. Versão do endpoint a ser acessada. Por exemplo, <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Somente especifique este valor para usar uma versão de endpoint diferente da mais recente. Tipo de dados: cadeia de caracteres |
| appid | Sys_id da aplicação a ser atualizada. Localizado na tabela Aplicação de CDM \[sn_cdm_application\]. Tipo de dados: cadeia de caracteres |
[Tabela 13. Parâmetros de caminho]

{#devops-config-PATCH-app__entry__8}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 14. Parâmetros de consulta]

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

| Nome | Descrição |
|-|-|
| appDescription | Descrição da aplicação. Tipo de dados: cadeia de caracteres |
| appManagedByGroups | Lista separada por vírgulas de sys_ids dos grupos que gerenciam a aplicação. O usuário de chamada deve pertencer a esses grupos. Localizado na tabela Grupo \[sys_user_group\]. Tipo de dados: cadeia de caracteres "appManagedByGroups": "sys_id, sys_id" |
| appManufacturerId | Sys_id do fabricante. Localizado na tabela Empresa \[core_company\]. Tipo de dados: cadeia de caracteres |
| appModelOwnerId | Sys_id do proprietário do modelo da aplicação. Localizado na tabela Usuário \[sys_user\]. Tipo de dados: cadeia de caracteres |
[Tabela 15. Parâmetros do corpo da solicitação (JSON)]

### Cabeçalhos

Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte [Cabeçalhos de REST API compatíveis](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#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}

| Cabeçalho | Descrição |
|-|-|
| Aceitar | Formato de dados do corpo da resposta. Oferece suporte somente a application/json. |
| Tipo de conteúdo | Formato de dados do corpo da solicitação. Oferece suporte somente a application/json. |
[Tabela 16. Cabeçalhos da solicitação]

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

| Cabeçalho | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 17. Cabeçalhos de resposta]

### Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte [Códigos de resposta HTTP de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#devops-config-PATCH-app__table_jk3_y1r_fvb__entry__2}

| Código de status | Descrição |
|-|-|
| 200 | Aplicação atualizada com sucesso. |
| 403 | Proibido. O usuário não tem permissão para acessar a API. |
| 404 | Aplicação não atualizada. A propriedade \[ message no objeto result contém informações adicionais sobre o erro. |
[Tabela 18. Códigos de status]

{#devops-config-PATCH-app__table_jk3_y1r_fvb}

### Parâmetros do corpo da resposta (JSON) {#devops-config-PATCH-app__section_y3v_z5d_gvb}

{#devops-config-PATCH-app__table_z3v_z5d_gvb__entry__2}

| Nome | Descrição |
|-|-|
| erro | Informações do erro. Este parâmetro só será retornado se a solicitação falhar. Tipo de dados: objeto "error": { "message": "String", "detail": "String" } |
| mensagem.erro | Mensagem de erro que contém o motivo da falha na solicitação. Tipo de dados: cadeia de caracteres |
| erro.detalhe | Detalhes adicionais sobre o motivo da falha da solicitação. Tipo de dados: cadeia de caracteres |
| resultado | Objeto de resultado que contém informações sobre a aplicação. Tipo de dados: objeto "result": { "message": "String", "data": "String" } |
| resultado.mensagem | Informações sobre o resultado bem-sucedido ou malsucedido da solicitação. Tipo de dados: cadeia de caracteres |
| resultado.dados | Sys_id da aplicação. Localizado na tabela Aplicação de CDM \[sn_cdm_application\]. Tipo de dados: cadeia de caracteres |
| status | Status da solicitação. Este parâmetro só será retornado se a solicitação falhar. Valor possível: falha Tipo de dados: cadeia de caracteres |
[ ]

{#devops-config-PATCH-app__table_z3v_z5d_gvb}  

### Solicitação de cURL

Este exemplo atualiza uma aplicação existente.

    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' 

Corpo da resposta.

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

## Configuração de DevOps - POST /devops_config/application {#ariaid-title5}

Cria uma aplicação.

### Formato da URL

URL com controle de versão: /api/sn_devops_config/v1/devops_config/application

URL padrão: /api/sn_devops_config/devops_config/application

### Parâmetros de solicitação compatíveis

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

| Nome | Descrição |
|-|-|
| api_version | Opcional. Versão do endpoint a ser acessada. Por exemplo, <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Somente especifique este valor para usar uma versão de endpoint diferente da mais recente. Tipo de dados: cadeia de caracteres |
[Tabela 19. Parâmetros de caminho]

{#devops-config-POST-app__entry__6}

| Nome | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 20. Parâmetros de consulta]

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

| Nome | Descrição |
|-|-|
| appDescription | Descrição da aplicação. Tipo de dados: cadeia de caracteres |
| appManagedByGroups | Lista separada por vírgulas de sys_ids dos grupos que gerenciam a aplicação. O usuário de chamada deve pertencer a esses grupos. Localizado na tabela Grupo \[sys_user_group\]. Tipo de dados: cadeia de caracteres "appManagedByGroups": "sys_id, sys_id" |
| appManufacturerId | Sys_id do fabricante. Localizado na tabela Empresa \[core_company\]. Tipo de dados: cadeia de caracteres |
| appModelId | Sys_id de um modelo de aplicação existente a ser usado para criar a aplicação. Localizado na tabela Modelo de aplicação \[cmdb_application_product_model\]. Se este parâmetro for fornecido, não forneça os parâmetros appName, appModelName, appServiceName, appServiceIdou technicalServiceId. Tipo de dados: cadeia de caracteres |
| appModelName | Nome de um modelo de aplicação existente a ser usado para criar a aplicação. Localizado na tabela Modelo de aplicação \[cmdb_application_product_model\]. Se este parâmetro for fornecido, não forneça os parâmetros appName, appModelId, appServiceName, appServiceIdou technicalServiceId. Tipo de dados: cadeia de caracteres |
| appModelOwnerId | Sys_id do proprietário do modelo da aplicação. Localizado na tabela Usuário \[sys_user\]. Tipo de dados: cadeia de caracteres |
| appName | Nome da aplicação. Não use o mesmo nome de qualquer aplicação existente. Se este parâmetro for fornecido, não forneça os parâmetros appModelName, appModelId, appServiceName, appServiceIdou technicalServiceId. Tipo de dados: cadeia de caracteres |
| appServiceId | Sys_id de um serviço de aplicativos existente a ser usado para criar a aplicação. Localizado na tabela Serviço de aplicações \[cmdb_ci_service_auto\]. Use este parâmetro somente quando type for uma <kbd class="ph userinput">aplicação</kbd>. Se este parâmetro for fornecido, não forneça os parâmetros appName, appModelName, appModelId, appServiceNameou technicalServiceId. Tipo de dados: cadeia de caracteres |
| appServiceName | Nome de um serviço de aplicativos existente a ser usado para criar a aplicação. Localizado na tabela Serviço de aplicações \[cmdb_ci_service_auto\]. Use este parâmetro somente quando type for uma <kbd class="ph userinput">aplicação</kbd>. Se este parâmetro for fornecido, não forneça os parâmetros appName, appModelName, appModelId, appServiceIdou technicalServiceId. Tipo de dados: cadeia de caracteres |
| técnicoServiçoId | Sys_id de um grupo de IC dinâmico existente a ser usado para criar a aplicação. Localizado na tabela Grupo de ICs dinâmicos \[cmdb_ci_query_based_service\]. Use este parâmetro somente quando o type for <kbd class="ph userinput">infraestrutura</kbd>. Se este parâmetro for fornecido, não forneça os parâmetros appName, appModelName, appModelId, appServiceNameou appServiceId. Tipo de dados: cadeia de caracteres |
| tipo | Obrigatório. O tipo de aplicação a ser criado. Valores válidos: * aplicação * infraestrutura {#devops-config-POST-app__ul_rt4_x3q_dvb} Tipo de dados: cadeia de caracteres |
[Tabela 21. Parâmetros do corpo da solicitação (JSON)]

### Cabeçalhos

Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte [Cabeçalhos de REST API compatíveis](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#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}

| Cabeçalho | Descrição |
|-|-|
| Aceitar | Formato de dados do corpo da resposta. Oferece suporte somente a application/json. |
| Tipo de conteúdo | Formato de dados do corpo da solicitação. Oferece suporte somente a application/json. |
[Tabela 22. Cabeçalhos da solicitação]

{#devops-config-POST-app__entry__40}

| Cabeçalho | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 23. Cabeçalhos de resposta]

### Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte [Códigos de resposta HTTP de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#devops-config-POST-app__entry__44}

| Código de status | Descrição |
|-|-|
| 201 | Aplicação criada com sucesso. |
| 403 | Proibido. O usuário não tem permissão para acessar a API. |
| 404 | Aplicação não criada. A propriedade \[ message no objeto result contém informações adicionais sobre o erro. |
[Tabela 24. Códigos de status]

### Parâmetros do corpo da resposta (JSON) {#devops-config-POST-app__section_y3v_z5d_gvb}

{#devops-config-POST-app__table_z3v_z5d_gvb__entry__2}

| Nome | Descrição |
|-|-|
| erro | Informações do erro. Este parâmetro só será retornado se a solicitação falhar. Tipo de dados: objeto "error": { "message": "String", "detail": "String" } |
| mensagem.erro | Mensagem de erro que contém o motivo da falha na solicitação. Tipo de dados: cadeia de caracteres |
| erro.detalhe | Detalhes adicionais sobre o motivo da falha da solicitação. Tipo de dados: cadeia de caracteres |
| resultado | Objeto de resultado que contém informações sobre a aplicação. Tipo de dados: objeto "result": { "message": "String", "data": "String" } |
| resultado.mensagem | Informações sobre o resultado bem-sucedido ou malsucedido da solicitação. Tipo de dados: cadeia de caracteres |
| resultado.dados | Sys_id da aplicação. Localizado na tabela Aplicação de CDM \[sn_cdm_application\]. Tipo de dados: cadeia de caracteres |
| status | Status da solicitação. Este parâmetro só será retornado se a solicitação falhar. Valor possível: falha Tipo de dados: cadeia de caracteres |
[ ]

{#devops-config-POST-app__table_z3v_z5d_gvb}  

### Solicitação de cURL

Este exemplo cria uma nova aplicação.

    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' 

Corpo da resposta.

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