功能介绍

• 接口名称

  DeleteShareFiles

• 功能描述

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

URI

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

请求消息

• 请求参数

  参数	是否必选	参数类型	描述
  file_paths	是	String	所需删除的共享存储文件绝对路径 以/开头，最大长度4096字节，目前只支持大小写字母、数字、点（.）、斜线（/）、中划线（-）、空格、下划线（_）、等号（=），不支持中文。 路径中不能包含.. 上层目录路径，防止跨目录攻击。
  server_ids	是	Array of strings	云手机服务器ID列表 可通过查询云手机服务器列表获取。

• 请求样例

  POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/share-files 
  { 
      "file_paths": [
          "/data/app",
          "/data/data/test.apk"
      ],
      "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"
          }
      ]
  }

返回值

请参考返回值。

错误码

请参考错误码。