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

# Configuración de servicios XBOX

> Administra la configuración de servicios XBOX, incluidos su estado, documentos, publicación, esquemas e imágenes de logros.

La familia de comandos `xbl` es experimental. Su interfaz de la CLI puede cambiar
o quitarse en función de los comentarios.

`xbox xbl` administra la configuración de servicios XBOX (el estado de la configuración de trabajo y
publicada, los documentos de configuración, la publicación y los esquemas de configuración), así como
las imágenes de logros. Para enumerar los sandboxes a los que se dirigen los comandos de configuración,
usa [`xbox sandbox list`](https://docs.xbox.com/es/tools/xbox-cli/commands/sandbox).

Estos comandos trabajan con la misma configuración que edita Partner Center. Para saber qué hace cada
característica de los servicios XBOX y cómo configurarla, consulta
[Información general sobre la configuración del portal](https://devdocs.xbox.com/services/xbox-services/fundamentals/portal-config/live-portal-config-overview)
en la documentación para desarrolladores de XBOX.

| Grupo | Comandos | Propósito |
| - | - | - |
| `config` | `list`, `status`, `download`, `save`, `publish` | Inspeccionar el estado de la configuración de trabajo y publicada, descargar y guardar documentos de configuración, y publicar la configuración en un sandbox. |
| `schema` | `list`, `get`, `download` | Enumerar los tipos y las versiones de los esquemas de configuración, obtener una versión o descargar XSD. |
| [`achievement-image`](https://docs.xbox.com/es/tools/xbox-cli/commands/xbl/achievement-image) | `upload`, `get`, `list`, `download` | Registrar, inspeccionar o descargar imágenes de logros. |

## Comportamiento compartido

### Vendedor y sandbox

Todos los comandos excepto los comandos `schema` aceptan `--seller-id`. Sin esta opción, un comando usa
`XBOX_SELLER_ID` o el vendedor guardado con [`xbox context set`](https://docs.xbox.com/es/tools/xbox-cli/commands/context) y, después, tu único
vendedor; si tienes varios, pasa `--seller-id`.

`config status` y `config publish` toman `--sandbox-id` de `XBOX_SANDBOX_ID` o del valor guardado
`sandbox-id` cuando lo omites. `config download` y `config save` necesitan `--sandbox-id` en
la línea de comandos para los documentos de sandbox.

### Selección del título

`config list`, `config status`, `config publish`, y `config download` y `config save` con ámbito de sandbox
aceptan el identificador de configuración de servicio (SCID) del título con `--scid`, o su
identificador de título de XBOX con `--title-id`, pero no ambos. Sin ninguno de los dos, usan `XBOX_TITLE_ID` o el
valor guardado `title-id`; consulta [Contexto](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md). `--scid` ignora ambos.

* `--title-id` es hexadecimal, tal como lo muestra [`game get`](https://docs.xbox.com/es/tools/xbox-cli/commands/game): de `00000001` a
  `7FFFFFFF`, con un prefijo `0x` opcional. Para otros identificadores de título, pasa el SCID.
* Las lecturas de un título vinculado a la configuración de otro título usan el SCID del título principal.
* `config save` y `config publish` con el identificador de un título vinculado se rechazan, incluso con
  `--validate-only` (`bound_title_requires_scid`). El error indica el título principal y su
  SCID; vuelve a ejecutar el comando con ese `--scid`.
* Guardar o publicar con `--title-id` en una configuración a la que están vinculados otros títulos
  la cambia para todos ellos. En un terminal, la CLI enumera los títulos vinculados y pregunta primero;
  sin un terminal, produce un error. `--allow-shared-configuration` omite la pregunta. Una escritura con
  `--scid` no pregunta.
* `config save` y `config publish` escriben en stderr el vendedor y el SCID que usaron. Los comandos de
  lectura lo hacen con `--verbose`.

Estos comandos guardan un identificador de título y, después, lo usan para leer, descargar y validar la
configuración de ese título en XDKS.1. El último indica el título con `--title-id` en su lugar:

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

### Salida

Todos los comandos `xbl` aceptan `--output table`, además de `json` (el predeterminado) y
`json-compact`. La tabla de opciones de cada comando enumera las columnas de su tabla.

### Errores

Una solicitud con errores sale con 1 y escribe en stderr un error JSON con `status`, `title`, `detail`
y `code` cuando el servicio envía uno. Bifurca según `status` o `code`, no según el texto de
`detail`. Un error 429 incluye `retryAfterSeconds`; consulta
[Límites de frecuencia](https://docs.xbox.com/es/tools/xbox-cli/cli-for-agents.md#rate-limits).

Cuando la validación de los servicios XBOX rechaza la configuración, el error enumera cada mensaje en
`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` y `config publish` sin `--validate-only` indican si un cambio con errores
podría haberse aplicado:

| Código de salida | Significado |
| - | - |
| 1 | No se cambió nada: la solicitud se detuvo o produjo un error antes de enviarse, o se rechazó con un `4xx` distinto de `408`. |
| 3 | El resultado es desconocido: Ctrl+C, un tiempo de espera agotado o una conexión perdida después de enviar la solicitud, cualquier otro estado de error o una respuesta correcta que la CLI no puede leer. |

Con la salida 3, no vuelvas a enviar. stderr imprime un comando de solo lectura con el que comprobarlo: para un guardado,
`config download --view draft`, para compararlo con los archivos que guardaste; para una publicación,
`config status`.

***

## config

Inspecciona, descarga, guarda y publica la configuración de servicios XBOX de un SCID. Un sandbox
contiene una configuración de trabajo, que `config save` cambia, y una configuración publicada,
que ven los jugadores y las cuentas de prueba una vez que `config publish` activa la configuración de trabajo.

| Comando | Descripción |
| - | - |
| `config list` | Enumera el estado de trabajo y publicado en todos los sandboxes accesibles. |
| `config status` | Obtiene el estado de trabajo y publicado de un sandbox, y su última publicación. |
| `config download` | Descarga y extrae un conjunto de documentos. |
| `config save` | Valida o guarda un conjunto de documentos de trabajo. |
| `config publish` | Valida o inicia la publicación de un conjunto de configuración. |

### `config list` y `config status`

Ambos comandos informan de las versiones de trabajo y publicadas más recientes, de la hora de confirmación de cada versión
y de si la versión de trabajo tiene cambios sin publicar. Una hora de confirmación publicada es
la hora de confirmación de la versión publicada, no el momento en que terminó la publicación.

`config list` devuelve una matriz con un objeto por sandbox. `config status` devuelve un objeto
para un sandbox y agrega su última publicación en `lastPublish`, o `null` cuando no hay ninguna de la que
informar. Para `--sandbox-id ALL`, `lastPublish` siempre es `null`, porque la configuración
de todo el título en `ALL` se activa mediante una publicación en `HIDDEN`.

| Campo de `lastPublish` | Descripción |
| - | - |
| `status` | `Running`, `Success` o `Failed`. `null` cuando el servicio no informa de ninguno. |
| `jobId` | El identificador del trabajo de publicación. |
| `message` | El mensaje del servicio sobre la publicación, o `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
  }
}
```

#### Opciones de `config list`

| Opción | Obligatoria | Descripción |
| - | - | - |
| `--scid <guid>` | O el título | SCID de la configuración del título. |
| `--title-id <hex-id>` | O el SCID | Identificador de título de XBOX. Consulta [Selección del título](#title-targeting). |
| `--seller-id <id>` | No | Identificador de vendedor de Partner Center. |
| `--output <format>` | No | `json` (predeterminado), `json-compact` o `table`. |

#### Opciones de `config status`

| Opción | Obligatoria | Descripción |
| - | - | - |
| `--scid <guid>` | O el título | SCID de la configuración del título. |
| `--title-id <hex-id>` | O el SCID | Identificador de título de XBOX. Consulta [Selección del título](#title-targeting). |
| `--sandbox-id <id>` | Sí | Identificador de sandbox, que distingue mayúsculas de minúsculas. El valor predeterminado es `XBOX_SANDBOX_ID` y, después, el identificador de sandbox guardado. |
| `--seller-id <id>` | No | Identificador de vendedor de Partner Center. |
| `--output <format>` | No | `json` (predeterminado), `json-compact` o `table`. |

Las tablas de ambos comandos tienen las columnas `SANDBOX`, `WORKING`, `WORKING COMMIT`,
`PUBLISHED`, `PUBLISHED COMMIT` y `UNPUBLISHED`. `config status` agrega `PUBLISH STATUS`,
el `status` de la última publicación.

#### Ejemplos de `config list` y `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` y `config save`

Descarga, valida y guarda conjuntos de documentos de configuración de servicios XBOX. Un conjunto de documentos
pertenece a un sandbox (el valor predeterminado, que necesita un SCID o un título y `--sandbox-id`) o a la
cuenta (`--type account`, que no acepta SCID, título ni sandbox).

`config download` guarda la ETag del conjunto de documentos junto a los documentos, como `<sandbox>.etag`, o
`Account.etag` para el ámbito de cuenta; en Windows el archivo está oculto. `config save` lee el archivo de ETag
que está junto al primer archivo con el que coincide `--file`, y lo reescribe después de guardar. Si la
configuración cambió desde que la descargaste, el guardado produce un error; pasa `--force` para guardar sobre
esos cambios, o `--etag` para proporcionar una ETag tú mismo.

`config save` no pregunta antes de guardar, y `--confirm` no se aplica a este comando. Ejecútalo primero con
`--validate-only`.

#### Opciones de `config download`

| Opción | Obligatoria | Descripción |
| - | - | - |
| `--view <draft\|published>` | Sí | `draft`, la configuración de trabajo que cambia `config save`, o `published`, la configuración activa que ven los jugadores y las cuentas de prueba. Partner Center usa los mismos dos nombres. |
| `--dest <directory>` | Sí | Directorio donde se guardan los documentos y el archivo de ETag. |
| `--type <sandbox\|account>` | No | Ámbito del documento. El valor predeterminado es `sandbox`. |
| `--scid <guid>` | O el título para `sandbox` | SCID de la configuración del título. |
| `--title-id <hex-id>` | O el SCID para `sandbox` | Identificador de título de XBOX. Consulta [Selección del título](#title-targeting). |
| `--sandbox-id <id>` | Para `sandbox` | Identificador de sandbox, que distingue mayúsculas de minúsculas. |
| `--version <number>` | No | Versión histórica positiva del conjunto de documentos. El valor predeterminado es la versión más reciente. |
| `--document <filename>` | No | Nombre de archivo del documento que se va a descargar. Repítela para agregar más. El valor predeterminado son todos los documentos. |
| `--seller-id <id>` | No | Identificador de vendedor de Partner Center. |
| `--output <format>` | No | `json` (predeterminado), `json-compact` o `table` con las columnas `TYPE`, `SANDBOX`, `VIEW`, `VERSION`, `FILES` y `DESTINATION`. |

#### Opciones de `config save`

| Opción | Obligatoria | Descripción |
| - | - | - |
| `--file <path-or-glob>` | Sí | Archivo local o patrón glob de nombre de archivo entre comillas. Repite `--file` para agregar más, con una ruta de acceso o un patrón en cada uno: `--file a.xml --file b.xml`. El nombre de cada archivo es su nombre de documento. Un valor que no coincide con ningún archivo hace que el comando produzca un error. |
| `--type <sandbox\|account>` | No | Ámbito del documento. El valor predeterminado es `sandbox`. |
| `--scid <guid>` | O el título para `sandbox` | SCID de la configuración del título. |
| `--title-id <hex-id>` | O el SCID para `sandbox` | Identificador de título de XBOX. Consulta [Selección del título](#title-targeting). |
| `--sandbox-id <id>` | Para `sandbox` | Identificador de sandbox, que distingue mayúsculas de minúsculas. |
| `--validate-only` | No | Valida sin guardar. |
| `--allow-shared-configuration` | No | Guarda con `--title-id` en una configuración a la que están vinculados otros títulos, sin preguntar. Consulta [Selección del título](#title-targeting). |
| `--etag <value>` | No | ETag con la que guardar. El valor predeterminado es el archivo de ETag guardado. |
| `--force` | No | Guarda sobre los cambios realizados desde la ETag guardada. |
| `--message <text>` | No | Mensaje de guardado. |
| `--seller-id <id>` | No | Identificador de vendedor de Partner Center. |
| `--output <format>` | No | `json` (predeterminado), `json-compact` o `table` con las columnas `TYPE`, `SANDBOX`, `VALIDATE ONLY`, `CAN COMMIT`, `COMMITTED`, `FILES` y `ETAG FILE`. |

Cuando los servicios XBOX no pueden guardar los documentos (`CanCommit` es false con `--validate-only`;
de lo contrario, `Committed` es false), el comando sigue escribiendo el resultado en stdout, escribe cada
mensaje de validación en stderr, deja sin cambios el archivo de ETag y sale con 1:

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

Los documentos que coinciden con los de trabajo más recientes no son un error: no se guarda nada,
`ValidationInfo` informa de `FilesNotChangedCommit` y el comando sale con 0.

#### Ejemplos de `config download` y `config save`

Descarga los documentos de sandbox en borrador más recientes en `xbox-config`:

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

Después de editar los documentos, valídalos todos o solo los dos que cambiaste:

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

Guárdalos con un mensaje:

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

Descarga un documento tal como estaba en la versión 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
```

Descarga los documentos en borrador de la cuenta:

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

### `config publish`

Publica una versión de trabajo de la configuración de servicios XBOX en la configuración publicada de un sandbox.
La publicación es asincrónica: iníciala con `config publish` y, después, ejecuta
[`config status`](#config-list-and-config-status) para el sandbox de destino hasta que
`lastPublish.status` sea `Success` o `Failed`.

#### Selección del origen

`--sandbox-id` es el destino. El origen es una versión de trabajo del sandbox de origen,
que de forma predeterminada es el destino:

| Escenario | Efecto |
| - | - |
| `--source-sandbox-id` omitido o igual a `--sandbox-id` | Publica la versión de trabajo más reciente del sandbox. |
| `--source-sandbox-id` distinto de `--sandbox-id` | Publica la versión de trabajo más reciente del sandbox de origen en el destino, y [reemplaza los archivos globales del almacenamiento de títulos del destino](#cross-sandbox-publishing-replaces-global-title-storage-files). |
| `--configset <number>` | Publica esa versión de trabajo del sandbox de origen. |

Cuando el sandbox de origen tiene cambios sin publicar, su versión de trabajo más reciente no es la que está
activa allí. Una publicación entre sandboxes sin `--configset` muestra entonces una advertencia e indica la versión
que está activa:

```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 exactamente lo que está activo en el origen, ejecuta primero con `--validate-only` y agrega el
`--configset` que sugiere. En la salida JSON, `SourceVersion` es la versión de trabajo usada,
`sourceHasUnpublishedChanges` indica si difiere de lo que está activo en el origen, y
`sourceLiveVersion` es la versión que está activa allí, cuando se encuentra una.

Una publicación de todo el título, `--sandbox-id HIDDEN`, siempre publica la configuración de trabajo más reciente
de `ALL`, por lo que no acepta `--source-sandbox-id` ni `--configset`. Para ver qué versión se
activa, ejecuta primero `config status --sandbox-id ALL` y lee `workingVersion`.

#### Confirmación

`config publish` pregunta antes de publicar en estos casos:

| Publicación | Por qué pregunta |
| - | - |
| `--sandbox-id RETAIL` | Los jugadores ven el cambio cuando finaliza la publicación. |
| `--sandbox-id CERT` o `CERT.DEBUG` | La certificación de XBOX realiza pruebas en estos sandboxes. |
| `--sandbox-id HIDDEN` | Publica la configuración de todo el título, que usan todos los sandboxes, incluido RETAIL. |
| `--source-sandbox-id` distinto de `--sandbox-id` | Primero reemplaza los documentos de trabajo del destino que tienen los mismos nombres, y sus [archivos globales del almacenamiento de títulos](#cross-sandbox-publishing-replaces-global-title-storage-files). |

En un terminal, describe la publicación y pregunta. Sin un terminal, se niega y sale con 1.
`--confirm` (`--yes`, `-y`) omite la pregunta, y `--validate-only` nunca pregunta. Consulta
[Seguridad y operaciones destructivas](https://docs.xbox.com/es/tools/xbox-cli/safety.md).

Antes de preguntar sobre una publicación en RETAIL, valida la publicación y enumera los
[logros que agrega](#achievements-a-retail-publish-adds). Si respondes que sí, publica
la versión de trabajo que validó, de modo que lo que se activa es lo que se enumeró:

```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]:
```

Cuando esa validación produce un error, no publica nada ni pregunta. Por eso, en un terminal, una publicación en
RETAIL con `--title-id` en una configuración a la que están vinculados otros títulos necesita
`--allow-shared-configuration`. Con `--confirm` no hay lista, así que ejecuta primero `--validate-only`
para verla.

#### Logros que agrega una publicación en RETAIL

Una vez que los logros están activos en RETAIL, no se pueden quitar, y sus reglas de desbloqueo y su
gamerscore no pueden cambiar. Por eso, una publicación en RETAIL indica qué identificadores de logro agrega que RETAIL
todavía no tiene:

* Con `--validate-only`, la lista va a stderr, y la salida JSON la incluye en
  `achievementChanges.added`.
* En un terminal sin `--validate-only`, la lista aparece antes de la pregunta, como se muestra
  en [Confirmación](#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.
```

Una publicación que no agrega ninguno lo indica. Los demás sandboxes no enumeran logros.

#### Republicación

`config publish` publica solo los cambios. Cuando nada ha cambiado desde la última
publicación correcta del destino, no se inicia ninguna publicación, y el `Status` del resultado es `AlreadyPublished`. Después de
que una publicación produzca un error, volver a ejecutar `config publish` la reintenta.

A veces XBOX bloquea RETAIL para un producto, y una publicación de RETAIL a RETAIL produce entonces un error con
`retail_locked`. Para publicar de todos modos, agrega `--republish`: fuerza la
configuración seleccionada, de forma predeterminada la configuración de trabajo más reciente de RETAIL, en RETAIL. Publicar en
RETAIL desde otro sandbox, como CERT, también elimina el bloqueo, pero reemplaza los
documentos de trabajo de RETAIL por los de ese sandbox.

`--republish` publica de forma completa, incluso cuando nada ha cambiado. No se puede combinar con
`--validate-only`.

#### Diagnóstico

Los diagnósticos de validación de los servicios XBOX, como la advertencia de una primera publicación en RETAIL
sin un embargo configurado, van a stderr, uno por línea. La salida JSON los conserva en
`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.
```

Cuando la validación produce un error, `config publish` sale con 1 y enumera cada mensaje en `validation`, como
se muestra en [Errores](#errors).

#### La publicación entre sandboxes reemplaza los archivos globales del almacenamiento de títulos

> [!CAUTION]
>
> Publicar de un sandbox a otro convierte los archivos globales del almacenamiento de títulos del destino
> en una copia exacta de los del origen. Los archivos que solo tiene el destino se eliminan y no se pueden
> recuperar.

Los archivos globales son los archivos que lee cada jugador del juego, como las fuentes de noticias y los mapas:

| Archivo | Origen | Destino antes | Destino después |
| - | - | - | - |
| `news.json` | Presente | Presente | Sobrescrito con la copia del origen |
| `tuning.cfg` | Presente | — | Agregado |
| `maps.bin` | — | Presente | **Eliminado** |

La copia toma lo que contenga el origen cuando se ejecuta la publicación. Los datos propios de los jugadores no se
modifican, y una publicación dentro del mismo sandbox no afecta a los archivos globales. Para conservar un archivo del destino,
agrégalo al sandbox de origen antes de publicar.

Cada publicación entre sandboxes escribe esta advertencia en stderr, incluso con `--validate-only`,
y la incluye en la pregunta de [confirmación](#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.
```

#### Opciones de `config publish`

| Opción | Alias | Obligatoria | Descripción |
| - | - | - | - |
| `--scid <guid>` | — | O el título | SCID de la configuración del título. |
| `--title-id <hex-id>` | — | O el SCID | Identificador de título de XBOX. Consulta [Selección del título](#title-targeting). |
| `--sandbox-id <id>` | — | Sí | Identificador del sandbox de destino. El valor predeterminado es `XBOX_SANDBOX_ID` y, después, el identificador de sandbox guardado. |
| `--source-sandbox-id <id>` | — | No | Identificador del sandbox de origen. El valor predeterminado es `--sandbox-id`. No se permite con `--sandbox-id HIDDEN`. |
| `--validate-only` | — | No | Valida sin publicar. Para RETAIL, también enumera los [logros que agrega la publicación](#achievements-a-retail-publish-adds). |
| `--allow-shared-configuration` | — | No | Publica con `--title-id` en una configuración a la que están vinculados otros títulos, sin preguntar. Consulta [Selección del título](#title-targeting). |
| `--configset <number>` | — | No | Versión de trabajo positiva del sandbox de origen. El valor predeterminado es la más reciente. No se permite con `--sandbox-id HIDDEN`. |
| `--republish` | — | No | Publica de forma completa aunque nada haya cambiado, o en un RETAIL bloqueado tras una migración. Consulta [Republicación](#republishing). |
| `--confirm` | `--yes`, `-y` | No | Publica sin preguntar. Consulta [Confirmación](#confirmation). |
| `--seller-id <id>` | — | No | Identificador de vendedor de Partner Center. |
| `--output <format>` | `-o` | No | `json` (predeterminado), `json-compact` o `table` con las columnas `STATUS`, `SOURCE`, `DESTINATION`, `VALIDATE ONLY` y `SOURCE VERSION`. |

#### Ejemplos de `config publish`

Valida una publicación en SANDBOX1 sin publicar:

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

Publica la configuración de trabajo más reciente de SANDBOX1 para que esté activa en SANDBOX1:

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

Publica la versión de trabajo más reciente de SANDBOX1 en SANDBOX2. Esto también reemplaza los archivos globales
del almacenamiento de títulos de SANDBOX2 por los de SANDBOX1:

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

Publica la versión de trabajo 42 de SANDBOX1 en SANDBOX2:

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

Valida una publicación de CERT a RETAIL, que enumera los logros que agrega:

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

A continuación, pasa el `SourceVersion` de la salida como `--configset` para publicar la versión que validaste,
sin una solicitud de confirmación:

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

Vuelve a publicar SANDBOX1 aunque nada haya cambiado:

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

Comprueba la publicación en SANDBOX2:

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

***

## schema

Descubre y descarga esquemas de documentos de configuración de servicios XBOX.

| Comando | Descripción |
| - | - |
| `schema list` | Enumera todos los tipos de esquema. |
| `schema list --type <type>` | Enumera las versiones de un tipo de esquema. |
| `schema get --type <type>` | Obtiene una versión de un tipo de esquema: su tipo, versión y espacio de nombres. El valor predeterminado es la versión más reciente. |
| `schema download --dest <directory>` | Guarda XSD en un directorio: una versión, todas las versiones de un tipo o todas las versiones de todos los tipos. |
| `schema download --type <type> --version <n> --dest -` | Escribe un XSD en stdout. |

### Opciones de `schema list`

| Opción | Obligatoria | Descripción |
| - | - | - |
| `--type <type>` | No | Tipo de esquema cuyas versiones se van a enumerar. Omítela para enumerar todos los tipos. |
| `--output <format>` | No | `json` (predeterminado), `json-compact` o `table` con las columnas `TYPE`, `VERSION`, `NAMESPACE`, `PATH` y `BYTES`. |

### Opciones de `schema get`

| Opción | Obligatoria | Descripción |
| - | - | - |
| `--type <type>` | Sí | Tipo de esquema. |
| `--version <number>` | No | Versión positiva del esquema. El valor predeterminado es la versión más reciente del tipo. |
| `--output <format>` | No | `json` (predeterminado), `json-compact` o `table` con las columnas `TYPE`, `VERSION` y `NAMESPACE`. |

`schema get` escribe un objeto JSON:

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

### Opciones de `schema download`

| Opción | Obligatoria | Descripción |
| - | - | - |
| `--dest <directory>` | Sí | Directorio para los archivos XSD guardados, o `-` para escribir un XSD en stdout. `-` requiere `--type` y `--version`. |
| `--type <type>` | No | Tipo de esquema. Omítela para descargar todos los tipos. |
| `--version <number>` | No | Versión positiva del esquema. Requiere `--type`. Omítela para descargar todas las versiones. |
| `--output <format>` | No | `json` (predeterminado), `json-compact` o `table` con las columnas `TYPE`, `VERSION`, `NAMESPACE`, `PATH` y `BYTES`. |

Cada esquema se guarda como `<type>_<version>.xsd`, con el tipo en minúsculas, y el comando
imprime las rutas de acceso guardadas. Con `--dest -`, escribe en su lugar el XSD sin procesar en stdout, y
`--output` no se aplica.

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

***

## Un ciclo completo típico de configuración

1. Busca los sandboxes a los que puedes acceder:

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

2. Comprueba en qué estado están las configuraciones de trabajo y publicada:

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

3. Descarga el conjunto de documentos en borrador, lo que también guarda `SANDBOX1.etag`:

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

4. Edita los documentos de `xbox-config` y, después, valídalos:

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

5. Guárdalos:

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

6. Publícalos en SANDBOX1:

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

7. Comprueba la publicación y repite hasta que su estado sea `Success` o `Failed`:

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


## Related topics

- [Configuración de los servicios de XBOX](https://docs.xbox.com/es/publishing/game-publishing/concepts/xbox-services.md)
- [Configuración de servicios personalizados](https://docs.xbox.com/es/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/live-custom-services-config-nav.md)
- [Autenticación de los servicios de XBOX para servicios de título](https://docs.xbox.com/es/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/live-title-service-authentication.md)
- [Página de resumen de la configuración de los servicios XBOX](https://docs.xbox.com/es/services/xbox-services/fundamentals/portal-config/live-portal-summary-tab.md)
- [Configuración de sandboxes](https://docs.xbox.com/es/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes.md)
