全部产品
Search
文档中心

无影云手机:ResetAndroidInstancesInGroup - 重置实例(初始化系统)

更新时间:Sep 04, 2026

重置云手机实例。 重置是使用该云手机的镜像进行重装系统的过程,例如云手机创建时使用的镜像被删除将重置失败。

接口说明

只有实例处于可用、已关机、异常、备份失败、恢复失败状态时才支持重置(初始化系统)。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

AndroidInstanceIds

array

否

实例 ID 列表。

string

否

实例 ID。

acp-scaucydkl****

SaleMode

string

否

售卖模式。该参数已废弃!

枚举值:

  • Instance :

    云手机实例模式

  • Node :

    云手机矩阵模式

Instance

SettingResetType

integer

否

国际站不支持此参数

枚举值:

  • 0 :

    不保留属性设置

  • 1 :

    保留属性设置

1

IgnoreParamValidation

boolean

否

TargetDataDiskSize

integer

否

仅针对云手机矩阵下的实例,重置的同时需要进行存储缩容时,请填写该参数,目前该功能白名单开放。

10

AutoPay

boolean

否

是否自动支付。默认为 false。

true

PromotionId

string

否

优惠活动 ID。

50003308011****

返回参数

名称

类型

描述

示例值

object

返回参数。

RequestId

string

请求 ID。

69BCBBE4-FCF2-59B8-AD9D-531EB422****

Tasks

object

任务信息

ParentTaskId

string

父任务 ID

t-xxxx

ChildTasks

array<object>

子任务

object

子任务对象

InstanceId

string

实例 ID

acp-xxxx

TaskId

string

子任务 ID

t-xxxx

OrderId

string

针对云手机矩阵下的实例,重置的同时需要进行存储缩容时,会返回存储缩容的订单 Id,其他场景不会返回。

22365781890****

示例

正常返回示例

JSON格式

{
  "RequestId": "69BCBBE4-FCF2-59B8-AD9D-531EB422****",
  "Tasks": {
    "ParentTaskId": "t-xxxx",
    "ChildTasks": [
      {
        "InstanceId": "acp-xxxx",
        "TaskId": "t-xxxx"
      }
    ]
  },
  "OrderId": "22365781890****"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。