playfab mps est expérimentale. Son interface CLI peut changer
ou être supprimée en fonction des retours.
playfab mps gère les serveurs multijoueurs PlayFab (MPS) : les builds ainsi que leurs alias et
régions, les serveurs, les ressources, les certificats, les secrets, les images conteneur, les quotas et les machines
virtuelles (VM). Elle couvre les mêmes opérations que le module
MpsPowershell de PlayFab ; l’équivalent de son
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
uniquement --body-file, et asset upload n’accepte ni l’une ni l’autre ; consultez leurs sections.
Commandes destructrices
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 destructrices.
Pagination
Ces commandes de liste renvoient 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 soit renvoyé avec la valeur null. Définissez "PageSize" dans le corps de la requête pour modifier le nombre de
résultats par page.
Obtenir la première page de builds :
SkipToken n’est pas null, obtenez la page suivante en passant ce jeton :
SkipToken ; lorsqu’il existe d’autres résultats, le tableau est donc
suivi d’un avis sur 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 renvoient 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 renvoie
la valeur réelle.
mps build create
build create nécessite --type, qui sélectionne l’API PlayFab appelée, 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 n’acceptent leur corps de requête qu’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 du shell 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 chargé.
certificate.json contient le PFX encodé en Base64 et son mot de passe :
--body-file -.
Ici, jq lit la valeur depuis api-key.txt plutôt que depuis ses propres arguments ; la
valeur n’apparaît donc pas dans les listes de processus :
mps asset upload
asset upload charge 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 chargement au format JSON.
