Usar APIs de serviços de aplicações

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura
  • Os serviços de aplicações fornecem APIs com as quais é possível executar operações como criar e atualizar um Instância de serviço, preencher o serviço de aplicativos com ICs do CMDB e recuperar detalhes de um Instância de serviço existente.

    Função necessária: app_service_admin

    Uma instância de serviço é um conjunto de hosts e aplicações interconectadas que são configuradas para oferecer um serviço à organização. As instâncias de serviço podem ser internas, como um sistema de e-mail da organização, ou voltadas para o cliente, como um site da organização.

    Criar um serviço de aplicativos

    O uso da REST API createOrUpdateService - POST para criar um Instância de serviço que atenderá à organização se o ServiceNow CMDB já contiver os ICs que constituem o serviço. Normalmente, isso acontece se você adicionou ICs manualmente direto no CMDB ou usou a aplicação Descoberta para descobrir ICs e armazenar informações sobre esses ICs no CMDB. Você também pode usar a API para criar um Instância de serviço com ICs descobertos usando aplicações que não sejam da ServiceNow.

    Por padrão, quando um Instância de serviço é criado, todas as conexões com ICs são do tipo de relacionamento Depends on::Used by. Você pode modificar esse tipo padrão alterando o valor da propriedade sa.it_service.manual_ci_rel_type.

    Antes de criar um serviço de aplicativos, certifique-se do seguinte:
    • O CMDB contém todos os ICs que compõem o serviço de aplicações.
    • Você tem a propriedade sys_id de cada IC existente no serviço de aplicativos que deseja criar.
    • Você entende a hierarquia formada pelos ICs.

    A tabela Serviço de aplicações mapeadas [cmdb_ci_service_discovered] contém todo Instância de serviço, inclusive os serviços criados usando APIs.

    Você também pode criar um Instância de serviço manualmente usando a interface do usuário, conforme descrito em Criar um serviço de aplicativos.

    Recuperar conteúdo de um serviço de aplicativos

    Use a REST API getContent - GET para recuperar uma lista de ICs e as relações entre eles em busca de um serviço de aplicativos que foi criado manualmente.

    APIs adicionais

    As seguintes APIs JavaScript também estão disponíveis: