Passer au contenu principal
L’ampleur des changements possibles d’une commande entre deux versions dépend de la version de la CLI et du fait que l’aide étiquette ou non la commande [Experimental]. Une étiquette sur un groupe de commandes s’applique à toutes les commandes qu’il contient.

Avant la version 1.0

Jusqu’à la version 1.0, la XBOX CLI est en préversion, et toute commande peut changer ou être supprimée d’une version à l’autre, qu’elle soit étiquetée Experimental ou non. Cela inclut ses chemins, arguments, options, valeurs par défaut, sortie structurée et codes de sortie. Pour l’automatisation, épinglez une version testée de la CLI et testez vos workflows avant de mettre à niveau.

À partir de la version 1.0

À partir de la version 1.0, les commandes qui ne sont pas étiquetées Experimental respectent leur contrat documenté. Une modification qui casse l’automatisation n’arrive que dans une version qui indique explicitement qu’elle est cassante. Le contrat couvre :
  • Les chemins des commandes et sous-commandes.
  • Les noms et significations 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 significations des champs.
  • Les codes de sortie documentés.
De nouvelles commandes, options et propriétés JSON peuvent apparaître dans n’importe quelle version : vos scripts doivent donc ignorer les propriétés JSON qu’ils ne reconnaissent pas. La sortie destinée aux personnes, comme le texte et les tableaux, ne fait pas partie du contrat.

Transmission directe de l’API

Lorsqu’une commande renvoie la réponse d’un service telle quelle, comme le fait xbox 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 supprime, restent couverts.

Expérimental

Les commandes expérimentales sont publiées pour recueillir des commentaires sur leur interface. Même après la version 1.0, leurs chemins, options, valeurs par défaut, sortie et comportement peuvent changer, ou les commandes peuvent être supprimées : ne comptez donc pas sur la compatibilité continue d’une automatisation qui les utilise. Les commandes expérimentales sont terminées et testées, et suivent les mêmes règles de sécurité que toutes les autres commandes, y compris la confirmation avant les opérations destructives. Elles s’exécutent comme n’importe quelle autre commande ; vous n’avez pas besoin de les activer.
Dernière modification le 19 novembre 2026