AI 助理
文档备案控制台
官方文档
首页

ListFileUpload - 获取文件上传的列表

更新时间：
复制 MD 格式
产品详情
我的收藏

ListFileUpload

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

dms:ListFileUpload

list

*全部资源

*

 无 无

请求语法

POST  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值
DmsUnit

string

否

当前 DMS 单元

cn-hangzhou

SessionId

string

否

会话 ID

h8r********4fch
FileId

string

否

文件 ID

f-8*******01m

CallFrom

string

否

仅前端使用

仅前端使用
FileFrom

string

否

文件来源

Agent
FileCategory

string

否

文件种类

枚举值：

  • WebReport :

    网页报告

  • TextReport :

    文字报告

  • DefaultArtifact :

    默认产物

TextReport
SortColumn

string

否

排序列

枚举值：

  • gmtCreated :

    创建时间

gmtCreated
SortDirection

string

否

排列顺序

枚举值：

  • asc :

    升序

  • desc :

    降序

asc
DownloadLinkExpire

integer

否

下载链接有效时长（仅支持用户 OSS 上的文件），单位秒，默认 3600 秒

  • 最小时长：3600 秒（1 小时）

  • 最大时长：129600 秒（36 小时）

其他注意：

  • 内置 OSS（非用户 OSS）上的文件下载链接，有效期为 1 小时

  • 用户 OSS 上的文件下载链接，该参数才生效，有效期支持设置 1 小时~36 小时

3600

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

Id of the request

67E910F2-4B62-5B0C-ACA3-7547695C****
Success

boolean

是否调用成功，返回值如下：

  • true：请求成功。

  • false：请求失败。

true
ErrorCode

string

错误码

success
ErrorMessage

string

调用失败时，返回的错误信息

Specified parameter Tid is not valid.
Data

array<object>

返回的结构体

object

返回结果

FileId

string

文件 ID

f-8*******01m

FileName

string

文件名称

samele_report.md
FileType

string

文件类型，扩展名

md

FileSize

integer

文件大小，单位为字节

7453
UploadLocation

string

文件上传路径

data_agent/agent_file_upload/16738266********/4mynz********/samele_report.md
Region

string

地域

cn-hangzhou
AliyunUid

string

阿里云账户 ID

20372822********

AliyunParentUid

string

阿里云主账号 ID

16738266********
SessionId

string

会话 ID

h8r********4fch
FileFrom

string

文件来源

Agent
FileCategory

string

文件种类

枚举值：

  • WebReport :

    网页报告

  • TextReport :

    文字报告

  • DefaultArtifact :

    默认产物

TextReport
GmtCreated

string

创建时间

2025-12-11T14:04:32.000+00:00

示例

正常返回示例

JSON格式

