将多个云手机实例批量更换为同一种机型。 ## 注意事项 * 本接口暂仅支持使用 **2026 年 9 月 23 日及之后** 发布的全版本 AOSP 镜像，或 **2026 年 7 月 14 日及之后** AOSP 13 或 AOSP 15 镜像版本，镜像版本详情请参见 [AOSP 13 发布历史](https://docs.volcengine.com/docs/6394/1513693)、[AOSP 15 发布历史](https://docs.volcengine.com/docs/6394/2652277)。 * 修改机型将删除所有持久化系统属性，重置 `android_id`，并移除原有的 `procSysKernelRandomBootId` 和 `procCpuInfo`。详情请见 [Settings 属性列表](https://docs.volcengine.com/docs/Cloudphone/Annex#.c2V0dGluZ3Mt5bGe5oCn5YiX6KGo)。 ## 请求说明 * 请求方式：POST * 请求地址：https://open.volcengineapi.com?Action=ResetPodPhoneTemplate&Version=2025\-05\-01 ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见 [公共参数](https://www.volcengine.com/docs/6369/67268)。 ### Query |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |ResetPodPhoneTemplate |接口名称。当前 API 的名称为 `ResetPodPhoneTemplate`。 | |Version |String |是 |2025\-05\-01 |接口版本。当前 API 的版本为 `2025-05-01`。 | ### Body |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |ProductId |String |是 |1635714550\*\*\* |业务 ID，管理云手机资源、开展云手机业务的标识。您可以登录 [云手机控制台](https://console.volcengine.com/ACEP)，在已创建的业务卡片中获取。 | |PodIdList |Array of String |是 |["7294157141458\*\*\*", "7294107154305\*\*\*"] |需要更换机型参数的云手机实例 ID 列表，您可以通过调用 [ListPod](https://docs.volcengine.com/docs/6394/2304643) 接口获取。列表长度上限为 100。 | |PhoneTemplateIdList |Array of String |是 |["7658996557\*\*\*"] |目标机型库的 ID 列表，实例重启后将统一变更为对应机型。当前仅支持传入 1 个机型库 ID，您可以通过调用 [ListPhoneTemplate](https://docs.volcengine.com/docs/6394/1905403) 接口获取。

注意

PodIdList 中传入的所有云手机实例将统一变更为同一个机型，不支持为各实例分别指定不同机型。

| |ForceReboot |Boolean |否 |true |是否在变更机型参数后强制重启实例使配置立即生效，取值：

* `true`：（默认值）变更后立即重启实例。

* `false`：变更后不重启实例，您需要调用 [RebootPod](https://docs.volcengine.com/docs/6394/2279963) 接口自行重启实例，重启后的实例方可变更为对应机型。 | ## 返回参数下表仅列出本接口特有的返回参数。更多信息请参见 [返回结构](https://www.volcengine.com/docs/6394/75748#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C)。 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |TaskId |String |7301255941591\*\*\* |返回的任务 ID，可用于通过 [GetTaskInfo](https://docs.volcengine.com/docs/6394/2189053) 接口查看任务执行状态及结果。 | |TaskAction |String |ResetPodPhoneTemplate |任务操作类型。调用本接口时，该字段固定返回 `ResetPodPhoneTemplate`，表示更换实例机型操作。 | ## 请求示例 ```JSON POST https://open.volcengineapi.com?Action=ResetPodPhoneTemplate&Version=2025-05-01 { "ProductId": "1635714550***", "PodIdList": [ "7294157141458***", "7294107154305***" ], "PhoneTemplateIdList": [ "7658996557***" ], "ForceReboot": true } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "Action": "ResetPodPhoneTemplate", "Region": "cn-north-1", "Service": "ACEP", "Version": "2025-05-01", "RequestId": "20230604110420****100232280022D31" }, "Result": { "TaskId": "7301255941591***", "TaskAction": "ResetPodPhoneTemplate" } } ``` ## 错误码您可访问 [公共错误码](https://www.volcengine.com/docs/6394/1134303)，获取更多错误码信息。