메인 콘텐츠로 건너뛰기
playfab file은 플레이어 같은 PlayFab 엔터티에 저장된 파일을 관리합니다.
모든 파일 명령에는 --entity-id와 --entity-type이 필요합니다. 플레이어의 경우 마스터 플레이어 계정 ID가 아니라 타이틀 플레이어 계정 ID를 --entity-type title_player_account와 함께 전달하세요. playfab player account get은 이 ID를 UserInfo.TitleInfo.TitlePlayerAccount.Id로 반환합니다.

출력

playfab file list는 파일의 메타데이터를 stdout에 JSON으로 쓰거나, --output table을 사용하면 FILE NAME, LAST MODIFIED, CHECKSUM을 표시하는 표로 씁니다. upload, download, delete는 cp 및 rm과 같은 파일 작업입니다. 이러한 명령은 stdout에 아무것도 쓰지 않으며, 수행한 작업을 stderr에 보고합니다. 이러한 메시지는 릴리스마다 변경될 수 있으므로 스크립트는 종료 코드를 확인해야 합니다. 작업이 성공하면 0이고, 실패하면 0이 아니며 오류는 stderr에 있습니다. 이 세 명령은 --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일