playfab mps est expérimentale. Son interface CLI pourrait changer
ou être retirée en fonction des commentaires.
playfab mps gère PlayFab Multiplayer Servers (MPS) : les builds ainsi que leurs alias et
régions, les serveurs, les ressources, les certificats, les secrets, les images de conteneur, les quotas et les machines
virtuelles (VM). Elle couvre les mêmes opérations que le module
MpsPowershell de PlayFab; l’équivalent de sa commande
Set-PfTitle est xbox context set playfab-title-id <id>. Consultez Contexte.
Arborescence des commandes
Chaque commande s’exécute sousxbox playfab mps.
Corps de la requête
La plupart des commandes MPS envoient l’objet de requête JSON de l’opération, commeplayfab api :
--body et --body-file ne peuvent pas être combinées. certificate upload et secret upload acceptent
seulement --body-file, et asset upload n’accepte ni l’une ni l’autre; consultez leurs sections.
Commandes destructives
Ces commandes demandent d’abord une confirmation dans un terminal, et nécessitent--confirm (--yes, -y) ailleurs :
build delete, build alias delete, build region delete, server shutdown,
asset delete, certificate delete, secret delete,
container-image repository delete et remote-user delete. Avec --body-file -, elles
nécessitent --confirm même dans un terminal. Les autres commandes MPS qui modifient des éléments s’exécutent sans
demander de confirmation. Consultez Sécurité et opérations destructives.
Pagination
Ces commandes de liste retournent une page de résultats par appel :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 réponse est défini. Pour obtenir la page suivante, ajoutez
"SkipToken" avec cette valeur au corps de la requête, conservez ses autres champs, et répétez jusqu’à ce que
SkipToken revienne avec la valeur null. Définissez "PageSize" dans le corps de la requête pour modifier le nombre de
résultats que contient une page.
Obtenir la première page de builds :
SkipToken n’est pas null, obtenez la page suivante en transmettant ce jeton :
SkipToken; lorsqu’il existe d’autres résultats, le tableau est donc
suivi d’un avis dans stderr indiquant le jeton à envoyer.
Sortie sous forme de tableau
Les commandes de ces tableaux acceptent--output table; les autres commandes MPS ne l’acceptent pas. Consultez
Sortie sous forme de tableau.
Les commandes qui retournent un seul enregistrement l’affichent sur une seule ligne :
Les colonnes masquées affichent
********, car la valeur est une information d’identification. La sortie JSON retourne
la valeur réelle.
mps build create
build create exige --type, qui sélectionne l’API PlayFab qu’elle appelle, et accepte le
corps de la requête comme les autres commandes MPS :
mps certificate upload et mps secret upload
certificate upload et secret upload acceptent leur corps de requête seulement avec
--body-file <path>, ou --body-file - pour stdin, car il contient un mot de passe PFX ou une
valeur secrète. Elles refusent --body, qui laisserait la valeur dans l’historique de l’interpréteur de commandes et dans les
listes de processus. Aucune des deux n’accepte --output table.
ForceUpdate remplace un certificat ou un secret qui porte déjà ce nom. Gardez le fichier de
corps hors du contrôle de code source, et supprimez-le une fois qu’il est téléversé.
certificate.json contient le PFX encodé en Base64 et son mot de passe :
--body-file -.
Ici, jq lit la valeur à partir de api-key.txt plutôt qu’à partir de ses propres arguments; la
valeur reste donc absente des listes de processus :
mps asset upload
asset upload téléverse un fichier local en tant que ressource de serveur multijoueur. Elle accepte des options plutôt
qu’un corps de requête, et écrit le nom de la ressource et l’état du téléversement en JSON.
