Opérations

Certaines commandes d’API se poursuivent après le retour de la requête HTTP. Leur réponse inclut un objet operation et une URL links.self. Attendez que l’opération soit terminée avant d’utiliser la ressource modifiée.

Séquence d’états

1. requested signifie que votre commande a été acceptée.
2. committed signifie que la configuration demandée a été enregistrée.
3. applied signifie que la configuration a été appliquée; la ressource est peut-être encore en train de démarrer.
4. ready signifie que la ressource est prête à être utilisée.

failed et timed_out sont des états finaux. Lisez error_code et error_message avant de réessayer. Réutilisez la clé d’idempotence d’origine quand vous réessayez après une réponse d’acceptation ambiguë.

Interroger une opération

curl --fail-with-body \
  -H "Authorization: Bearer $THALOVANT_TOKEN" \
  https://api.thalovant.com/v1/operations/OPERATION_ID

Interrogez avec un délai d’attente croissant et plafonné (backoff). Arrêtez-vous sur ready, failed ou timed_out. Pour les commandes qui ne font qu’enregistrer une configuration, committed peut être l’état final. Suivez l’état d’achèvement documenté pour la commande que vous avez appelée.

Attention

Les lectures d’opérations sont privées : vous pouvez lire seulement les opérations lancées par votre propre compte. Un ID inconnu, ou un ID qui appartient à quelqu’un d’autre, renvoie 404 dans les deux cas.

Les clients du plan de contrôle des SDK Python, Node, Go et Rust exposent get_operation ou getOperation, selon la convention de nommage de leur langage.