ListShareLink - Drive and Photo Service - Alibaba Cloud Documentation Center

Queries shares.

Operation description

This operation is discontinued. To query shares, you can call the SearchShareLink operation.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request syntax

POST /v2/share_link/list HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
body	object	No	The request parameters.
creator	string	No	The creator of the share.	c9b7a5aa04d14ae3867fdc886fa01da4
limit	integer	No	The maximum number of results to return. Valid values: 0 to 100. The number of returned results must be less than or equal to the specified number.	50
marker	string	No	The pagination token that is used in the next request to retrieve a new page of results. You do not need to specify this parameter for the first request. You must specify the token that is obtained from the previous query as the value of marker. By default, this parameter is left empty.	NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg
order_by	string	No	The field by which to sort the returned results. Default value: created_at. Valid values: share_name: sorts the results by the name of the share. updated_at: sorts the results by the time when the share was modified. description: sorts the results by the description of the share. created_at: sorts the results by the time when the share was created.	share_name
order_direction	string	No	The order in which you want to sort the returned results. By default, order_direction is set to DESC if order_by is set to created_at or updated_at, and is set to ASC if order_by is set to other values. Valid values: ASC: sorts the results in ascending order. DESC: sorts the results in descending order.	ASC
include_cancelled	boolean	No	Specifies whether to return the shares that are canceled.	true

Response parameters

Parameter	Type	Description	Example
	object	The response parameters.
items	array	The information about the shares.
	ShareLink	The information about a share.
next_marker	string	A pagination token. It can be used in the next request to retrieve a new page of results. If next_marker is empty, no next page exists.	NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg

Examples

Sample success responses

JSONformat

{
  "items": [
    {
      "share_id": "7JQX1FswpQ8",
      "share_pwd": "abcF123x",
      "drive_id": "1",
      "file_id_list": "[\"520b217f13adf4fc24f2191991b1664ce045b393\"]",
      "expiration": "2020-06-28T11:33:00.000+08:00",
      "expired": false,
      "created_at": "2019-08-20T06:51:27.292Z",
      "updated_at": "2019-08-20T06:51:27.292Z",
      "description": "videos",
      "share_name": "video-1.MP4",
      "creator": "c9b7a5aa04d14ae3867fdc886fa01da4",
      "status": "enabled",
      "preview_count": 10,
      "save_count": 2,
      "download_count": 5,
      "report_count": 0,
      "video_preview_count": 1,
      "access_count": 4,
      "disable_preview": false,
      "disable_save": false,
      "disable_download": false,
      "preview_limit": 100,
      "save_limit": 100,
      "download_limit": 100,
      "require_login": false,
      "share_all_files": true,
      "share_msg": ""
    }
  ],
  "next_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg"
}

Error codes

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