功能介绍

• 接口名称

  RunShellCommand

• 功能描述

  在云手机中执行shell命令。该接口为异步接口，可调用查询任务执行状态和查询任务执行状态列表查询任务执行结果。

• 注意事项

  已给云手机服务系统账号授权OBS桶的只读权限，详情请参考用户指南中的“批量控制”。

  管理面性能有限，对相同服务器批量执行的ADB命令，将会阻塞云手机其他任务执行。

URI

POST /v1/{project_id}/cloud-phone/phones/commands

请求消息

• 参数说明

  参数	是否必选	参数类型	描述
  command	是	String	ADB命令，固定填写shell。
  content	是	String	待执行的命令 最大长度为1024字节，只支持大小写字母、数字、下划线（_）、点（.）、斜线（/）、冒号（:）、中划线（-）。
  server_ids	否 phone_ids参数不存在时必选	Array of strings	云手机服务器ID列表 可通过查询云手机服务器列表获取。
  phone_ids	否 server_ids参数不存在时必选	Array of strings	云手机ID列表 可通过查询云手机列表获取。

• 请求样例

  POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/commands
  {
      "command": "shell",
      "content": "ls -l /system",
      "phone_ids": [
          "1234567b8bab40ffb711234cb80d0234",
          "1678567b8bab40f93711234cb80d0764"
      ]
  }

响应消息

• 响应参数

  参数	参数类型	描述
  request_id	String	请求的唯一标识ID
  jobs	Array of objects	任务信息，详情请参见表2。

  表2 job数据结构说明

  参数	参数类型	描述
  phone_id	String	云手机的唯一标识，云手机相关任务包含此字段。
  job_id	String	任务的唯一标识

• 响应样例

  {
      "request_id": "6837531fd3f54550927b930180a706bf",
      "jobs": [
          {
              "phone_id": "1234567b8bab40ffb711234cb80d0234",
              "job_id": "1564567b8bab40f34711234cb80d0123"
          },
          { 
              "phone_id": "1678567b8bab40f93711234cb80d0764",
              "job_id": "1564567b8bab40f34711234cb80d5678"
          }
      ]
  }

返回值

请参考返回值。

错误码

请参考错误码。