ListDelta - Drive and Photo Service - Alibaba Cloud Documentation Center

Queries incremental information.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request syntax

POST /v2/file/list_delta HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
body	object	No	The request parameters.
drive_id	string	Yes	The drive ID.	1
sync_root_id	string	No	The ID of the root file of the synced folder.	622fb09598ae66777c7040109a16f49381f6abe1
cursor	string	No	The cursor of the incremental information.	NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg
limit	integer	No	The maximum number of results to return. Valid values: 0 to 100. Default value: 100. The number of returned results must be less than or equal to the specified number.	50

Response parameters

Parameter	Type	Description	Example
	object	The response parameters.
items	array<object>	The incremental information returned.
	object
file_id	string	The file ID.	122fb09598ae66777c7040109a16f49381f6abe2
op	string	The operation that is performed. Valid values: Valid values: create overwrite delete update move trash restore rename	create
file	File	The information about the file.
has_more	boolean	Indicates whether more information is returned.	true
cursor	string	The cursor of the incremental information.	1WQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

Examples

Sample success responses

JSONformat

{
  "items": [
    {
      "file_id": "122fb09598ae66777c7040109a16f49381f6abe2",
      "op": "create",
      "file": {
        "domain_id": "",
        "drive_id": "",
        "file_id": "",
        "name": "",
        "type": "",
        "content_type": "",
        "created_at": "",
        "updated_at": "",
        "description": "",
        "trashed_at": "",
        "file_extension": "",
        "mime_type": "",
        "mime_extension": "",
        "hidden": true,
        "size": 0,
        "starred": true,
        "status": "",
        "user_meta": "",
        "labels": "",
        "upload_id": "",
        "parent_file_id": "",
        "crc64_hash": "",
        "content_hash": "",
        "content_hash_name": "",
        "download_url": "",
        "thumbnail": "",
        "category": "",
        "local_created_at": "",
        "local_modified_at": "",
        "revision_id": ""
      }
    }
  ],
  "has_more": true,
  "cursor": "1WQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg"
}

XMLformat

<ListDeltaResponse>
    <items>
        <file_id>122fb09598ae66777c7040109a16f49381f6abe2</file_id>
        <op>create</op>
        <file/>
    </items>
    <has_more>true</has_more>
    <cursor>1WQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg</cursor>
</ListDeltaResponse>

Error codes

For a list of error codes, visit the Service error codes.