Comandos instalados com CMDBAPI e CLI da aplicação

Solicitar aplicativos na Store

Acesse o site ServiceNow Store 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.

Para criar scripts 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 que a CLI da aplicação do CMDB e a aplicação da loja de APIs fornecem em vez de usar a interface do usuário. A ILC 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 dessas APIs.

Os comandos de API e da CLI da aplicação do CMDB habilitam as seguintes tarefas:

Registrar e criar um serviço de aplicações e estabelecer relacionamentos ascendentes
Obtendo detalhes de um determinado serviço de aplicação e seus relacionamentos ascendentes
Conectar construções de nível superior, como aplicações de negócios e ofertas de serviços de negócios
Preenchendo um serviço de aplicações com um determinado tipo de preenchimento
Alterando o estado de um serviço de aplicações

Para obter a solução REST API, consulte SG Services API .

Converter Serviço de aplicações

Converte um serviço de aplicações do tipo manual ou vazio em um serviço de aplicações calculado. Durante a conversão, o registro de serviço da aplicação é movido para a tabela [cmdb_ci_service_calculated] com a classe recém-atribuída.

Grupo de comando:

Grupo primário: Service-graph
Grupo secundário: App-service

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 para Mac OS

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

Estrutura de comando para sistema operacional Windows

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

Argumentos

Este comando passa um objeto JSON usando o. dataparâmetro.

As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

Sys_id - Se sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
Número - Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
Nome do campo IRE - O sistema só usa esses valores se o sys_id ou o número não forem fornecidos.

Tabela 1. Propriedades do objeto JSON
Nome	Descrição
Nome do campo IRE>	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 aplicações. Tipo de dados: Cadeia de caracteres
sys_id	SYS_id do serviço de aplicações. Tipo de dados: Cadeia de caracteres

Exemplo no Mac OS

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

Exemplo no sistema operacional Windows

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

Constrói relações ascendentes, como aplicações de negócios, ofertas de serviços de negócios e outros serviços de aplicações. A execução deste comando cria um relacionamento, obtendo entrada com um único primário e um objeto secundário correspondente.

Grupo de comando:

Grupo primário: Service-graph
Grupo secundário: App-service

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 para Mac OS

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

Estrutura de comando para sistema operacional Windows

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

Argumentos

Este comando passa um objeto JSON usando o. dataparâmetro.

As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

Sys_id - Se sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
Número - Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
Nome do campo IRE - O sistema só usa esses valores se o sys_id ou o número não forem fornecidos.

Tabela 2. Propriedades do objeto JSON
Nome	Descrição
secundário	Informações que identificam o serviço de aplicações secundário com o qual criar um relacionamento. O secundário está localizado na tabela Instância de serviço [cmdb_ci_service_auto]. Um grupo de IC dinâmico 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" }`
Nome do campo IRE	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
número.secundário	Número exclusivo que identifica o serviço de aplicações secundário. Tipo de dados: Cadeia de caracteres
sys_id.child.sys_id	SYS_id do serviço de aplicações secundário listado na Instância de serviço [cmdb_ci_service_auto]. Tipo de dados: Cadeia de caracteres
primário	Detalhes que identificam o serviço de aplicações primário com o qual criar um relacionamento. Tipo de dados: Objeto `"parent": { "<IRE field name>": "String", "number": "String", "sys_id": "String", "class_name": "String" }`
Nome do campo IRE	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.primário	Número exclusivo que identifica o serviço de aplicações. Tipo de dados: Cadeia de caracteres
sys_id.primário	SYS_id do serviço de aplicações listado na Instância de serviço [cmdb_ci_service_auto]. Tipo de dados: Cadeia de caracteres
parent.class_name	Nome da classe que contém o serviço de aplicações. 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 Padrão: cmdb_ci_service_auto Tipo de dados: Cadeia de caracteres

Exemplo no Mac OS

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

Exemplo no sistema operacional Windows

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

Exclui um serviço de aplicações.

Grupo de comando:

Grupo primário: Service-graph
Grupo secundário: App-service

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 para Mac OS

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

Estrutura de comando para sistema operacional Windows

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

Argumentos

Este comando passa um objeto JSON usando o. dataparâmetro.

As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

Sys_id - Se sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
Número - Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
Nome do campo IRE - O sistema só usa esses valores se o sys_id ou o número não forem fornecidos.

Tabela 3. Propriedades do objeto JSON
Nome	Descrição
Nome do campo IRE>	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 aplicações. Tipo de dados: Cadeia de caracteres
sys_id	SYS_id do serviço de aplicações listado na tabela Instância de serviço [cmdb_ci_service_auto]. Tipo de dados: Cadeia de caracteres

Exemplo no Mac OS

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

Exemplo no sistema operacional Windows

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

Valor de retorno

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

Exclua o relacionamento de serviço de aplicações

Exclui um relacionamento ascendente do serviço de aplicações.

Grupo de comando:

Grupo primário: Service-graph
Grupo secundário: App-service

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 para Mac OS

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

Estrutura de comando para sistema operacional Windows

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

Argumentos