{
  "RequestId": "67E910F2-4B62-5B0C-ACA3-7547695C****",
  "Success": true,
  "ErrorCode": "success",
  "ErrorMessage": "Specified parameter Tid is not valid.",
  "Data": [
    {
      "FileId": "f-8*******01m\n",
      "FileName": "samele_report.md",
      "FileType": "md\n",
      "FileSize": 7453,
      "UploadLocation": "data_agent/agent_file_upload/16738266********/4mynz********/samele_report.md",
      "DownloadLink": "https://********.oss-cn-hangzhou.aliyuncs.com/data_agent/agent_file_upload/1673866201******/6kaqhjd81agobeg7r********/sample_report.md?Expires=1765526467&OSSAccessKeyId=STS.NZP89ErN4A5BMuFMSovQjripY&Signature=eRjLGooo1EQvDyMphUS%2FQH5nt38%3D&response-content-disposition=attachment&security-token=CAIS6wN1q6Ft5B2yfSjIr5nlc4Pxn5EV9vepT1P3qVM6et5Gnazbuzz2IHhMdXlrCOgYt%2F8xnG1V6f8flrJ%2FToQAX0HfatZq5ZkS9AqnaoXM%2Fte496IFg5D92d4278egjqHoeOzcYI733Z7PAgm2N0YRrJL%2BcTK9JRPHVbSClZ9gaPkOQwC8dkAoLdxKJwxk2qh4UHzKLqSCPwLNiGjdB1YSRGMe71ly8qOi2MaRxwPDhVnhsI8vqp%2F2P4KvYrt%2BXod2WMzn2%2FdtJOiTknxc7gMP%2BK5qhelN9jrBopSFGV5dphyedvHT78FvIQZieu1jXKJNsPHLnPJ1vPCUnov6zQp6M%2BBRXhPCXISnyceDQb32bYZjK%2BimYy2QiInRaN6l7Bl6YnsCbQpUccM%2BMHJ%2FDhYsSD3IJbenvxLoGl77E%2FXdifxvjMcllA62o4uwSgLRE%2BnD40ExIYQhak4kDRkS0FH6f7UOGw42KAs%2FVubOHN0tNUsA8f614lSPTF5pynBGovvyYujOoKcUZJ7kX5RJ3YMBbY5Bt2Y6mutDnA5aJC3%2BHUkSotY%2BuMGFUffXY488UCSQqje%2BPfruvExMcBH%2FrSCUqLWZ0UGeHSXbkINxMi0cPU0dPmqR4erXLz22Z%2Br%2FEqmG17cNuMM2n2RioYeLOhqAAXurgCh5hs3XZ3n42rAf5nUhbzmxvSEozjif16B9zOwNlEH5LvhHfJ95roMLxAAeOW95A0mhbPco%2Fas3aqZv3lWCrmYuU6sGoioo86ezXyDrFD44YdkxC%2BP0yAQ2xi7tErXAyqbfJ4y40b2a0blRmu%2FI4s3jcLyLnUSNx3f9bXjCIAA%3D",
      "IntranetDownloadLink": "https://********.oss-cn-hangzhou-internal.aliyuncs.com/data_agent/agent_file_upload/1673866201******/6kaqhjd81agobeg7r********/sample_report.md?Expires=1765526467&OSSAccessKeyId=STS.NZP89ErN4A5BMuFMSovQjripY&Signature=eRjLGooo1EQvDyMphUS%2FQH5nt38%3D&response-content-disposition=attachment&security-token=CAIS6wN1q6Ft5B2yfSjIr5nlc4Pxn5EV9vepT1P3qVM6et5Gnazbuzz2IHhMdXlrCOgYt%2F8xnG1V6f8flrJ%2FToQAX0HfatZq5ZkS9AqnaoXM%2Fte496IFg5D92d4278egjqHoeOzcYI733Z7PAgm2N0YRrJL%2BcTK9JRPHVbSClZ9gaPkOQwC8dkAoLdxKJwxk2qh4UHzKLqSCPwLNiGjdB1YSRGMe71ly8qOi2MaRxwPDhVnhsI8vqp%2F2P4KvYrt%2BXod2WMzn2%2FdtJOiTknxc7gMP%2BK5qhelN9jrBopSFGV5dphyedvHT78FvIQZieu1jXKJNsPHLnPJ1vPCUnov6zQp6M%2BBRXhPCXISnyceDQb32bYZjK%2BimYy2QiInRaN6l7Bl6YnsCbQpUccM%2BMHJ%2FDhYsSD3IJbenvxLoGl77E%2FXdifxvjMcllA62o4uwSgLRE%2BnD40ExIYQhak4kDRkS0FH6f7UOGw42KAs%2FVubOHN0tNUsA8f614lSPTF5pynBGovvyYujOoKcUZJ7kX5RJ3YMBbY5Bt2Y6mutDnA5aJC3%2BHUkSotY%2BuMGFUffXY488UCSQqje%2BPfruvExMcBH%2FrSCUqLWZ0UGeHSXbkINxMi0cPU0dPmqR4erXLz22Z%2Br%2FEqmG17cNuMM2n2RioYeLOhqAAXurgCh5hs3XZ3n42rAf5nUhbzmxvSEozjif16B9zOwNlEH5LvhHfJ95roMLxAAeOW95A0mhbPco%2Fas3aqZv3lWCrmYuU6sGoioo86ezXyDrFD44YdkxC%2BP0yAQ2xi7tErXAyqbfJ4y40b2a0blRmu%2FI4s3jcLyLnUSNx3f9bXjCIAA%3D",
      "Region": "cn-hangzhou",
      "AliyunUid": "20372822********\n",
      "AliyunParentUid": "16738266********",
      "SessionId": "h8r********4fch",
      "FileFrom": "Agent",
      "FileCategory": "TextReport",
      "GmtCreated": "2025-12-11T14:04:32.000+00:00"
    }
  ]
}

错误码

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

变更历史

更多信息，参考变更详情。

上一篇：ListDocuments - 查询文档列表下一篇：ListKnowledgeBases - 获取知识库的列表