文件传输检索

最近更新时间: 2026-09-17 00:00:19

1. 接口描述

接口请求域名： bhsaas.api3.fincloud.tencent.cn。

文件传输检索

默认接口请求频率限制：20次/秒。

接口更新时间：2023-09-05 03:35:41。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：SearchFile
Version	是	否	String	公共参数，本接口取值：2019-10-18
Region	是	否	String	公共参数，地域信息本接口不需要传递此参数。
StartTime	是	否	Datetime_iso	查询开始时间示例值： 2020-01-03T01:01:01Z
EndTime	否	否	Datetime_iso	查询结束时间示例值： 2020-01-04T01:01:01Z
UserName	否	否	String	用户名示例值： Daniel
RealName	否	否	String	姓名示例值：张三
InstanceId	否	否	String	资产ID 示例值： ins-wesdeww
DeviceName	否	否	String	资产名称示例值：开发机
PublicIp	否	否	String	资产公网IP 示例值： 100.100.100.100
PrivateIp	否	否	String	资产内网IP 示例值： 192.168.1.100
Method	否	否	Array of Uint64	操作类型：1 - 文件上传，2 - 文件下载，3 - 文件删除，4 - 文件(夹)移动，5 - 文件(夹)重命名，6 - 新建文件夹，9 - 删除文件夹示例值： 1
FileName	否	否	String	可填写路径名或文件（夹）名示例值： 1.txt
AuditAction	否	否	Array of Uint64	1-已执行， 2-被阻断示例值： 1
Limit	否	否	Uint64	分页的页内记录数，默认为20，最大200 示例值： 10
Offset	否	否	Uint64	分页偏移位置，默认值为0 示例值： 0

3. 输出参数

参数名称	类型	描述
TotalCount	Uint64	记录数示例值： 20
Files	Array of SearchFileResult	文件操作列表示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InvalidParameter	参数错误。
InternalError	内部错误。
InvalidParameterValue	参数取值错误。

5. 示例

示例1 搜索session列表

搜索session列表

输入示例

POST / HTTP/1.1
Host: dasb.platformcloudapi.com
Content-Type: application/json
X-TC-Action: SearchFile
<公共请求参数>

{
    "UserName": "al", 
    "DeviceName": "al", 
    "RealName": "al", 
    "PrivateIp": "al", 
    "InstanceId": "al", 
    "AuditAction": [
        0
    ], 
    "FileName": "al", 
    "PublicIp": "al", 
    "Limit": 1, 
    "StartTime": "2020-09-22T00:00:00+00:00", 
    "Offset": 1, 
    "EndTime": "2020-09-22T00:00:00+00:00", 
    "Method": [
        1
    ]
}

输出示例

{
    "Response": {
        "Files": [
            {
                "UserName": "xx", 
                "DeviceName": "xx", 
                "RealName": "xx", 
                "InstanceId": "xx", 
                "PrivateIp": "xx", 
                "PublicIp": "xx", 
                "Time": "xx", 
                "Action": 1, 
                "Method": 1, 
                "FileName": "xx"
            }
        ], 
        "TotalCount": 1, 
        "RequestId": "xx"
    }
}