XBOX_ ou d’une
valeur enregistrée avec xbox context set. Une commande qui modifie quelque chose nomme 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 parGet, 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 comprend une section SAFETY qui indique si elle lit ou modifie quelque chose.
Ce qui demande une confirmation
La plupart des commandes qui modifient quelque chose s’exécutent sans demander de confirmation. Celles-ci demandent d’abord une 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 n’avoir aucun accès au studio tant qu’une commandesetn’a pas réussi, ce qui peut arrêter un pipeline qui se connecte en tant que ce principal. Passez--expected-versionpour quesetéchoue au lieu de remplacer la modification de quelqu’un d’autre. playfab privacy exportenvoie par courriel les données du joueur, provenant de tous les titres de l’éditeur auxquels il a joué, à l’adresse courriel de notification du titre. L’exportation et son courriel ne peuvent pas être rappelés.xbl config publishà partir d’un autre sandbox remplace les fichiers de stockage global du titre de la destination par ceux de la source, et supprime les fichiers que seule la destination possède. Les fichiers supprimés ne peuvent pas être récupérés.xbl config publish --sandbox-id HIDDENpublie la configuration à l’échelle du titre, qu’utilisent tous les sandboxes, y compris RETAIL.
Une écriture interrompue signale que son résultat est inconnu
Si une modification est interrompue après que la CLI l’a envoyée, par exemple par Ctrl+C, par un délai d’expiration ou par une perte de connexion, ou si le service répond par 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 de nouveau la modification. Les commandes autres que
playfab affichent une
commande en lecture seule permettant d’effectuer la vérification. La CLI ne réessaie jamais une modification d’elle-même.
Certaines commandes qui attendent une tâche se terminent avec le code 4 lorsque la requête a été acceptée, mais que l’attente
a pris fin. Ne les exécutez pas de nouveau; consultez la page de la commande pour savoir comment continuer d’attendre.