playfab mps é Experimental. Sua interface de CLI pode mudar
ou ser removida com base em comentários.
playfab mps gerencia os PlayFab Multiplayer Servers (MPS): builds e seus aliases e
regiões, servidores, ativos, certificados, segredos, imagens de contêiner, cotas e máquinas
virtuais (VMs). Ele abrange as mesmas operações que o módulo
MpsPowershell do PlayFab; o equivalente ao seu
Set-PfTitle é xbox context set playfab-title-id <id>. Consulte Contexto.
Árvore de comandos
Cada comando é executado emxbox playfab mps.
Corpo da solicitação
A maioria dos comandos MPS envia o objeto de solicitação JSON da operação, comoplayfab api:
--body e --body-file não podem ser combinadas. certificate upload e secret upload aceitam
somente --body-file, e asset upload não aceita nenhuma delas; consulte as seções correspondentes.
Comandos destrutivos
Estes comandos pedem confirmação primeiro em um terminal e exigem--confirm (--yes, -y) em outros contextos:
build delete, build alias delete, build region delete, server shutdown,
asset delete, certificate delete, secret delete,
container-image repository delete e remote-user delete. Com --body-file -, eles
exigem --confirm mesmo em um terminal. Outros comandos MPS que alteram algo são executados sem
pedir confirmação. Consulte Segurança e operações destrutivas.
Paginação
Estes comandos de listagem retornam uma página de resultados por chamada:build list,build alias listserver list,server list-archivedasset list,certificate list,secret listcontainer-image list,container-image list-tagsvirtual-machine list
SkipToken da resposta é definido. Para obter a próxima página, adicione
"SkipToken" com esse valor ao corpo da solicitação, mantenha os outros campos e repita até que
SkipToken volte como null. Defina "PageSize" no corpo da solicitação para alterar quantos
resultados uma página contém.
Obtenha a primeira página de builds:
SkipToken dela não for null, obtenha a próxima página passando esse token:
SkipToken; portanto, quando há mais resultados, a tabela é
seguida por um aviso em stderr com o token a ser enviado.
Saída em tabela
Os comandos destas tabelas aceitam--output table; os outros comandos MPS não. Consulte
Saída em tabela.
Os comandos que retornam um único registro o mostram como uma linha:
As colunas ocultadas imprimem
********, porque o valor é uma credencial. A saída JSON retorna
o valor real.
mps build create
build create exige --type, que seleciona a API do PlayFab que ele chama, e aceita o
corpo da solicitação como os outros comandos MPS:
mps certificate upload e mps secret upload
certificate upload e secret upload aceitam o corpo da solicitação somente com
--body-file <path>, ou --body-file - para stdin, porque ele contém uma senha de PFX ou um
valor secreto. Eles recusam --body, que deixaria o valor no histórico do shell e nas
listagens de processos. Nenhum deles aceita --output table.
ForceUpdate substitui um certificado ou segredo que já tenha o nome. Mantenha o arquivo de
corpo fora do controle do código-fonte e exclua-o depois que ele for carregado.
certificate.json contém o PFX codificado em Base64 e sua senha:
--body-file -.
Aqui, jq lê o valor de api-key.txt em vez de seus próprios argumentos, de modo que o
valor fica fora das listagens de processos:
mps asset upload
asset upload carrega um arquivo local como um ativo de servidor multijogador. Ele aceita opções em vez
de um corpo de solicitação e grava o nome do ativo e o status do carregamento como JSON.
