调用ListCdsFiles查询云盘文件获取文件下载链接_无影云电脑(WUYING Workspace)-阿里云帮助中心

查询网盘中的文件列表，以及获取文件的下载链接。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
EndUserId	string	否	分配了网盘的用户 ID。	alice
GroupId	string	否	团队空间 ID。	cg-i1ruuudp92qpj****
CdsId	string	是	企业网盘 ID。	cn-hangzhou+cds-320357****
ParentFileId	string	否	父文件 ID。可通过本接口的返回参数`FileId`获取。	63636837e47e5a24a8a940218bef395c210e****
FileIds	array	否	需要查询的文件 ID 列表。
	string	否	需要查询的文件 ID。	[\"635d3c12f70beed7b6f84a9bb7bd51aad910****\"]
OrderType	string	否	文件列表排序方式。枚举值： CreateTimeDesc：按创建时间降序排序。 ModifiedTimeAsc：按修改时间升序排序。 NameDesc：按文件名称降序排序。 SizeAsc：按文件大小升序排序。 ModifiedTimeDesc：按修改时间降序排序。 CreateTimeAsc：按创建时间升序排序。 SizeDesc：按文件大小降序排序。 NameAsc：按文件名称升序排序。	CreateTimeDesc
Status	string	否	文件状态。枚举值： available：只返回正常文件。 uploading：只返回上传中的文件。	available
NextToken	string	否	查询凭证（Token）。取值为上一次调用该接口返回的`NextToken`参数值，初次调用接口时无需设置该参数。	aGN4YzAxQGNuLWhhbmd6aG91LjExNzU5NTMyNjgzMTQ1****
MaxResults	integer	否	分页查询时，每页最大行数。默认值：100。	100
RegionId	string	否	登录的地域 ID。可以调用 DescribeRegions 获取无影云电脑支持的地域列表。	cn-hangzhou

返回参数

名称	类型	描述	示例值
	object
NextToken	string	下一个查询开始的 Token，`NextToken`为空表示没有下一个。	aGN4YzAxQGNuLWhhbmd6aG91LjExNzU5NTMyNjgzMTQ1****
RequestId	string	请求 ID。	40D86754-20FD-53DC-A9B8-25F7FECC****
Count	string	文件列表条目总数量。	2
Code	string	执行结果。返回`success`表示成功，否则将返回错误信息。	success
Message	string	错误信息。当 Code 为`success`时，不返回该参数。	success
Success	boolean	操作是否成功。枚举值： true：成功。 false：失败。	true
FileModels	object []	文件列表。
ContentType	string	文件内容类型。	application/json
FileType	string	文件类型。枚举值： file：文件。 folder：文件夹。	file
FileExtension	string	文件的后缀名。	pdf
FileId	string	文件 ID。	637725ff2f63db8470984e6c92c692b87d52****
Creator	string	文件的创建者。	demo_user01@cn-shanghai.148875033399****
OpenTime	string	最近一次打开文件的时间。	2022-09-06T07:27:08Z
ParentId	string	父文件夹 ID。	3343213ff2f63db8470984e6c92c3213dfdw****
Modifier	string	修改者。	demo_user02@cn-shanghai.148875033399****
Description	string	文件描述。	test1
Name	string	文件名称。	SampleFile.pdf
DownloadUrl	string	下载链接，默认有效时间是 15 分钟。	https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899ef****?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx
Sha1	string	数据文件的 SHA1 哈希值。	EA4942AA8761213890A5C386F88E6464D2C3****
OpenTimeStamp	long	最后一次打开文件的时间戳。	168951245231
RegionId	string	地域 ID。可以调用 DescribeRegions 获取无影云电脑支持的地域列表。	cn-beijing
FilePath	string	文件路径。	isv/1019236948660053/temp/
Size	long	文件大小。单位：Byte（字节）。	102400
Category	string	文件类型分类。网盘会根据文件的后缀名和 MIME Type 对文件进行分了分类，主要分类有`doc`、`image`、`audio`、`video`。	image
Md5	string	文件 MD5 值。	63c83ececb4e6926c51448fc5ecb****
Thumbnail	string	缩略图地址。	https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899ef****?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx
CreateTime	string	创建时间。	2022-09-06T07:27:08Z
ModifiedTime	string	最后一次修改文件的时间。	2022-09-06T07:27:08Z

示例

正常返回示例

JSON格式

{
  "NextToken": "aGN4YzAxQGNuLWhhbmd6aG91LjExNzU5NTMyNjgzMTQ1****\n",
  "RequestId": "40D86754-20FD-53DC-A9B8-25F7FECC****",
  "Count": "2",
  "Code": "success",
  "Message": "success",
  "Success": true,
  "FileModels": [
    {
      "ContentType": "application/json",
      "FileType": "file",
      "FileExtension": "pdf",
      "FileId": "637725ff2f63db8470984e6c92c692b87d52****",
      "Creator": "demo_user01@cn-shanghai.148875033399****",
      "OpenTime": "2022-09-06T07:27:08Z",
      "ParentId": "3343213ff2f63db8470984e6c92c3213dfdw****\n",
      "Modifier": "demo_user02@cn-shanghai.148875033399****",
      "Description": "test1",
      "Name": "SampleFile.pdf",
      "DownloadUrl": "https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899ef****?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx",
      "Sha1": "EA4942AA8761213890A5C386F88E6464D2C3****",
      "OpenTimeStamp": 168951245231,
      "RegionId": "cn-beijing",
      "FilePath": "isv/1019236948660053/temp/",
      "Size": 102400,
      "Category": "image",
      "Md5": "63c83ececb4e6926c51448fc5ecb****",
      "Thumbnail": "https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899ef****?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx",
      "CreateTime": "2022-09-06T07:27:08Z",
      "ModifiedTime": "2022-09-06T07:27:08Z"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间

变更内容概要

操作

2023-08-29

OpenAPI 入参发生变更

看变更集

变更项	变更内容
入参	OpenAPI 入参发生变更。
	新增入参：GroupId

2023-05-16

API 内部配置变更，不影响调用

看变更集

变更项	变更内容
	API 内部配置变更，不影响调用。