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

推送共享存储文件

功能介绍

  • 接口名称

    PushShareFiles

  • 功能描述

    推送文件至共享存储目录中,该功能仅在支持共享存储的云手机规格上可实现。您可通过查询云手机规格列表的“extend_spec”参数,查询云手机规格是否支持共享存储(“extend_spec”参数中包含“max_share_disk_size_g”字段,表示支持)。

    需要您提前创建OBS桶,设置桶的相关权限,并将待推送的文件上传至OBS桶。详细操作可参阅“批量控制”。

URI

POST /v1/{project_id}/cloud-phone/phones/share-files

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

参数

是否必选

参数类型

描述

project_id

String

项目ID

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

请求消息

  • 请求参数

    参数

    是否必选

    参数类型

    描述

    bucket_name

    String

    合法的OBS桶名,3-63个字符,只能由小写字母、数字、中划线(-)和小数点组成。

    object_path

    String

    合法的OBS对象key,最大长度1024字符。

    推送的文件只支持tar文件类型。推送时,按tar文件解压后的文件目录结构推送到手机。当前只支持/data和/cache目录推送。

    server_ids

    Array of strings

    云手机服务器ID列表

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

  • 请求样例
    POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/share-files
    {
        "bucket_name": "bucketA",
        "object_path": "my_apps/test.tar",
        "server_ids": [
            "1234567b8bab40ffb711234cb80d0234",
            "1678567b8bab40f93711234cb80d0764"
        ]
    }

响应消息

  • 响应参数

    参数

    参数类型

    描述

    request_id

    String

    请求的唯一标识ID

    jobs

    Array of objects

    任务信息,详情请参见表2

    表2 job数据结构说明

    参数

    参数类型

    描述

    server_id

    String

    云手机服务器的唯一标识

    job_id

    String

    任务的唯一标识

  • 响应样例
    {
        "request_id": "6837531fd3f54550927b930180a706bf",
        "jobs": [
            {
                "server_id": "1234567b8bab40ffb711234cb80d0234",
                "job_id": "1564567b8bab40f34711234cb80d0123"
            },
            { 
                "server_id": "1678567b8bab40f93711234cb80d0764",
                "job_id": "1564567b8bab40f34711234cb80d5678"
            }
        ]
    }

返回值

请参考返回值

错误码

请参考错误码

分享:

    相关文档

    相关产品

close