Passer au contenu principal
La XBOX CLI agit avec vos autorisations, souvent sur des titres et des vendeurs de production. Cette page indique quelles commandes se contentent de lire, lesquelles demandent confirmation avant de modifier quelque chose, les quelques commandes qui font quelque chose que leur nom n’indique pas, et que faire quand le résultat d’une modification est inconnu. Pour savoir ce qu’un agent d’IA doit demander avant une modification, consultez Utiliser la XBOX CLI depuis des agents. Une commande obtient son titre, son vendeur ou son sandbox à partir d’un indicateur, d’une variable d’environnement XBOX_ ou d’une valeur enregistrée avec xbox context set. Une commande qui modifie quelque chose indique sur stderr chaque valeur que vous n’avez pas passée sur sa ligne de commande : vérifiez-la donc avant une modification de production. Consultez Contexte.

Ce qui est en lecture seule

Une opération PlayFab est en lecture seule uniquement si son nom commence par Get, List ou Search, comme /Admin/GetTitleData ou /MultiplayerServer/ListBuildSummariesV2. Toute autre opération modifie quelque chose. C’est particulièrement important pour xbox playfab api <api-path>, où vous tapez le chemin de l’opération, et non un nom de commande. L’aide d’une commande comporte une section SAFETY qui indique si elle lit ou modifie quelque chose.

Ce qui demande confirmation d’abord

La plupart des commandes qui modifient quelque chose s’exécutent sans demander. Les commandes suivantes demandent d’abord confirmation dans un terminal, et sans terminal, elles refusent de s’exécuter sauf si vous passez --confirm (--yes, -y) :

Ce que le nom d’une commande n’indique pas

  • Si playfab service-principal set échoue, le principal de service peut ne plus avoir aucun accès au studio jusqu’à ce qu’un set réussisse, ce qui peut bloquer un pipeline qui se connecte avec ce principal. Passez --expected-version pour que set échoue au lieu d’écraser la modification de quelqu’un d’autre.
  • playfab privacy export envoie par e-mail les données du joueur, issues de tous les titres de l’éditeur auxquels il a joué, à l’adresse e-mail de notification du titre. L’exportation et son e-mail ne peuvent pas être rappelés.
  • xbl config publish depuis un autre sandbox remplace les fichiers de stockage global du titre de la destination par ceux de la source, et supprime les fichiers présents uniquement dans la destination. Les fichiers supprimés ne peuvent pas être récupérés.
  • xbl config publish --sandbox-id HIDDEN publie la configuration à l’échelle du titre, utilisée par tous les sandbox, y compris RETAIL.

Une écriture interrompue signale que son résultat est inconnu

Si une modification est interrompue après son envoi par la CLI, par exemple par Ctrl+C, un délai d’expiration ou une perte de connexion, ou si le service répond avec une erreur HTTP 5xx, la modification a peut-être été appliquée. La commande indique que son résultat est inconnu, comme dans cette erreur PlayFab :
Lisez l’état concerné avant d’exécuter à nouveau la modification. Les commandes en dehors de playfab affichent une commande en lecture seule permettant de vérifier. La CLI ne réessaie jamais une modification d’elle-même. Certaines commandes qui attendent une tâche se terminent avec 4 lorsque la requête a été acceptée mais que l’attente a pris fin. Ne les exécutez pas à nouveau ; consultez la page de la commande pour savoir comment continuer à attendre.
Dernière modification le 19 novembre 2026