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

# Configuração dos serviços do XBOX

> Gerencie a configuração dos serviços do XBOX, incluindo seu estado, documentos, publicação, esquemas e imagens de conquistas.

A família de comandos `xbl` é Experimental. Sua interface de CLI pode mudar
ou ser removida com base em comentários.

`xbox xbl` gerencia a configuração dos serviços do XBOX — o estado da configuração de trabalho e da configuração
publicada, os documentos de configuração, a publicação e os esquemas de configuração —, bem como as
imagens de conquistas. Para listar as sandboxes às quais os comandos de configuração se destinam,
use [`xbox sandbox list`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/sandbox).

Estes comandos trabalham com a mesma configuração que o Partner Center edita. Para saber o que cada
recurso dos serviços do XBOX faz e como configurá-lo, consulte
[Visão geral da configuração do portal](https://devdocs.xbox.com/services/xbox-services/fundamentals/portal-config/live-portal-config-overview)
na documentação para desenvolvedores do XBOX.

| Grupo | Comandos | Finalidade |
| - | - | - |
| `config` | `list`, `status`, `download`, `save`, `publish` | Inspecionar o estado da configuração de trabalho e da publicada, baixar e salvar documentos de configuração e publicar a configuração em uma sandbox. |
| `schema` | `list`, `get`, `download` | Listar tipos e versões de esquemas de configuração, obter uma versão ou baixar XSDs. |
| [`achievement-image`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/xbl/achievement-image) | `upload`, `get`, `list`, `download` | Registrar, inspecionar ou baixar imagens de conquistas. |

## Comportamento compartilhado

### Vendedor e sandbox

Todos os comandos, exceto os comandos `schema`, aceitam `--seller-id`. Sem essa opção, o comando usa
`XBOX_SELLER_ID` ou o vendedor salvo com [`xbox context set`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/context) e, em seguida, seu único
vendedor; se você tiver vários, passe `--seller-id`.

`config status` e `config publish` obtêm `--sandbox-id` de `XBOX_SANDBOX_ID` ou da `sandbox-id`
salva quando você a omite. `config download` e `config save` precisam de `--sandbox-id` na
linha de comando para documentos de sandbox.

### Direcionamento de título

`config list`, `config status`, `config publish` e `config download` e
`config save` com escopo de sandbox aceitam o identificador de configuração de serviço (SCID) do título com `--scid`, ou sua
ID de título do XBOX com `--title-id`, mas não ambos. Sem nenhum dos dois, eles usam `XBOX_TITLE_ID` ou a
`title-id` salva; consulte [Contexto](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/context.md). `--scid` ignora ambos.

* `--title-id` é hexadecimal, como [`game get`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/game) a mostra: de `00000001` a
  `7FFFFFFF`, com um prefixo `0x` opcional. Para outras IDs de título, passe o SCID.
* As leituras de um título vinculado à configuração de outro título usam o SCID do título principal.
* `config save` e `config publish` pela ID de um título vinculado são recusados, mesmo com
  `--validate-only` (`bound_title_requires_scid`). O erro indica o título principal e o
  SCID; execute novamente com esse `--scid`.
* Salvar ou publicar por `--title-id` em uma configuração à qual outros títulos estão vinculados
  a altera para todos eles. Em um terminal, a CLI lista os títulos vinculados e pede confirmação primeiro;
  sem um terminal, ela falha. `--allow-shared-configuration` ignora a pergunta. Uma gravação por
  `--scid` não pede confirmação.
* `config save` e `config publish` gravam em stderr o vendedor e o SCID que usaram. Os comandos de
  leitura fazem isso com `--verbose`.

Estes comandos salvam uma ID de título e, em seguida, a usam para ler, baixar e validar a
configuração desse título em XDKS.1. O último indica o título com `--title-id`:

```powershell theme={null}
xbox context set title-id 1234ABCD
xbox xbl config list --output table
xbox xbl config status --sandbox-id XDKS.1
xbox xbl config download --sandbox-id XDKS.1 --view draft --dest .\xbox-config
xbox xbl config save --sandbox-id XDKS.1 --file ".\xbox-config\*.xml" --validate-only
xbox xbl config status --title-id 1234ABCD --sandbox-id XDKS.1
```

### Saída

Todos os comandos `xbl` aceitam `--output table`, além de `json` (o padrão) e
`json-compact`. A tabela de opções de cada comando lista as colunas da tabela dele.

### Erros

Uma solicitação com falha sai com o código 1 e grava em stderr um erro JSON com `status`, `title`, `detail`
e `code` quando o serviço envia um. Ramifique com base em `status` ou `code`, e não no texto de
`detail`. Um erro 429 inclui `retryAfterSeconds`; consulte
[Limites de taxa](https://docs.xbox.com/pt-BR/tools/xbox-cli/cli-for-agents.md#rate-limits).

Quando a validação dos serviços do XBOX rejeita a configuração, o erro lista cada mensagem em
`validation`:

```json theme={null}
{
  "status": 409,
  "title": "Validation failed.",
  "detail": "The configuration failed XBOX services validation. See validation for each message. MS-CV: ...",
  "code": "validation_failed",
  "validation": [
    {
      "severity": "Error",
      "documentName": "achievements2017.xml",
      "message": "XblLimited products do not support achievements or stats2013/stats2015 configuration. Please remove the unsupported configuration. Document failing validation: achievements2017.xml."
    }
  ]
}
```

`config save` e `config publish` sem `--validate-only` informam se uma alteração com falha
pode ter sido aplicada:

| Código de saída | Significado |
| - | - |
| 1 | Nada foi alterado: a solicitação foi interrompida ou falhou antes de ser enviada, ou foi rejeitada com um `4xx` diferente de `408`. |
| 3 | O resultado é desconhecido: Ctrl+C, um tempo limite ou uma conexão perdida depois que a solicitação foi enviada, qualquer outro status de erro ou uma resposta de sucesso que a CLI não consegue ler. |

Na saída 3, não envie novamente. stderr imprime um comando somente leitura para verificar: para um salvamento,
`config download --view draft`, para comparar com os arquivos que você salvou; para uma publicação,
`config status`.

***

## config

Inspecione, baixe, salve e publique a configuração dos serviços do XBOX para um SCID. Uma sandbox
contém uma configuração de trabalho, que `config save` altera, e uma configuração publicada,
que os jogadores e as contas de teste veem depois que `config publish` torna a configuração de trabalho
ativa.

| Comando | Descrição |
| - | - |
| `config list` | Lista o estado da configuração de trabalho e da publicada em todas as sandboxes acessíveis. |
| `config status` | Obtém o estado da configuração de trabalho e da publicada de uma sandbox e sua última publicação. |
| `config download` | Baixa e extrai um conjunto de documentos. |
| `config save` | Valida ou salva um conjunto de documentos de trabalho. |
| `config publish` | Valida ou inicia a publicação de um conjunto de configurações. |

### `config list` e `config status`

Ambos os comandos relatam as versões de trabalho e publicada mais recentes, a hora de confirmação de cada
versão e se a versão de trabalho tem alterações não publicadas. A hora de confirmação publicada é
a hora de confirmação da versão publicada, e não o momento em que a publicação terminou.

`config list` retorna uma matriz com um objeto por sandbox. `config status` retorna um objeto
para uma sandbox e adiciona sua última publicação em `lastPublish`, ou `null` quando não há nenhuma a
relatar. Para `--sandbox-id ALL`, `lastPublish` é sempre `null`, porque a configuração
de todo o título em `ALL` se torna ativa por meio de uma publicação em `HIDDEN`.

| Campo de `lastPublish` | Descrição |
| - | - |
| `status` | `Running`, `Success` ou `Failed`. `null` quando o serviço não relata um status. |
| `jobId` | A ID do trabalho de publicação. |
| `message` | A mensagem do serviço sobre a publicação, ou `null`. |

```json theme={null}
{
  "sandbox": "SANDBOX1",
  "hasWorkingConfiguration": true,
  "workingVersion": 9,
  "workingCommitTime": "2026-10-29T21:40:12+00:00",
  "hasPublishedConfiguration": true,
  "publishedVersion": 9,
  "publishedCommitTime": "2026-10-29T21:40:12+00:00",
  "hasUnpublishedChanges": false,
  "lastPublish": {
    "status": "Success",
    "jobId": "11111111-2222-3333-4444-555555555555",
    "message": null
  }
}
```

#### Opções de `config list`

| Opção | Obrigatória | Descrição |
| - | - | - |
| `--scid <guid>` | Ou título | SCID da configuração do título. |
| `--title-id <hex-id>` | Ou SCID | ID de título do XBOX. Consulte [Direcionamento de título](#title-targeting). |
| `--seller-id <id>` | Não | ID do vendedor no Partner Center. |
| `--output <format>` | Não | `json` (padrão), `json-compact` ou `table`. |

#### Opções de `config status`

| Opção | Obrigatória | Descrição |
| - | - | - |
| `--scid <guid>` | Ou título | SCID da configuração do título. |
| `--title-id <hex-id>` | Ou SCID | ID de título do XBOX. Consulte [Direcionamento de título](#title-targeting). |
| `--sandbox-id <id>` | Sim | ID da sandbox, com diferenciação entre maiúsculas e minúsculas. O padrão é `XBOX_SANDBOX_ID` e, em seguida, a ID da sandbox salva. |
| `--seller-id <id>` | Não | ID do vendedor no Partner Center. |
| `--output <format>` | Não | `json` (padrão), `json-compact` ou `table`. |

As tabelas de ambos os comandos têm as colunas `SANDBOX`, `WORKING`, `WORKING COMMIT`,
`PUBLISHED`, `PUBLISHED COMMIT` e `UNPUBLISHED`. `config status` adiciona `PUBLISH STATUS`,
o `status` da última publicação.

#### Exemplos de `config list` e `config status`

```bash theme={null}
# Every accessible sandbox for one title
xbox xbl config list \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --output table

# One sandbox, single JSON object
xbox xbl config status \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1

# Compact output for scripting
xbox xbl config status \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 --output json-compact
```

### `config download` e `config save`

Baixe, valide e salve conjuntos de documentos de configuração dos serviços do XBOX. Um conjunto de documentos
pertence a uma sandbox (o padrão, que exige um SCID ou título e `--sandbox-id`) ou à
conta (`--type account`, que não aceita SCID, título nem sandbox).

`config download` salva a ETag do conjunto de documentos ao lado dos documentos, como `<sandbox>.etag`, ou
`Account.etag` para o escopo de conta; no Windows, o arquivo fica oculto. `config save` lê o arquivo de ETag
ao lado do primeiro arquivo correspondente a `--file` e o regrava após um salvamento. Se a
configuração tiver mudado desde que você a baixou, o salvamento falhará; passe `--force` para salvar por cima
dessas alterações ou `--etag` para fornecer uma ETag você mesmo.

`config save` não pede confirmação antes de salvar, e `--confirm` não se aplica a ele. Execute-o primeiro com
`--validate-only`.

#### Opções de `config download`

| Opção | Obrigatória | Descrição |
| - | - | - |
| `--view <draft\|published>` | Sim | `draft`, a configuração de trabalho que `config save` altera, ou `published`, a configuração ativa que os jogadores e as contas de teste veem. O Partner Center usa os mesmos dois nomes. |
| `--dest <directory>` | Sim | Diretório em que os documentos e o arquivo de ETag são salvos. |
| `--type <sandbox\|account>` | Não | Escopo do documento. O padrão é `sandbox`. |
| `--scid <guid>` | Ou título para `sandbox` | SCID da configuração do título. |
| `--title-id <hex-id>` | Ou SCID para `sandbox` | ID de título do XBOX. Consulte [Direcionamento de título](#title-targeting). |
| `--sandbox-id <id>` | Para `sandbox` | ID da sandbox, com diferenciação entre maiúsculas e minúsculas. |
| `--version <number>` | Não | Versão histórica positiva do conjunto de documentos. O padrão é a versão mais recente. |
| `--document <filename>` | Não | Nome do arquivo do documento a ser baixado. Repita para adicionar mais. O padrão são todos os documentos. |
| `--seller-id <id>` | Não | ID do vendedor no Partner Center. |
| `--output <format>` | Não | `json` (padrão), `json-compact` ou `table` com as colunas `TYPE`, `SANDBOX`, `VIEW`, `VERSION`, `FILES` e `DESTINATION`. |

#### Opções de `config save`

| Opção | Obrigatória | Descrição |
| - | - | - |
| `--file <path-or-glob>` | Sim | Arquivo local ou padrão glob de nome de arquivo entre aspas. Repita `--file` para adicionar mais, um caminho ou padrão em cada: `--file a.xml --file b.xml`. O nome de cada arquivo é o nome do documento. Um valor que não corresponde a nenhum arquivo faz o comando falhar. |
| `--type <sandbox\|account>` | Não | Escopo do documento. O padrão é `sandbox`. |
| `--scid <guid>` | Ou título para `sandbox` | SCID da configuração do título. |
| `--title-id <hex-id>` | Ou SCID para `sandbox` | ID de título do XBOX. Consulte [Direcionamento de título](#title-targeting). |
| `--sandbox-id <id>` | Para `sandbox` | ID da sandbox, com diferenciação entre maiúsculas e minúsculas. |
| `--validate-only` | Não | Valida sem salvar. |
| `--allow-shared-configuration` | Não | Salva por `--title-id` em uma configuração à qual outros títulos estão vinculados, sem pedir confirmação. Consulte [Direcionamento de título](#title-targeting). |
| `--etag <value>` | Não | ETag com base na qual salvar. O padrão é o arquivo de ETag salvo. |
| `--force` | Não | Salva por cima das alterações feitas desde a ETag salva. |
| `--message <text>` | Não | Mensagem de salvamento. |
| `--seller-id <id>` | Não | ID do vendedor no Partner Center. |
| `--output <format>` | Não | `json` (padrão), `json-compact` ou `table` com as colunas `TYPE`, `SANDBOX`, `VALIDATE ONLY`, `CAN COMMIT`, `COMMITTED`, `FILES` e `ETAG FILE`. |

Quando os serviços do XBOX não conseguem salvar os documentos (`CanCommit` falso com `--validate-only`;
caso contrário, `Committed` falso), o comando ainda grava o resultado em stdout, grava cada
mensagem de validação em stderr, mantém o arquivo de ETag inalterado e sai com o código 1:

```text theme={null}
XBOX services can't save these documents:
Error: achievements2017.xml: The root namespace doesn't match the document type. (NamespaceDocTypeMismatch)
```

Documentos iguais aos de trabalho mais recentes não são uma falha: nada é salvo,
`ValidationInfo` relata `FilesNotChangedCommit` e o comando sai com 0.

#### Exemplos de `config download` e `config save`

Baixe os documentos de rascunho mais recentes da sandbox em `xbox-config`:

```bash theme={null}
xbox xbl config download \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 --view draft --dest xbox-config
```

Depois de editar os documentos, valide todos eles ou somente os dois que você alterou:

```bash theme={null}
xbox xbl config save \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 \
  --file "xbox-config/*.xml" --validate-only

xbox xbl config save \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 \
  --file xbox-config/achievements2017.xml --file xbox-config/localization.xml --validate-only
```

Salve-os com uma mensagem:

```bash theme={null}
xbox xbl config save \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 \
  --file "xbox-config/*.xml" --message "Update achievements"
```

Baixe um documento como ele estava na versão publicada 7:

```bash theme={null}
xbox xbl config download \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 \
  --view published --version 7 --document achievements.xml --dest xbox-config
```

Baixe os documentos de rascunho da conta:

```bash theme={null}
xbox xbl config download --type account --view draft --dest xbox-config --output table
```

### `config publish`

Publique uma versão de trabalho da configuração dos serviços do XBOX na configuração publicada
de uma sandbox. A publicação é assíncrona: inicie-a com `config publish` e, em seguida, execute
[`config status`](#config-list-and-config-status) para a sandbox de destino até que
`lastPublish.status` seja `Success` ou `Failed`.

#### Seleção da origem

`--sandbox-id` é o destino. A origem é uma versão de trabalho da sandbox de origem,
que, por padrão, é o destino:

| Cenário | Efeito |
| - | - |
| `--source-sandbox-id` omitida ou igual a `--sandbox-id` | Publica a versão de trabalho mais recente da sandbox. |
| `--source-sandbox-id` diferente de `--sandbox-id` | Publica a versão de trabalho mais recente da sandbox de origem no destino e [substitui os arquivos globais do Title Storage do destino](#cross-sandbox-publishing-replaces-global-title-storage-files). |
| `--configset <number>` | Publica essa versão de trabalho da sandbox de origem. |

Quando a sandbox de origem tem alterações não publicadas, sua versão de trabalho mais recente não é o que está
ativo nela. Uma publicação entre sandboxes sem `--configset` então emite um aviso e indica a versão
que está ativa:

```text theme={null}
Warning: XDKS.1 has unpublished changes. This publish uses its latest working version, 53; what's live in XDKS.1 is working version 52. To publish that instead, add --configset 52.
```

Para promover exatamente o que está ativo na origem, execute primeiro com `--validate-only` e adicione o
`--configset` sugerido. Na saída JSON, `SourceVersion` é a versão de trabalho usada,
`sourceHasUnpublishedChanges` informa se ela difere do que está ativo na origem, e
`sourceLiveVersion` é a versão que está ativa lá, quando uma é encontrada.

Uma publicação de todo o título, `--sandbox-id HIDDEN`, sempre publica a configuração de trabalho mais recente
em `ALL`; por isso, ela não aceita `--source-sandbox-id` nem `--configset`. Para ver qual versão se torna
ativa, execute primeiro `config status --sandbox-id ALL` e leia `workingVersion`.

#### Confirmação

`config publish` pede confirmação antes de publicar nestes casos:

| Publicação | Por que pede confirmação |
| - | - |
| `--sandbox-id RETAIL` | Os jogadores veem a alteração quando a publicação termina. |
| `--sandbox-id CERT` ou `CERT.DEBUG` | Os testes de certificação do XBOX ocorrem nessas sandboxes. |
| `--sandbox-id HIDDEN` | Publica a configuração de todo o título, que todas as sandboxes usam, incluindo RETAIL. |
| `--source-sandbox-id` diferente de `--sandbox-id` | Primeiro substitui os documentos de trabalho do destino que têm os mesmos nomes e seus [arquivos globais do Title Storage](#cross-sandbox-publishing-replaces-global-title-storage-files). |

Em um terminal, ele descreve a publicação e pede confirmação. Sem um terminal, ele se recusa e sai com o código 1.
`--confirm` (`--yes`, `-y`) ignora a pergunta, e `--validate-only` nunca pede confirmação. Consulte
[Segurança e operações destrutivas](https://docs.xbox.com/pt-BR/tools/xbox-cli/safety.md).

Antes de pedir confirmação para uma publicação em RETAIL, ele valida a publicação e lista as
[conquistas que ela adiciona](#achievements-a-retail-publish-adds). Se você responder sim, ele publicará
a versão de trabalho que validou; portanto, o que se torna ativo é o que foi listado:

```console theme={null}
$ xbox xbl config publish --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --source-sandbox-id CERT --sandbox-id RETAIL
This publish adds 2 achievements to RETAIL: 1, 2. Once they're live in RETAIL, achievements can't be removed, and their unlock rules and gamerscore can't change.
This publishes working version 52 of CERT's configuration to RETAIL for SCID aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee.
RETAIL is live: players see the change when the publish finishes.
Publishing from CERT first replaces RETAIL's working documents that have the same names.
Warning: publishing from CERT to RETAIL replaces RETAIL's global title storage files with CERT's. Files with the same path are overwritten, files only CERT holds are added, and files only RETAIL holds are deleted. Deleted files can't be recovered.

Publish to RETAIL? [y/N]:
```

Quando essa validação falha, ele não publica nada e não pede confirmação. Portanto, em um terminal, uma publicação em RETAIL
por `--title-id` em uma configuração à qual outros títulos estão vinculados exige
`--allow-shared-configuration`. Com `--confirm`, não há lista; por isso, execute `--validate-only`
primeiro para vê-la.

#### Conquistas que uma publicação em RETAIL adiciona

Depois que as conquistas estão ativas em RETAIL, elas não podem ser removidas, e suas regras de desbloqueio e
gamerscore não podem mudar. Por isso, uma publicação em RETAIL informa quais IDs de conquista ela adiciona que RETAIL
ainda não tem:

* Com `--validate-only`, a lista vai para stderr, e a saída JSON a inclui em
  `achievementChanges.added`.
* Em um terminal sem `--validate-only`, a lista aparece antes da pergunta, conforme mostrado
  em [Confirmação](#confirmation).

```console theme={null}
$ xbox xbl config publish --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --source-sandbox-id CERT --sandbox-id RETAIL --validate-only
This publish would add 2 achievements to RETAIL: 1, 2. Once they're live in RETAIL, achievements can't be removed, and their unlock rules and gamerscore can't change.
```

Uma publicação que não adiciona nenhuma conquista informa isso. As outras sandboxes não listam conquistas.

#### Republicação

`config publish` publica somente alterações. Quando nada mudou desde a última
publicação bem-sucedida do destino, nenhuma publicação é iniciada, e o `Status` do resultado é `AlreadyPublished`. Depois que
uma publicação falha, executar `config publish` novamente faz uma nova tentativa.

Às vezes, o XBOX bloqueia RETAIL para um produto, e uma publicação de RETAIL para RETAIL falha com
`retail_locked`. Para publicar mesmo assim, adicione `--republish`: essa opção força a configuração
selecionada, por padrão a configuração de trabalho mais recente de RETAIL, em RETAIL. Publicar em
RETAIL a partir de outra sandbox, como CERT, também remove o bloqueio, mas substitui os
documentos de trabalho de RETAIL pelos dessa sandbox.

`--republish` publica tudo, mesmo quando nada mudou. Não pode ser combinada com
`--validate-only`.

#### Diagnóstico

Os diagnósticos de validação dos serviços do XBOX, como o aviso para uma primeira publicação em RETAIL
sem embargo, vão para stderr, um por linha. A saída JSON os mantém em
`ValidationResult`.

```text theme={null}
XBOX services warning (FirstRetailPublishWithoutEffectiveEmbargo): This is the first time these Xbox Gameplay Settings will be published to RETAIL, and no embargo is configured.
```

Quando a validação falha, `config publish` sai com o código 1 e lista cada mensagem em `validation`, conforme
mostrado em [Erros](#errors).

#### A publicação entre sandboxes substitui os arquivos globais do Title Storage

> [!CAUTION]
>
> Publicar de uma sandbox para outra torna os arquivos globais do Title Storage do destino
> uma cópia exata dos da origem. Os arquivos que existem somente no destino são excluídos e não podem ser
> recuperados.

Os arquivos globais são os arquivos que todos os jogadores do jogo leem, como feeds de notícias e mapas:

| Arquivo | Origem | Destino antes | Destino depois |
| - | - | - | - |
| `news.json` | Presente | Presente | Substituído pela cópia da origem |
| `tuning.cfg` | Presente | — | Adicionado |
| `maps.bin` | — | Presente | **Excluído** |

A cópia usa o que a origem contém no momento em que a publicação é executada. Os dados dos próprios jogadores não são
afetados, e uma publicação na mesma sandbox não altera os arquivos globais. Para manter um arquivo do destino,
adicione-o à sandbox de origem antes de publicar.

Toda publicação entre sandboxes grava este aviso em stderr, inclusive com `--validate-only`,
e o inclui na pergunta de [confirmação](#confirmation):

```text theme={null}
Warning: publishing from SANDBOX1 to SANDBOX2 replaces SANDBOX2's global title storage files with SANDBOX1's. Files with the same path are overwritten, files only SANDBOX1 holds are added, and files only SANDBOX2 holds are deleted. Deleted files can't be recovered.
```

#### Opções de `config publish`

| Opção | Alias | Obrigatória | Descrição |
| - | - | - | - |
| `--scid <guid>` | — | Ou título | SCID da configuração do título. |
| `--title-id <hex-id>` | — | Ou SCID | ID de título do XBOX. Consulte [Direcionamento de título](#title-targeting). |
| `--sandbox-id <id>` | — | Sim | ID da sandbox de destino. O padrão é `XBOX_SANDBOX_ID` e, em seguida, a ID da sandbox salva. |
| `--source-sandbox-id <id>` | — | Não | ID da sandbox de origem. O padrão é `--sandbox-id`. Não é permitida com `--sandbox-id HIDDEN`. |
| `--validate-only` | — | Não | Valida sem publicar. Para RETAIL, também lista as [conquistas que a publicação adiciona](#achievements-a-retail-publish-adds). |
| `--allow-shared-configuration` | — | Não | Publica por `--title-id` em uma configuração à qual outros títulos estão vinculados, sem pedir confirmação. Consulte [Direcionamento de título](#title-targeting). |
| `--configset <number>` | — | Não | Versão de trabalho positiva da sandbox de origem. O padrão é a mais recente. Não é permitida com `--sandbox-id HIDDEN`. |
| `--republish` | — | Não | Publica tudo mesmo quando nada mudou, ou em uma RETAIL bloqueada após uma migração. Consulte [Republicação](#republishing). |
| `--confirm` | `--yes`, `-y` | Não | Publica sem pedir confirmação. Consulte [Confirmação](#confirmation). |
| `--seller-id <id>` | — | Não | ID do vendedor no Partner Center. |
| `--output <format>` | `-o` | Não | `json` (padrão), `json-compact` ou `table` com as colunas `STATUS`, `SOURCE`, `DESTINATION`, `VALIDATE ONLY` e `SOURCE VERSION`. |

#### Exemplos de `config publish`

Valide uma publicação em SANDBOX1 sem publicar:

```bash theme={null}
xbox xbl config publish \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 --validate-only
```

Publique a configuração de trabalho mais recente de SANDBOX1 para que ela fique ativa em SANDBOX1:

```bash theme={null}
xbox xbl config publish \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1
```

Publique a versão de trabalho mais recente de SANDBOX1 em SANDBOX2. Isso também substitui os arquivos globais do
Title Storage de SANDBOX2 pelos de SANDBOX1:

```bash theme={null}
xbox xbl config publish \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --source-sandbox-id SANDBOX1 --sandbox-id SANDBOX2
```

Publique a versão de trabalho 42 de SANDBOX1 em SANDBOX2:

```bash theme={null}
xbox xbl config publish \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee \
  --source-sandbox-id SANDBOX1 --sandbox-id SANDBOX2 --configset 42
```

Valide uma publicação de CERT para RETAIL, o que lista as conquistas que ela adiciona:

```bash theme={null}
xbox xbl config publish \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --source-sandbox-id CERT --sandbox-id RETAIL --validate-only
```

Em seguida, passe o `SourceVersion` da saída como `--configset` para publicar a versão que você validou,
sem prompt:

```bash theme={null}
xbox xbl config publish \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --source-sandbox-id CERT --sandbox-id RETAIL --configset 52 --confirm
```

Publique SANDBOX1 novamente, embora nada tenha mudado:

```bash theme={null}
xbox xbl config publish \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 --republish
```

Verifique a publicação em SANDBOX2:

```bash theme={null}
xbox xbl config status \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX2 --output table
```

***

## schema

Descubra e baixe os esquemas de documentos de configuração dos serviços do XBOX.

| Comando | Descrição |
| - | - |
| `schema list` | Lista todos os tipos de esquema. |
| `schema list --type <type>` | Lista as versões de um tipo de esquema. |
| `schema get --type <type>` | Obtém uma versão de um tipo de esquema: seu tipo, sua versão e seu namespace. O padrão é a versão mais recente. |
| `schema download --dest <directory>` | Salva XSDs em um diretório: uma versão, todas as versões de um tipo ou todas as versões de todos os tipos. |
| `schema download --type <type> --version <n> --dest -` | Grava um XSD em stdout. |

### Opções de `schema list`

| Opção | Obrigatória | Descrição |
| - | - | - |
| `--type <type>` | Não | Tipo de esquema cujas versões serão listadas. Omita-a para listar todos os tipos. |
| `--output <format>` | Não | `json` (padrão), `json-compact` ou `table` com as colunas `TYPE`, `VERSION`, `NAMESPACE`, `PATH` e `BYTES`. |

### Opções de `schema get`

| Opção | Obrigatória | Descrição |
| - | - | - |
| `--type <type>` | Sim | Tipo de esquema. |
| `--version <number>` | Não | Versão positiva do esquema. O padrão é a versão mais recente do tipo. |
| `--output <format>` | Não | `json` (padrão), `json-compact` ou `table` com as colunas `TYPE`, `VERSION` e `NAMESPACE`. |

`schema get` grava um objeto JSON:

```json theme={null}
{
  "type": "achievements2017",
  "version": 1,
  "namespace": "http://config.mgt.xboxlive.com/schema/achievements2017/1"
}
```

### Opções de `schema download`

| Opção | Obrigatória | Descrição |
| - | - | - |
| `--dest <directory>` | Sim | Diretório para os arquivos XSD salvos, ou `-` para gravar um XSD em stdout. `-` exige `--type` e `--version`. |
| `--type <type>` | Não | Tipo de esquema. Omita-a para baixar todos os tipos. |
| `--version <number>` | Não | Versão positiva do esquema. Exige `--type`. Omita-a para baixar todas as versões. |
| `--output <format>` | Não | `json` (padrão), `json-compact` ou `table` com as colunas `TYPE`, `VERSION`, `NAMESPACE`, `PATH` e `BYTES`. |

Cada esquema é salvo como `<type>_<version>.xsd`, com o tipo em minúsculas, e o comando
imprime os caminhos salvos. Com `--dest -`, ele grava o XSD bruto em stdout, e
`--output` não se aplica.

### Exemplos de `schema`

```bash theme={null}
# List every schema type
xbox xbl schema list

# List versions of one type, as a table
xbox xbl schema list --type achievements2017 --output table

# Get the latest version of one type
xbox xbl schema get --type achievements2017

# Redirect one XSD straight to a file
xbox xbl schema download --type achievements2017 --version 1 --dest - > achievements2017_1.xsd

# Save one XSD into a directory
xbox xbl schema download --type achievements2017 --version 1 --dest schemas

# Download every version of one schema type
xbox xbl schema download --type achievements2017 --dest schemas

# Download every version of every schema type
xbox xbl schema download --dest schemas
```

***

## Um ciclo típico de configuração

1. Encontre as sandboxes que você pode acessar:

   ```bash theme={null}
   xbox sandbox list --output table
   ```

2. Veja a situação da configuração de trabalho e da publicada:

   ```bash theme={null}
   xbox xbl config list \
     --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --output table
   ```

3. Baixe o conjunto de documentos de rascunho, o que também salva `SANDBOX1.etag`:

   ```bash theme={null}
   xbox xbl config download \
     --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 --view draft --dest xbox-config
   ```

4. Edite os documentos em `xbox-config` e, em seguida, valide-os:

   ```bash theme={null}
   xbox xbl config save \
     --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 \
     --file "xbox-config/*.xml" --validate-only
   ```

5. Salve-os:

   ```bash theme={null}
   xbox xbl config save \
     --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 \
     --file "xbox-config/*.xml" --message "Update configuration"
   ```

6. Publique-os em SANDBOX1:

   ```bash theme={null}
   xbox xbl config publish \
     --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1
   ```

7. Verifique a publicação e repita até que o status seja `Success` ou `Failed`:

   ```bash theme={null}
   xbox xbl config status \
     --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --sandbox-id SANDBOX1 --output table
   ```


## Related topics

- [Configuração do portal](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/portal-config/index.md)
- [Página de resumo da configuração dos serviços do XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/portal-config/live-portal-summary-tab.md)
- [IDs de configuração dos serviços do XBOX para Managed Partners](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/portal-config/live-service-config-ids-mp.md)
- [Visão geral das áreas restritas dos serviços do XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [Visão geral da configuração do portal](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/portal-config/live-portal-config-overview.md)
