[Experimental]. Une étiquette sur un groupe de commandes s’applique à chaque commande
qu’il contient.
Avant la version 1.0
Jusqu’à la version 1.0, l’XBOX CLI est en préversion, et n’importe quelle commande peut changer ou être retirée d’une version à l’autre, qu’elle soit étiquetée Expérimental ou non. Cela comprend ses chemins, ses arguments, ses options, ses valeurs par défaut, sa sortie structurée et ses codes de sortie. Pour l’automatisation, épinglez une version testée de la CLI et testez vos flux de travail avant de procéder à une mise à niveau.À partir de la version 1.0
À partir de la version 1.0, les commandes qui ne sont pas étiquetées Expérimental respectent leur contrat documenté. Un changement qui brise l’automatisation n’arrive que dans une version qui indique qu’il s’agit d’un changement cassant. Le contrat couvre :- Les chemins des commandes et des sous-commandes.
- Les noms et la signification des arguments et des options.
- Les entrées obligatoires.
- Les valeurs par défaut documentées.
- La sortie JSON documentée, y compris les noms et la signification des champs.
- Les codes de sortie documentés.
Transmission directe d’API
Lorsqu’une commande renvoie la réponse d’un service telle quelle, comme le faitxbox playfab api, cette
réponse suit le contrat de compatibilité propre au service, et non celui de la CLI. Les entrées de la CLI,
ses codes de sortie et la sortie qu’elle ajoute, comme l’enveloppe de réponse que --data-only
retire, restent couverts.
