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

# Sandbox

> Enumera, obtén y crea los sandboxes de XBOX disponibles para el desarrollador que ha iniciado sesión.

Un sandbox de XBOX es un entorno aislado de una cuenta de Partner Center, para productos de Microsoft Store
y servicios de XBOX. Microsoft administra los sandboxes globales, como `RETAIL`;
los sandboxes de desarrollo, como `ABCDEF.1`, pertenecen a tu cuenta. Consulta
[Sandboxes](https://learn.microsoft.com/gaming/game-publishing/concepts/sandboxes) en la guía de publicación
de juegos. Para cambiar el sandbox que usa un PC con Windows, consulta [PC](https://docs.xbox.com/es/tools/xbox-cli/commands/pc.md).

Cada comando actúa sobre un vendedor, a partir de `--seller-id` o de tu vendedor guardado; consulta
[Contexto](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md). Si no es el vendedor que seleccionaste por última vez en Partner Center, consulta
[este problema conocido](https://docs.xbox.com/es/tools/xbox-cli/known-issues.md#xbox-sandbox-commands-show-only-global-sandboxes).

## Comandos

| Comando | Descripción |
| - | - |
| `sandbox list` | Enumera los sandboxes del vendedor y los sandboxes globales, tal como los muestra la página Sandboxes de Partner Center. |
| `sandbox get <sandbox-id>` | Obtiene un sandbox, incluido uno global o aislado: su identificador, su tipo, el vendedor propietario y si es global. |
| `sandbox create <sandbox-id>` | Crea un sandbox de desarrollo compartido y, después, espera a su trabajo de creación. |

## Argumentos y opciones

| Argumento u opción | Se aplica a | Obligatorio | Descripción |
| - | - | - | - |
| `<sandbox-id>` | `get`, `create` | Sí | Identificador del sandbox, como `ABCDEF.1`. No se distingue entre mayúsculas y minúsculas. Consulta [Identificadores de sandbox](#sandbox-ids). |
| `--seller-id <id>` | todos | Si no está guardado | Identificador de vendedor de Partner Center. |
| `--base-url <url>` | todos | No | URL base de las solicitudes, que invalida la clave de configuración `XboxPartner:BaseUrl`. |
| `--confirm`, `--yes`, `-y` | `create` | No | Crea el sandbox sin la solicitud de confirmación. |
| `--output <format>` | todos | No | `json` (predeterminado) o `json-compact`; `table` solo en `list` y `get`. |

Pasa un `sandboxId` de `list` a otros comandos, como la opción `--sandbox-id` de los comandos
[`xbl`](https://docs.xbox.com/es/tools/xbox-cli/commands/xbl).

### Identificadores de sandbox

Un identificador de sandbox está formado por letras y dígitos con un sufijo opcional separado por un punto, de hasta 64
caracteres. La CLI lo convierte a mayúsculas.

* `get` acepta cualquier identificador de sandbox, incluidos los globales, como `RETAIL` y `CERT.DEBUG`.
* `create` necesita de 4 a 60 letras o dígitos, un punto y un número del `0` al `999` sin
  cero inicial, como `ABCDEF.1`. El sufijo `.58` está reservado para los sandboxes aislados, y
  no se pueden usar `UNDEFINED` ni los nombres de los sandboxes globales.

## Salida

`sandbox get` escribe un sandbox:

```json theme={null}
{ "sandboxId": "ABCDEF.58", "type": "Isolated", "sellerId": "1234567", "global": false }
```

| Campo | Descripción |
| - | - |
| `sandboxId` | El identificador del sandbox. |
| `type` | `Shared`, `Isolated` o `Unknown`. `create` solo crea sandboxes compartidos. |
| `sellerId` | El vendedor propietario, o `null` para un sandbox global. |
| `global` | `true` para un sandbox global, como `RETAIL`. |

`sandbox list` escribe una matriz `sandboxes` de los mismos objetos:

```json theme={null}
{
  "sandboxes": [
    { "sandboxId": "RETAIL", "type": "Shared", "sellerId": null, "global": true },
    { "sandboxId": "ABCDEF.1", "type": "Shared", "sellerId": "1234567", "global": false }
  ]
}
```

`list --output table` tiene las columnas `SANDBOX`, `TYPE` y `GLOBAL`, y `get --output table` tiene
`SANDBOX ID`, `TYPE` y `SELLER ID`. `create` rechaza `--output table`.

## Creación de un sandbox

```bash theme={null}
xbox sandbox create ABCDEF.1 --seller-id 1234567 --confirm
```

`sandbox create` pregunta antes de crear el sandbox; sin un terminal, necesita `--confirm`.
La CLI no puede eliminar un sandbox. Si perteneces a varios vendedores, consulta primero
[el problema conocido](https://docs.xbox.com/es/tools/xbox-cli/known-issues.md#xbox-sandbox-commands-show-only-global-sandboxes): el
sandbox se puede crear en otro vendedor.

El comando envía la solicitud una sola vez y espera hasta dos minutos al trabajo de creación. Cuando el
trabajo se completa correctamente, escribe el nuevo sandbox con la misma forma que `sandbox get`. El identificador del trabajo,
el identificador de correlación y lo que debes comprobar a continuación van a stderr. Cuando el código de salida es `3` o `4`, compruébalo con
`sandbox get <sandbox-id>` y no vuelvas a crear el sandbox.

| Código de salida | Significado |
| - | - |
| `0` | Se creó el sandbox. |
| `1` | No se creó el sandbox: se rechazó la entrada o la confirmación, no se envió la solicitud o el servicio la rechazó, por ejemplo con `409` cuando el sandbox ya existe. Corrige el problema y vuelve a ejecutar el comando. |
| `2` | El trabajo de creación falló. El trabajo, con sus `errors`, se escribe en stdout. |
| `3` | Se envió la solicitud, pero se desconoce su resultado. Compruébalo con `sandbox get`. |
| `4` | Se aceptó el trabajo, pero la espera terminó antes de que se confirmara el sandbox. No se escribe nada en stdout. Compruébalo con `sandbox get`. |

## Errores

Un error escribe texto en stderr, sea cual sea `--output`: el identificador de correlación, indicaciones para el
estado HTTP y el detalle del error del servicio, cuando lo hay. `--verbose` agrega el cuerpo de la
respuesta. Los scripts deben bifurcarse según el código de salida, no según el texto.

## Ejemplos

Enumerar sandboxes y obtener dos de ellos:

```bash theme={null}
xbox sandbox list --output table
xbox sandbox get ABCDEF.1
xbox sandbox get RETAIL
```

Crear un sandbox sin la solicitud de confirmación:

```bash theme={null}
xbox sandbox create ABCDEF.2 --seller-id 1234567 --confirm --output json-compact
```


## Related topics

- [Sandboxes](https://docs.xbox.com/es/publishing/game-publishing/concepts/sandboxes.md)
- [Configuración de sandboxes](https://docs.xbox.com/es/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes.md)
- [Conmutador de sandbox de PC (XblPCSandbox.exe)](https://docs.xbox.com/es/tools/tools-services/live-pc-sandbox-switcher.md)
- [Crear y administrar sandboxes de desarrollo](https://docs.xbox.com/es/publishing/game-publishing/how-to/how-to-create-and-manage-sandboxes.md)
- [XSystemGetXboxLiveSandboxId](https://docs.xbox.com/es/reference/system/xsystem/functions/xsystemgetxboxlivesandboxid.md)