Este comando passa um objeto JSON usando o. dataparâmetro.

As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

Sys_id - Se sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
Número - Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
Nome do campo IRE - O sistema só usa esses valores se o sys_id ou o número não forem fornecidos.

Tabela 4. Propriedades do objeto JSON
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" }`
Nome do campo IRE	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
número.secundário	Número exclusivo que identifica o serviço de aplicações secundário. Tipo de dados: Cadeia de caracteres
sys_id.child.sys_id	SYS_id do serviço de aplicações secundário listado na Instância de serviço [cmdb_ci_service_auto]. Tipo de dados: Cadeia de caracteres
primário	Detalhes que identificam o serviço de aplicações primário do qual remover um relacionamento. Tipo de dados: Objeto `"parent": { "<IRE field name>": "String", "number": "String", "sys_id": "String", "class_name": "String" }`
Nome do campo IRE	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.primário	Número exclusivo que identifica o serviço de aplicações. Tipo de dados: Cadeia de caracteres
sys_id.primário	SYS_id do serviço de aplicações listado na tabela Instância de serviço [cmdb_ci_service_auto]. Tipo de dados: Cadeia de caracteres
parent.class_name	Nome da classe que contém o serviço de aplicações. 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 Padrão: cmdb_ci_service_auto Tipo de dados: Cadeia de caracteres

Exemplo no Mac OS

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

Exemplo no sistema operacional Windows

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

Encontra os detalhes de um determinado serviço de aplicações e seus relacionamentos ascendentes.

Grupo de comando:

Grupo primário: Service-graph
Grupo secundário: App-service

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 serviços de aplicações de exibição 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 para Mac OS

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

Estrutura de comando para sistema operacional Windows

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

Argumentos

Este comando passa um objeto JSON usando o. dataparâmetro.

As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

Sys_id - Se sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
Número - Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
Nome do campo IRE - O sistema só usa esses valores se o sys_id ou o número não forem fornecidos.

Tabela 5. Propriedades do objeto JSON
Nome	Descrição
Nome do campo IRE>	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 aplicações. Tipo de dados: Cadeia de caracteres
sys_id	SYS_id do serviço de aplicações listado na tabela Instância de serviço [cmdb_ci_service_auto]. Tipo de dados: Cadeia de caracteres

Exemplo no Mac OS

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

Exemplo no sistema operacional Windows

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

Preencha o Serviço de aplicações

Preenche um serviço de aplicações com um método de preenchimento de serviço.

Grupo de comando:

Grupo primário: Service-graph
Grupo secundário: App-service

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 para Mac OS

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

Estrutura de comando para sistema operacional Windows

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

Argumentos

Este comando passa um objeto JSON usando o. dataparâmetro.

As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

Sys_id - Se sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
Número - Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
Nome do campo IRE - O sistema só usa esses valores se o sys_id ou o número não forem fornecidos.

Tabela 6. Propriedades do objeto JSON
Nome	Descrição
Nome do campo IRE>	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 aplicações. Tipo de dados: Cadeia de caracteres
population_method	Necessário. Identifica o método de preenchimento e sua propriedade que o acompanha para identificar o conteúdo para preenchimento. Apenas um objeto acompanhante é válido por tipo. Tipo de dados: Objeto
population_method.group_id	ID do grupo do grupo 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 população associado: cmdb_group
population_method.levels	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á sys_property para o valor. Se svc.manual.convert.levels.default_value não estiver preenchido, será usado um valor padrão de 3. Tipo de dados: Número `"population_method": { "levels": Number, "type": "dynamic_service" }` Tipo de população associado: Dynamic_service Padrão: 3 se nenhum valor de nível for definido para sys_property
population_method.service_candidate	Identificador exclusivo do candidato ao serviço. Tipo de dados: Cadeia de caracteres `"population_method": { "service_candidate": "String", "type": "tag_based_service_family" }` Tipo de população associado: Tag_based_service_family
population_method.service_relations	Lista de objetos que contêm dados de hierarquia para os ICs no serviço de aplicações. Todos os ICs formam pares com um IC primário e secundário. O IC de nível superior, conhecido como o ponto de entrada de um serviço de aplicações, não tem um IC primário. Tipo de dados: Matriz `"population_method": { "service_relations":[ { "child": "String", "parent": "String" } ], "type": "service_hierarchy" }` Tipo de população associado: Service_hierarchy
population_method.service_relations.child	Nome de um IC secundário relacionado ao IC. Tipo de dados: Cadeia de caracteres
population_method.service_relations.parent	Nome de um IC primário relacionado ao IC. Tipo de dados: Cadeia de caracteres
population_method.tags	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 população associado: Tag_list
population_method.tags.tag	Nome do marcador. Tipo de dados: Cadeia de caracteres
population_method.tags.value	Valor do marcador. Tipo de dados: Cadeia de caracteres
population_method.type	Necessário. Tipo de população a ser adicionado ao serviço de aplicações. Tipo de dados: Objeto Valores válidos: cmdb_group service_hierarchy dynamic_service tag_list tag_based_service_family
sys_id	SYS_id do serviço de aplicações listado na tabela Instância de serviço [cmdb_ci_service_auto]. Tipo de dados: Cadeia de caracteres

