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

# Segurança e operações destrutivas

> Quais comandos da XBOX CLI apenas leem, quais perguntam antes de alterar algo, quais fazem algo que o nome não indica e o que fazer quando o resultado de uma alteração é desconhecido.

A XBOX CLI atua com as suas permissões, muitas vezes em títulos e vendedores de produção. Esta página aborda
quais comandos apenas leem, quais perguntam antes de alterar algo, os poucos que fazem algo
que o nome não indica e o que fazer quando o resultado de uma alteração é desconhecido. Para saber o que um agente de IA
precisa perguntar antes de uma alteração, consulte [Usar a XBOX CLI a partir de agentes](https://docs.xbox.com/pt-BR/tools/xbox-cli/cli-for-agents.md).

Um comando obtém o título, o vendedor ou a sandbox de um sinalizador, de uma variável de ambiente `XBOX_` ou de um
valor salvo com `xbox context set`. Um comando que altera algo nomeia em stderr cada
valor que você não passou na linha de comando; portanto, verifique-o antes de uma alteração de produção. Consulte
[Contexto](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/context.md).

## O que é somente leitura

Uma operação do PlayFab é somente leitura apenas se o nome dela começar com `Get`, `List` ou `Search`, como
`/Admin/GetTitleData` ou `/MultiplayerServer/ListBuildSummariesV2`. Todas as outras operações
alteram algo. Isso é mais importante para `xbox playfab api <api-path>`, em que você digita o
caminho da operação, não o nome de um comando.

A Ajuda de um comando tem uma seção `SAFETY` que informa se ele lê ou altera algo.

## O que pergunta primeiro

A maioria dos comandos que alteram algo é executada sem perguntar. Estes perguntam primeiro em um terminal e,
sem um terminal, recusam a execução, a menos que você passe `--confirm` (`--yes`, `-y`):

| Comando | Quando precisa de confirmação |
| - | - |
| Qualquer operação `Delete*` ou `Shutdown*` do PlayFab, por meio de qualquer comando, incluindo `playfab api` | Sempre |
| `playfab economy inventory operation execute` | Quando o lote contém uma operação `Delete`. Ele recusa a execução sem `--confirm`, mesmo em um terminal. |
| `playfab api-policy set --overwrite` | Sempre. Ele recusa a execução sem `--confirm`, mesmo em um terminal. |
| [`audience create`, `audience update`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/audience) | Sempre |
| [`game create`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/game) | Sempre |
| [`playtest create`, `update`, `publish`, `delete`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playtest) | Sempre |
| [`sandbox create`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/sandbox) | Sempre |
| [`test-account batch create`, `update`, `delete`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/test-account) | Sempre |
| [`xbl config publish`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/xbl#config-publish) | Para RETAIL, CERT, CERT.DEBUG ou HIDDEN, ou a partir de outra sandbox. Nunca com `--validate-only`. |
| [`xbl config save`, `xbl config publish`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/xbl#title-targeting) por `--title-id` | Quando outros títulos compartilham a configuração. `--allow-shared-configuration` ignora a pergunta; `--confirm` não. |
| [`pc sandbox set`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/pc) | Sempre |

## O que o nome de um comando não indica

* Se [`playfab service-principal set`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playfab/service-principal) falhar, a entidade
  de serviço pode ficar sem acesso no estúdio até que um `set` seja bem-sucedido, o que pode interromper um
  pipeline que entra como ela. Passe `--expected-version` para que `set` falhe em vez de substituir
  a alteração de outra pessoa.
* [`playfab privacy export`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playfab/privacy) envia por email os dados do jogador, de todos os
  títulos do editor que ele jogou, para o endereço de email de notificação do título. A exportação
  e o email dela não podem ser cancelados.
* [`xbl config publish`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/xbl#cross-sandbox-publishing-replaces-global-title-storage-files)
  a partir de outra sandbox substitui os arquivos globais do Title Storage do destino pelos da
  origem e exclui os arquivos que somente o destino tem. Os arquivos excluídos não podem ser recuperados.
* `xbl config publish --sandbox-id HIDDEN` publica a configuração de todo o título, que todas as
  sandboxes usam, inclusive RETAIL.

## Uma gravação interrompida informa que seu resultado é desconhecido

Se uma alteração for interrompida depois que a CLI a enviar, por exemplo, por Ctrl+C, por um tempo limite ou por perda de
conexão, ou se o serviço responder com um erro HTTP 5xx, a alteração pode ter sido aplicada.
O comando informa que o resultado é desconhecido, como neste erro do 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 saída quando o resultado é desconhecido |
| - | - |
| `audience create` e `update`, `playtest create`, `update`, `publish` e `delete`, `sandbox create`, `test-account batch create`, `update` e `delete`, e `xbl config save` e `publish` | `3` |
| Outros comandos, incluindo todos os comandos `playfab` | `1`, exceto `game create`, que sai com `130` quando você pressiona Ctrl+C depois que ele envia a solicitação. Quando o PlayFab respondeu com um JSON de erro, o JSON em stderr também tem um campo `outcomeUnknown`. |

Leia o estado afetado antes de executar a alteração novamente. Os comandos fora de `playfab` imprimem um
comando somente leitura para fazer a verificação. A CLI nunca tenta repetir uma alteração por conta própria.

Alguns comandos que aguardam um trabalho saem com `4` quando a solicitação foi aceita, mas a espera
terminou. Não os execute novamente; consulte a página do comando para saber como continuar aguardando.


## Related topics

- [Comandos](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands.md)
- [Integração com a API do PlayFab](https://docs.xbox.com/pt-BR/tools/xbox-cli/playfab-api.md)
- [Usar a XBOX CLI a partir de agentes](https://docs.xbox.com/pt-BR/tools/xbox-cli/cli-for-agents.md)
- [Imagens de conquistas](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/xbl/achievement-image.md)
- [PlayFab](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playfab.md)
