playfab file は、プレイヤーなどの PlayFab エンティティに保存されているファイルを管理します。
--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 で失敗する場合にのみ実行してください。
