ListFile_大模型服务平台百炼_API文档-阿里云OpenAPI开发者门户

接口说明

RAM 用户（子账号）需要首先获取百炼的数据权限（需要AliyunBailianDataFullAccess，已包括 sfm:ListFile 权限点），然后才能调用本接口，详见为 RAM 用户授予数据权限。阿里云账号（主账号）可直接调用无须授权。建议您通过最新版百炼 SDK来调用本接口。
分页查询首页时，仅需设置MaxResults以限制返回信息的条目数，返回结果中的NextToken将作为查询后续页的凭证。查询后续页时，将NextToken参数设置为上一次返回结果中获取到的NextToken作为查询凭证（如果NextToken为空，表示结果已经完全返回，不需要再请求），并设置MaxResults限制返回条目数。
本接口具有幂等性。

限流说明： 本接口频繁调用会被限流，频率请勿超过 5 次/秒。如遇限流，请稍后重试。

当前云产品API请求速率暂未透出。

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

sfm:ListFile	List	全部资源 *	无	无

GET /{WorkspaceId}/datacenter/files HTTP/1.1

字段名称	字段详情
WorkspaceIdstring	类目所属的业务空间 ID。获取方式请参见如何使用业务空间。示例值:llm-3shx2gu255oqxxxx

字段名称	字段详情
CategoryIdstring	类目 ID，即 AddCategory 接口返回的`CategoryId`。您也可以在应用数据-非结构化数据页签，单击类目名称旁的 ID 图标获取。示例值:cate_cdd11b1b79a74e8bbd675c356a91ee35xxxxxxxx
NextTokenstring	查询凭证（Token），取值为上一次 API 调用返回的 NextToken 参数值。示例值:AAAAAdH70eOCSCKtacdomNzak4U=
MaxResultsinteger<int32>	分页查询时每页行数。取值范围[1-200]。展开详情示例值:20
FileNamestring	文件名称（不含后缀），仅支持按照文件名精准查找，不支持模糊搜索。示例值:测试文件名参考取值来源: DescribeFile

字段名称	字段详情
Codestring	错误状态码。示例值:success
Dataobject	接口业务数据字段。
Messagestring	错误信息。示例值:Requests throttling triggered.
RequestIdstring	请求 ID。示例值:8F97A63B-xxxx-527F-9D6E-467B6A7E8CF1
Statusstring	接口返回的状态码。示例值:200
Successboolean	接口调用是否成功，可能值为：展开详情示例值:true

	变更时间	变更内容概要	操作
	2024-10-15	新增请求参数FileName
	2024-09-18	变更返回参数