机群工作流程
Follow this workflow to create and manage fleets using the API.
阅读时间3 分钟最后更新于 15 天前
警告
警告：此内容是该文档的预览版。完整的文档以及代码示例仍在制作中。若有任何反馈，请通过本页底部的反馈机制来提供。
- Multiplay API 查看者
- Multiplay API 编辑者
注意
在这整个工作流程中，您都需要使用您的 Unity Project ID 和环境 ID。您可以在项目设置页面上找到 Project ID 并在环境页面上找到环境 ID。
机群工作流程图
获取版本配置
可以使用列出版本配置 API 来获取版本配置。请参阅版本配置工作流程。注意
请确保保存版本配置 ID。如果您已有版本配置 ID，则请继续获取机群。
请参阅列出版本配置 API 文档（了解示例响应体）和参数文档。curl -X GET \-H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" \https://services.api.unity.com/multiplay/build-configurations/v1/projects/{projectId}/environments/{environmentId}/build-configurations
获取机群
获取机群的过程取决于您要使用现有机群还是创建新机群。如果您选择使用现有机群但要对其进行更新，请参阅更新机群。获取现有机群
可以使用列出机群 API 按名称获取机群 ID。如果您已知道机群 ID，并希望更新该机群，请继续更新机群。 以下代码示例显示了如何使用 curl 获取现有机群：请参阅列出机群 API 文档（了解示例响应体）和参数文档。curl -X GET \-H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" \https://services.api.unity.com/multiplay/fleets/v1/projects/{projectId}/environments/{environmentId}/fleets
创建新机群
可以使用创建机群 API 来创建机群。创建机群时，需要配置游戏服务器要放置在哪个地区。通过列出模板机群地区 API 来查找有效的地区 ID。可以使用 curl 调用此 API：以下代码示例展示了如何使用 curl 创建新机群：curl -X GET \-H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" \https://services.api.unity.com/multiplay/fleets/v1/projects/{projectId}/environments/{environmentId}/fleets/regions
请参阅创建机群 API 文档（了解示例响应体）和参数文档。curl -X POST \-H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" \-H "Content-Type: application/json" \-d '{"buildConfigurations": [<BUILD_CONFIG_ID>], "name": "Example Fleet", "osFamily": "LINUX", "osID": "1111a1a1-a11a-11a1-a1a1-1a111aa11111", "regions": [{"maxServers": 10, "minAvailableServers": 10, "regionID": "<REGION_ID>"}]}' \https://services.api.unity.com/multiplay/fleets/v1/projects/{projectId}/environments/{environmentId}/fleets
更新机群
可以使用更新机群 API 来更新现有机群。注意
仅更新您正在使用的现有机群。如果您要创建新机群，则无需使用更新工作流程。
请参阅更新机群 API 文档（了解示例响应体）和参数文档。curl -X PUT \-H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" \-H "Content-Type: application/json" \-d '{"buildConfigurations": [<BUILD_CONFIG_ID>], "deleteTTL": 604800, "disabledDeleteTTL": 604800, "name": "Example Fleet", "shutdownTTL": 900}' \https://services.api.unity.com/multiplay/fleets/v1/projects/{projectId}/environments/{environmentId}/fleets/{fleetId}