Documentação do Oracle Cloud Infrastructure

Criando uma Tarefa REST

Uma tarefa REST no Data Integration permite chamar um ponto final de API REST usando o protocolo HTTP.

Criar uma tarefa REST em um projeto ou pasta. O Data Integration inclui um projeto padrão para você começar. Para criar outros projetos ou pastas, consulte Projetos e Pastas.

No Data Integration, por padrão, você pode ter execuções de tarefas simultâneas ou paralelas de uma tarefa em um determinado momento. Para não permitir execuções de tarefas simultâneas iniciadas manualmente, marque a caixa de seleção Desativar execução simultânea da tarefa ao criar a tarefa. Quando execuções de tarefas simultâneas não são permitidas, uma solicitação de execução para a tarefa falha se já houver uma execução de tarefa em andamento que esteja em um estado não terminal.

  • A IU de configuração contém quatro seções nas quais você fornece a API REST e os detalhes de autenticação da tarefa, fornece valores de parâmetro opcionais no escopo da tarefa e verifica se há erros e avisos.

    As etapas de cada seção no procedimento a seguir também podem ser usadas ao editar uma tarefa REST.

    1. Na página Tarefas do projeto ou pasta em que você deseja criar uma tarefa, selecione Criar tarefa e, em seguida, REST. Se precisar de ajuda para localizar a página Tarefas em um projeto ou pasta, consulte Listando Tarefas.
    2. Na página Criar tarefa REST, digite um nome e uma descrição opcional.

      O identificador é um valor gerado pelo sistema com base no nome. Você pode alterar o valor, mas depois de criar e salvar a tarefa, não será possível atualizar o identificador.

    3. Marque a caixa de seleção Desativar execução simultânea da tarefa se quiser não permitir execuções simultâneas desta tarefa.
    4. (Opcional) Para Projeto ou pasta, clique em Selecionar e selecione outro projeto ou pasta para salvar a tarefa.
    5. Para salvar a tarefa pela primeira vez, selecione um dos seguintes botões:

      • Criar: Cria e salva a tarefa. Você pode continuar a criar e editar a tarefa.

      • Criar e fechar: Cria e salva a tarefa, fecha a página e retorna você à lista de tarefas na página de detalhes do projeto ou da pasta.

    6. Salve periodicamente enquanto trabalha selecionando um dos seguintes botões:

      • Salvar: Confirma alterações desde o último salvamento. Você pode continuar editando depois de salvar.

      • Salvar e fechar: Confirma alterações, fecha a página e retorna você à lista de tarefas na página de detalhes do projeto ou da pasta.

      • Salvar como: Confirma alterações (desde o último salvamento) e salva em uma cópia em vez de substituir a tarefa atual. Você pode fornecer um nome para a cópia e selecionar outro projeto ou pasta para a cópia ou salvar a cópia no mesmo projeto ou pasta da tarefa existente.

    7. Na seção Detalhes da API REST, selecione Configurar.

      Na página Configurar detalhes da API REST que é exibida, forneça os detalhes de execução da API REST e os critérios de conclusão (condição de sucesso) para uma chamada REST bem-sucedida.

      1. Siga estas etapas para definir os detalhes de execução da API REST:
        1. Especifique o método HTTP e o URL REST.
        2. (Opcional) Configure quaisquer parâmetros de URL.
        3. Adicionar um cabeçalho de solicitação REST.
        4. (Opcional) Adicione um parâmetro de tarefa para o valor do cabeçalho REST.
        5. Para um método HTTP POST ou PUT, adicione o corpo da solicitação.
        6. (Opcional) Adicione um parâmetro de tarefa para todo o corpo da solicitação.
        7. Para mostrar o URL REST que você configurou, selecione Mostrar URL para visualização.
        8. Selecione Próximo.
      2. Para especificar os critérios de uma conclusão bem-sucedida da execução da API REST, edite a condição de sucesso padrão fornecida na seção Condições.
      3. Se a API REST chamar uma operação de execução longa, além da condição de sucesso, marque a caixa de seleção Configurar uma condição de polling e encerramento para uma chamada REST sem espera e especifique os detalhes necessários para uma configuração de polling (comportamento assíncrono). Consulte Fornecendo Critérios de Conclusão com Sondagem.
      4. Selecione Configurar.

        Você retornará à página Criar tarefa REST ou Tarefa REST: <task name>.

    8. Na seção Autenticação, selecione Configurar. No painel Configurar autenticação que aparece, especifique o método de autenticação para executar o ponto final da API REST. Por padrão, nenhum método de autenticação é necessário.
    9. (Opcional) Na seção Parâmetros, selecione Configurar. Na página parâmetros de tarefa REST exibida, exiba e edite valores para os parâmetros que estão disponíveis no escopo desta tarefa REST.
    10. (Opcional) Na seção Validar tarefa, selecione Validar.

      Se houver erros ou avisos, selecione Exibir mensagens. Resolva os erros antes de publicar a tarefa.

    11. Quando terminar de configurar a tarefa REST, selecione Criar e fechar ou Salvar e fechar.
    Publique a tarefa REST em um aplicativo no Data Integration antes de executar a tarefa ou programá-la para execução. Para publicar informações, consulte Publicando em um Aplicativo Data Integration.

  • Use o comando oci data-integration task create-task-from-rest-task e os parâmetros necessários para criar uma tarefa REST:

    oci data-integration task create-task-from-rest-task [OPTIONS]

    Para obter uma lista completa de flags e opções de variáveis para comandos da CLI, consulte a Referência de Linha de Comando.

  • Execute a operação CreateTask com o subtipo de recurso apropriado para criar uma tarefa REST.