Exemplo no Mac OS

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

Exemplo no sistema operacional Windows

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

Cria um serviço de aplicações, marcadores e constrói relacionamentos ascendentes, como aplicações de negócios, ofertas de serviços de negócios e outros serviços de aplicações.

Grupo de comando:

Grupo primário: Service-graph
Grupo secundário: App-service

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 para Mac OS

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

Estrutura de comando para sistema operacional Windows

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

Argumentos

Este comando passa um objeto JSON usando o. dataparâmetro.

As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

Sys_id - Se sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
Número - Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
Nome do campo IRE - O sistema só usa esses valores se o sys_id ou o número não forem fornecidos.

Tabela 7. Propriedades do objeto JSON
Nome	Descrição
Nome do campo IRE>	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 aplicações. 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.business_app	Lista de objetos que representam os tipos de relacionamento da aplicação de negócios. Esses valores podem ser definidos usando um dos itens a seguir como pares de chave-valor. Nome do campo IRE> número sys_id Tipo de dados: Matriz
business_service_offering.business_service_offering	Lista de objetos que representam tipos de relacionamento da oferta de serviço de negócio. Esses valores podem ser definidos usando os seguintes itens como pares de chave-valor. Nome do campo IRE> número sys_id 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 seguintes itens como pares de chave-valor. Nome do campo IRE> número sys_id Tipo de dados: Matriz
relationships.technical_service_offering	Lista de objetos que representam a oferta de gestão de tecnologia (anteriormente oferta de serviço técnico) tipos de relacionamento. Esses valores podem ser definidos usando os seguintes itens como pares de chave-valor. Nome do campo IRE> número sys_id Tipo de dados: Matriz
sys_id	SYS_id do serviço de aplicações listado na tabela Instância de serviço [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

Exemplo no Mac OS

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

Exemplo no sistema operacional Windows

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

Atualiza um serviço de aplicações existente fornecido e cria marcadores para o serviço de aplicações fornecido.

Grupo de comando:

Grupo primário: Service-graph
Grupo secundário: App-service

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 para Mac OS

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

Estrutura de comando para sistema operacional Windows

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

Argumentos

Este comando passa um objeto JSON usando o. dataparâmetro.

As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

Sys_id - Se sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
Número - Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
Nome do campo IRE - O sistema só usa esses valores se o sys_id ou o número não forem fornecidos.

Tabela 8. Propriedades do objeto JSON
Nome	Descrição
campos ou marcadores para atualizar>	Use pares chave-valor para identificar cada campo ou marcador a ser atualizado. Somente as informações básicas podem ser atualizadas, nenhum relacionamento ascendente pode ser atualizado. Tipo de dados: Cadeia de caracteres
Nome do campo IRE>	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 aplicações. Tipo de dados: Cadeia de caracteres
sys_id	SYS_id do serviço de aplicações listado na Instância de serviço [cmdb_ci_service_auto]. Tipo de dados: Cadeia de caracteres

Exemplo no Mac OS

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

Exemplo no sistema operacional Windows

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

Muda o estado do ciclo de vida do serviço da aplicação para ativar, desativar ou descontinuar.

Grupo de comando:

Grupo primário: Service-graph
Grupo secundário: App-service

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 para Mac OS

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

Estrutura de comando para sistema operacional Windows

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

Argumentos

Este comando passa um objeto JSON usando o. dataparâmetro.

As seguintes propriedades para identificar um IC têm precedência da seguinte forma:

Sys_id - Se sys_id, o sistema usará somente o sys_id e ignorará todos os valores adicionais.
Número - Se fornecido sem o sys_id, o sistema usará somente o número e ignorará todos os valores adicionais.
Nome do campo IRE - O sistema só usa esses valores se o sys_id ou o número não forem fornecidos.

Tabela 9. Propriedades do objeto JSON
Nome	Descrição
Nome do campo IRE>	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 aplicações. Tipo de dados: Cadeia de caracteres
estado	Necessário. Estado do ciclo de vida do serviço de aplicações. Esses valores são atualizados na tabela Instância de serviço [cmdb_ci_service_auto]. Valores válidos: ATIVAR - O ciclo de vida está operacional e em uso. Operational_status: Operacional Life_cycle_stage: Operacional Life_cycle_stage_status: Em uso DESATIVAR - O ciclo de vida não está operacional e está na fase de design. Operational_status: Não operacional Life_cycle_stage_design Life_cycle_stage_status_build DESCONTINUAR - Fim da vida útil. Operational_status: Descontinuado Life_cycle_stage: Fim da vida útil Life_cycle_stage_status: Descontinuado Tipo de dados: Cadeia de caracteres
sys_id	SYS_id do serviço de aplicações listado na Instância de serviço [cmdb_ci_service_auto]. Tipo de dados: Cadeia de caracteres

Exemplo no Mac OS

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

Exemplo no sistema operacional Windows

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

Valor de retorno

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