全部产品
Search
文档中心

无影云手机:RunSyncCommand - 同步执行远程命令

更新时间:Mar 23, 2026

执行云手机命令,并尝试返回结果。

接口说明

RunSyncCommand适合能快速返回结果(毫秒级)的命令。对于执行时间较长(秒级)的命令,建议使用 RunCommand 接口。

调试

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

调试

授权信息

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

请求语法

POST  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

InstanceIds

array

云手机实例 ID 列表。一次请求最多支持 50 个实例。

string

云手机实例 ID。

acp-5hh431emkt6u*****

CommandContent

string

命令内容。

ls

WaitTime

integer

等待时间,单位为毫秒。取值范围 500~3000,默认值为 1000。

1000

ContentEncoding

string

脚本内容的编码方式。若该参数传入的值不在枚举值范围内,则一律视为传入默认值PlainText

枚举值:

  • Base64 :

    Base64 编码

  • PlainText :

    不编码,采用明文传输 [默认值]

PlainText

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

请求 ID。

5C5CEF0A-D6E1-58D3-8750-67DB4F82****

TotalCount

string

总条目数。

31

Data

array<object>

返回结果对象。

object

返回结果对象。

InvocationId

string

命令执行 ID。

t-15775dc8****

StartTime

string

命令开始执行时间。

2022-10-11T08:53:32Z

FinishTime

string

命令结束执行时间。

2022-08-11 17:45:03

Output

string

命令执行输出的结果。

success

InstanceId

string

执行当前命令的实例 ID。

acp-uto81vfd8t8z****

InvocationStatus

string

命令执行进度状态。

RUNNING

示例

正常返回示例

JSON格式

{
  "RequestId": "5C5CEF0A-D6E1-58D3-8750-67DB4F82****",
  "TotalCount": "31",
  "Data": [
    {
      "InvocationId": "t-15775dc8****",
      "StartTime": "2022-10-11T08:53:32Z",
      "FinishTime": "2022-08-11 17:45:03",
      "Output": "success",
      "InstanceId": "acp-uto81vfd8t8z****",
      "InvocationStatus": "RUNNING"
    }
  ]
}

错误码

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

变更历史

更多信息,参考变更详情