F5 402 : API REST, orchestration et preuve de résultat

Une architecture peut utiliser des API pour exposer une demande, agir sur l’infrastructure, configurer un service ou lire des observations. Le modèle north/east/south/west du blueprint décrit des relations d’orchestration ; une direction seule n’établit ni protocole ni garantie de résultat.

Distinguez transport, authentification, autorisation et ressource. Une connexion HTTPS valide ne prouve pas le droit de modifier un objet. De même, une réponse d’API acceptée ne démontre pas la réussite d’un parcours applicatif.

iControl REST expose des ressources de configuration et de gestion. Le fragment suivant lit les pools d’un laboratoire à partir d’un token préparé séparément et d’une autorité de confiance locale. Il n’installe rien ; les informations retournées peuvent néanmoins être sensibles.

Les noms, l’autorité et le token doivent être adaptés au périmètre autorisé. Ne mettez pas le token dans un dépôt ou un exemple public. Vérifiez également les ressources et droits dans la documentation correspondant à votre version BIG-IP.

Consignez code HTTP, résultat de tâche éventuelle et observation de l’état réel. Un timeout client peut laisser une opération en cours côté serveur. Avant de retenter un changement, vérifiez l’état et la portée de l’action pour éviter doublons ou effets inattendus.

Préparez des limites de temps, des règles de retry et un traitement des réponses partielles. L’orchestrateur doit pouvoir distinguer une opération non commencée d’un état intermédiaire. La recette du service reste une étape séparée du succès d’une API.

Une requête de configuration dépasse le délai client. Listez les informations à lire avant toute répétition : identité de la demande, tâche, état de la ressource et comportement du service. Expliquez pourquoi « pas de réponse reçue » ne signifie pas toujours « aucune modification ».

Le livrable est un diagramme d’états avec erreurs, observation et reprise. Poursuivez avec les déclarations DO et AS3 pour distinguer état d’infrastructure et état applicatif.