> ## 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.

# Seguridad y operaciones destructivas

> Qué comandos de la XBOX CLI solo leen, cuáles preguntan antes de cambiar algo, cuáles hacen algo que su nombre no indica y qué hacer cuando el resultado de un cambio es desconocido.

La XBOX CLI actúa con tus permisos, a menudo sobre títulos y vendedores de producción. En esta página se explica
qué comandos solo leen, cuáles preguntan antes de cambiar algo, los pocos que hacen algo que
su nombre no indica y qué hacer cuando el resultado de un cambio es desconocido. Para saber qué debe preguntar un agente
de IA antes de un cambio, consulta [Uso de la XBOX CLI desde agentes](https://docs.xbox.com/es/tools/xbox-cli/cli-for-agents.md).

Un comando toma su título, vendedor o sandbox de una marca, de una variable de entorno `XBOX_` o de un
valor guardado con `xbox context set`. Un comando que cambia algo indica en stderr cada
valor que no pasaste en su línea de comandos, así que compruébalo antes de un cambio en producción. Consulta
[Contexto](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md).

## Qué es de solo lectura

Una operación de PlayFab solo es de solo lectura si su nombre empieza por `Get`, `List` o `Search`, como
`/Admin/GetTitleData` o `/MultiplayerServer/ListBuildSummariesV2`. Cualquier otra operación
cambia algo. Esto es especialmente importante con `xbox playfab api <api-path>`, donde escribes la
ruta de la operación, no el nombre de un comando.

La Ayuda de un comando tiene una sección `SAFETY` que indica si lee o cambia algo.

## Qué pregunta primero

La mayoría de los comandos que cambian algo se ejecutan sin preguntar. Estos preguntan primero en un terminal y,
sin terminal, se niegan a ejecutarse a menos que pases `--confirm` (`--yes`, `-y`):

| Comando | Cuándo necesita confirmación |
| - | - |
| Cualquier operación `Delete*` o `Shutdown*` de PlayFab, mediante cualquier comando, incluido `playfab api` | Siempre |
| `playfab economy inventory operation execute` | Cuando el lote contiene una operación `Delete`. Se niega a ejecutarse sin `--confirm`, incluso en un terminal. |
| `playfab api-policy set --overwrite` | Siempre. Se niega a ejecutarse sin `--confirm`, incluso en un terminal. |
| [`audience create`, `audience update`](https://docs.xbox.com/es/tools/xbox-cli/commands/audience) | Siempre |
| [`game create`](https://docs.xbox.com/es/tools/xbox-cli/commands/game) | Siempre |
| [`playtest create`, `update`, `publish`, `delete`](https://docs.xbox.com/es/tools/xbox-cli/commands/playtest) | Siempre |
| [`sandbox create`](https://docs.xbox.com/es/tools/xbox-cli/commands/sandbox) | Siempre |
| [`test-account batch create`, `update`, `delete`](https://docs.xbox.com/es/tools/xbox-cli/commands/test-account) | Siempre |
| [`xbl config publish`](https://docs.xbox.com/es/tools/xbox-cli/commands/xbl#config-publish) | En RETAIL, CERT, CERT.DEBUG o HIDDEN, o desde otro sandbox. Nunca con `--validate-only`. |
| [`xbl config save`, `xbl config publish`](https://docs.xbox.com/es/tools/xbox-cli/commands/xbl#title-targeting) por `--title-id` | Cuando otros títulos comparten la configuración. `--allow-shared-configuration` omite la pregunta; `--confirm` no. |
| [`pc sandbox set`](https://docs.xbox.com/es/tools/xbox-cli/commands/pc) | Siempre |

## Lo que el nombre de un comando no indica

* Si [`playfab service-principal set`](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab/service-principal) falla, es posible que la entidad
  de servicio no tenga acceso en el estudio hasta que un `set` se ejecute correctamente, lo que puede detener una
  canalización que inicie sesión como ella. Pasa `--expected-version` para que `set` falle en lugar de sobrescribir
  el cambio de otra persona.
* [`playfab privacy export`](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab/privacy) envía por correo electrónico los datos del jugador, de todos los
  títulos del editor a los que ha jugado, a la dirección de correo electrónico de notificación del título. La exportación
  y su correo electrónico no se pueden recuperar.
* [`xbl config publish`](https://docs.xbox.com/es/tools/xbox-cli/commands/xbl#cross-sandbox-publishing-replaces-global-title-storage-files)
  desde otro sandbox reemplaza los archivos de almacenamiento global del título del destino por los del
  origen y elimina los archivos que solo tiene el destino. Los archivos eliminados no se pueden recuperar.
* `xbl config publish --sandbox-id HIDDEN` publica la configuración de todo el título, que usan todos los
  sandboxes, incluido RETAIL.

## Una escritura interrumpida indica que su resultado es desconocido

Si un cambio se interrumpe después de que la CLI lo envíe, por ejemplo, con Ctrl+C, por un tiempo de espera agotado o por una
conexión perdida, o si el servicio responde con un error HTTP 5xx, es posible que el cambio se haya aplicado.
El comando indica que su resultado es desconocido, como en este error de PlayFab:

```text theme={null}
Request failed: /Admin/SetTitleData may have reached PlayFab, but the request was canceled, so its outcome is unknown. Check whether it was applied before retrying.
```

| Comandos | Código de salida cuando el resultado es desconocido |
| - | - |
| `audience create` y `update`; `playtest create`, `update`, `publish` y `delete`; `sandbox create`; `test-account batch create`, `update` y `delete`; y `xbl config save` y `publish` | `3` |
| Otros comandos, incluidos todos los comandos `playfab` | `1`, excepto `game create`, que sale con `130` cuando presionas Ctrl+C después de que envíe la solicitud. Cuando PlayFab respondió con un JSON de error, el JSON de stderr también tiene un campo `outcomeUnknown`. |

Lee el estado afectado antes de volver a ejecutar el cambio. Los comandos que no son de `playfab` muestran un
comando de solo lectura con el que comprobarlo. La CLI nunca reintenta un cambio por sí misma.

Algunos comandos que esperan a que termine un trabajo salen con `4` cuando la solicitud se aceptó pero la espera
terminó. No vuelvas a ejecutarlos; consulta la página del comando para saber cómo seguir esperando.


## Related topics

- [Comandos](https://docs.xbox.com/es/tools/xbox-cli/commands.md)
- [Integración de la API de PlayFab](https://docs.xbox.com/es/tools/xbox-cli/playfab-api.md)
- [Uso de la XBOX CLI desde agentes](https://docs.xbox.com/es/tools/xbox-cli/cli-for-agents.md)
- [Introducción](https://docs.xbox.com/es/tools/xbox-cli/getting-started.md)
- [Imágenes de logros](https://docs.xbox.com/es/tools/xbox-cli/commands/xbl/achievement-image.md)
