Usar APIs de serviços de aplicações

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. 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 aplicativos e hosts interconectados que são configurados 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: