Pular para o conteúdo principal
playfab file gerencia os arquivos armazenados em uma entidade do PlayFab, como um jogador.
Todos os comandos de arquivo exigem --entity-id e --entity-type. Para um jogador, passe a ID da conta de jogador do título dele com --entity-type title_player_account, e não a ID da conta de jogador mestre; playfab player account get a retorna como UserInfo.TitleInfo.TitlePlayerAccount.Id.

Saída

playfab file list grava os metadados dos arquivos em stdout como JSON, ou como uma tabela com --output table, que mostra FILE NAME, LAST MODIFIED e CHECKSUM. upload, download e delete são operações de arquivo, como cp e rm. Eles não gravam nada em stdout e informam o que fizeram em stderr: Essas mensagens podem mudar entre versões; portanto, os scripts devem verificar o código de saída: 0 quando a operação foi bem-sucedida e diferente de zero quando falhou, com o erro em stderr. Esses três comandos não aceitam --output table, e --data-only não altera o que eles gravam.

playfab file list

playfab file download

download substitui um arquivo local que já esteja no caminho de destino.
Quando a entidade não tem nenhum arquivo com esse nome, o erro mostra o comando file list a ser executado:

playfab file upload

Se um carregamento falhar

Enquanto um carregamento está em andamento, o PlayFab bloqueia todos os outros carregamentos para os arquivos da entidade, inclusive os do próprio jogo, que falham com EntityFileOperationPending. Portanto, quando um carregamento falha no meio do caminho, ou quando você pressiona Ctrl+C, a CLI o cancela e informa em stderr se isso funcionou. Quando o cancelamento funciona, os arquivos da entidade permanecem inalterados. Quando a CLI não consegue cancelar o carregamento ou não consegue determinar se o carregamento ou o cancelamento foi aplicado, ela informa isso. Ela imprime o comando que cancela o carregamento pendente e, quando o arquivo pode ter sido alterado, o comando file list para verificar. Execute o comando de cancelamento somente se os carregamentos posteriores falharem com EntityFileOperationPending, porque ele também cancela um carregamento desse arquivo que o jogo iniciou.

playfab file delete

Última modificação em 19 de novembro de 2026