更新时间:2022-03-31 GMT+08:00
分享

推送文件

功能介绍

  • 接口名称

    PushFile

  • 功能描述

    推送文件到云手机文件系统中。系统会将所指定的文件下载解压后,将解压后的内容全部推送到云手机的根目录下。只支持指定“tar”格式的文件进行推送,您需要将“tar”文件提前上传至您的OBS桶中。该接口为异步接口,可调用查询任务执行状态查询任务执行状态列表查询任务执行结果。

  • 注意事项

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

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

    允许推送的文件大小限制为6G(即不可将obs桶内大于6G的文件推送到手机中),超过限制将返回错误。

URI

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

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

参数

是否必选

参数类型

描述

project_id

String

项目ID

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

请求消息

  • 请求参数

    参数

    是否必选

    参数类型

    描述

    command

    String

    手机管理命令,推送文件场景固定填写push。

    content

    String

    指定OBS桶中的tar文件

    最大长度为1024字节,只支持大小写字母、数字、下划线(_)、点(.)、斜线(/)、冒号(:)、中划线(-)。推送的文件只支持tar文件类型。文件格式:obs://obs-bucket-name/obs-file-path/file.tar。

    phone_ids

    server_ids参数不存在时必选,同时存在只处理phone_ids。

    Array of strings

    云手机ID列表

    可通过查询云手机列表获取。

    server_ids

    phone_ids参数不存在时必选,同时存在只处理phone_ids。

    Array of strings

    云手机服务器ID列表

    可通过查询云手机服务器列表获取。

  • 请求样例
    POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/commands
    {
        "command": "push",
        "content": "obs://push-bucket/my_apps/test.tar",
        "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" 
            }
        ]
    }

返回值

请参考返回值

错误码

请参考错误码

分享:

    相关文档

    相关产品

close