az account alias wait |
Azure : Attendre un alias de compte |
|---|---|
| Azure CLI | |
Syntaxe
| az account alias wait --name [--created] [--custom] [--deleted] [--exists] [--interval] [--timeout] [--updated] |
Paramètres
| Nom | Description |
|---|---|
| --created | Ce paramètre permet d'attendre la création avec 'provisioningState' à 'Succeeded'. |
| --custom | Ce paramètre permet d'attendre que la condition satisfasse une requête JMESPath personnalisée. Par exemple : «provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']». |
| --debug | Ce paramètre permet d'augmenter les détails du journal de bord pour afficher tous les journals de bord de débogage. |
| --deleted | Ce paramètre permet d'attendre la suppression. |
| --exists | Ce paramètre permet d'attendre que la ressource existe. |
| -h | Ce paramètre permet d'afficher ce message d'aide et de quitter. |
| --help | Ce paramètre permet d'afficher ce message d'aide et de quitter. |
| --interval | Ce paramètre permet d'indiquer l'intervalle d'interrogation en secondes. La valeur par défaut est 30. |
| --name | Ce paramètre permet d'indiquer le nom de l'alias. |
| -n | Ce paramètre permet d'indiquer le nom de l'alias. |
| -o | Ce paramètre permet d'indiquer le format de sortie. |
| --only-show-errors | Ce paramètre permet d'afficher uniquement les erreurs, en supprimant les avertissements. |
| --output | Ce paramètre permet d'indiquer le format de sortie. |
| --query | Ce paramètre permet d'indiquer la chaîne de requête JMESPath. |
| --timeout | Ce paramètre permet d'attendre un maximum de secondes spécifié. La valeur par défaut est 3600. |
| --updated | Ce paramètre permet d'attendre la mise à jour avec provisioningState à 'Succeeded'. |
| --verbose | Ce paramètre permet d'augmenter les détails du journal de bord. Utilisez --debug pour les journaux de débogage complets. |
Description
Cette commande permet de placer le CLI dans un état d'attente jusqu'à ce qu'une condition de l'alias de compte soit remplie.
Remarques
- Commande conçue pour la synchronisation des actions automatisées : La commande az account alias wait est particulièrement utile dans les scripts automatisés où il est nécessaire d'attendre qu'un alias de compte soit dans un certain état (créé, supprimé, mis à jour, etc.) avant de poursuivre l'exécution. Cela permet d'éviter les erreurs dues à des ressources non encore prêtes.
- Support de plusieurs états de surveillance via des indicateurs dédiés : Cette commande offre des options explicites telles que --created, --deleted, --updated ou --exists pour attendre un état spécifique. Cela simplifie la logique et permet d'écrire des scripts plus lisibles et robustes.
- Personnalisation avancée avec le paramètre --custom : Le paramètre --custom permet d'attendre une condition définie via une expression JMESPath. Cela donne un contrôle très précis sur les critères d'attente, utile pour surveiller des changements spécifiques au-delà des états standards.
- Définition d'un intervalle de vérification grâce à --interval : Le paramètre --interval permet de régler la fréquence des vérifications en secondes. Cela est particulièrement utile pour équilibrer entre rapidité de réponse et consommation d'API, surtout dans des boucles longues.
- Limitation de la durée d'attente grâce à --timeout : Pour éviter des blocages infinis, le paramètre --timeout permet de définir une durée maximale d'attente (par défaut 3600 secondes). Cela garantit que le script se termine ou échoue proprement si la condition n'est jamais remplie.
- Commande non-destructive, orientée observation passive : Contrairement à d'autres commandes de gestion, az account alias wait n'effectue aucune modification sur les ressources. Elle se contente d'observer leur état, ce qui la rend sûre à utiliser dans tous les contextes.
- Retour utile dans les pipelines CI/CD et DevOps : Dans les scénarios DevOps, cette commande est essentielle pour s'assurer qu'une ressource est prête avant de lancer l'étape suivante du pipeline. Elle évite les échecs dus à des déploiements prématurés.
- Complément naturel des commandes create, delete, update : La commande wait s'utilise idéalement juste après une commande de création ou de suppression (az account alias create/delete). Elle assure une transition douce entre les étapes, en rendant explicite le moment où une ressource est effectivement disponible ou supprimée.
Dernière mise à jour : Dimanche, le 4 Avril 2021