Files:update.patchresume

功能介绍

修改并准备断点续传。

场景描述

您的应用调用Files.update.resume接口进行初始化断点更新，对已有文件元数据进行增量更新，解析元数据，最终返回location以供Files.resume接口使用。

使用约束

• 0bit文件（空文件），不允许带缩略图上传。
• Scope至少包含下面其中一个：
  • https://www.huawei.com/auth/drive.file
  • https://www.huawei.com/auth/drive.appdata
  • https://www.huawei.com/auth/drive

接口原型

路径参数

查询参数

请求参数

Request Header

Request Body

请求示例

PATCH https://driveapis.cloud.huawei.com.cn/upload/drive/v1/files/DSQpEkxcAAADKXEPJAYABgEZivNwAmCu?uploadType=resume&fields=* HTTP/1.1 
X-Upload-Content-Type: image/jpeg 
X-Upload-Content-Length: 200000  
Authorization: Bearer CV3PnPLZXyr9K2GV7RYZkF962JZvoEkMQhTho3QHQAPQUyma/lEyZskP/IMWrc7FvaeHivO7y0lyibI/fQvulBnTgtXArSVPsjaLKvYNkDsJSaIR2/sx+K40bYDWWpKFvJNKg2U47jRwz2mfiF3ortNk
Cache-Control: no-cache
{
    "appSettings":{
        "test1":"value1"
    },
    "contentExtras":{
        "thumbnail":{
            "content":"***",
            "mimeType":"image/jpeg",
            "thumbnailPublic":false
        }
    },
    "writerHasCopyPermission":false,
    "createdTime":"2019-11-14T07:53:24.953Z",
    "description":"test test test zb",
    "mimeType":"image/jpeg",
    "editedTime":"2019-11-14T07:53:24.953Z",
    "fileName":"1234.JPG",
    "originalFilename":"3123.JPG",
    "parentFolder":[
        "/opt/test"
    ],
    "properties":{
        "test2":"value2"
    },
    "favorite":true,
    "writersHasSharePermission":false
}

响应参数

状态码为200时:

响应示例

{
    "sliceSize":4194304
}
Headers:  
Location:https://driveapis.cloud.huawei.com.cn/upload/drive/v1/fc7300dbe0280d39/files?fields=*&uploadType=resume&uploadId=324314495017204480
Content-Type: application/json; charset=utf-8Content-Length: 21

常见错误码

错误码后4位为业务错误码，用于区分错误场景，其他业务错误码见状态码章节。

调用示例

    public static void main(String[] args) throws IOException {
        // 设置请求地址,文件ID和用户认证令牌
        String url = "https://driveapis.cloud.huawei.com.cn/upload/drive/v1/files";
        String fileId = "AACWO19qK7wAg6gA2-kVh4QNqAzb5CuwA";
        String access_token = "CF3p+5TNdpCs0OjI+bP04rVLLe6WJpFWefKlASOzIaDArxxS36ku2TePpHUGzfJAW4C4YO06wB7eIhMdu/MEOsqAkWu0rpNmVcTUsVefUSmt5RUvhAr2oQ==";
        // 修改文件信息并准备断点续传
        String fileInfo = filesUpdatePatchresume(url, access_token, fileId);
        if(fileInfo != null){
            System.out.println(fileInfo);
        }
    }
    private static String filesUpdatePatchresume(String url, String access_token, String fileId) throws IOException {
        StringBuilder stringBuilder = new StringBuilder("");
        stringBuilder.append("/").append(fileId);
        stringBuilder.append("?").append("fields=*");
        stringBuilder.append("&").append("uploadType=resume");
        HttpPatch httpPatch = new HttpPatch(url + stringBuilder);
        httpPatch.setHeader("Authorization","Bearer " + access_token);
        httpPatch.setHeader("Content-Type", "application/json;charset=UTF-8");
        httpPatch.setHeader("Accept", "*/*");
        httpPatch.setHeader("X-Upload-Content-Length", "53");

        JSONObject jsonParam = new JSONObject();
        jsonParam.put("\"appSettings\"", "{    \"test1\": \"value1\"  }");
        StringEntity entity = new StringEntity(jsonParam.toString());
        httpPatch.setEntity(entity);

        CloseableHttpResponse response = HttpClientUtil.getClient().execute(httpPatch);

        try {
            if(response.getStatusLine().getStatusCode() == 200){
                String ret = response.getHeaders("Location")[0].getValue();
                return ret;
            }
            HttpEntity responseEntity = response.getEntity();
            String ret = responseEntity != null ? EntityUtils.toString(responseEntity) : null;
            JSONObject jsonObject = (JSONObject) JSON.parse(ret);
            EntityUtils.consume(responseEntity);
            return jsonObject.toJSONString();
        }finally {
            response.close();
        }
    }