云手机
云手机
云手机
文档指南
请输入
云手机
产品动态
控制台指南
服务端 OpenAPI 文档
实例管理
实例属性管理
镜像管理
资源管理
屏幕布局管理
应用管理
应用生命周期管理
云手机操控
网络配置与管理
端口映射管理
DNS 管理
ADB 管理
历史版本
2023-10-30
【旧版】实例管理
【旧版】实例属性管理
【旧版】云机管理
【旧版】镜像管理
【旧版】机房管理
【旧版】资源管理
【旧版】屏幕布局管理
【旧版】应用管理
【旧版】云手机操控
【旧版】网络配置与管理
【旧版】端口映射管理
2022-08-01
【旧版】实例管理
【旧版】镜像管理
【旧版】机房管理
【旧版】资源管理
【旧版】屏幕布局管理
【旧版】应用管理
【旧版】云手机操控
【旧版】标签管理
【旧版】通用服务
服务端 SDK 参考
客户端 SDK 参考
最佳实践
Mobile Use Agent
产品动态
最佳实践
API 参考
配置管理
代理运行配置
安全策略
任务管理
Computer Use Agent
产品动态
正式接入 CUA
API 参考
配置管理
代理运行配置
任务管理
- 文档首页
云手机云手机服务端 OpenAPI 文档应用管理应用生命周期管理批量安装应用 InstallApps
复制全文
下载 pdf批量安装应用 InstallApps
文档反馈
问问助手此接口用于将多个应用批量安装部署到指定云机实例中（异步任务）。
使用说明
请求说明
- 请求方式：POST
- 请求地址：https://open.volcengineapi.com?Action=InstallApps&Version=2025-05-01
请求参数
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 | 是 |
| 待安装的应用列表。 | |
InstallType | Integer | 否 | 0 | 应用安装类型：
|
IsPreinstall | Boolean | 否 | false | 用于标记应用是否为预安装应用：
说明
|
AppInfo
返回参数
参数 | 类型 | 示例值 | 描述 |
参数 | 类型 | 示例值 | 描述 |
Jobs |
| 子任务列表。 | |
TaskId | String | 7299428080677xxxxxx | 应用安装任务 ID。 |
TaskAction | String | InstallApp | 任务类型。 |
Job
参数 | 类型 | 示例值 | 描述 |
参数 | 类型 | 示例值 | 描述 |
JobId | String | job-7294170061873******-7294157141458****** | 子任务 ID，每个子任务 ID 对应一个实例。 |
PodId | String | 7294157141458****** | 实例 ID。 |
Status | Integer | 100 | 子任务执行状态。取值：
|
JobAction | String | InstallApp | 子任务名称。 |
请求示例
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
}
返回示例
{
"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"
}
}
错误码
最近更新时间：2026.10.14 18:41:53
这个页面对您有帮助吗？
有用
有用
无用
无用