--- sourceDocument: Capacidades da Now Platform da Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Capacidades da Now Platform da Yokohama ft:clusterId : - platcap bundleId : - platcap workflow : - Platform --- # Usar APIs de serviços de aplicações # Usar APIs de serviços de aplicações {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 aplicações 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 voltados para o cliente, como o site de uma organização. ## Criar um serviço de aplicativos {#use-app-services-api__section_i1y_b2g_sdb} O uso da REST API [createOrUpdateService - POST](https://www.servicenow.com/docs/access?context=application-service-api&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US) 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](https://servicenow-prod.fluidtopics.net/sg2bS8ULHpy6fwv_SdseYQ "Vários tipos de componentes são instalados com a ativação do plug-in Application Service [com.snc.cmdb.it_service], incluindo tabelas, funções do usuário e trabalhos agendados."). 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. {#use-app-services-api__ul_cdh_hjg_sdb} 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 aplicações](https://servicenow-prod.fluidtopics.net/ado40NzyrwrkmhMRHyXINw "Crie um serviço de aplicações Para aderir aos padrões de CSDM e padronizar a organização, a manutenção e o monitoramento de serviços em sua organização."). ## Recuperar conteúdo de um serviço de aplicativos {#use-app-services-api__section_t1d_c2g_sdb} Use a REST API [getContent - GET](https://www.servicenow.com/docs/access?context=application-service-api&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US) 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 {#use-app-services-api__section_cgl_4y5_wdb} As seguintes APIs JavaScript também estão disponíveis: * [addCI()](https://www.servicenow.com/docs/access?context=BusinessServiceManagerAPI&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US): adicione um IC a um instância de serviço criado manualmente. Para conferir as restrições sobre os ICs que estão sendo adicionados e outros detalhes sobre como adicionar um IC a um instância de serviço, consulte [Adicionar manualmente ICs a um serviço de aplicativos](https://servicenow-prod.fluidtopics.net/mPf2rD~xL7LOJ7yOOH7M6A "Adicione itens de configuração (ICs) a serviços de aplicações criados manualmente ou a serviços descobertos pelo Mapeamento de serviços. Você pode editar instâncias de serviço descobertas e criadas manualmente."). * [addManualConnection()](https://www.servicenow.com/docs/access?context=BusinessServiceManagerAPI&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US): adicione uma conexão criada manualmente a um serviço de aplicativos. * [migrateManualToApplicationService()](https://www.servicenow.com/docs/access?context=BusinessServiceManagerAPI&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US): converta um serviço manual em um serviço de aplicativos. * [populateApplicationService()](https://www.servicenow.com/docs/access?context=BusinessServiceManagerAPI&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US): preencha um serviço de aplicativos com ICs e relações do ponto de entrada designado. * [removeCI()](https://www.servicenow.com/docs/access?context=BusinessServiceManagerAPI&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US): remova um IC criado manualmente a partir de um serviço de aplicativos. * [removeManualConnection()](https://www.servicenow.com/docs/access?context=BusinessServiceManagerAPI&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US): remova uma conexão criada manualmente e o IC conectado de um serviço de aplicativos. {#use-app-services-api__ul_h5f_qy5_wdb} **Tópicos relacionados** * [API de serviço de aplicativos](https://www.servicenow.com/docs/access?context=application-service-api&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US)