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

# Multiplayer Servers

> Administra PlayFab Multiplayer Servers, incluidas las compilaciones, los servidores, los recursos, las imágenes de contenedor y las cuotas.

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

`playfab mps` administra PlayFab Multiplayer Servers (MPS): las compilaciones y sus alias y
regiones, los servidores, los recursos, los certificados, los secretos, las imágenes de contenedor, las cuotas y las máquinas
virtuales (VM). Abarca las mismas operaciones que el módulo
[MpsPowershell](https://github.com/PlayFab/MpsPowershell) de PlayFab; el equivalente de su
`Set-PfTitle` es `xbox context set playfab-title-id <id>`. Consulta [Contexto](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md).

```bash theme={null}
xbox --playfab-title-id ABC123 --output json-compact --data-only playfab mps build list
```

## Árbol de comandos

Cada comando se ejecuta en `xbox playfab mps`.

| Comando | Ruta de la API de PlayFab | Descripción |
| - | - | - |
| `title enable` | `/MultiplayerServer/EnableMultiplayerServersForTitle` | Habilita MPS para el título. |
| `title status` | `/MultiplayerServer/GetTitleEnabledForMultiplayerServersStatus` | Comprueba si MPS está habilitado para el título. |
| `build get` | `/MultiplayerServer/GetBuild` | Obtiene una compilación. |
| `build list` | `/MultiplayerServer/ListBuildSummariesV2` | Enumera una página de compilaciones. |
| `build create` | Depende de `--type` | Crea una compilación. Consulta [`mps build create`](#mps-build-create). |
| `build update-name` | `/MultiplayerServer/UpdateBuildName` | Cambia el nombre de una compilación. |
| `build delete` | `/MultiplayerServer/DeleteBuild` | Elimina una compilación. |
| `build alias get` | `/MultiplayerServer/GetBuildAlias` | Obtiene un alias de compilación. |
| `build alias list` | `/MultiplayerServer/ListBuildAliases` | Enumera una página de alias de compilación. |
| `build alias create` | `/MultiplayerServer/CreateBuildAlias` | Crea un alias de compilación. |
| `build alias update` | `/MultiplayerServer/UpdateBuildAlias` | Actualiza un alias de compilación. |
| `build alias delete` | `/MultiplayerServer/DeleteBuildAlias` | Elimina un alias de compilación. |
| `build region update` | `/MultiplayerServer/UpdateBuildRegion` | Actualiza una de las regiones de una compilación. |
| `build region update-all` | `/MultiplayerServer/UpdateBuildRegions` | Actualiza todas las regiones de una compilación. |
| `build region delete` | `/MultiplayerServer/DeleteBuildRegion` | Quita una región de una compilación. |
| `server get` | `/MultiplayerServer/GetMultiplayerServerDetails` | Obtiene los detalles de una sesión de servidor. |
| `server list` | `/MultiplayerServer/ListMultiplayerServers` | Enumera una página de las sesiones de servidor de una compilación en una región. |
| `server list-archived` | `/MultiplayerServer/ListArchivedMultiplayerServers` | Enumera una página de las sesiones de servidor archivadas de una compilación. |
| `server request` | `/MultiplayerServer/RequestMultiplayerServer` | Solicita una sesión de servidor. |
| `server shutdown` | `/MultiplayerServer/ShutdownMultiplayerServer` | Apaga una sesión de servidor. |
| `server get-logs` | `/MultiplayerServer/GetMultiplayerServerLogs` | Obtiene los registros de un servidor finalizado. |
| `server get-session-logs` | `/MultiplayerServer/GetMultiplayerSessionLogsBySessionId` | Obtiene los registros de un servidor finalizado por identificador de sesión. |
| `asset list` | `/MultiplayerServer/ListAssetSummaries` | Enumera una página de recursos. |
| `asset upload` | `/MultiplayerServer/GetAssetUploadUrl` | Carga un archivo local como recurso. Consulta [`mps asset upload`](#mps-asset-upload). |
| `asset delete` | `/MultiplayerServer/DeleteAsset` | Elimina un recurso. |
| `asset get-upload-url` | `/MultiplayerServer/GetAssetUploadUrl` | Obtiene una URL a la que cargar un recurso. |
| `asset get-download-url` | `/MultiplayerServer/GetAssetDownloadUrl` | Obtiene una URL desde la que descargar un recurso. |
| `certificate list` | `/MultiplayerServer/ListCertificateSummaries` | Enumera una página de certificados. |
| `certificate upload` | `/MultiplayerServer/UploadCertificate` | Carga un certificado. Consulta [`mps certificate upload`](#mps-certificate-upload-and-mps-secret-upload). |
| `certificate delete` | `/MultiplayerServer/DeleteCertificate` | Elimina un certificado. |
| `secret list` | `/MultiplayerServer/ListSecretSummaries` | Enumera una página de secretos. |
| `secret upload` | `/MultiplayerServer/UploadSecret` | Carga un secreto. Consulta [`mps secret upload`](#mps-certificate-upload-and-mps-secret-upload). |
| `secret delete` | `/MultiplayerServer/DeleteSecret` | Elimina un secreto. |
| `container-image list` | `/MultiplayerServer/ListContainerImages` | Enumera una página de imágenes de contenedor personalizadas. |
| `container-image list-tags` | `/MultiplayerServer/ListContainerImageTags` | Enumera una página de las etiquetas de una imagen de contenedor. |
| `container-image untag` | `/MultiplayerServer/UntagContainerImage` | Quita una etiqueta de una imagen de contenedor. |
| `container-image repository delete` | `/MultiplayerServer/DeleteContainerImageRepository` | Elimina un repositorio de imágenes de contenedor. |
| `container-registry credentials get` | `/MultiplayerServer/GetContainerRegistryCredentials` | Obtiene las credenciales del registro de contenedor. |
| `container-registry credentials rollover` | `/MultiplayerServer/RolloverContainerRegistryCredentials` | Reemplaza las credenciales del registro de contenedor. |
| `quota get` | `/MultiplayerServer/GetTitleMultiplayerServersQuotas` | Obtiene las cuotas de MPS del título. |
| `quota change get` | `/MultiplayerServer/GetTitleMultiplayerServersQuotaChange` | Obtiene una solicitud de cambio de cuota. |
| `quota change list` | `/MultiplayerServer/ListTitleMultiplayerServersQuotaChanges` | Enumera todas las solicitudes de cambio de cuota. |
| `quota change create` | `/MultiplayerServer/CreateTitleMultiplayerServersQuotaChange` | Solicita un cambio de cuota. |
| `qos-server list` | `/MultiplayerServer/ListQosServersForTitle` | Enumera los servidores QoS del título. |
| `party-qos-server list` | `/MultiplayerServer/ListPartyQosServers` | Enumera los servidores QoS de PlayFab Party. |
| `virtual-machine list` | `/MultiplayerServer/ListVirtualMachineSummaries` | Enumera una página de VM. |
| `remote-user create` | `/MultiplayerServer/CreateRemoteUser` | Crea un usuario remoto para iniciar sesión en la VM de una compilación. |
| `remote-user delete` | `/MultiplayerServer/DeleteRemoteUser` | Elimina un usuario remoto. |
| `remote-login get-endpoint` | `/MultiplayerServer/GetRemoteLoginEndpoint` | Obtiene el punto de conexión de inicio de sesión remoto de una VM que hospeda una compilación. |
| `party request` | `/Party/RequestPartyService` | Solicita una sesión de PlayFab Party. |

## Cuerpo de la solicitud

La mayoría de los comandos de MPS envían el objeto de solicitud JSON de la operación, igual que
[`playfab api`](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab/api):

| Opción | Descripción |
| - | - |
| `--body` | El cuerpo de la solicitud JSON, insertado. El valor predeterminado es `{}` cuando no se pasa ninguna de las dos opciones de cuerpo. |
| `--body-file` | Ruta de acceso a un archivo que contiene el cuerpo de la solicitud JSON, o `-` para leerlo desde stdin. |

`--body` y `--body-file` no se pueden combinar. `certificate upload` y `secret upload` aceptan
solo `--body-file`, y `asset upload` no acepta ninguna de las dos; consulta sus secciones.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab mps build get --body '{ "BuildId": "11111111-2222-3333-4444-555555555555" }'
xbox --playfab-title-id ABC123 --data-only playfab mps server list --body '{ "BuildId": "11111111-2222-3333-4444-555555555555", "Region": "EastUs" }'
```

## Comandos destructivos

Estos comandos preguntan primero en un terminal y, en otros entornos, necesitan `--confirm` (`--yes`, `-y`):
`build delete`, `build alias delete`, `build region delete`, `server shutdown`,
`asset delete`, `certificate delete`, `secret delete`,
`container-image repository delete` y `remote-user delete`. Con `--body-file -`,
necesitan `--confirm` incluso en un terminal. Los demás comandos de MPS que cambian algo se ejecutan sin
preguntar. Consulta [Seguridad y operaciones destructivas](https://docs.xbox.com/es/tools/xbox-cli/safety.md).

```bash theme={null}
xbox --playfab-title-id ABC123 playfab mps build delete --body '{ "BuildId": "11111111-2222-3333-4444-555555555555" }' --confirm
```

## Paginación

Estos comandos de lista devuelven una página de resultados por llamada:

* `build list`, `build alias list`
* `server list`, `server list-archived`
* `asset list`, `certificate list`, `secret list`
* `container-image list`, `container-image list-tags`
* `virtual-machine list`

Cuando hay más resultados, se establece el `SkipToken` de la respuesta. Para obtener la página siguiente, agrega
`"SkipToken"` con ese valor al cuerpo de la solicitud, conserva sus demás campos y repite hasta que
`SkipToken` vuelva como `null`. Establece `"PageSize"` en el cuerpo de la solicitud para cambiar cuántos
resultados contiene una página.

Obtén la primera página de compilaciones:

```bash theme={null}
xbox --playfab-title-id ABC123 --data-only playfab mps build list --body '{ "PageSize": 50 }'
```

Si su `SkipToken` no es `null`, obtén la página siguiente pasando ese token:

```bash theme={null}
xbox --playfab-title-id ABC123 --data-only playfab mps build list --body '{ "PageSize": 50, "SkipToken": "<SkipToken from the previous page>" }'
```

La salida de tabla no tiene ninguna columna para `SkipToken`, por lo que, cuando hay más resultados, la tabla va
seguida de un aviso en stderr con el token que se debe enviar.

## Salida de tabla

Los comandos de estas tablas aceptan `--output table`; los demás comandos de MPS no. Consulta
[Salida de tabla](https://docs.xbox.com/es/tools/xbox-cli/commands.md#table-output).

| Comando | Columnas |
| - | - |
| `build list` | `BUILD ID`, `NAME`, `CREATED` |
| `build alias list` | `ALIAS ID`, `NAME` |
| `server list` | `SERVER ID`, `REGION`, `STATE`, `SESSION ID` |
| `server list-archived` | `SERVER ID`, `REGION`, `STATE`, `LAST TRANSITION` |
| `asset list` | `FILE NAME` |
| `certificate list` | `NAME`, `THUMBPRINT` |
| `secret list` | `NAME`, `VERSION`, `EXPIRES` |
| `container-image list` | `IMAGE` |
| `container-image list-tags` | `TAG` |
| `quota change list` | `REQUEST ID`, `DESCRIPTION`, `PENDING`, `APPROVED` |
| `qos-server list` | `REGION`, `SERVER URL` |
| `party-qos-server list` | `REGION`, `SERVER URL` |
| `virtual-machine list` | `VM ID`, `STATE`, `HEALTH` |

Los comandos que devuelven un solo registro lo muestran como una fila:

| Comando | Columnas |
| - | - |
| `title status` | `STATUS` |
| `build get` | `BUILD ID`, `NAME`, `STATUS`, `OS`, `VM SIZE` |
| `build alias get` | `ALIAS ID`, `NAME` |
| `server get` | `SERVER ID`, `STATE`, `REGION`, `SESSION ID`, `IPV4 ADDRESS` |
| `asset get-upload-url` | `FILE NAME`, `UPLOAD URL` (censurado) |
| `asset get-download-url` | `FILE NAME`, `DOWNLOAD URL` (censurado) |
| `container-registry credentials get` | `DNS NAME`, `USERNAME`, `PASSWORD` (censurado) |
| `quota change get` | `REQUEST ID`, `DESCRIPTION`, `PENDING`, `APPROVED` |
| `remote-login get-endpoint` | `IPV4 ADDRESS`, `PORT` |

Las columnas censuradas imprimen `********`, porque el valor es una credencial. La salida JSON devuelve
el valor real.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab mps build list --output table
```

```text theme={null}
BUILD ID                              NAME            CREATED
------------------------------------  --------------  ------------------------
11111111-2222-3333-4444-555555555555  combat-sandbox  2026-04-26T22:15:16.7Z
22222222-3333-4444-5555-666666666666  lobby-service   2026-06-23T22:00:37.702Z
```

## `mps build create`

`build create` requiere `--type`, que selecciona la API de PlayFab a la que llama, y acepta el
cuerpo de la solicitud igual que los demás comandos de MPS:

| Valor de `--type` | Ruta de la API de PlayFab |
| - | - |
| `managed` | `/MultiplayerServer/CreateBuildWithManagedContainer` |
| `custom` | `/MultiplayerServer/CreateBuildWithCustomContainer` |
| `process` | `/MultiplayerServer/CreateBuildWithProcessBasedServer` |

```bash theme={null}
xbox --playfab-title-id ABC123 playfab mps build create --type managed --body-file managed-build.json
```

## `mps certificate upload` y `mps secret upload`

`certificate upload` y `secret upload` aceptan el cuerpo de la solicitud solo con
`--body-file <path>`, o `--body-file -` para stdin, porque contiene una contraseña de PFX o un
valor secreto. Rechazan `--body`, que dejaría el valor en el historial del shell y en las
listas de procesos. Ninguno de los dos acepta `--output table`.

| Comando | Campos de la solicitud |
| - | - |
| `certificate upload` | `GameCertificate` (`Name`, `Base64EncodedValue` y `Password` si el PFX tiene una), `ForceUpdate`, `CustomTags` |
| `secret upload` | `GameSecret` (`Name`, `Value`, `ExpirationDate`), `ForceUpdate`, `CustomTags` |

`ForceUpdate` reemplaza un certificado o secreto que ya tiene ese nombre. Mantén el archivo
de cuerpo fuera del control de código fuente y elimínalo una vez cargado.

`certificate.json` contiene el PFX codificado en Base64 y su contraseña:

```json theme={null}
{
  "GameCertificate": {
    "Name": "nod-arena-tls",
    "Base64EncodedValue": "<Base64-encoded PFX>",
    "Password": "<PFX password>"
  }
}
```

```bash theme={null}
xbox --playfab-title-id ABC123 playfab mps certificate upload --body-file certificate.json
```

Para crear el cuerpo sin escribir el secreto en otro archivo, canalízalo a `--body-file -`.
Aquí, `jq` lee el valor de `api-key.txt` en lugar de sus propios argumentos, por lo que el
valor no aparece en las listas de procesos:

```bash theme={null}
jq -n --rawfile value api-key.txt \
  '{GameSecret: {Name: "nod-arena-api-key", Value: ($value | rtrimstr("\n"))}}' \
  | xbox --playfab-title-id ABC123 playfab mps secret upload --body-file -
```

## `mps asset upload`

`asset upload` carga un archivo local como recurso de servidor multijugador. Acepta opciones en lugar
de un cuerpo de solicitud, y escribe el nombre del recurso y el estado de la carga como JSON.

| Opción | Obligatoria | Descripción |
| - | - | - |
| `--file` | Sí | Ruta de acceso al archivo local que se va a cargar. |
| `--asset-name` | Sí | Nombre del recurso que se va a crear en PlayFab. |
| `--buffer-size` | No | Tamaño de bloque de carga en bytes. El valor predeterminado es `4194304` (4 MiB). |

```bash theme={null}
xbox --playfab-title-id ABC123 playfab mps asset upload --file gameserver.zip --asset-name gameserver.zip
```


## Related topics

- [List Multiplayer Servers](https://docs.xbox.com/api-reference/multiplayerserver/list-multiplayer-servers.md)
- [Request Multiplayer Server](https://docs.xbox.com/api-reference/multiplayerserver/request-multiplayer-server.md)
- [Shutdown Multiplayer Server](https://docs.xbox.com/api-reference/multiplayerserver/shutdown-multiplayer-server.md)
- [PFMultiplayerServerRequestMultiplayerServerResponse](https://docs.xbox.com/es/services/playfab/api-references/c/pfmultiplayerservertypes/structs/pfmultiplayerserverrequestmultiplayerserverresponse.md)
- [PFMultiplayerServerRequestMultiplayerServerAsync](https://docs.xbox.com/es/services/playfab/api-references/c/pfmultiplayerserver/functions/pfmultiplayerserverrequestmultiplayerserverasync.md)
