更新时间:2025-07-28 GMT+08:00
分享

查询RR历史记录

功能介绍

查询RR的历史记录。

调用方法

请参见如何调用API

URI

GET /v4/rrs/{rr_id}/histories

表1 路径参数

参数

是否必选

参数类型

描述

rr_id

String

参数解释:

RR的id。可以通过查询工作项列表接口获取,请求参数的issue_type为RR的时候,响应消息体中的issues.id字段的值就是rr_id。

约束限制:

正则表达式:[0-9]*。

取值范围:

不涉及。

默认取值:

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

参数解释:

分页索引,偏移量,offset是limit的整数倍数。

约束限制:

从0开始。

取值范围:

最小值:0,最大值:10000。

默认取值:

缺省值:0

limit

Integer

参数解释:

条数,每页显示查询的数量。

约束限制:

不涉及。

取值范围:

最小值:1,最大值:1000。

默认取值:

10

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

必传。

取值范围:

最小长度:10,最大长度:32768。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

histories

RrHistory object

参数解释:

RR的历史记录。

total

Integer

参数解释:

总数。

取值范围:

不涉及。

表5 RrHistory

参数

参数类型

描述

created_time

Long

参数解释:

变更RR的时间。

取值范围:

时间戳。

details

Array of IrRecordDetail objects

参数解释:

详细操作(该字段为包含0个或1个元素的数组,包含元素时,其内容表示对某个字段的操作)

operation_type

String

参数解释:

操作类型。

取值范围:

不涉及。

operator

RrUser object

参数解释:

变更RR的用户信息。

rr_id

String

参数解释:

历史记录所属RR的id。

取值范围:

不涉及。

表6 IrRecordDetail

参数

参数类型

描述

field_id

String

参数解释:

操作的字段id。

取值范围:

不涉及。

field_label

String

参数解释:

字段名称。

取值范围:

不涉及。

new_value

String

参数解释:

修改后的值。

取值范围:

不涉及。

old_value

String

参数解释:

修改前的值。

取值范围:

不涉及。

表7 RrUser

参数

参数类型

描述

domain_id

String

参数解释:

租户uuid。

取值范围:

不涉及。

domain_name

String

参数解释:

租户名。

取值范围:

不涉及。

nick_name

String

参数解释:

昵称。

取值范围:

不涉及。

user_id

String

参数解释:

用户uuid。

取值范围:

不涉及。

user_name

String

参数解释:

用户名。

取值范围:

不涉及。

状态码:400

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

状态码:401

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

GET /v4/rrs/4647058403938004992/histories

响应示例

状态码:200

OK

{
  "histories" : [ {
    "created_time" : 16860576000000,
    "details" : [ {
      "field_id" : "rr_name",
      "field_label" : "RR名称",
      "old_value" : "旧名称",
      "new_value" : "新名称"
    } ],
    "operation_type" : "update",
    "operator" : {
      "domain_id" : "d4c2a1b3-8f5e-4c1a-9b2c-7a3d4e5f6g7h",
      "domain_name" : "租户A",
      "nick_name" : "admin_user",
      "user_id" : "u1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6",
      "user_name" : "admin"
    },
    "rr_id" : "4647058403938004992"
  } ],
  "total" : 5
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

错误码

请参见错误码

相关文档