datai/docs/archive/api-docs/setting/DataiConfigAuditLogController/0005-edit-log.md

接口文档

接口信息

• 接口名称: 修改配置审计日志
• 接口路径: /setting/log
• 请求方法: PUT
• 模块归属: datai-salesforce-setting
• 版本号: v1.0
• 创建日期: 2026-01-14
• 最后更新: 2026-01-14

功能描述

修改配置审计日志记录。通常此接口用于修正审计日志中的错误信息或补充缺失的信息。

请求参数

请求体 (JSON)

{
  "id": 1,
  "deptId": 1,
  "operationType": "UPDATE",
  "objectType": "CONFIGURATION",
  "objectId": 100,
  "oldValue": "{\"apiVersion\":\"59.0\"}",
  "newValue": "{\"apiVersion\":\"60.0\"}",
  "operationDesc": "更新API版本",
  "operator": "admin",
  "operationTime": "2026-01-14 10:30:00",
  "ipAddress": "192.168.1.100",
  "userAgent": "Mozilla/5.0...",
  "requestId": "req_123456789",
  "result": "SUCCESS",
  "errorMessage": null,
  "orgType": "source"
}

参数名	类型	必填	描述	示例
id	Long	是	日志ID	1
deptId	Long	否	部门ID	1
operationType	String	否	操作类型（CREATE/UPDATE/DELETE）	UPDATE
objectType	String	否	对象类型（CONFIGURATION/ENVIRONMENT/SNAPSHOT等）	CONFIGURATION
objectId	Long	否	对象ID	100
oldValue	String	否	旧值（JSON格式）	{"apiVersion":"59.0"}
newValue	String	否	新值（JSON格式）	{"apiVersion":"60.0"}
operationDesc	String	否	操作描述	更新API版本
operator	String	否	操作人	admin
operationTime	String	否	操作时间	2026-01-14 10:30:00
ipAddress	String	否	IP地址	192.168.1.100
userAgent	String	否	用户代理	Mozilla/5.0...
requestId	String	否	请求ID	req_123456789
result	String	否	操作结果（SUCCESS/FAILED）	SUCCESS
errorMessage	String	否	错误信息	null
orgType	String	否	ORG类型（source/target）	source

响应数据

成功响应

HTTP 状态码: 200 OK

{
  "code": 200,
  "msg": "操作成功",
  "data": 1
}

字段名	类型	描述	示例
code	Integer	响应码	200
msg	String	响应消息	操作成功
data	Integer	影响的行数（修改成功的记录数）	1

失败响应

HTTP 状态码: 400/401/403/404/500

{
  "code": 404,
  "msg": "审计日志不存在",
  "data": null
}

错误码	错误信息	描述
400	参数错误	参数验证失败
401	您没有权限执行此操作	权限不足
403	访问被拒绝	访问被拒绝
404	审计日志不存在	指定的日志ID不存在
500	系统错误	系统内部错误

接口示例

请求示例

curl -X PUT "http://localhost:8080/setting/log" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer [token]" \
  -d '{
    "id": 1,
    "operationDesc": "更新API版本从59.0到60.0",
    "result": "SUCCESS",
    "orgType": "source"
  }'

响应示例

成功:

{
  "code": 200,
  "msg": "操作成功",
  "data": 1
}

失败:

{
  "code": 404,
  "msg": "审计日志不存在",
  "data": null
}

错误处理

1. 权限验证失败: 检查用户是否具有 setting:log:edit 权限
2. 参数验证失败: 检查请求参数是否有效
3. 数据不存在: 检查指定的日志ID是否存在
4. 系统错误: 记录错误日志并返回通用错误信息

注意事项

1. 接口需要登录认证，需要携带有效的 token
2. 接口需要 setting:log:edit 权限
3. id 字段为必填项，用于指定要修改的日志记录
4. 通常只修改部分字段，不需要提供所有字段
5. 修改操作会记录到操作日志中
6. 审计日志的修改应该谨慎进行，确保数据的准确性

相关接口

• 查询配置审计日志列表 - 查询配置审计日志列表
• 获取配置审计日志详细信息 - 获取单条审计日志的详细信息
• 新增配置审计日志 - 新增配置审计日志

实现细节

1. 接收请求参数，转换为 DataiConfigAuditLog 对象
2. 调用 IDataiConfigAuditLogService 更新日志记录
3. 返回操作结果

测试信息

测试环境

• 环境: 本地开发环境
• 版本: v1.0

测试用例

测试场景	输入参数	预期结果	实际结果	状态
修改存在的日志	id=1, operationDesc=新描述	返回成功，data=1	返回成功，data=1	通过
修改不存在的日志	id=9999	返回404错误	返回404错误	通过
缺少ID参数	无id	返回参数错误	返回参数错误	通过
无权限访问	无权限token	返回401错误	返回401错误	通过