Politique des nouveaux essais

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 4 minutes de lecture

    • Réessayez automatiquement les demandes ayant échoué lorsqu’une étape rencontre un problème intermittent tel qu’une défaillance du réseau ou une limite de taux de demande. Définissez une politique de nouvelle tentative pour éviter d’avoir à déclencher manuellement l’étape à nouveau.

    Fonctionnalités

    Les politiques des nouveaux essais peuvent être :
    • Créé pour prendre en charge les délais de connexion ou les demandes ayant échoué en fonction de l’en-tête, de l’état, du corps de la réponse, de l’erreur et de la méthode HTTP.
    • Appliqué à toutes les actions qui utilisent un alias de connexion donné.
    • Appliqué directement à une étape d’action.
    Utilisez des politiques de nouvelle tentative pour définir :
    • Conditions qui doivent être remplies pour retenter une étape.
    • Intervalle de temps à attendre avant de retenter une étape.
    • Nombre maximal de nouvelles tentatives de l’étape avant l’arrêt.
    Associez une politique de nouvelle tentative par défaut à un alias de connexion et d’informations d’identification et appliquez la politique de nouvelle tentative à toutes les connexions HTTP.
    Remarque :
    Vous ne pouvez créer des politiques de nouvelle tentative que pour les étapes JDBC, REST et SOAP.

    Créer une politique des nouveaux essais

    Réessayez automatiquement les demandes ayant échoué lorsqu’une étape rencontre un problème intermittent tel qu’une défaillance du réseau ou une limite de taux de demande. Définissez une politique de nouvelle tentative pour éviter d’avoir à déclencher manuellement l’étape à nouveau.

    Avant de commencer

    • Rôle requis : connection_admin ou credential_admin

    Procédure

    1. Accédez à la Tout > Centre d'intégration > Politique des nouveaux essais > Créer.
    2. Renseignez les champs du formulaire.
      Tableau 1. Formulaire de la politique des nouveaux essais
      Champ Description
      Nom Nom permettant d’identifier de façon unique la politique des nouveaux essais.
      Type de connexion HTTP (en anglais)
      Condition Conditions qui doivent être remplies pour déclencher la politique des nouveaux essais. Les conditions qui déclenchent une politique de nouvelle tentative incluent les opérateurs est, n’est pas, contient et contient pas .
      Stratégie de nouvelle tentative
      • Temporisation exponentielle : option permettant d’augmenter de façon exponentielle l’intervalle de temps pour les tentatives de nouvelles tentatives suivantes. Le multiplicateur est de 2.
      • Intervalle fixe : option permettant de spécifier un intervalle de temps fixe après lequel une nouvelle tentative doit être effectuée.
      • Respecter l’en-tête « Réessayer-après » : option permettant de spécifier une nouvelle tentative en fonction de la valeur de date et d’heure renvoyée dans la valeur de l’en-tête Recommencer après de la demande HTTP. Pour plus d’informations sur l’en-tête, consultez RFC 7231, section 7.1.3 : Réessayer après.
        Remarque :
        L’en-tête Respecter « Réessayer-après » prend uniquement en charge les étapes REST et SOAP.
      Intervalle (en secondes) Intervalle de temps, en secondes, après lequel une nouvelle tentative doit être effectuée. Ce champ s’applique uniquement aux stratégies de temporisation exponentielle et de nouvelle tentative à intervalle fixe .
      Remarque :
      Si la stratégie de nouvelle tentative est Temporisation exponentielle, l’intervalle de temps augmente de façon exponentielle après chaque nouvelle tentative jusqu’à ce que le nombre maximal de tentatives soit atteint.
      Nombre Nombre maximal de nouvelles tentatives. Ce champ s’applique uniquement aux stratégies de temporisation exponentielle et de nouvelle tentative à intervalle fixe . Si aucune valeur n’est spécifiée, le nombre maximal de nouvelles tentatives est basé sur la valeur fournie dans la glide.fdih.retry.max_count propriété système. La valeur par défaut de la glide.fdih.retry.max_count propriété système est de 0. Pour plus d’informations sur les propriétés système, consultez Propriétés système disponibles.
      Temps écoulé maximal (en secondes) Temps cumulé maximal, en secondes, après lequel les tentatives de nouvelles tentatives sont arrêtées. Ce champ apparaît uniquement lorsque l’en-tête Respecter « Réessayer-après » est sélectionné dans Stratégie de nouvelle tentative.
      Remarque :
      Si le délai maximal de nouvelle tentative est spécifié dans la glide.fdih.retry.max_time_in_seconds propriété, la valeur de propriété système a priorité sur cette valeur de champ. Assurez-vous également que le temps écoulé maximal est égal ou supérieur à la valeur de propriété système.
    3. Facultatif : Créez une propriété système globale avec les attributs suivants.
      Pour plus d’informations sur la création d’une propriété, consultez Ajouter une propriété système. Vous pouvez utiliser cette propriété système pour spécifier la durée maximale, en secondes, d’une politique de nouvelle tentative.
      Champ Valeur
      Nom glide.fdih.retry.max_temps_dans_secondes
      Type entier
      Valeur Valeur par défaut : 86 400 (secondes) Durée maximale prise en charge : 604 800 (secondes)
    4. Cliquez sur Envoyer.

    Politique des nouveaux essais avec stratégie des nouveaux essais comme temporisation exponentielle

    Figure 1. Exemple de politique des nouveaux essais
    Exemple de politique des nouveaux essais lorsque la stratégie des nouveaux essais est Temporisation exponentielle
    Dans cet exemple, la politique est définie pour tenter une nouvelle tentative lorsque l’une de ces conditions est remplie :
    • La méthode HTTP est GET et l’erreur est Délai de connexion
    • La méthode HTTP est GET et le code d’état est 429
    Lorsque la condition est remplie, de nouvelles tentatives sont effectuées pour un nombre maximum de trois fois. L’intervalle de temps entre les tentatives est augmenté de façon exponentielle. Dans cet exemple, les intervalles de temps sont de 10 secondes, 20 secondes et 40 secondes.

    Que faire ensuite

    • Créez un alias de connexion et d’informations d’identification si vous n’avez pas l’alias requis.
    • Affectez la politique des nouveaux essais en tant que politique des nouveaux essais par défaut à l’alias de connexion et d’informations d’identification requis.
      Remarque :
      Une politique des nouveaux essais par défaut est fournie et est sélectionnée en tant que politique des nouveaux essais par défaut. Si vous avez créé des politiques de nouveaux essais, vous pouvez sélectionner la politique requise comme politique des nouveaux essais par défaut.
    • Créez une connexion HTTP(s) dans la liste connexe Connexions pour l’alias de connexion et d’informations d’identification. Pour plus d’informations, consultez Connexions et informations d’identification.
    • Vérifiez et affichez les détails des nouvelles tentatives en accédant à Journaux système > Demandes HTTP sortantes.