Política de repetição

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura
  • Repita automaticamente as solicitações com falha quando uma etapa encontrar um problema intermitente, como falha de rede ou limite de taxa de solicitação. Defina uma política de nova tentativa para evitar a necessidade de acionar manualmente a etapa.

    Recursos

    As políticas de novas tentativas podem ser:
    • Criado para oferecer suporte a tempos limites de conexão ou solicitações com falha com base no cabeçalho, status, corpo da resposta, erro e método HTTP.
    • Aplicado a todas as ações que usam um determinado alias de conexão.
    • Aplicado diretamente a uma etapa de ação.
    Use políticas de novas tentativas para definir:
    • As condições que devem ser atendidas para tentar novamente uma etapa.
    • O intervalo de tempo de espera antes de tentar novamente uma etapa.
    • O número máximo de tentativas que a etapa faz antes de parar.
    Associe uma política de nova tentativa padrão a um alias de conexão e credenciais e aplique a política de nova tentativa a todas as conexões HTTP.
    Nota:
    Você só pode criar políticas de nova tentativa para etapas JDBC, REST e SOAP.

    Crie uma política de novas tentativas

    Repita automaticamente as solicitações com falha quando uma etapa encontrar um problema intermitente, como falha de rede ou limite de taxa de solicitação. Defina uma política de nova tentativa para evitar a necessidade de acionar manualmente a etapa.

    Antes de Iniciar

    • Função necessária: Connection_admin ou credential_admin

    Procedimento

    1. Navegar até Tudo > IntegrationHub > Tentar Política Novamente > Criar novo(a).
    2. No formulário, preencha os campos.
      Tabela 1. Formulário Política de novas tentativas
      Campo Descrição
      Nome Nome para identificar exclusivamente a política de novas tentativas.
      Tipo de conexão HTTP
      Condição Condições que devem ser atendidas para acionar a política de novas tentativas. As condições que acionam uma política de nova tentativa incluem . , não é , contém e não contém operadores.
      Tentar Estratégia Novamente
      • Recuo exponencial Opção para aumentar exponencialmente o intervalo de tempo das tentativas de novas tentativas subsequentes. O multiplicador é 2.
      • Intervalo fixo Opção para especificar um intervalo de tempo fixo após o qual uma tentativa de nova tentativa deve ser feita.
      • Respeitar cabeçalho "Repetir após" Opção para especificar uma tentativa de nova tentativa com base no valor de data e hora retornado no valor do cabeçalho Repetir após da solicitação HTTP. Para obter mais informações sobre o cabeçalho, consulte RFC 7231, seção 7,1.3: Repetir após .
        Nota:
        Respeitar cabeçalho "Repetir após" Compatível somente com etapas REST e SOAP.
      Intervalos (segundos) Intervalo de tempo em segundos após o qual uma nova tentativa deve ser feita. Este campo se aplica somente a. Recuo exponencial e. Intervalo fixo estratégias de novas tentativas.
      Nota:
      Se Tentar estratégia novamente . Recuo exponencial , o intervalo de tempo aumenta exponencialmente após cada tentativa de nova tentativa até que o número máximo de tentativas seja atingido.
      Contagem Número máximo de tentativas. Este campo se aplica somente a. Recuo exponencial e. Intervalo fixo estratégias de novas tentativas. Se nenhum valor for especificado, o número máximo de tentativas será baseado no valor fornecido em glide.fdih.retry.max_countpropriedade do sistema. Valor padrão de glide.fdih.retry.max_counta propriedade do sistema é 0. Para obter mais informações sobre propriedades do sistema, consulte Propriedades do sistema disponíveis .
      Tempo máximo decorrido (segundos) Tempo cumulativo máximo em segundos após o qual as tentativas de nova tentativa são interrompidas. Este campo aparece somente quando Respeitar cabeçalho "Repetir após" selecionado de Tentar estratégia novamente .
      Nota:
      Se o tempo máximo de novas tentativas for especificado em glide.fdih.retry.max_time_in_seconds, o valor da propriedade do sistema tem precedência sobre este valor de campo. Além disso, certifique-se de que o tempo máximo decorrido seja igual ou maior que o valor da propriedade do sistema.
    3. Opcional: Crie uma propriedade do sistema global com os seguintes atributos.
      Para obter mais informações sobre como criar uma propriedade, consulte Adicione uma propriedade do sistema . Você pode usar esta propriedade do sistema para especificar o tempo máximo em segundos para uma política de novas tentativas.
      Campo Valor
      Nome glide.fdih.retry.max_time_in_seconds
      Tipo inteiro
      Valor Valor padrão: 86400 (Segundos) Tempo máximo compatível: 604800 (segundos)
    4. Clique em Enviar.

    Política de novas tentativas com Estratégia de novas tentativas como reversão exponencial

    Figura 1. Política de novas tentativas de amostra
    Política de novas tentativas de amostra quando Tentar estratégia novamente . Recuo exponencial
    Neste exemplo, a política é definida para tentar novamente quando uma destas condições é atendida:
    • O método HTTP é GET e Erro é Tempo limite de conexão
    • O método HTTP é GET e o Código de status é 429
    Quando a condição é atendida, as tentativas de novas tentativas são feitas por um número máximo de três vezes. O intervalo de tempo entre as tentativas de nova tentativa aumenta exponencialmente. Os intervalos de tempo neste exemplo são 10 segundos, 20 segundos e 40 segundos.

    O que Fazer Depois

    • Crie um alias de conexão e credencial se você não tiver o alias necessário.
    • Atribua a política de novas tentativas como Política de novas tentativas padrão Para o alias de conexão e credencial necessário.
      Nota:
      Uma política de nova tentativa padrão é fornecida e selecionada como Política de novas tentativas padrão . Se você criou políticas de nova tentativa, poderá selecionar a política necessária como Política de novas tentativas padrão .
    • Crie uma conexão HTTP(s) na lista relacionada Conexões para o alias de conexão e credencial. Para obter mais informações, consulte Credenciais e conexões .
    • Para verificar e exibir os detalhes das tentativas de nova tentativa navegando até Logs do sistema > Solicitações de saída de HTTP.