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 de PlayFab; el equivalente de su
Set-PfTitle es xbox context set playfab-title-id <id>. Consulta Contexto.
Árbol de comandos
Cada comando se ejecuta enxbox playfab mps.
Cuerpo de la solicitud
La mayoría de los comandos de MPS envían el objeto de solicitud JSON de la operación, igual queplayfab api:
--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.
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.
Paginación
Estos comandos de lista devuelven una página de resultados por llamada:build list,build alias listserver list,server list-archivedasset list,certificate list,secret listcontainer-image list,container-image list-tagsvirtual-machine list
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:
SkipToken no es null, obtén la página siguiente pasando ese token:
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.
Los comandos que devuelven un solo registro lo muestran como una fila:
Las columnas censuradas imprimen
********, porque el valor es una credencial. La salida JSON devuelve
el valor real.
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:
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.
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:
--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:
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.
