云手机
云手机
- 文档首页
云手机服务端 OpenAPI 文档应用管理批量启动应用 LaunchApps
文档反馈
问问助手此接口用于启动应用，可在一个实例中实现批量启动多个 App。
请求说明
- 请求方式：POST
- 请求地址：https://open.volcengineapi.com?Action=LaunchApps&Version=2025-05-01
请求参数
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
Query
参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 |
| 接口名称。当前 API 的名称为 |
Version | String | 是 |
| 接口版本。当前 API 的版本为 |
Body
参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
ProductId | String | 是 | 73301***716136236 | 实例所归属的业务 ID。可通过调用 ListPod 接口获取。 |
PodId | String | 是 | 73301074***6136236 | 实例 ID。可通过调用 ListPod 接口获取。 |
PackageNameList | Array of String | 是 | ["com.android.settings","com.android.documentsui1"] | 包名列表，最大长度 20。可通过调用 GetPodAppList 接口获取。 |
返回参数
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
TaskId | String | 7330560***30876716 | 任务 ID。 |
TaskAction | String | LaunchApps | 任务类型。 |
Jobs | Array of Job | 实例任务。 |
Job
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
JobId | String |
| 子任务 ID，每个子任务 ID 对应一个实例。 |
PodId | String |
| 实例 ID。 |
Status | Integer | 10 | 子任务执行状态。取值如下：
|
JobAction | String | LaunchApps | 子任务类型。 |
JobMessage | String | null | 子任务信息。 |
请求示例
POST https://open.volcengineapi.com?Action=LaunchApps&Version=2025-05-01 { "ProductId": "73301***716136236", "PodId": "73301074***6136236", "PackageNameList": [ "com.android.settings", "com.android.documentsui1" ] }
返回示例
{ "ResponseMetadata": { "Action": "LaunchApps", "Region": "cn-north-1", "RequestId": "2024020117***424B50EB2EB8FFCF", "Service": "ACEP", "Version": "2025-05-01" }, "Result": { "TaskId": "7330560***0876716", "TaskAction": "LaunchApps", "Jobs": [ { "PodId": "7327950***7811756", "JobId": "job-733056055273***90617811756", "JobAction": "LaunchApps", "Status": 10, "JobMessage": "" } ] } }
错误码
您可访问公共错误码，获取更多错误码信息。