---
title: 上报文件访问信息
description: "向可信状态系统上报文件访问记录。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengcctrustzone/tee/kdcl/kdcl_kfzn_033.html
sourcePath: /source/zh/kunpengcctrustzone/tee/kdcl/kdcl_kfzn_033.html
indexId: 28271410c0d2d9ff929f001f77e3255e88cdc44fdfe96189e5d7cb1496340cad57
---
# 上报文件访问信息

向可信状态系统上报文件访问记录。

| 项目 | 内容 |
| --- | --- |
| 接口路径 | /rest/kdc\_agent/v1/proxy |
| 请求方法 | POST |
| 内容描述 | 该接口由网管实现，{PREFIX}前缀由网管定义，通过Customize定制将{PREFIX}/v1配置给TrustRuntime |


#### 请求头（Request Header）

| 参数 | 取值 |
| --- | --- |
| Content\-Type | application/json |
| Accept | application/json |


#### 请求体（Request Body）

| 参数 | 参数类型 | 规格 | 是否必选 | 描述 |
| --- | --- | --- | --- | --- |
| taskId | String | 64 | 是 | 任务ID，每次请求不能使用相同ID |
| version | String | 8 | 是 | payload格式版本号，定义为VR格式，初始设置为26.0 |
| msgType | Int | 32 | 是 | 业务消息类型，值为34 |
| data | Object | \- | 是 | 业务消息实体，key:value格式 |
| data.filename | String | 256 | 是 | 文件名 |
| data.timestamp | UInt64 | 64 | 否 | 文件访问时间戳（毫秒） |


#### 请求体示例

```
{
"taskId": "SDFMOASDMNFIOASMD",
"version": "26.0",
"msgType": 34,
"data": {
"filename": "file1",
"timestamp": 1774615888000
}
}
```


#### 响应头（Response Header）

| 参数 | 取值 |
| --- | --- |
| Content\-Type | application/json |


#### 响应体（Response Body）

| 参数 | 参数类型 | 规格 | 是否必选 | 描述 |
| --- | --- | --- | --- | --- |
| retCode | Int | 32 | 是 | 错误码 |
| retMsg | String | 64 | 是 | 错误消息 |
| data | Object | \- | 否 | 业务自定义 |


#### 响应体示例

```
{
"retCode": 0,
"retMsg": "Success"
}
```


#### 返回错误码

| 错误码 | 描述 |
| --- | --- |
| 0 | 成功 |
| 200 | 锚点无效 |
| 201 | 文件计数超出限制 |
| 202 | 数据库操作失败 |
| 203 | 数据被篡改 |
| 204 | 数据库未找到 |
| 205 | 检测到回滚 |