Usar APIs de serviços de aplicações

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 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 Serviço de aplicações, preencher o serviço de aplicativos com ICs do CMDB e recuperar detalhes de um Serviço de aplicações existente.

    Função necessária: app_service_admin

    Um serviço de aplicativos é um conjunto de aplicativos e hosts interconectados que são configurados para oferecer um serviço à organização. Os serviços de aplicativos podem ser internos, como um sistema de e-mail da organização, ou voltados para o cliente, como o site de uma organização.

    Criar um serviço de aplicativos

    O uso da REST API createOrUpdateService - POST para criar um Serviço de aplicações 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 Serviço de aplicações com ICs descobertos usando aplicações que não sejam da ServiceNow.

    Por padrão, quando um Serviço de aplicações é 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 Serviço de aplicações, inclusive os serviços criados usando APIs.

    Você também pode criar um Serviço de aplicações 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: