---
sourceDocument: Criar ou modificar aplicações do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/application-development

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Criar ou modificar aplicações do Xanadu

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Creator


---

# Comandos instalados com CMDB API e CLI da aplicação

# Comandos instalados com CMDB API e CLI da aplicação {#ariaid-title1}

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

Comandos e grupos de comandos disponíveis para o ServiceNow CLI quando o plug-in app-cmdb-api-cli está instalado.

## Solicitar aplicativos na Store {#cmdb-cli-commands__id_lzg_lxy_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 cumulativa para todos os aplicativos liberados, consulte as [ServiceNow Store notas de versão do histórico de versão](https://www.servicenow.com/docs/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html).{#cmdb-cli-commands__inline-send-to-store}
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

{#cmdb-cli-commands__ul_fzw_bgj_3qb}

Para a solução de REST API, consulte [API SG Services](https://www.servicenow.com/docs/access?context=sg_services-api&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US).

## Converter serviço de aplicações {#cmdb-cli-commands__section_xtm_tdk_ppb}

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.  
Grupo de comandos:

* Grupo primário: service-graph
* Grupo secundário: app-service
{#cmdb-cli-commands__ul_cqd_5mb_3qb}  

Funções necessárias
:   app_service_admin
:   Se estiver usando um serviço relacionado ao mapeamento de serviços, o usuário deverá ter as funções necessárias para esse serviço relacionado ao mapeamento de serviços.

Estrutura de comando
:

        snc service-graph app-service convert --data '{JSON}'

Argumentos

:   Este comando passa um objeto JSON usando o parâmetro data.

    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.
    {#cmdb-cli-commands__ol_qk4_msd_3qb}  
    {#cmdb-cli-commands__table_lhc_n2d_3qb__entry__2}{#cmdb-cli-commands__sg_svcs-reqParm-ire-ph}{#cmdb-cli-commands__sg_svcs-reqParm-number-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. Tipo de dados: cadeia de caracteres |
    [Tabela 1. Propriedades do objeto JSON]

    {#cmdb-cli-commands__table_lhc_n2d_3qb}

Exemplo
:

        snc service-graph app-service convert --data '{"name":"Test Register","environment":"Test","version":"1.0","levels":8}'

Valor de retorno
:

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

## Criar relacionamento de serviço de aplicações {#cmdb-cli-commands__section_ikm_mvc_gqb}

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. A execução deste comando cria um relacionamento, recebendo entrada com um único objeto primário e um objeto secundário correspondente.  
Grupo de comandos:

* Grupo primário: service-graph
* Grupo secundário: app-service
{#cmdb-cli-commands__ul_f3n_5mb_3qb}  

Funções necessárias
:   app_service_admin
:   Se estiver usando um serviço relacionado ao mapeamento de serviços, o usuário deverá ter as funções necessárias para esse serviço relacionado ao mapeamento de serviços.

Estrutura de comando
:

        snc service-graph app-service create-relationship --data '{JSON}'

Argumentos

:   Este comando passa um objeto JSON usando o parâmetro data.

    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.
    {#cmdb-cli-commands__d2262e196}  
    {#cmdb-cli-commands__table_ty2_q2d_3qb__entry__2}

    | 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": { "<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 com o qual um relacionamento será criado. 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 no 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 {#cmdb-cli-commands__ul_xlk_nc1_hqb} Padrão: cmdb_ci_service_auto Tipo de dados: cadeia de caracteres |
    [Tabela 2. Propriedades do objeto JSON]

    {#cmdb-cli-commands__table_ty2_q2d_3qb}

Exemplo
:

        snc service-graph app-service create-relationship --data '{"child":{"name":"wdfsdf","environment":"Test","version":"1.0"},"parent":{"sys_id":"abcdefg","name":"business App1","class_name":"service_offering"}}'

Valor de retorno
:

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

## Excluir serviço de aplicativos {#cmdb-cli-commands__section_y2p_mvc_gqb}

Exclui um serviço de aplicativos.  
Grupo de comandos:

* Grupo primário: service-graph
* Grupo secundário: app-service
{#cmdb-cli-commands__ul_sr5_5mb_3qb}  

Funções necessárias
:   app_service_admin
:   Se estiver usando um serviço relacionado ao mapeamento de serviços, o usuário deverá ter as funções necessárias para esse serviço relacionado ao mapeamento de serviços.

Estrutura de comando
:

        snc service-graph app-service delete --data '{JSON}'

Argumentos

:   Este comando passa um objeto JSON usando o parâmetro data.

    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.
    {#cmdb-cli-commands__d2262e196}  
    {#cmdb-cli-commands__table_icm_q2d_3qb__entry__2}{#cmdb-cli-commands__d2262e242}{#cmdb-cli-commands__d2262e266}{#cmdb-cli-commands__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 3. Propriedades do objeto JSON]

    {#cmdb-cli-commands__table_icm_q2d_3qb}

Exemplo
:

        snc service-graph app-service delete --data '{"name":"Test Register","environment":"Test","version":"1.0"}'

Valor de retorno
:

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

## Excluir relacionamento de serviço de aplicações {#cmdb-cli-commands__section_n3r_mvc_gqb}

Exclui um relacionamento ascendente de serviço de aplicativos.  
Grupo de comandos:

* Grupo primário: service-graph
* Grupo secundário: app-service
{#cmdb-cli-commands__ul_n4d_vmb_3qb}  

Funções necessárias
:   app_service_admin
:   Se estiver usando um serviço relacionado ao mapeamento de serviços, o usuário deverá ter as funções necessárias para esse serviço relacionado ao mapeamento de serviços.

Estrutura de comando
:

        snc service-graph app-service delete-relationship --data '{JSON}'

Argumentos

:   Este comando passa um objeto JSON usando o parâmetro data.

    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.
    {#cmdb-cli-commands__d2262e196}  
    {#cmdb-cli-commands__table_mwt_q2d_3qb__entry__2}{#cmdb-cli-commands__d2262e574}

    | 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 {#cmdb-cli-commands__ul_ktf_45d_3qb} Padrão: cmdb_ci_service_auto Tipo de dados: cadeia de caracteres |
    [Tabela 4. Propriedades do objeto JSON]

    {#cmdb-cli-commands__table_mwt_q2d_3qb}

Exemplo
:

        snc service-graph app-service delete-relationship --data '{"child":{"name":"Test Register","environment":"Test","version":"1.0"},"parent":{"name":"business Service Offering1","class_name":"service_offering"}}'

Valor de retorno
:

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

## Localizar serviço de aplicações {#cmdb-cli-commands__section_mss_mvc_gqb}

Encontra os detalhes de um determinado serviço de aplicativos e seus relacionamentos ascendentes.  
Grupo de comandos:

* Grupo primário: service-graph
* Grupo secundário: app-service
{#cmdb-cli-commands__ul_yjr_vmb_3qb}  

Funções necessárias
:   app_service_admin -- Esta função fornece exibição ilimitada de serviços de aplicações.
:   app_service_user -- Esta função fornece somente a exibição de serviços de aplicações no status Operacional.
:   Se estiver usando um serviço relacionado ao mapeamento de serviços, o usuário deverá ter as funções necessárias para esse serviço relacionado ao mapeamento de serviços.

Estrutura de comando
:

        snc service-graph app-service find --data '{JSON}'

Argumentos

:   Este comando passa um objeto JSON usando o parâmetro data.

    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.
    {#cmdb-cli-commands__d2262e196}  
    {#cmdb-cli-commands__table_wb1_r2d_3qb__entry__2}{#cmdb-cli-commands__d2262e242}{#cmdb-cli-commands__d2262e266}{#cmdb-cli-commands__d2262e574}

    | 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 5. Propriedades do objeto JSON]

    {#cmdb-cli-commands__table_wb1_r2d_3qb}

Exemplo
:

        snc service-graph app-service find --data '{"name" : "Test App Service1"}'

Valor de retorno
:

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

## Preencher serviço de aplicações {#cmdb-cli-commands__section_ext_mvc_gqb}

Preenche um serviço de aplicativos com um método de preenchimento de serviço.  
Grupo de comandos:

* Grupo primário: service-graph
* Grupo secundário: app-service
{#cmdb-cli-commands__ul_l1y_vmb_3qb}  

Funções necessárias
:   app_service_admin
:   Se estiver usando um serviço relacionado ao mapeamento de serviços, o usuário deverá ter as funções necessárias para esse serviço relacionado ao mapeamento de serviços.

Estrutura de comando
:

        snc service-graph app-service populate --data '{JSON}'

Argumentos

:   Este comando passa um objeto JSON usando o parâmetro data.

    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.
    {#cmdb-cli-commands__d2262e196}  
    {#cmdb-cli-commands__table_acn_r2d_3qb__entry__2}{#cmdb-cli-commands__d2262e242}{#cmdb-cli-commands__d2262e266}{#cmdb-cli-commands__d2262e574}

    | 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 {#cmdb-cli-commands__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 6. Propriedades do objeto JSON]

    {#cmdb-cli-commands__table_acn_r2d_3qb}

Exemplo
:

        snc service-graph app-service populate --data '{"name":"Test Register","environment":"Test","version":"1.0","population_method":{"group_id":"String","type":"cmdb_group"}}'

Valor de retorno
:

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

## Registrar serviço de aplicações {#cmdb-cli-commands__section_zcv_mvc_gqb}

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.  
Grupo de comandos:

* Grupo primário: service-graph
* Grupo secundário: app-service
{#cmdb-cli-commands__ul_j2g_shb_3qb}  

Funções necessárias
:   app_service_admin
:   Se estiver usando um serviço relacionado ao mapeamento de serviços, o usuário deverá ter as funções necessárias para esse serviço relacionado ao mapeamento de serviços.

Estrutura de comando
:

        snc service-graph app-service register --data '{JSON}'

Argumentos

:   Este comando passa um objeto JSON usando o parâmetro data.

    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.
    {#cmdb-cli-commands__d2262e196}  
    {#cmdb-cli-commands__table_mrr_r2d_3qb__entry__2}{#cmdb-cli-commands__d2262e242}{#cmdb-cli-commands__d2262e266}{#cmdb-cli-commands__d2262e574}

    | 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 {#cmdb-cli-commands__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 {#cmdb-cli-commands__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 {#cmdb-cli-commands__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 {#cmdb-cli-commands__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 7. Propriedades do objeto JSON]

    {#cmdb-cli-commands__table_mrr_r2d_3qb}

Exemplo
:

        snc service-graph app-service register --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"}]}'

Valor de retorno
:

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

## Atualizar serviço de aplicativos {#cmdb-cli-commands__section_fhw_mvc_gqb}

Atualiza um serviço de aplicativos existente fornecido e cria marcadores para o serviço de aplicativos fornecido.  
Grupo de comandos:

* Grupo primário: service-graph
* Grupo secundário: app-service
{#cmdb-cli-commands__ul_r3j_wmb_3qb}  

Funções necessárias
:   app_service_admin
:   Se estiver usando um serviço relacionado ao mapeamento de serviços, o usuário deverá ter as funções necessárias para esse serviço relacionado ao mapeamento de serviços.

Estrutura de comando
:

        snc service-graph app-service update --data '{JSON}'

Argumentos

:   Este comando passa um objeto JSON usando o parâmetro data.

    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.
    {#cmdb-cli-commands__d2262e196}  
    {#cmdb-cli-commands__table_vyz_r2d_3qb__entry__2}

    | 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. 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 no Serviço de aplicações \[cmdb_ci_service_auto\]. Tipo de dados: cadeia de caracteres |
    [Tabela 8. Propriedades do objeto JSON]

    {#cmdb-cli-commands__table_vyz_r2d_3qb}

Exemplo
:

        snc service-graph app-service update --data '{"name": "Test Register", "version": "2.0"}'

Valor de retorno
:

        {
          "result": {
            "sys_id": "99b2a54040697410f87713b6564742ad",
            "name": "Test Register",
            "number": "SNSVC0001014",
            "version": "2.0"
          }
        }

## Atualizar estado do serviço de aplicações {#cmdb-cli-commands__section_clr_dxc_gqb}

Altera o estado do ciclo de vida do serviço de aplicações para ativar, desativar ou descontinuar.  
Grupo de comandos:

* Grupo primário: service-graph
* Grupo secundário: app-service
{#cmdb-cli-commands__ul_v1r_wmb_3qb}  

Funções necessárias
:   app_service_admin
:   Se estiver usando um serviço relacionado ao mapeamento de serviços, o usuário deverá ter as funções necessárias para esse serviço relacionado ao mapeamento de serviços.

Estrutura de comando
:

        snc service-graph app-service update-state --data '{JSON}'

Argumentos

:   Este comando passa um objeto JSON usando o parâmetro data.

    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.
    {#cmdb-cli-commands__d2262e196}  
    {#cmdb-cli-commands__table_xrh_s2d_3qb__entry__2}

    | 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 {#cmdb-cli-commands__ul_xrz_wzd_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 {#cmdb-cli-commands__ul_yrz_wzd_3qb} * RETIRAR -- Fim da vida útil. * operacional_status=Descontinuado * life_cycle_stage=Fim da vida útil * life_cycle_stage_status=Descontinuado {#cmdb-cli-commands__ul_zrz_wzd_3qb} {#cmdb-cli-commands__ul_wrz_wzd_3qb} Tipo de dados: cadeia de caracteres |
    | sys_id | Sys_id do serviço de aplicações listado no Serviço de aplicações \[cmdb_ci_service_auto\]. Tipo de dados: cadeia de caracteres |
    [Tabela 9. Propriedades do objeto JSON]

    {#cmdb-cli-commands__table_xrh_s2d_3qb}

Exemplo
:

        snc service-graph app-service update-state --data '{"name":"Test Register","environment":"Test","version":"1.0"}'

Valor de retorno
:

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