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

# Comandos experimentales

> Cuánto pueden cambiar los comandos antes y después de la versión 1.0 y qué significa la etiqueta Experimental.

Cuánto puede cambiar un comando entre versiones depende de la versión de la CLI y de si
la Ayuda etiqueta el comando como `[Experimental]`. Una etiqueta en un grupo de comandos se aplica a todos los comandos
que contiene.

## Antes de la versión 1.0

Hasta la versión 1.0, la XBOX CLI está en versión preliminar, y cualquier comando puede cambiar o
quitarse entre versiones, tenga o no la etiqueta Experimental. Esto incluye sus rutas,
argumentos, opciones, valores predeterminados, salida estructurada y códigos de salida. Para la automatización, fija una versión
probada de la CLI y prueba tus flujos de trabajo antes de actualizar.

## A partir de la versión 1.0

A partir de la versión 1.0, los comandos que no tienen la etiqueta Experimental mantienen su contrato
documentado. Un cambio que interrumpa la automatización solo llega en una versión que indique que es un cambio importante.
El contrato abarca:

* Las rutas de comandos y subcomandos.
* Los nombres y significados de los argumentos y las opciones.
* Qué entradas son obligatorias.
* Los valores predeterminados documentados.
* La salida JSON documentada, incluidos los nombres y significados de los campos.
* Los códigos de salida documentados.

Pueden aparecer nuevos comandos, opciones y propiedades JSON en cualquier versión, por lo que tus scripts deben
omitir las propiedades JSON que no reconozcan. La salida escrita para personas, como texto y
tablas, no forma parte del contrato.

### Paso directo de API

Cuando un comando devuelve la respuesta de un servicio tal cual, como hace `xbox playfab api`, esa
respuesta sigue el contrato de compatibilidad propio del servicio, no el de la CLI. Las entradas de la CLI,
los códigos de salida y la salida que agrega, como el sobre de respuesta que quita `--data-only`,
sí siguen cubiertos.

## Experimental

Los comandos experimentales se publican para recibir comentarios sobre su interfaz. Incluso después de la versión 1.0, sus
rutas, opciones, valores predeterminados, salida y comportamiento pueden cambiar, o los comandos pueden quitarse,
así que no confíes en que la automatización que los usa siga siendo compatible.

Los comandos experimentales están terminados y probados, y siguen las mismas reglas de seguridad y protección
que cualquier otro comando, incluida la confirmación antes de las operaciones destructivas. Se ejecutan como
cualquier otro comando; no es necesario activarlos.


## Related topics

- [Comandos](https://docs.xbox.com/es/tools/xbox-cli/commands.md)
- [Ayuda](https://docs.xbox.com/es/tools/xbox-cli/commands/help.md)
- [Paquete](https://docs.xbox.com/es/tools/xbox-cli/commands/package.md)
- [Playtest](https://docs.xbox.com/es/tools/xbox-cli/commands/playtest.md)
- [Tu primer playtest](https://docs.xbox.com/es/tools/xbox-cli/first-playtest.md)
