Passer au contenu principal
playfab file gère les fichiers stockés sur une entité PlayFab, comme un joueur.
Chaque commande de fichier exige --entity-id et --entity-type. Pour un joueur, transmettez l’ID de son compte de joueur du titre avec --entity-type title_player_account, et non l’ID de son compte de joueur principal; playfab player account get le retourne sous la forme UserInfo.TitleInfo.TitlePlayerAccount.Id.

Sortie

playfab file list écrit les métadonnées des fichiers sur stdout en JSON, ou sous forme de tableau avec --output table, qui affiche FILE NAME, LAST MODIFIED et CHECKSUM. upload, download et delete sont des opérations sur les fichiers, comme cp et rm. Elles n’écrivent rien sur stdout et signalent ce qu’elles ont fait sur stderr : Ces messages peuvent changer d’une version à l’autre; les scripts doivent donc vérifier le code de sortie : 0 lorsque l’opération a réussi, et un code non nul lorsqu’elle a échoué, avec l’erreur sur stderr. Ces trois commandes n’acceptent pas --output table, et --data-only ne change pas ce qu’elles écrivent.

playfab file list

playfab file download

download remplace un fichier local qui se trouve déjà au chemin de destination.
Lorsque l’entité n’a aucun fichier portant ce nom, l’erreur affiche la commande file list à exécuter :

playfab file upload

Si un téléversement échoue

Pendant qu’un téléversement est en cours, PlayFab bloque tous les autres téléversements vers les fichiers de l’entité, y compris ceux du jeu lui-même, qui échouent avec EntityFileOperationPending. Ainsi, lorsqu’un téléversement échoue en cours de route, ou que vous appuyez sur Ctrl+C, la CLI l’annule et indique sur stderr si l’annulation a fonctionné. Lorsque l’annulation fonctionne, les fichiers de l’entité restent inchangés. Lorsque la CLI ne peut pas annuler le téléversement, ou ne peut pas déterminer si le téléversement ou l’annulation a été appliqué, elle l’indique. Elle affiche la commande qui annule le téléversement en attente et, lorsque le fichier pourrait avoir changé, la commande file list permettant de le vérifier. Exécutez la commande d’annulation seulement si les téléversements suivants échouent avec EntityFileOperationPending, car elle annule aussi un téléversement de ce fichier que le jeu a lancé.

playfab file delete

Dernière modification le 19 novembre 2026