文档首页> 云手机 CPH> API参考> 云手机API> ADB命令> 执行异步adb shell命令
更新时间:2022-03-31 GMT+08:00
分享

执行异步adb shell命令

功能介绍

  • 接口名称

    RunShellCommand

  • 功能描述

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

  • 注意事项

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

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

URI

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

参数说明请参见表1
表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

项目ID

获取方式请参见获取项目ID

请求消息

  • 参数说明

    参数

    是否必选

    参数类型

    描述

    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"
            }
        ]
    }

返回值

请参考返回值

错误码

请参考错误码

分享:

    相关文档

    相关产品

关闭导读