tencent cloud

Viewing Historical Versions List
Download PDF
Last updated: 2026-01-07 14:28:02
Viewing Historical Versions List
Last updated: 2026-01-07 14:28:02
Download PDF

Description

View historical versions list.

Request

Request Example

GET /api/v1/directory-history/{LibraryId}/{SpaceId}/history-list/{FilePath}?marker={Marker}&limit={Limit}&page={Page}&page_size={PageSize}&order_by={OrderBy}&order_by_type={OrderByType}&access_token={AccessToken}

Request Parameter

Request parameters.
Description
Type
Required or Not
LibraryId
Media Library ID, obtained after creating a media library in the media hosting console. See Create Media Library
String
Yes
SpaceId
Space ID. If the media library is in single-tenant mode, this parameter is fixed as a hyphen (-); if the media library is in multi-tenant mode, you must specify this parameter.
String
Yes
FilePath
file path. For multi-level directory, use slash (/) to separate, such as foo/bar.txt
String
Yes
Marker
Sequential listing of page identification
String
No
Limit
Limit on the number of locally listed items for sequential pagination, defaults to 20
If not specified, defaults to paginate with (marker, limit) parameters.
If used simultaneously with (page, page_size) parameters, defaults to paginate with (page, page_size).
Int
No
Page
pagination code, default first page
Int
No
PageSize
pagination size, default 20; if used simultaneously with (marker, limit) parameters, defaults to (page, page_size) for pagination
Int
No
OrderBy
sorting field, sorted by file id as id, sorted by creation time as creationTime, defaults to id, latest version always ranks first
Int
No
OrderByType
Sorting method, ascending as asc, descending as desc, defaults to desc
String
No
AccessToken
Access token, see Generate Access Token
String
Yes

Request Body

This request does not have a request body.

Response

Response code

Retrieval successful, return HTTP 200 OK.

Response Body

application/json
Response body example:
{
    "totalNum": 2,
    "contents": [
        {
          "createdBy":"123",
          "creationWay":1,
          "version":2,
          "isLatestVersion":true,
          "name": "test",
          "size":2345,
          "crc64": "4937027024332829001",
          "contentType": "image/png",
          "creationTime": "2021-08-12T08:13:55.000Z",
          "setLatestTime": "2021-08-12T08:13:55.000Z"
        },{
          "id":1,
          "createdBy":"456",
          "creationWay":1,
          "version":2,
          "isLatestVersion":false,
          "name": "test",
          "size":2300,
          "crc64": "8237027023432829000",
          "contentType": "image/png",
          "creationTime": "2021-08-12T08:13:54.000Z",
          "setLatestTime": "2021-08-12T08:13:54.000Z"
        }
    ]
}
Response body field description:
Response Parameters
Description
Type
totalNum
Total number of historic versions, return this field only in page mode
Int
hasMore
Whether there is more search result
Boolean
nextMarker
The pagination identifier to obtain subsequent pages, return this field only when hasMore is true.
String
contents
Object array Specific content in a directory or album
Array
The contents include the following:
Response Parameters
Description
Type
id
Earlier version ID, the latest version does not return this field
Int
createdBy
Creator ID
String
creationWay
Creation Method, 0: Create, 1: Update
Int
version
Version number.
Int
isLatestVersion
Whether it is the latest version
Boolean
name
Directory or album name or file name
String
size
Historical version file size
Int
crc64
CRC64-ECMA182 check value of the file, to avoid number accuracy issues, here is the string format
String
contentType
File metaclass
String
creationTime

ISO 8601 formatted date and time string, representing the file creation time, such as 2020-10-14T10:17:57.953Z
String
setLatestTime

Set to the latest version the time when, for example 2020-10-14T10:17:57.953Z
String

Error Codes

This request operation has no special error messages. For common error messages, see Error Codes.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback