此接口用于将多个应用批量安装部署到指定云机实例中（异步任务）。 ## 使用说明应用安装结果通过任务执行回调返回，详细信息，参考 [云手机回调服务接入指南](https://www.volcengine.com/docs/6394/138583)。 ## 请求说明 * 请求方式：POST * 请求地址：https://open.volcengineapi.com?Action=InstallApps&Version=2025\-05\-01 ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见 [公共参数](https://www.volcengine.com/docs/6369/67268)。 ### Query |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |`InstallApps` |接口名称。当前 API 的名称为 `InstallApps`。 | |Version |String |是 |`2025-05-01` |接口版本。当前 API 的版本为 `2025-05-01`。 | ### Body |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |ProductId |String |是 |1608456935646xxxxxx |业务 ID，可在**云手机控制台 \> 业务管理 \> 业务详情**中获取。 | |PodId |String |是 |7299381659819xxxxxx |指定实例 ID 进行应用安装。 | |AppList |Array of [AppInfo](https://docs.volcengine.com/docs/Cloudphone/BatchInstallApps#f92f1d1e) |是 |* |待安装的应用列表。 | |InstallType |Integer |否 |0 |应用安装类型：

* `0`：（默认）机身存储独立安装（非共享）

* `1`：共享安装 | |IsPreinstall |Boolean |否 |false |用于标记应用是否为预安装应用：

* true：是；

* false：否。

当标记某应用为预安装应用后，重置实例时可选择是否保留该应用及相关数据。具体参看 [ResetPod](https://www.volcengine.com/docs/6394/1221459) 接口的 `PreInstallAppPersistedType` 字段说明。

说明

该参数需配合 2024 年 9 月 5 日及之后发布的公共镜像版本使用。

后缀为 .xapk 的应用，不支持标记为预安装应用。如果安装 .xapk 应用时 IsPreinstall 参数取值为 true，请求将会失败。

| ### AppInfo |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |AppId |String |是 |7278660795155xxxxxx |应用 ID，可通过调用 [ListApp](https://www.volcengine.com/docs/6394/1226894) 接口获取。 | |VersionId |String |是 |7278660795155xxxxxx |应用版本 ID，可通过调用 [ListApp](https://www.volcengine.com/docs/6394/1226894) 接口获取。 | ## 返回参数下表仅列出本接口特有的返回参数。更多信息请参见 [返回结构](https://www.volcengine.com/docs/6394/75748#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C)。 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Jobs |Array of [Job](https://docs.volcengine.com/docs/Cloudphone/BatchInstallApps#b4559ae6) |* |子任务列表。 | |TaskId |String |7299428080677xxxxxx |应用安装任务 ID。 | |TaskAction |String |InstallApp |任务类型。 | ### Job |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |JobId |String |`job-7294170061873******-7294157141458******` |子任务 ID，每个子任务 ID 对应一个实例。 | |PodId |String |`7294157141458******` |实例 ID。 | |Status |Integer |100 |子任务执行状态。取值：

* `-2`：部分失败

* `-1`：全部失败

* `10`：执行中

* `100`：成功 | |JobAction |String |InstallApp |子任务名称。 | ## 请求示例 ```JSON POST https://open.volcengineapi.com?Action=InstallApps&Version=2025-05-01 { "ProductId": "1608456935646xxxxxx", "PodId": "7299381659819xxxxxx", "AppList": [ { "AppId": "7278660795155xxxxxx", "VersionId": "7278660795155xxxxxx" }, { "AppId": "7291927828638xxxxxx", "VersionId": "7278660795155xxxxxx" } ], "InstallType": 0 } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "RequestId": "202306041104200100100232280022D31", "Action": "InstallApps", "Version": "2025-05-01", "Service": "ACEP", "Region": "cn-north-1" }, "Result": { "Jobs": [ { "PodId": "7299381659819xxxxxx", "JobAction": "InstallApp", "JobId": "job-7299395610653xxxxxx-7299381659819xxxxxx", "Status": 100 } ], "TaskAction": "InstallApp", "TaskId": "7299428080677xxxxxx" } } ``` ## 错误码您可访问 [公共错误码](https://www.volcengine.com/docs/6394/1134303)，获取更多错误码信息。