Passer au contenu principal
L’ampleur des changements qu’une commande peut subir d’une version à l’autre 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 à 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.
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 d’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 retire, 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 retirées; ne comptez donc pas sur le maintien de la compatibilité de l’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 destructrices. 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