HistoryVersions:list

Function

Lists the historical versions of a file.

Scenario

By calling the HistoryVersions.list API, your app can list the historical versions of a file.

Restrictions

• The value of scope must be one of the following:
  • https://www.huawei.com/auth/drive.file
  • https://www.huawei.com/auth/drive
  • https://www.huawei.com/auth/drive.readonly
  • https://www.huawei.com/auth/drive.metadata
  • https://www.huawei.com/auth/drive.metadata.readonly
  • https://www.huawei.com/auth/drive.appdata

Prototype

Path Parameters

Query Parameters

Request Parameters

Request Header

Request Example

GET 
https://driveapis.cloud.huawei.com.cn/drive/v1/files/BjYqWC-dH6-gcN6p5zxhI4I7Z1wtrR-po/historyVersions?fields=* HTTP/1.1
Accept: application/json
Authorization: Bearer
CgB6e3x9Bjh6m9tm8OB0GXjeMWk0m4pVnLmwteDNWXOKPhh0/tjwtIy6Q+OscvD7zhdrElYD0Rak6xA7dI4BM3GSQTuUgFK6ZwFk7K/fjJS5vB7JFmV3
Cache-Control: no-cache

Response Parameters

When the status code is 200:

Response Example

HTTP/1.1 200 OK 
{
   "historyVersions": [
      {
   "editedTime": "2020-05-15T06:21:11Z",
   "size": 1,
   "sha256": "4dcdc56b396adb1b68ad3257f2f9679f0b289ff003bbf3251bc7c8956c731849",
   "lastEditor": {
  "permissionId": "239606675785384320",
  "displayName": "*******3121@**3.com",
  "me": true,
  "category": "drive#user"
     },
   "id": "362821313154268928.362821313154268929",
   "mimeType": "text/plain",
   "category": "drive#historyVersion",
   "keepPermanent": false
      }
     ],
    "category": "drive#historyVersionList"
}

Common Result Codes

The last four digits in the result code indicate the service error code, which is used to differentiate error scenarios. For details about other service error codes, please refer to Status Codes.

Call Example

	public static void main(String[] args) throws IOException {
        // Set the request URL, file ID, permission ID, and access token.
        String url = "https://driveapis.cloud.huawei.com.cn/drive/v1/files";
        String fileId = "AB0tr6O8DTQAguUs3yPFt3wQ5SDfLg04A";//Your own fileId
        String access_token = "CV5T547SEXpRlyuxqvz+PnRCtnVu784+OEIXmXAafKC+ifA3eJRnM0Ttsv20bJCkrcA+FNi4bU4nKcbERpQxlkMLQ6/Xt1iEQJYrFMyamnnI9JUV+jz4cQ==";
        // List the historical versions of a file.
        JSONObject historyVersionsInfo = historyVersionsList(url, access_token, fileId);
        System.out.println(historyVersionsInfo.toJSONString());
    }

    private static JSONObject historyVersionsList(String url, String access_token, String fileId) throws IOException {
        StringBuilder stringBuilder = new StringBuilder("");
        stringBuilder.append("/").append(fileId).append("/").append("historyVersions");
        stringBuilder.append("?").append("fields=*");
        HttpGet httpGet = new HttpGet(url + stringBuilder);
        httpGet.setHeader("Authorization","Bearer " + access_token);
        CloseableHttpResponse response = HttpClientUtil.getClient().execute(httpGet);

        try {
            HttpEntity responseEntity = response.getEntity();
            String ret = responseEntity != null ? EntityUtils.toString(responseEntity) : null;
            JSONObject jsonObject = (JSONObject) JSON.parse(ret);
            EntityUtils.consume(responseEntity);
            return jsonObject;
        }finally {
            response.close();
        }
    }