playfab mps 命令系列属于实验性功能。其 CLI 接口可能会根据反馈而更改或被删除。
playfab mps 管理 PlayFab Multiplayer Servers (MPS):生成及其别名和区域、服务器、资产、证书、机密、容器映像、配额和虚拟机 (VM)。它涵盖与 PlayFab 的 MpsPowershell 模块相同的操作;与其 Set-PfTitle 等效的是 xbox context set playfab-title-id <id>。请参阅上下文。
命令树
每个命令都在xbox playfab mps 下运行。
请求正文
大多数 MPS 命令会发送操作的 JSON 请求对象,与playfab api 类似:
--body 和 --body-file 不能结合使用。certificate upload 和 secret upload 仅接受 --body-file,asset upload 两者都不接受;请参阅它们各自的部分。
破坏性命令
以下命令在终端中会先进行询问,在其他环境中则需要--confirm (--yes, -y):build delete、build alias delete、build region delete、server shutdown、asset delete、certificate delete、secret delete、container-image repository delete 和 remote-user delete。使用 --body-file - 时,即使在终端中也需要 --confirm。其他进行更改的 MPS 命令会直接运行而不询问。请参阅安全性和破坏性操作。
分页
以下列表命令每次调用返回一页结果:build list、build alias listserver list、server list-archivedasset list、certificate list、secret listcontainer-image list、container-image list-tagsvirtual-machine list
SkipToken。若要获取下一页,请将带有该值的 "SkipToken" 添加到请求正文中,保留其他字段,并重复此操作,直到返回的 SkipToken 为 null。在请求正文中设置 "PageSize" 可更改每页包含的结果数。
获取第一页生成:
SkipToken 不为 null,请传递该令牌以获取下一页:
SkipToken 列,因此当存在更多结果时,表格之后会在 stderr 上显示一条通知,其中包含要发送的令牌。
表格输出
以下表格中的命令接受--output table;其他 MPS 命令不接受。请参阅表格输出。
返回单条记录的命令将其显示为一行:
已编辑的列会打印
********,因为该值是凭据。JSON 输出会返回实际值。
mps build create
build create 需要 --type(它选择要调用的 PlayFab API),并像其他 MPS 命令一样接受请求正文:
mps certificate upload 和 mps secret upload
certificate upload 和 secret upload 仅通过 --body-file <path>(或用于 stdin 的 --body-file -)接受请求正文,因为正文包含 PFX 密码或机密值。它们拒绝 --body,因为该选项会将值留在 shell 历史记录和进程列表中。两者都不接受 --output table。
ForceUpdate 会替换已使用该名称的证书或机密。请勿将正文文件纳入源代码管理,并在上传后将其删除。
certificate.json 包含 Base64 编码的 PFX 及其密码:
--body-file -。此处,jq 从 api-key.txt 而不是从其自身的参数中读取该值,因此该值不会出现在进程列表中:
mps asset upload
asset upload 将本地文件作为多人游戏服务器资产上传。它接受选项而不是请求正文,并以 JSON 形式写入资产名称和上传状态。
