---
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 serviços do SG

# API de serviços do SG {#ariaid-title1}

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

A API SG Services fornece endpoints para criar e gerenciar serviços de aplicações e os relacionamentos ascendentes entre eles.

## Solicitar aplicativos na Store {#sg_services-api__section_eck_nxy_pqb}

Acesse o site [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativas para todos os apps lançados, consulte as [notas de versão da ServiceNow Store](https://www.servicenow.com/docs/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html).{#sg_services-api__inline-send-to-store}
Esta API só pode ser usada quando o plug-in API da aplicação do CMDB e CLI (sn_service_graph) estão ativados. Esta API é usada no namespace `sn_service_graph`.

O uso desta API não requer detalhes sobre tabelas de origem ou tipos de relacionamento.

Para criar script de operações críticas que oferecem suporte à automação em toda a empresa, você pode aproveitar APIs ou executar operações de linha de comando fornecidas pela CLI da aplicação do CMDB e pela aplicação da loja de APIs em vez de usar a interface do usuário. A CLI da aplicação do CMDB e a aplicação da loja de APIs fornecem uma estrutura robusta que consolida todas as APIs relacionadas aos serviços de aplicações e as linhas de comando que permitem acessar a interface com essas APIs.  
A CLI da aplicação do CMDB e os comandos de API habilitam as seguintes tarefas:

* Registrar e criar um serviço de aplicações e estabelecer relacionamentos ascendentes
* Obter detalhes de um determinado serviço de aplicações e seus relacionamentos ascendentes
* Conectando construções de nível superior, como aplicações de negócios e ofertas de serviço de negócios
* Preencher um serviço de aplicações com um determinado tipo de preenchimento
* Como alterar o estado de um serviço de aplicativos
{#sg_services-api__ul_q4w_dgj_3qb}

Para a solução de linha de comando, consulte [Comandos disponíveis de API e CLI da aplicação do CMDB](https://www.servicenow.com/docs/access?context=cmdb-cli-commands&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US).

## Serviços SG -- POST -- /sg_services/app_service/convert {#ariaid-title2}

Converte um serviço de aplicativos de tipo manual ou vazio em um serviço de aplicativos calculado. Durante a conversão, o registro de serviço de aplicativos é movido para a tabela \[cmdb_ci_service_calculated\] com a classe recém-atribuída.
As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

1. sys_id -- se for sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
2. número -- Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
3. \<IRE field name\>-- O sistema só usará esses valores se o sys_id ou o número não forem fornecidos.
{#sg_svcs-POST-convert__ol_qk4_msd_3qb}

### Formato da URL

URL com controle de versão: /api/sn_service_graph/{api_version}/sg_services/app_service/convert

URL padrão: /api/sn_service_graph/sg_services/app_service/convert

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

{#sg_svcs-POST-convert__entry__2}{#sg_svcs-POST-convert__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 1. Parâmetros de caminho]

{#sg_svcs-POST-convert__entry__6}

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

{#sg_svcs-POST-convert__entry__10}{#sg_svcs-POST-convert__sg_svcs-reqParm-ire-ph}{#sg_svcs-POST-convert__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-convert__sg_svcs-reqParm-sysid-ph}

| Nome | Descrição |
|-|-|
| \<IRE field name\> | Um ou mais campos de IRE que identificam o serviço de aplicações. Por exemplo, nome ou versão. Tipo de dados: cadeia de caracteres |
| níveis | Número de níveis a serem incluídos na conversão. Tipo de dados: cadeia de caracteres |
| número | Número exclusivo que identifica o serviço de aplicativos. Tipo de dados: cadeia de caracteres |
| sys_id | Sys_id do serviço de aplicações listado na tabela Serviço de aplicações \[cmdb_ci_service_auto\]. Tipo de dados: cadeia de caracteres |
[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.").
{#sg_svcs-POST-convert__entry__20}{#sg_svcs-POST-convert__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]

{#sg_svcs-POST-convert__entry__24}

| 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.").
{#sg_svcs-POST-convert__entry__28}{#sg_svcs-POST-convert__entry-200-status-code}{#sg_svcs-POST-convert__entry-400-status-code}{#sg_svcs-POST-convert__entry-500-status-code}

| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 400 | Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou o usuário não tem a função app_service_admin. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
[Tabela 6. Códigos de status]

### Parâmetros do corpo da resposta (JSON) {#sg_svcs-POST-convert__section_hyx_jnx_gqb}

{#sg_svcs-POST-convert__table_iyx_jnx_gqb__entry__2}

| Nome | Descrição |
|-|-|
| status | Indica sucesso ou falha. Tipo de dados: cadeia de caracteres |
[ ]

{#sg_svcs-POST-convert__table_iyx_jnx_gqb}  

### Solicitação de cURL

O exemplo a seguir mostra como converter um tipo de serviço de aplicativos.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/convert" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
     \"name\": \"Test Register\",
     \"environment\": \"Test\",
     \"version\": \"1.0\",
     \"levels\" : 8
    }" \
    --user 'username':'password'

Resultados que indicam uma conversão bem-sucedida para um serviço de aplicativos calculado.

    {
      "result": {
      "status": "success"
      }
    }

## Serviços SG -- POST -- /sg_services/app_service/delete {#ariaid-title3}

Exclui um serviço de aplicativos.
As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

1. sys_id -- se for sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
2. número -- Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
3. \<IRE field name\>-- O sistema só usará esses valores se o sys_id ou o número não forem fornecidos.
{#sg_svcs-POST-delete__ol_qk4_msd_3qb}

### Formato da URL

URL com controle de versão: /api/sn_service_graph/{api_version}/sg_services/app_service/delete

URL padrão: /api/sn_service_graph/sg_services/app_service/delete

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

{#sg_svcs-POST-delete__entry__2}{#sg_svcs-POST-delete__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 7. Parâmetros de caminho]

{#sg_svcs-POST-delete__entry__6}

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

{#sg_svcs-POST-delete__table_e5t_gwt_gqb__entry__2}{#sg_svcs-POST-delete__sg_svcs-reqParm-ire-ph}{#sg_svcs-POST-delete__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-delete__sg_svcs-reqParm-sysid-ph}

| Nome | Descrição |
|-|-|
| \<IRE field name\> | Um ou mais campos de IRE que identificam o serviço de aplicações. Por exemplo, nome ou versão. Tipo de dados: cadeia de caracteres |
| número | Número exclusivo que identifica o serviço de aplicativos. Tipo de dados: cadeia de caracteres |
| sys_id | Sys_id do serviço de aplicações listado na tabela Serviço de aplicações \[cmdb_ci_service_auto\]. Tipo de dados: cadeia de caracteres |
[Tabela 9. Parâmetros do corpo da solicitação (JSON)]

{#sg_svcs-POST-delete__table_e5t_gwt_gqb}

### 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.").
{#sg_svcs-POST-delete__entry__18}{#sg_svcs-POST-delete__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]

{#sg_svcs-POST-delete__entry__22}

| 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.").
{#sg_svcs-POST-delete__entry__26}{#sg_svcs-POST-delete__entry-200-status-code}{#sg_svcs-POST-delete__entry-400-status-code}{#sg_svcs-POST-delete__entry-500-status-code}

| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 400 | Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou o usuário não tem a função app_service_admin. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
[Tabela 12. Códigos de status]

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

{#sg_svcs-POST-delete__table_pvd_l5t_gqb__entry__2}

| Nome | Descrição |
|-|-|
| status | Indica sucesso ou falha. Tipo de dados: cadeia de caracteres |
[ ]

{#sg_svcs-POST-delete__table_pvd_l5t_gqb}  

### Solicitação de cURL

O exemplo a seguir mostra como excluir um serviço de aplicativos.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/delete" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       \"name\": \"Test Register\",
       \"environment\": \"Test\",
       \"version\": \"1.0\"
    }" \
    --user 'username':'password'

Resultados que indicam uma remoção bem-sucedida de um serviço de aplicativos.

    {
      "result": {
      "status": "success"
      }
    }

## Serviços SG -- POST -- /sg_services/app_service/find {#ariaid-title4}

Encontra os detalhes de um determinado serviço de aplicativos e seus relacionamentos ascendentes.
Usuários com a função app_service_user podem usar esta API, mas os resultados são restritos a serviços de aplicações com status Operacional. A função app_service_admin fornece exibição ilimitada de serviços de aplicações.  
As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

1. sys_id -- se for sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
2. número -- Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
3. \<IRE field name\>-- O sistema só usará esses valores se o sys_id ou o número não forem fornecidos.
{#sg_svcs-POST-find__ol_qk4_msd_3qb}

### Formato da URL

URL com controle de versão: /api/sn_service_graph/{api_version}/sg_services/app_service/find

URL padrão: /api/sn_service_graph/sg_services/app_service/find

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

{#sg_svcs-POST-find__entry__2}{#sg_svcs-POST-find__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 13. Parâmetros de caminho]

{#sg_svcs-POST-find__entry__6}

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

{#sg_svcs-POST-find__entry__10}{#sg_svcs-POST-find__sg_svcs-reqParm-ire-ph}{#sg_svcs-POST-find__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-find__sg_svcs-reqParm-sysid-ph}

| Nome | Descrição |
|-|-|
| \<IRE fields\> | Um ou mais campos de IRE que identificam o serviço de aplicações. Por exemplo, nome ou versão. Tipo de dados: cadeia de caracteres |
| número | Número exclusivo que identifica o serviço de aplicativos. Tipo de dados: cadeia de caracteres |
| sys_id | Sys_id do serviço de aplicações listado na tabela Serviço de aplicações \[cmdb_ci_service_auto\]. 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.").
{#sg_svcs-POST-find__entry__18}{#sg_svcs-POST-find__accept-JSON-only-entry-RESTAPI}

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

{#sg_svcs-POST-find__entry__22}

| 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.").
{#sg_svcs-POST-find__entry__26}{#sg_svcs-POST-find__entry-200-status-code}{#sg_svcs-POST-find__entry-400-status-code}{#sg_svcs-POST-find__entry-500-status-code}

| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 400 | Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou o usuário não tem a função app_service_admin. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
[Tabela 18. Códigos de status]

### Parâmetros do corpo da resposta (JSON) {#sg_svcs-POST-find__section_hyx_jnx_gqb}

{#sg_svcs-POST-find__table_iyx_jnx_gqb__entry__2}{#sg_svcs-POST-find__d2838e242}

| Nome | Descrição |
|-|-|
| \<IRE field name\> | Um ou mais campos de IRE que identificam o serviço de aplicações. Por exemplo, nome ou versão. Tipo de dados: cadeia de caracteres |
| número | Número exclusivo que identifica o serviço de aplicativos. Tipo de dados: cadeia de caracteres |
| operational_status | Status operacional do serviço de aplicativos. Por exemplo, ativo. Tipo de dados: cadeia de caracteres |
| relacionamentos | Lista de objetos que definem os relacionamentos ascendentes do serviço de aplicativos. Tipo de dados: matriz "relationships": [ { "name": "String", "number": "String", "sys_id": "String", "class_name": "String", "relationship": "String" } ] |
| relacionamentos.class_name | Nome da classe que contém o serviço de aplicativos. Tipo de dados: cadeia de caracteres |
| relationships.name | Nome do relacionamento. Tipo de dados: cadeia de caracteres |
| relacionamentos.número | Número exclusivo do relacionamento. Tipo de dados: cadeia de caracteres |
| relacionamentos.relacionamento | A regra de relacionamento. Tipo de dados: cadeia de caracteres |
| relacionamentos.sys_id | Sys_id do relacionamento. Tipo de dados: cadeia de caracteres |
| sys_id | Sys_id do serviço de aplicações listado na tabela Serviço de aplicações \[cmdb_ci_service_auto\]. Tipo de dados: cadeia de caracteres |
[ ]

{#sg_svcs-POST-find__table_iyx_jnx_gqb}  

### Solicitação de cURL

O exemplo a seguir mostra como encontrar detalhes de um serviço de aplicativos.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/find" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       \"name\": \"Test App Service1\"
     }" \
    --user 'username':'password'

O corpo da resposta inclui o serviço de aplicativos e as informações de relacionamento.

    {
      "result": {
        "aliases": null,
        "asset": null,
        "asset_tag": null,
        "assigned": "",
        "assigned_to": null,
        "assignment_group": null,
        "attestation_score": null,
        "attested": "0",
        "attested_by": null,
        "attested_date": "",
        "attributes": null,
        "bucket": null,
        "business_contact": null,
        "business_need": null,
        "business_relation_manager": null,
        "business_unit": null,
        "busines_criticality": "4 - not critical",
        "can_print": "0",
        "category": null,
        "change_control": null,
        "checked_in": "",
        "checked_out": "",
        "checkout": null,
        "comments": null,
        "company": null,
        "compatibility_dependencies": null,
        "consumer_type": "internal",
        "correlation_id": null,
        "cost": null,
        "cost_cc": "USD",
        "cost_center": null,
        "delivery_date": "",
        "delivery_manager": null,
        "department": null,
        "discovery_source": "Manual Entry",
        "dns_domain": null,
        "due": "",
        "due_in": null,
        "duplicate_of": null,
        "end_date": "",
        "environment": null,
        "fault_count": "0",
        "first_discovered": "2021-07-19 20:09:48",
        "fqdn": null,
        "gl_account": null,
        "hide_from_dashboard": "0",
        "install_date": "",
        "install_status": "1",
        "invoice_number": null,
        "ip_address": null,
        "justification": null,
        "last_discovered": "2021-07-19 20:09:48",
        "last_review_date": "",
        "layer": null,
        "lease_id": null,
        "life_cycle_stage": null,
        "life_cycle_stage_status": null,
        "location": null,
        "mac_address": null,
        "maintenance_schedule": null,
        "managed_by": null,
        "managed_by_group": null,
        "manufacturer": null,
        "model_id": null,
        "model_number": null,
        "monitor": "0",
        "monitoring_requirements": null,
        "name": "Test App Service1",
        "number": "SNSVC0001014",
        "operational_status": "2",
        "order_date": "",
        "owned_by": null,
        "parent": null,
        "portfolio_status": "pipeline",
        "po_number": null,
        "prerequisites": null,
        "price_model": "per_unit",
        "price_unit": null,
        "published_ref": null,
        "purchase_date": "",
        "schedule": null,
        "serial_number": null,
        "service_classification": "Application Service",
        "service_level_requirement": null,
        "service_owner_delegate": null,
        "service_status": "requirements",
        "severity": null,
        "short_description": null,
        "skip_sync": "0",
        "sla": null,
        "spm_service_portfolio": null,
        "spm_taxonomy_node": null,
        "stakeholders": null,
        "start_date": "",
        "state": null,
        "subcategory": null,
        "supported_by": null,
        "support_group": null,
        "sys_class_name": "cmdb_ci_service_auto",
        "sys_class_path": "/!!/!7/!(",
        "sys_created_by": "admin",
        "sys_created_on": "2021-07-19 20:09:48",
        "sys_domain": "global",
        "sys_domain_path": "/",
        "sys_id": "a2f0618040697410f87713b656474255",
        "sys_mod_count": "0",
        "sys_updated_by": "admin",
        "sys_updated_on": "2021-07-19 20:09:48",
        "unit_description": null,
        "unverified": "0",
        "used_for": "Production",
        "user_group": null,
        "vendor": null,
        "version": null,
        "view_service": "61e1cb757f23220002d31ccebefa9120",
        "warranty_expiration": "",
        "relationships": [
          {
            "name": "Test Biz App1",
            "sys_id": "0250a94040697410f87713b656474250",
            "number": "APM0001001",
            "class_name": "cmdb_ci_business_app",
            "relationship": "Consumes::Consumed by"
          },
          {
            "name": "Tech Service Offering1",
            "sys_id": "98d0ed4040697410f87713b6564742ef",
            "number": "BSN0001005",
            "class_name": "service_offering",
            "relationship": "Contains::Contained by"
          }
        ]
      }
    }

## Serviços SG -- POST -- /sg_services/app_service/populate {#ariaid-title5}

Preenche um serviço de aplicativos com um método de preenchimento de serviço.
As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

1. sys_id -- se for sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
2. número -- Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
3. \<IRE field name\>-- O sistema só usará esses valores se o sys_id ou o número não forem fornecidos.
{#sg_svcs-POST-populate__ol_qk4_msd_3qb}

### Formato da URL

URL com controle de versão: /api/sn_service_graph/{api_version}/sg_services/app_service/populate

URL padrão: /api/sn_service_graph/sg_services/app_service/populate

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

{#sg_svcs-POST-populate__entry__2}{#sg_svcs-POST-populate__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]

{#sg_svcs-POST-populate__entry__6}

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

{#sg_svcs-POST-populate__entry__10}{#sg_svcs-POST-populate__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-populate__sg_svcs-reqParm-sysid-ph}

| Nome | Descrição |
|-|-|
| \<IRE field name\> | Um ou mais campos de IRE que identificam o serviço de aplicações. Por exemplo, nome ou versão. Tipo de dados: cadeia de caracteres |
| número | Número exclusivo que identifica o serviço de aplicativos. Tipo de dados: cadeia de caracteres |
| método_população | Obrigatório. Identifica o método de preenchimento e a propriedade que o acompanha para identificar o conteúdo para preenchimento. Somente um objeto de acompanhamento é válido por tipo. Tipo de dados: objeto |
| População_method.group_id | ID do grupo do CMDB configurado com o tipo de preenchimento cmdb_group. Tipo de dados: "cadeia de caracteres" "population_method": { "group_id": "String", "type": "cmdb_group" } Tipo de preenchimento associado: cmdb_group |
| população_método.níveis | Número de níveis a serem usados na criação do serviço. Se o valor de nível não for fornecido, o sistema verificará o valor em sys_property. Se svc.manual.convert.levels.default_value não estiver preenchido, um valor padrão de 3 será usado. Tipo de dados: número "population_method": { "levels": Number, "type": "dynamic_service" } Tipo de preenchimento associado: dynamic_service Padrão: 3 se nenhum valor de nível estiver definido para sys_property |
| População_method.service_candidate | Identificador exclusivo do candidato a serviço. Tipo de dados: cadeia de caracteres "population_method": { "service_candidate": "String", "type": "tag_based_service_family" } Tipo de preenchimento associado: tag_based_service_family |
| popuation_method.service_relations | Lista de objetos que contém dados de hierarquia para os ICs no serviço de aplicativos. Todos os ICs formam pares com um IC primário e um secundário. O IC de nível superior, conhecido como o ponto de entrada de um serviço de aplicativos, não tem um IC primário. Tipo de dados: matriz "population_method": { "service_relations":[ { "child": "String", "parent": "String" } ], "type": "service_hierarchy" } Tipo de preenchimento associado: service_hierarchy |
| population_method.service_relations.child | Nome de um IC secundário relacionado ao IC. Tipo de dados: cadeia de caracteres |
| População_method.service_relations.parent | Nome de um IC primário relacionado ao IC. Tipo de dados: cadeia de caracteres |
| população_metodo.marcadores | Lista de objetos que contêm marcadores a serem associados ao IC. Essas informações estão localizadas na tabela Valores de chave \[cmdb_key_value}. Tipo de dados: matriz "population_method": { "tags": [ { "tag": "String", "value": "String" } ], "type": "tag_list" } Tipo de preenchimento associado: tag_list |
| população_metodo.marcadores.marcador | Nome do marcador. Tipo de dados: cadeia de caracteres |
| população_metodo.marcadores.valor | Valor do marcador. Tipo de dados: cadeia de caracteres |
| População_method.type | Obrigatório. Tipo de preenchimento a ser adicionado ao serviço de aplicativos. Tipo de dados: objeto Valores válidos: * cmdb_group * serviço_hierarquia * dinâmico_serviço * tag_list * tag_based_service_family {#sg_svcs-POST-populate__ul_f2v_4by_gqb} |
| sys_id | Sys_id do serviço de aplicações listado na tabela Serviço de aplicações \[cmdb_ci_service_auto\]. 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.").
{#sg_svcs-POST-populate__entry__40}{#sg_svcs-POST-populate__accept-JSON-only-entry-RESTAPI}

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

{#sg_svcs-POST-populate__entry__44}

| 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.").
{#sg_svcs-POST-populate__entry__48}{#sg_svcs-POST-populate__entry-200-status-code}{#sg_svcs-POST-populate__entry-400-status-code}{#sg_svcs-POST-populate__entry-500-status-code}

| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 400 | Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou o usuário não tem a função app_service_admin. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
[Tabela 24. Códigos de status]

### Parâmetros do corpo da resposta (JSON) {#sg_svcs-POST-populate__section_hyx_jnx_gqb}

{#sg_svcs-POST-populate__table_iyx_jnx_gqb__entry__2}

| Nome | Descrição |
|-|-|
| status | Indica sucesso ou falha. Tipo de dados: cadeia de caracteres |
[ ]

{#sg_svcs-POST-populate__table_iyx_jnx_gqb}  

### Solicitação de cURL

O exemplo a seguir mostra como preencher um serviço de aplicativos com um tipo dynamic_service.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/populate" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"name\": \"Test Register\",
      \"environment\": \"Test\",
      \"version\": \"1.0\",

     \"population_method\": {
       \"type\": \"dynamic_service\",
       \"levels\" : 8
      }
    }" \
    --user 'username':'password'

Resultados que indicam um preenchimento bem-sucedido de um serviço de aplicativos.

    {
      "result": {
      "status": "success"
      }
    }

## Serviços SG -- POST -- /sg_services/app_service/register {#ariaid-title6}

Cria um serviço de aplicações, marca e constrói relacionamentos ascendentes, como aplicações de negócios, ofertas de serviço de negócios e outros serviços de aplicações.
As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

1. sys_id -- se for sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
2. número -- Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
3. \<IRE field name\>-- O sistema só usará esses valores se o sys_id ou o número não forem fornecidos.
{#sg_svcs-POST-register__ol_qk4_msd_3qb}

### Formato da URL

URL com controle de versão: /api/sn_service_graph/{api_version}/sg_services/app_service/register

URL padrão: /api/sn_service_graph/sg_services/app_service/register

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

{#sg_svcs-POST-register__entry__2}{#sg_svcs-POST-register__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 25. Parâmetros de caminho]

{#sg_svcs-POST-register__entry__6}

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

{#sg_svcs-POST-register__entry__10}{#sg_svcs-POST-register__sg_svcs-reqParm-ire-ph}{#sg_svcs-POST-register__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-register__sg_svcs-reqParm-sysid-ph}

| Nome | Descrição |
|-|-|
| \<IRE field name\> | Um ou mais campos de IRE que identificam o serviço de aplicações. Por exemplo, nome ou versão. Tipo de dados: cadeia de caracteres |
| número | Número exclusivo que identifica o serviço de aplicativos. Tipo de dados: cadeia de caracteres |
| relacionamentos | Relacionamentos ascendentes categorizados por tipo. Tipo de dados: objeto "relationships": { "business_app": [Array], "business_service_offering": [Array], "parent_app_service": [Array], "technical_service_offering": [Array] } O número máximo de relacionamentos é 25. |
| relacionamentos.app_de_negócios | Lista de objetos que representam tipos de relacionamento de aplicação de negócios. Esses valores podem ser definidos usando um dos itens a seguir como pares de chave-valor. * \<IRE field name\> * número * sys_id {#sg_svcs-POST-register__ul_gh2_52y_gqb} Tipo de dados: matriz |
| relacionamentos.business_service_offering | Lista de objetos que representam tipos de relacionamento de oferta de serviço de negócio. Esses valores podem ser definidos usando os itens a seguir como pares de chave-valor. * \<IRE field name\> * número * sys_id {#sg_svcs-POST-register__ul_hh2_52y_gqb} Tipo de dados: matriz |
| relacionamentos.parent_app_service | Lista de objetos que representam tipos de relacionamento de serviço de aplicações. Esses valores podem ser definidos usando os itens a seguir como pares de chave-valor. * \<IRE field name\> * número * sys_id {#sg_svcs-POST-register__ul_jh2_52y_gqb} Tipo de dados: matriz |
| relacionamentos.technical_service_offering | Lista de objetos que representam tipos de relacionamento de oferta de serviço técnico. Esses valores podem ser definidos usando os itens a seguir como pares de chave-valor. * \<IRE field name\> * número * sys_id {#sg_svcs-POST-register__ul_ih2_52y_gqb} Tipo de dados: matriz |
| sys_id | Sys_id do serviço de aplicações listado na tabela Serviço de aplicações \[cmdb_ci_service_auto\]. Tipo de dados: cadeia de caracteres |
| marcadores | Lista de objetos que contêm definições de marcador como pares de chave-valor. "tags": [ { "key": "String", "value": "String" }] Tipo de dados: matriz |
| tags.key | Nome da categoria de marcador. Tipo de dados: cadeia de caracteres |
| tags.value | Valor do marcador. Tipo de dados: cadeia de caracteres |
[Tabela 27. 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.").
{#sg_svcs-POST-register__entry__34}{#sg_svcs-POST-register__accept-JSON-only-entry-RESTAPI}

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

{#sg_svcs-POST-register__entry__38}

| cCabeçalho | Descrição |
|-|-|
| nenhum |   |
[Tabela 29. 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.").
{#sg_svcs-POST-register__entry__42}{#sg_svcs-POST-register__entry-200-status-code}{#sg_svcs-POST-register__entry-400-status-code}{#sg_svcs-POST-register__entry-500-status-code}

| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 400 | Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou o usuário não tem a função app_service_admin. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
[Tabela 30. Códigos de status]

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

{#sg_svcs-POST-register__entry__52}

| cCabeçalho | Descrição |
|-|-|
| app_service | Detalhes do serviço de aplicações. Tipo de dados: objeto "app_service": { "name": "String", "number": "String", "sys_id": "String" } |
| app_service.name | Nome do serviço de aplicativos. Tipo de dados: cadeia de caracteres |
| app_service.number | Número exclusivo que identifica o serviço de aplicativos. Tipo de dados: cadeia de caracteres |
| app_service.sys_id | Sys_id do serviço de aplicações listado na tabela Serviço de aplicações \[cmdb_ci_service_auto\]. Tipo de dados: cadeia de caracteres |
| mensagem | Mensagem descrevendo o status. Valores possíveis: * O serviço já existe * Serviço registrado com sucesso {#sg_svcs-POST-register__ul_jwp_x41_hqb} Tipo de dados: cadeia de caracteres |
| status | Status que indica se o serviço foi registrado. Valores possíveis: * Inserir: o serviço de aplicativos foi criado com sucesso. * Nenhuma ação: o serviço de aplicativos já existe. Nenhuma ação realizada. {#sg_svcs-POST-register__ul_kwp_x41_hqb} Tipo de dados: cadeia de caracteres |
[ ]

### Solicitação de cURL

O exemplo a seguir mostra como registrar um serviço de aplicativos.

    curl "instance.service-now.com/api/sn_service_graph/sg_services/app_service/register" \--request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"name\": \"Test Register\",
      \"environment\": \"Test\",
      \"version\": \"1.0\",
      \"number\": \" SNSVC0001014\",
      \"relationships\": {
        \"business_application\": [
          {
            \"sys_id\": \"0250a94040697410f87713b656474250\"
          },
          {
            \"number\": \"APM0001002\"
          },
          {
            \"name\": \"Test Biz App1\"
          }
        ],
        \"business_service_offering\": [
          {
            \"sys_id\": \"ed32e98040697410f87713b656474259\"
          }
        ],
        \"technical_service_offering\": [
          {
            \"sys_id\": \"80e12d8040697410f87713b65647421c\"
          },
          {
            \"number\": \"BSN0001005\"
          },
          {
            \"name\": \"Tech Service Offering2\"
          }
        ],
        \"parent_app_service\": [
          {
            \"sys_id\": \"a2f0618040697410f87713b656474255\"
          }
        ]
      },
      \"tags\": [
        {
          \"key\": \"key1\",
          \"value\": \"value1\"
        },
        {
          \"key\": \"key2\",
          \"value\": \"value2\"
        }
      ]
    }" \
    --user 'username':'password'

O corpo da resposta inclui informações de ID e status.

    {
      "result": {
        "app_service": {
          "sys_id": "5780cb604061f410f87713b656474271",
          "name": "Test Register",
          "number": " SNSVC0001014"
        },
        "message": "Service registered successfully",
        "status": "INSERT"
      }
    }

## Serviços SG -- POST -- /sg_services/app_service/relationship/create {#ariaid-title7}

Constrói relações ascendentes, como aplicações de negócios, ofertas de serviço de negócios e outros serviços de aplicações.
Esta API cria um relacionamento, recebendo entrada com um único objeto primário e um objeto secundário correspondente.  
As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

1. sys_id -- se for sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
2. número -- Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
3. \<IRE field name\>-- O sistema só usará esses valores se o sys_id ou o número não forem fornecidos.
{#sg_svcs-POST-rel-create__ol_qk4_msd_3qb}

### Formato da URL

URL com controle de versão: /api/sn_service_graph/{api_version}/sg_services/app_service/relationship/create

URL padrão: /api/sn_service_graph/sg_services/app_service/relationship/create

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

{#sg_svcs-POST-rel-create__entry__2}{#sg_svcs-POST-rel-create__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 31. Parâmetros de caminho]

{#sg_svcs-POST-rel-create__entry__6}

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

{#sg_svcs-POST-rel-create__entry__10}

| Nome | Descrição |
|-|-|
| secundário | Informações que identificam o serviço de aplicativos secundário com o qual um relacionamento será criado. O secundário está localizado na tabela Serviço de aplicações \[cmdb_ci_service_auto\]. Um grupo de ICs dinâmicos pode ser adicionado como secundário, mas não pode ser primário. Tipo de dados: objeto "child": { "<service_app_identifier>": "String" } |
| criança.\<service_app_identifier\> | Detalhes que identificam o serviço de aplicativos secundário com o qual um relacionamento será criado. Somente uma opção é necessária. Cada opção é listada por precedência de processamento: * sys_id -- Sys_id do serviço de aplicações secundário. * number -- Número exclusivo que identifica o serviço de aplicativos secundário. * \<IRE field name\>-- Campos IRE que identificam o serviço de aplicações. Por exemplo, nome ou versão. {#sg_svcs-POST-rel-create__ul_hfz_zjd_3qb} Tipo de dados: cadeia de caracteres |
| primário | Detalhes que identificam o serviço de aplicativos primário com o qual um relacionamento será criado. Tipo de dados: objeto "parent": { "<service_app_identifier>": "String", "class_name": "String" } |
| pai.\<service_app_identifier\> | Informações que identificam o serviço de aplicações. Somente uma opção é necessária. Cada opção é listada por precedência de processamento: * sys_id -- Sys_id do serviço de aplicações listado no serviço de aplicações \[cmdb_ci_service_auto\]. * number -- Número exclusivo que identifica o serviço de aplicativos. * \<IRE field name\>-- Um ou mais campos de IRE que identificam o serviço de aplicações. Por exemplo, nome ou versão. {#sg_svcs-POST-rel-create__ul_jfk_mjd_3qb} Tipo de dados: cadeia de caracteres |
| parent.class_name | Nome da classe que contém o serviço de aplicativos. O nome da classe primária deve ser de uma das seguintes tabelas: * cmdb_ci_service_auto * cmdb_ci_service_discovered * cmdb_ci_service_by_tags * cmdb_ci_service_calculated * service_offering * cmdb_ci_business_app {#sg_svcs-POST-rel-create__ul_xlk_nc1_hqb} Padrão: cmdb_ci_service_auto Tipo de dados: cadeia de caracteres |
[Tabela 33. 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.").
{#sg_svcs-POST-rel-create__entry__22}{#sg_svcs-POST-rel-create__accept-JSON-only-entry-RESTAPI}

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

{#sg_svcs-POST-rel-create__entry__26}

| Cabeçalho | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 35. 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.").
{#sg_svcs-POST-rel-create__entry__30}{#sg_svcs-POST-rel-create__entry-200-status-code}{#sg_svcs-POST-rel-create__entry-400-status-code}{#sg_svcs-POST-rel-create__entry-500-status-code}

| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 400 | Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou o usuário não tem a função app_service_admin. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
[Tabela 36. Códigos de status]

### Parâmetros do corpo da resposta (JSON) {#sg_svcs-POST-rel-create__section_hyx_jnx_gqb}

{#sg_svcs-POST-rel-create__table_iyx_jnx_gqb__entry__2}

| Nome | Descrição |
|-|-|
| status | Indica sucesso ou falha. Tipo de dados: cadeia de caracteres |
[ ]

{#sg_svcs-POST-rel-create__table_iyx_jnx_gqb}  

### Solicitação de cURL

O exemplo a seguir mostra como criar um relacionamento a partir de um serviço de aplicativos.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/relationship/create" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"child\": {
       \"name\": \"wdfsdf\",
       \"environment\": \"Test\",
       \"version\": \"1.0\"
       },
      \"parent\": {
       \"sys_id\": \"abcdefg\",
       \"name\": \"business App1\",
       \"class_name\": \"service_offering\"
      }
    }" \
    --user 'username':'password'

Resultados que indicam uma criação bem-sucedida de um relacionamento de serviço de aplicativos.

    {
      "result": {
      "status": "success"
      }
    }

## Serviços SG -- POST -- /sg_services/app_service/relationship/delete {#ariaid-title8}

Exclui um relacionamento ascendente de serviço de aplicativos.
As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

1. sys_id -- se for sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
2. número -- Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
3. \<IRE field name\>-- O sistema só usará esses valores se o sys_id ou o número não forem fornecidos.
{#sg_svcs-POST-rel-delete__ol_qk4_msd_3qb}

### Formato da URL

URL com controle de versão: /api/sn_service_graph/{api_version}/sg_services/app_service/relationship/delete

URL padrão: /api/sn_service_graph/sg_services/app_service/relationship/delete

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

{#sg_svcs-POST-rel-delete__entry__2}{#sg_svcs-POST-rel-delete__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 37. Parâmetros de caminho]

{#sg_svcs-POST-rel-delete__entry__6}

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

{#sg_svcs-POST-rel-delete__entry__10}{#sg_svcs-POST-rel-delete__sg_svcs-reqParm-ire-ph}{#sg_svcs-POST-rel-delete__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-rel-delete__sg_svcs-reqParm-sysid-ph}

| Nome | Descrição |
|-|-|
| secundário | Informações que descrevem o relacionamento secundário a ser excluído da aplicação de serviço. Tipo de dados: objeto "child": { "<IRE field name>": "String", "number": "String", "sys_id": "String" } |
| criança.\<IRE field name\> | Um ou mais campos de IRE que identificam o serviço de aplicações secundário. Por exemplo, nome ou versão. Tipo de dados: cadeia de caracteres |
| criança.número | Número exclusivo que identifica o serviço de aplicativos secundário. Tipo de dados: cadeia de caracteres |
| child.sys_id | Sys_id do serviço de aplicações secundário listado no Serviço de aplicações \[cmdb_ci_service_auto\]. Tipo de dados: cadeia de caracteres |
| primário | Detalhes que identificam o serviço de aplicativos primário do qual um relacionamento será removido. Tipo de dados: objeto "parent": { "<IRE field name>": "String", "number": "String", "sys_id": "String", "class_name": "String" } |
| pai.\<IRE field name\> | Um ou mais campos de IRE que identificam o serviço de aplicações. Por exemplo, nome ou versão. Tipo de dados: cadeia de caracteres |
| primário.número | Número exclusivo que identifica o serviço de aplicativos. Tipo de dados: cadeia de caracteres |
| primário.sys_id | Sys_id do serviço de aplicações listado na tabela Serviço de aplicações \[cmdb_ci_service_auto\]. Tipo de dados: cadeia de caracteres |
| parent.class_name | Nome da classe que contém o serviço de aplicativos. O nome da classe primária deve ser de uma das seguintes tabelas: * cmdb_ci_service_auto * cmdb_ci_service_discovered * cmdb_ci_service_by_tags * cmdb_ci_service_calculated * service_offering * cmdb_ci_business_app {#sg_svcs-POST-rel-delete__ul_ktf_45d_3qb} Padrão: cmdb_ci_service_auto Tipo de dados: cadeia de caracteres |
[Tabela 39. 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.").
{#sg_svcs-POST-rel-delete__entry__30}{#sg_svcs-POST-rel-delete__accept-JSON-only-entry-RESTAPI}

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

{#sg_svcs-POST-rel-delete__entry__34}

| Cabeçalho | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 41. 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.").
{#sg_svcs-POST-rel-delete__entry__38}{#sg_svcs-POST-rel-delete__entry-200-status-code}{#sg_svcs-POST-rel-delete__entry-400-status-code}{#sg_svcs-POST-rel-delete__entry-500-status-code}

| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 400 | Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou o usuário não tem a função app_service_admin. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
[Tabela 42. Códigos de status]

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

{#sg_svcs-POST-rel-delete__entry__48}

| Nome | Descrição |
|-|-|
| status | Indica sucesso ou falha. Tipo de dados: cadeia de caracteres |
[ ]

### Solicitação de cURL

O exemplo a seguir mostra como remover um relacionamento de um serviço de aplicativos.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/relationship/delete" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"child\": {
      \"name\": \"Test Register\",
      \"environment\": \"Test\",
      \"version\": \"1.0\"

      },
      \"parent\": {
       \"sys_id\": \"abcdefg\",
       \"name\": \"business App1\",
       \"class_name\": \"service_offering\"
         }
     }" \
    --user 'username':'password'

Resultados que indicam uma remoção bem-sucedida de um relacionamento de serviço de aplicativos.

    {
      "result": {
      "status": "success"
      }
    }

## Serviços SG -- POST -- /sg_services/app_service/state {#ariaid-title9}

Altera o estado do ciclo de vida do serviço de aplicações para ativar, desativar ou descontinuar.
As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

1. sys_id -- se for sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
2. número -- Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
3. \<IRE field name\>-- O sistema só usará esses valores se o sys_id ou o número não forem fornecidos.
{#sg_svcs-POST-state__ol_qk4_msd_3qb}

### Formato da URL

URL com controle de versão: /api/sn_service_graph/{api_version}/sg_services/app_service/state

URL padrão: /api/sn_service_graph/sg_services/app_service/state

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

{#sg_svcs-POST-state__entry__2}{#sg_svcs-POST-state__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 43. Parâmetros de caminho]

{#sg_svcs-POST-state__entry__6}

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

{#sg_svcs-POST-state__table_h3q_lsx_gqb__entry__2}{#sg_svcs-POST-state__sg_svcs-reqParm-ire-ph}{#sg_svcs-POST-state__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-state__sg_svcs-reqParm-sysid-ph}

| Nome | Descrição |
|-|-|
| \<IRE field name\> | Um ou mais campos de IRE que identificam o serviço de aplicações. Por exemplo, nome ou versão. Tipo de dados: cadeia de caracteres |
| número | Número exclusivo que identifica o serviço de aplicativos. Tipo de dados: cadeia de caracteres |
| estado | Obrigatório. Estado do ciclo de vida do serviço de aplicações. Esses valores são atualizados na tabela Serviços de aplicações \[cmdb_ci_service_auto\]. Valores válidos: * ATIVAR -- O ciclo de vida está operacional e em uso. * operating_status=Operacional * life_cycle_stage=Operacional * life_cycle_stage_status=Em uso {#sg_svcs-POST-state__ul_mkp_kzd_3qb} * DEACTIVATE -- O ciclo de vida não está operacional e está na fase de design. * operacional_status=Não operacional * life_cycle_stage=Design * life_cycle_stage_status = Criar {#sg_svcs-POST-state__ul_pq4_lzd_3qb} * RETIRAR -- Fim da vida útil. * operacional_status=Descontinuado * life_cycle_stage=Fim da vida útil * life_cycle_stage_status=Descontinuado {#sg_svcs-POST-state__ul_x5w_lzd_3qb} {#sg_svcs-POST-state__ul_cfp_4sx_gqb} Tipo de dados: cadeia de caracteres |
| sys_id | Sys_id do serviço de aplicações listado na tabela Serviço de aplicações \[cmdb_ci_service_auto\]. Tipo de dados: cadeia de caracteres |
[Tabela 45. Parâmetros do corpo da solicitação (JSON)]

{#sg_svcs-POST-state__table_h3q_lsx_gqb}

### 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.").
{#sg_svcs-POST-state__entry__20}{#sg_svcs-POST-state__accept-JSON-only-entry-RESTAPI}

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

{#sg_svcs-POST-state__entry__24}

| Cabeçalho | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 47. 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.").
{#sg_svcs-POST-state__entry__28}{#sg_svcs-POST-state__entry-200-status-code}{#sg_svcs-POST-state__entry-400-status-code}{#sg_svcs-POST-state__entry-500-status-code}

| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 400 | Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou o usuário não tem a função app_service_admin. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
[Tabela 48. Códigos de status]

### Parâmetros do corpo da resposta (JSON) {#sg_svcs-POST-state__section_hyx_jnx_gqb}

{#sg_svcs-POST-state__table_iyx_jnx_gqb__entry__2}

| Nome | Descrição |
|-|-|
| status | Indica sucesso ou falha. Tipo de dados: cadeia de caracteres |
[ ]

{#sg_svcs-POST-state__table_iyx_jnx_gqb}  

### Solicitação de cURL

O exemplo a seguir mostra como mudar o estado de um ciclo de vida de serviço de aplicações para ativar.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/state" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      {
      \"name\": \"Test Register\",
      \"environment\": \"Test\",
      \"version\": \"1.0\",
      \"state\": \"activate\"
      }
    }" \
    --user 'username':'password'

Resultados que indicam uma operação bem-sucedida.

    {
      "result": {
      "status": "success"
      }
    }

## Serviços SG -- POST -- /sg_services/app_service/update {#ariaid-title10}

Atualiza um serviço de aplicativos existente fornecido e cria marcadores para o serviço de aplicativos fornecido.
As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

1. sys_id -- se for sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
2. número -- Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
3. \<IRE field name\>-- O sistema só usará esses valores se o sys_id ou o número não forem fornecidos.
{#sg_svcs-POST-update__ol_qk4_msd_3qb}

### Formato da URL

URL com controle de versão: /api/sn_service_graph/{api_version}/sg_services/app_service/update

URL padrão: /api/sn_service_graph/sg_services/app_service/update

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

{#sg_svcs-POST-update__entry__2}{#sg_svcs-POST-update__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 49. Parâmetros de caminho]

{#sg_svcs-POST-update__entry__6}{#sg_svcs-POST-update__sg_svcs-reqParm-number-ph}{#sg_svcs-POST-update__sg_svcs-reqParm-sysid-ph}

| Nome | Descrição |
|-|-|
| \<fields or tags to update\> | Use pares de chave-valor para identificar cada campo ou marcador a ser atualizado. Somente informações básicas podem ser atualizadas, nenhum relacionamento ascendente pode ser atualizado. Tipo de dados: cadeia de caracteres |
| \<IRE field name\> | Um ou mais campos de IRE que identificam o serviço de aplicações. Por exemplo, nome ou versão. Você pode enviar o sys_id, o número ou o IRE para identificar um serviço de aplicativos; no entanto, nenhum desses campos pode ser atualizado quando usado como um identificador. Para atualizar os campos de IRE, a entrada deve incluir o sys_id ou o número como um identificador. Tipo de dados: cadeia de caracteres |
| número | Número exclusivo que identifica o serviço de aplicativos. Tipo de dados: cadeia de caracteres |
| sys_id | Sys_id do serviço de aplicações listado na tabela Serviço de aplicações \[cmdb_ci_service_auto\]. Tipo de dados: cadeia de caracteres |
[Tabela 50. 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.").
{#sg_svcs-POST-update__entry__16}{#sg_svcs-POST-update__accept-JSON-only-entry-RESTAPI}

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

{#sg_svcs-POST-update__entry__20}

| Cabeçalho | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 52. 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.").
{#sg_svcs-POST-update__entry__24}{#sg_svcs-POST-update__entry-200-status-code}{#sg_svcs-POST-update__entry-400-status-code}{#sg_svcs-POST-update__entry-500-status-code}

| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 400 | Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada. |
| 401 | Não autorizado. As credenciais do usuário estão incorretas ou o usuário não tem a função app_service_admin. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
[Tabela 53. Códigos de status]

### Parâmetros do corpo da resposta (JSON) {#sg_svcs-POST-update__section_hyx_jnx_gqb}

{#sg_svcs-POST-update__table_iyx_jnx_gqb__entry__2}{#sg_svcs-POST-update__sg_svcs-reqParm-ire-ph}

| Nome | Descrição |
|-|-|
| \<IRE field name\> | Um ou mais campos de IRE que identificam o serviço de aplicações. Por exemplo, nome ou versão. Tipo de dados: cadeia de caracteres |
| número | Número exclusivo que identifica o serviço de aplicativos. Tipo de dados: cadeia de caracteres |
| sys_id | Sys_id do serviço de aplicações listado na tabela Serviço de aplicações \[cmdb_ci_service_auto\]. Tipo de dados: cadeia de caracteres |
| \<updated fields\> | Se a atualização for bem-sucedida, cada campo modificado enviado na carga útil será listado no corpo da resposta. |
[ ]

{#sg_svcs-POST-update__table_iyx_jnx_gqb}  

### Solicitação de cURL

O exemplo a seguir mostra como atualizar um serviço de aplicativos, usando o nome como um campo IRE.

    curl "https://instance.service-now.com/api/sn_service_graph/sg_services/app_service/update" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      {
       \"name\": \"Test Register\",
       \"environment\": \"Test\",
       \"version\": \"1.0\"
      }
    }" \
    --user 'username':'password'

A resposta inclui informações de identificação de serviço de aplicativos e campos atualizados.

    {
      "result": {
      "sys_id": "123456",
      "number": "SVCKji0w9e",
      "name": "Test Register",
      "environment": "Test",
      "version": "1.0"
      }
    }