文档中心

云手机

实例属性管理

更换实例机型 ResetPodPhoneTemplate

更换实例机型 ResetPodPhoneTemplate

将多个云手机实例批量更换为同一种机型。

注意事项

本接口暂仅支持使用 2026 年 9 月 23 日及之后发布的全版本 AOSP 镜像，或 2026 年 7 月 14 日及之后 AOSP 13 或 AOSP 15 镜像版本，镜像版本详情请参见 AOSP 13 发布历史、AOSP 15 发布历史。

修改机型将删除所有持久化系统属性，重置 android_id，并移除原有的 procSysKernelRandomBootId 和 procCpuInfo。详情请见 Settings 属性列表。

请求说明

请求方式：POST

请求地址：https://open.volcengineapi.com?Action=ResetPodPhoneTemplate&Version=2025-05-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	ResetPodPhoneTemplate	接口名称。当前 API 的名称为 ResetPodPhoneTemplate。
Version	String	是	2025-05-01	接口版本。当前 API 的版本为 2025-05-01。

Body

参数	类型	是否必选	示例值	描述
ProductId	String	是	1635714550***	业务 ID，管理云手机资源、开展云手机业务的标识。您可以登录云手机控制台，在已创建的业务卡片中获取。
PodIdList	Array of String	是	["7294157141458*", "7294107154305*"]	需要更换机型参数的云手机实例 ID 列表，您可以通过调用 ListPod 接口获取。列表长度上限为 100。
PhoneTemplateIdList	Array of String	是	["7658996557***"]	目标机型库的 ID 列表，实例重启后将统一变更为对应机型。当前仅支持传入 1 个机型库 ID，您可以通过调用 ListPhoneTemplate 接口获取。注意 PodIdList 中传入的所有云手机实例将统一变更为同一个机型，不支持为各实例分别指定不同机型。
ForceReboot	Boolean	否	true	是否在变更机型参数后强制重启实例使配置立即生效，取值： true：（默认值）变更后立即重启实例。 false：变更后不重启实例，您需要调用 RebootPod 接口自行重启实例，重启后的实例方可变更为对应机型。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
TaskId	String	7301255941591***	返回的任务 ID，可用于通过 GetTaskInfo 接口查看任务执行状态及结果。
TaskAction	String	ResetPodPhoneTemplate	任务操作类型。调用本接口时，该字段固定返回 ResetPodPhoneTemplate，表示更换实例机型操作。

请求示例

返回示例

错误码

您可访问公共错误码，获取更多错误码信息。

最近更新时间：2026.09.24 18:52:34

这个页面对您有帮助吗？

有用

有用

无用

无用