> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 以编程方式扩缩容

> 使用 Multiplayer Servers API 以及 DynamicStandby BuildRegionParams 对象以编程方式扩缩容 PlayFab Multiplayer Servers，实现基于需求的备用扩缩容。

## Dynamic Standby 对象

Dynamic Standby 功能向 Multiplayer 编程接口引入了一个新对象，称为 `DynamicStandby`。Dynamic Standby 对象是 [BuildRegionParams](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayerserver/updatebuildregions#buildregionparams) 对象的一个可选属性。

配置 Dynamic Standby 需要编辑 Dynamic Standby 对象的设置属性。修改这些属性的默认值是一项高级游戏服务器功能，必须谨慎操作。

## Scheduled Standby 对象

Scheduled Standby 功能向 Multiplayer 编程接口引入了一个新对象，称为 `ScheduledStandby`。Scheduled Standby 对象是 [BuildRegionParams](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/update-build-regions#buildregionparams) 对象的一个可选属性。

配置 Schedule Standby 需要编辑 Schedule Standby 对象的设置属性。修改这些属性的默认值是一项高级游戏服务器功能，必须谨慎操作。

## 以编程方式启用备用扩缩容

您可以通过调用以下任一 Multiplayer Server API，以编程方式启用 Dynamic 或 Scheduled Standby：

1. Override [Update Build Regions](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/update-build-regions)\
   *UPSERT：一种将行插入数据库表（如果尚未存在）或更新它们（如果已存在）的操作。*
2. [Create Build with Custom Container](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayerserver/createbuildwithcustomcontainer)
3. [Create Build with Managed Container](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/create-build-with-managed-container)

要以编程方式启用 Dynamic 或 Schedule Standby，请将 `Mode` 属性切换为 ON。`Mode` 是 Dynamic Standby 或 Schedule Standby Settings 对象唯一必需的属性。其默认值为 **OFF**。


## Related topics

- [备用扩缩容](/zh-CN/services/playfab/multiplayer/servers/scaling-standby.md)
- [PIXEndCapture](/zh-CN/reference/tools/pix3/functions/pixendcapture.md)
- [服务器](/zh-CN/services/playfab/multiplayer/servers/index.md)
- [Windows Device Portal REST API 参考](/zh-CN/reference/deviceportal/atoc-deviceportal-reference.md)
- [PIXCaptureParameters](/zh-CN/reference/tools/pix3/structs/pixcaptureparameters.md)