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

> Liste, obtenha e crie as sandboxes do XBOX disponíveis para o desenvolvedor conectado.

Uma sandbox do XBOX é um ambiente isolado em uma conta do Partner Center, para produtos da Microsoft Store
e XBOX services. As sandboxes globais, como `RETAIL`, são gerenciadas pela Microsoft;
as sandboxes de desenvolvimento, como `ABCDEF.1`, pertencem à sua conta. Consulte
[Sandboxes](https://learn.microsoft.com/gaming/game-publishing/concepts/sandboxes) no Guia de
Publicação de Jogos. Para trocar a sandbox que um PC com Windows usa, consulte [PC](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/pc.md).

Cada comando atua em um vendedor, de `--seller-id` ou do vendedor salvo; consulte
[Contexto](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/context.md). Se esse não for o vendedor que você selecionou por último no Partner Center, consulte
[este problema conhecido](https://docs.xbox.com/pt-BR/tools/xbox-cli/known-issues.md#xbox-sandbox-commands-show-only-global-sandboxes).

## Comandos

| Comando | Descrição |
| - | - |
| `sandbox list` | Lista as sandboxes do vendedor e as sandboxes globais, como a página Sandboxes do Partner Center as mostra. |
| `sandbox get <sandbox-id>` | Obtém uma sandbox, inclusive uma global ou Isolated: sua ID, tipo, vendedor proprietário e se ela é global. |
| `sandbox create <sandbox-id>` | Cria uma sandbox de desenvolvimento Shared e aguarda o trabalho de criação dela. |

## Argumentos e opções

| Argumento ou opção | Aplica-se a | Obrigatório | Descrição |
| - | - | - | - |
| `<sandbox-id>` | `get`, `create` | Sim | ID da sandbox, como `ABCDEF.1`. Maiúsculas e minúsculas não importam. Consulte [IDs de sandbox](#sandbox-ids). |
| `--seller-id <id>` | todos | Se não estiver salva | ID do vendedor no Partner Center. |
| `--base-url <url>` | todos | Não | URL base das solicitações, que substitui a chave de configuração `XboxPartner:BaseUrl`. |
| `--confirm`, `--yes`, `-y` | `create` | Não | Cria a sandbox sem a solicitação de confirmação. |
| `--output <format>` | todos | Não | `json` (padrão) ou `json-compact`; `table` somente em `list` e `get`. |

Passe uma `sandboxId` de `list` para outros comandos, como a opção `--sandbox-id` dos comandos
[`xbl`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/xbl).

### IDs de sandbox

Uma ID de sandbox é composta de letras e dígitos com um sufixo opcional separado por ponto, com até 64
caracteres. A CLI a converte em maiúsculas.

* `get` aceita qualquer ID de sandbox, inclusive as globais, como `RETAIL` e `CERT.DEBUG`.
* `create` precisa de 4 a 60 letras ou dígitos, um ponto e um número de `0` a `999` sem
  zero à esquerda, como `ABCDEF.1`. O sufixo `.58` é reservado para sandboxes Isolated, e
  `UNDEFINED` e os nomes das sandboxes globais não podem ser usados.

## Saída

`sandbox get` grava uma sandbox:

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

| Campo | Descrição |
| - | - |
| `sandboxId` | A ID da sandbox. |
| `type` | `Shared`, `Isolated` ou `Unknown`. `create` cria somente sandboxes Shared. |
| `sellerId` | O vendedor proprietário ou `null` para uma sandbox global. |
| `global` | `true` para uma sandbox global, como `RETAIL`. |

`sandbox list` grava uma matriz `sandboxes` com os mesmos 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` tem as colunas `SANDBOX`, `TYPE` e `GLOBAL`, e `get --output table` tem
`SANDBOX ID`, `TYPE` e `SELLER ID`. `create` recusa `--output table`.

## Criar uma sandbox

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

`sandbox create` pergunta antes de criar a sandbox; sem um terminal, ele precisa de `--confirm`.
A CLI não pode excluir uma sandbox. Se você pertencer a vários vendedores, verifique
[o problema conhecido](https://docs.xbox.com/pt-BR/tools/xbox-cli/known-issues.md#xbox-sandbox-commands-show-only-global-sandboxes) primeiro: a
sandbox pode ser criada em outro vendedor.

O comando envia a solicitação uma única vez e aguarda até dois minutos pelo trabalho de criação. Quando o
trabalho é bem-sucedido, ele grava a nova sandbox no mesmo formato de `sandbox get`. A ID do trabalho,
a ID de correlação e o que verificar em seguida vão para stderr. Quando o código de saída for `3` ou `4`, verifique com
`sandbox get <sandbox-id>` e não crie a sandbox novamente.

| Código de saída | Significado |
| - | - |
| `0` | A sandbox foi criada. |
| `1` | A sandbox não foi criada: a entrada ou a confirmação foi recusada, a solicitação não foi enviada ou o serviço a rejeitou, por exemplo, com `409` quando a sandbox já existe. Corrija o problema e execute o comando novamente. |
| `2` | O trabalho de criação falhou. O trabalho, com seus `errors`, é gravado em stdout. |
| `3` | A solicitação foi enviada, mas o resultado é desconhecido. Verifique com `sandbox get`. |
| `4` | O trabalho foi aceito, mas a espera terminou antes que a sandbox fosse confirmada. Nada é gravado em stdout. Verifique com `sandbox get`. |

## Erros

Uma falha grava texto em stderr, qualquer que seja o valor de `--output`: a ID de correlação, orientações para o
status HTTP e o detalhe do erro do serviço, quando houver. `--verbose` adiciona o corpo
da resposta. Os scripts devem se basear no código de saída, e não no texto da mensagem.

## Exemplos

Listar sandboxes e obter duas delas:

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

Criar uma sandbox sem a solicitação de confirmação:

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


## Related topics

- [Alternador de sandbox para PC (XblPCSandbox.exe)](https://docs.xbox.com/pt-BR/tools/tools-services/live-pc-sandbox-switcher.md)
- [Recomendações para testes na sandbox RETAIL](https://docs.xbox.com/pt-BR/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-recommendations-for-testing-in-retail.md)
- [XSystemGetXboxLiveSandboxId](https://docs.xbox.com/pt-BR/reference/system/xsystem/functions/xsystemgetxboxlivesandboxid.md)
- [HCHttpDisableAssertsForSSLValidationInDevSandboxes](https://docs.xbox.com/pt-BR/reference/live/httpclient/httpclient/functions/hchttpdisableassertsforsslvalidationindevsandboxes.md)
- [XblDisableAssertsForXboxLiveThrottlingInDevSandboxes](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/xbox_live_global_c/functions/xbldisableassertsforxboxlivethrottlingindevsandboxes.md)
