功能介绍

• 接口名称

  PushShareFiles

• 功能描述

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

  

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

URI

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

请求消息

• 请求参数

  参数	是否必选	参数类型	描述
  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"
          }
      ]
  }

返回值

请参考返回值。

错误码

请参考错误码。