> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Archivos

> Enumera, descarga, carga y elimina archivos de entidad mediante la API File de PlayFab.

`playfab file` administra los archivos almacenados en una entidad de PlayFab, como un jugador.

```text theme={null}
xbox --playfab-title-id ABC123 playfab file <command>
```

Todos los comandos de archivo requieren `--entity-id` y `--entity-type`. Para un jugador, pasa su
identificador de cuenta de jugador de título con `--entity-type title_player_account`, no su identificador de cuenta de
jugador maestra; [`playfab player account get`](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab/player) lo devuelve como
`UserInfo.TitleInfo.TitlePlayerAccount.Id`.

| Comando | Ruta de la API de PlayFab | Descripción |
| - | - | - |
| `playfab file list` | `/File/GetFiles` | Enumera los archivos de una entidad. |
| `playfab file download` | `/File/GetFiles` | Descarga un archivo. |
| `playfab file upload` | `/File/InitiateFileUploads`, `/File/FinalizeFileUploads` y `/File/AbortFileUploads` si la carga falla | Carga un archivo local, que se agrega o se reemplaza. |
| `playfab file delete` | `/File/DeleteFiles` | Elimina uno o varios archivos. Pregunta primero; consulta [Seguridad y operaciones destructivas](https://docs.xbox.com/es/tools/xbox-cli/safety.md). |

## Salida

`playfab file list` escribe los metadatos de los archivos en stdout como JSON o, con
`--output table`, como una tabla que muestra `FILE NAME`, `LAST MODIFIED` y `CHECKSUM`.

`upload`, `download` y `delete` son operaciones de archivo, como `cp` y `rm`. No escriben
nada en stdout e informan de lo que hicieron en stderr:

| Comando | stderr si se completa correctamente |
| - | - |
| `playfab file upload` | `Uploading source file: <path>` al empezar y, después, `Uploaded '<name>' (<bytes> bytes).` |
| `playfab file download` | `Downloaded '<name>' to '<path>' (<bytes> bytes).` |
| `playfab file delete` | `Deleted file: '<name>'`, o `Deleted files: '<name>', '<name>'` si son varios |

Estos mensajes pueden cambiar de una versión a otra, así que los scripts deben comprobar el código de salida: `0`
cuando la operación se completó correctamente, y un valor distinto de cero cuando falló, con el error en stderr. Estos
tres comandos no aceptan `--output table`, y `--data-only` no cambia lo que
escriben.

## `playfab file list`

```bash theme={null}
xbox --playfab-title-id ABC123 playfab file list --entity-id TITLEPLAYER123 --entity-type title_player_account
xbox --playfab-title-id ABC123 playfab file list --entity-id TITLEPLAYER123 --entity-type title_player_account --output table
```

## `playfab file download`

| Opción | Obligatorio | Descripción |
| - | - | - |
| `--entity-id <entity-id>` | Sí | Identificador de la entidad. |
| `--entity-type <entity-type>` | Sí | Tipo de entidad. |
| `--name <name>` | Sí | Nombre del archivo que se va a descargar. |
| `--dest <dest>` | No | Ruta de acceso local en la que se escribe. El valor predeterminado es el nombre del archivo en el directorio actual. Pásala cuando ese nombre no sea válido localmente. No se admite `-` para stdout. |

`download` reemplaza un archivo local que ya esté en la ruta de destino.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab file download --entity-id TITLEPLAYER123 --entity-type title_player_account --name data.json --dest data.json
```

Cuando la entidad no tiene ningún archivo con ese nombre, el error muestra el comando `file list` que se debe ejecutar:

```console theme={null}
$ xbox --playfab-title-id ABC123 playfab file download --entity-id TITLEPLAYER123 --entity-type title_player_account --name save.json
Error: File 'save.json' not found on this entity. To see its files, run:
  xbox --playfab-title-id ABC123 playfab file list --entity-id TITLEPLAYER123 --entity-type title_player_account
```

## `playfab file upload`

| Opción | Obligatorio | Descripción |
| - | - | - |
| `--entity-id <entity-id>` | Sí | Identificador de la entidad. |
| `--entity-type <entity-type>` | Sí | Tipo de entidad. |
| `--file <file>` | Sí | Ruta de acceso al archivo local que se va a cargar. No se admite `-` para stdin. |
| `--name <name>` | No | Nombre con el que se almacena el archivo. El valor predeterminado es el nombre del archivo local. |

```console theme={null}
$ xbox --playfab-title-id ABC123 playfab file upload --entity-id TITLEPLAYER123 --entity-type title_player_account --file save.json
Uploading source file: D:\NodArena\save.json
Uploaded 'save.json' (2048 bytes).
```

### Si una carga falla

Mientras hay una carga en curso, PlayFab bloquea todas las demás cargas a los archivos de la entidad,
incluidas las del propio juego, que fallan con `EntityFileOperationPending`. Por eso, cuando una carga
falla a medias, o pulsas Ctrl+C, la CLI la cancela e indica en stderr si la cancelación
funcionó. Cuando la cancelación funciona, los archivos de la entidad no cambian.

Cuando la CLI no puede cancelar la carga, o no puede saber si se aplicó la carga o la cancelación,
lo indica. Imprime el comando que cancela la carga pendiente y, cuando es posible que el archivo
haya cambiado, el comando `file list` para comprobarlo. Ejecuta el comando de cancelación solo si las cargas posteriores
fallan con `EntityFileOperationPending`, porque también cancela una carga de ese archivo que
haya iniciado el juego.

## `playfab file delete`

| Argumento u opción | Obligatorio | Descripción |
| - | - | - |
| `<names...>` | Sí | Uno o varios nombres de archivo que se van a eliminar. |
| `--entity-id <entity-id>` | Sí | Identificador de la entidad. |
| `--entity-type <entity-type>` | Sí | Tipo de entidad. |
| `--confirm`, `--yes`, `-y` | Fuera de un terminal interactivo | Confirma la eliminación. |

```bash theme={null}
xbox --playfab-title-id ABC123 playfab file delete data.json --entity-id TITLEPLAYER123 --entity-type title_player_account --confirm
```


## Related topics

- [Obtener archivos](https://docs.xbox.com/es/services/playfab/api-references/rest/data/file/get-files.md)
- [Eliminar archivos](https://docs.xbox.com/es/services/playfab/api-references/rest/data/file/delete-files.md)
- [Archivos de entidad](https://docs.xbox.com/es/services/playfab/live-service-management/game-configuration/entities/entity-files.md)
- [Iniciar cargas de archivos](https://docs.xbox.com/es/services/playfab/api-references/rest/data/file/initiate-file-uploads.md)
- [Anular cargas de archivos](https://docs.xbox.com/es/services/playfab/api-references/rest/data/file/abort-file-uploads.md)
