Criar um grupo de dispositivos da API e configurar o Tarefa de API

Este tópico descreve como criar um grupo de dispositivos da API e configurar Tarefas de API em um grupo de dispositivos de API. Você pode pré-aquecer Tarefas de API adicionando-as aos dispositivos Nuvem para que ele esteja pronto para a implantação.

Grupo de dispositivos da API Uma coleção lógica de dispositivos de nuvem nos quais as Tarefas de API são executadas é chamada de Pools de dispositivos da API. Os dispositivos pré-aquecidos (dispositivos atribuídos) e prontos para servir (dispositivos não atribuídos) estão presentes. Os dispositivos pré-aquecidos são conectados a uma Tarefa de API que pode executar uma solicitação de automação e já está implantado nos dispositivos pré-aquecidos. A quantidade de simultaneidade que você quer alcançar determina quantos dispositivos com pré-aquecimento devem ser atribuídos a uma Tarefa de API. Por exemplo, se você tiver casos de uso em que um Tarefa de API precise de uma resposta em tempo real, será necessário adicionar esse Tarefas de API para pré-aquecimento no pool de dispositivos. Esses dispositivos prontos para servir podem implantar uma Tarefa de API rapidamente e realizar uma solicitação sem latência durante a implantação.

Os dispositivos que não estão sendo utilizados para pré-aquecimento podem ser visualizados no campo Sessões de dispositivos não atribuídos. Esses dispositivos podem ser usados para executar Tarefas de API que podem ser colocados em fila e executados um após o outro.

Nota: Para evitar erros de ID da implementação, após a Tarefa de API ser criada e adicionada a um formulário e processo, você deverá fazer registrar a Tarefa de API. Depois que a Tarefa de API for registrada, você deverá adicioná-la ao grupo de dispositivos.

Pré-requisitos

Certifique-se de que você tem uma das seguintes funções para ver a guia Pools de dispositivos:
  • Proprietário de grupos de dispositivos
  • Administração do pool de dispositivos
Certifique-se de que você tem uma função com permissão Criar pools de dispositivos para criar um pool de dispositivos.
Nota: Um administrador da Control Room sem permissões de administrador do pool de dispositivos não pode visualizar ou criar um pool de dispositivos.

Você pode usar um pool de dispositivos da API para:

  • Gerenciar a alocação de dispositivos que executam as Tarefas de API.
  • Pré-aqueça (para formulários) as Tarefas de API em um conjunto de dispositivos disponíveis na nuvem.
  • Use os dispositivos não atribuídos para executar as Tarefas de API dos processos sem pré-aquecimento.

Se um grupo de dispositivos de API já tiver sido criado, acesse a etapa 7 para configurar uma Tarefa de API no grupo de dispositivos.

Procedimento

  1. Navegue até Gerenciar > Pools de dispositivos.
  2. Clique em Criar pool de dispositivos API.
  3. Digite o Nome.
  4. Opcional: Insira uma descrição.
  5. Insira o número de Sessões de dispositivo na nuvem que deseja estabelecer.
    Criar um pool de dispositivos de API
    Nota: É possível estabelecer um mínimo de 1 sessão de dispositivo e um máximo de 20 sessões de dispositivo.
  6. Clique em Avançar.
  7. Adicionar tarefa de API: clique em Adicionar tarefa de API e selecione o Tarefa de API que você deseja pré-aquecer na nuvem.
    Adicionar tarefa de API
  8. Atribuir sessões do dispositivo: Você pode alocar sessões de dispositivo do número total de sessões de dispositivo na nuvem que você estabeleceu.
    Nota: Aloque o Tarefa de API selecionado para um mínimo de uma sessão do dispositivo ou para um máximo de sessões totalmente disponíveis do dispositivo. Você pode alocar o restante das sessões de dispositivo disponíveis para diferentes Tarefas de API.
  9. Atribuir usuário: Um usuário de execução padrão (apitaskrunner) é atribuído a cada Tarefas de API configurada no grupo de dispositivos de API. Para alterar o usuário padrão, clique no menu de ações (três pontos verticais) localizado à direita de cada sessão de dispositivo alocada, clique em Atribuir usuário e selecione um usuário. Para atribuir o mesmo usuário de execução a todas as Tarefas de API, selecione Tarefas de API e clique na opção Atribuir usuário a itens marcados. Para mais informações sobre o usuário de execução do Tarefa de API, consulte Configuração de Tarefa de API.
    Atribuir usuário à tarefa de API
    Nota: Os dispositivos não atribuídos no pool de dispositivos da API são usados pelas Tarefas de API chamadas diretamente de um processo.
  10. Clique em Avançar.
  11. Opcional: Selecione os Proprietários de pools de dispositivos da API.
    Complete essa etapa para fornecer permissão a outros usuários para visualizar, editar e excluir o pool de dispositivos.
  12. Clique em Criar pool de dispositivos.
    Nota: A Control Room é limitada a um pool de dispositivos API por locatário.

Próximas etapas

É possível revisar os eventos correspondentes enquanto um pool de dispositivos de API está sendo criado nos logs de auditoria. Consulte Exibir registros de auditoria do tempo de execução da Tarefa de API.