ListDelta API to query incremental file changes - Drive and Photo Service - Alibaba Cloud - Drive and Photo Service

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST /v2/file/list_delta HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
domain_id	string	No
body	object	No	The request body.
drive_id	string	Yes	The drive ID.	1
sync_root_id	string	No	The file id of the sync root.	622fb09598ae66777c7040109a16f49381f6abe1
cursor	string	No	The pagination cursor. Leave this empty for the first request. To retrieve subsequent pages, use the `cursor` value from the previous response.	NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg
limit	integer	No	The maximum number of items to return, from 0 to 100. If this parameter is not specified, the default is 100. The service may return fewer items than the specified value.	50

Response elements

Element	Type	Description	Example
	object	The response body.
items	array<object>	A list of deltas.
	object
file_id	string	The file id.	122fb09598ae66777c7040109a16f49381f6abe2
op	string	The type of operation. Valid values: create overwrite delete update move trash restore rename	create
file	File	Details about the file involved in the operation.
has_more	boolean	A value of `true` indicates that more deltas are available to fetch.	true
cursor	string	The pagination cursor for the next page of results. This field is returned only when `has_more` is `true`.	1WQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

Examples

Success response

JSON format

{
  "items": [
    {
      "file_id": "122fb09598ae66777c7040109a16f49381f6abe2",
      "op": "create",
      "file": {
        "domain_id": "bj1",
        "drive_id": "1",
        "file_id": "5d79206586bb5dd69fb34c349282718146c55da7",
        "name": "1.mov",
        "type": "file",
        "content_type": "application/json",
        "created_at": "2019-08-20T06:51:27.292Z",
        "updated_at": "2019-08-20T06:51:27.292Z",
        "description": "image file",
        "trashed_at": "2019-08-20T06:51:27.292Z",
        "file_extension": "txt",
        "hidden": false,
        "size": 1024,
        "starred": false,
        "status": "available",
        "labels": [
          "[\"label1:1\", \"label2:2\"]"
        ],
        "upload_id": "C9DCFE5A82644AC7A02DB74C30C934A6",
        "parent_file_id": "3d5b846942cf94fa72324c8a4bda34e81da635a",
        "crc64_hash": "3574582125365864471",
        "content_hash": "EA4942AA8761213890A5C386F88E6464D2C31CA3",
        "content_hash_name": "sha1",
        "download_url": "https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx",
        "thumbnail": "https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx",
        "category": "image",
        "local_created_at": "2019-08-20T06:51:27.292Z",
        "local_modified_at": "2019-08-20T06:51:27.292Z",
        "revision_id": "5d5b846942cf94fa72324c14a4bda34e81da635d",
        "thumbnail_urls": {
          "key": "\"128X128\": \"https://url1\", \"800X800\": \"url2\""
        },
        "image_media_metadata": {
          "time": "2006-01-02T15:04:05.000Z07:00",
          "width": 1024,
          "height": 1024,
          "location": "30.185453,120.218522",
          "country": "China\n",
          "province": "Zhejiang\n",
          "city": "Hangzhou\n",
          "district": "Binjiang District\n",
          "township": "Xixing Street\n",
          "address_line": "Jiangling Road, Xixing Street, Binjiang District, Hangzhou, Zhejiang\n",
          "image_tags": [
            {
              "confidence": 0.98,
              "parent_name": "sport",
              "name": "basketball",
              "tag_level": 3,
              "source": "play basketball",
              "centric_score": 0.877
            }
          ],
          "faces": "[{\"FaceId\":\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\",\"GroupId\":\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\",\"FaceConfidence\":0.999,\"Age\":13,\"AgeConfidence\":4,\"Gender\":\"female\",\"GenderConfidence\":1,\"Emotion\":\"none\",\"EmotionConfidence\":0.672,\"FaceAttributes\":{\"Mask\":\"none\",\"MaskConfidence\":0.894,\"Beard\":\"none\",\"BeardConfidence\":0.997,\"Glasses\":\"none\",\"GlassesConfidence\":0.999,\"Mouth\":\"close\",\"MouthConfidence\":0.937,\"Hat\":\"none\",\"HatConfidence\":0.998,\"HeadPose\":{\"Pitch\":10.684,\"Roll\":-10.707,\"Yaw\":-20.094},\"FaceBoundary\":{\"Width\":457,\"Height\":687,\"Top\":1324,\"Left\":1356}}}]",
          "faces_thumbnail": [
            {
              "face_id": "a9a66a86-73dd-4c95-8b79-1d8a49db5226",
              "face_group_id": "Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0",
              "face_thumbnail": "https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2"
            }
          ],
          "exif": "{\"Compression\":{\"value\":\"6\"},\"DateTime\":{\"value\":\"2020:08:19 17:11:11\"}}",
          "image_quality": {
            "overall_score": 0.736
          }
        },
        "user_tags": {
          "key": "\"k1\":\"v1\", \"k2\",\"v2\""
        },
        "video_media_metadata": {
          "width": 1920,
          "height": 1080,
          "video_media_video_stream": [
            {
              "duration": "22.88",
              "bitrate": "108420",
              "code_name": "h264",
              "frame_count": "90"
            }
          ],
          "video_media_audio_stream": [
            {
              "duration": "7704.573000",
              "bit_rate": "129280",
              "code_name": "aac"
            }
          ]
        },
        "id_path": "id1/id2",
        "name_path": "root/f1/f2",
        "dir_size_info": {
          "dir_count": 1,
          "file_count": 10
        },
        "action_list": [
          ""
        ],
        "auto_delete_left_sec": 0
      }
    }
  ],
  "has_more": true,
  "cursor": "1WQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.