メインコンテンツへスキップ
playfab file は、プレイヤーなどの PlayFab エンティティに保存されているファイルを管理します。
すべての file コマンドには --entity-id と --entity-type が必要です。プレイヤーの場合は、マスター プレイヤー アカウント ID ではなく、タイトル プレイヤー アカウント ID を --entity-type title_player_account と共に渡します。 この ID は、playfab player account get から UserInfo.TitleInfo.TitlePlayerAccount.Id として返されます。

出力

playfab file list は、ファイルのメタデータを JSON として stdout に書き込みます。--output table を指定した場合は表として書き込み、 FILE NAME、LAST MODIFIED、CHECKSUM を表示します。 upload、download、delete は、cp や rm と同様のファイル操作です。これらのコマンドは stdout に何も書き込まず、実行した内容を stderr に報告します。 これらのメッセージはリリース間で変更される可能性があるため、スクリプトでは終了コードを確認してください。操作が成功した場合は 0、 失敗した場合は 0 以外で、エラーは stderr に出力されます。これらの 3 つのコマンドは --output table を受け付けず、--data-only を指定しても書き込まれる内容は 変わりません。

playfab file list

playfab file download

download は、書き込み先のパスに既にあるローカル ファイルを置き換えます。
エンティティにその名前のファイルがない場合は、実行する file list コマンドがエラーに表示されます。

playfab file upload

アップロードが失敗した場合

アップロードの進行中、PlayFab はエンティティのファイルに対する他のすべてのアップロードをブロックします。 これにはゲーム自体のアップロードも含まれ、EntityFileOperationPending で失敗します。そのため、アップロードが途中で 失敗した場合や Ctrl+C キーを押した場合、CLI はアップロードをキャンセルし、キャンセルが成功したかどうかを stderr に示します。 キャンセルが成功した場合、エンティティのファイルは変更されません。 CLI がアップロードをキャンセルできない場合、またはアップロードとキャンセルのどちらが適用されたかを判断できない場合は、 その旨が示されます。保留中のアップロードをキャンセルするコマンドと、ファイルが変更された可能性がある場合は 確認用の file list コマンドが出力されます。キャンセル コマンドは、ゲームが開始したそのファイルのアップロードも キャンセルするため、以降のアップロードが EntityFileOperationPending で失敗する場合にのみ実行してください。

playfab file delete

最終更新日 2026年11月19日