查询RR历史记录
功能介绍
查询RR的历史记录。
调用方法
请参见如何调用API。
URI
GET /v4/rrs/{rr_id}/histories
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
rr_id |
是 |
String |
参数解释: RR的id。可以通过查询工作项列表接口获取,请求参数的issue_type为RR的时候,响应消息体中的issues.id字段的值就是rr_id。 约束限制: 正则表达式:[0-9]*。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
offset |
是 |
Integer |
参数解释: 分页索引,偏移量,offset是limit的整数倍数。 约束限制: 从0开始。 取值范围: 最小值:0,最大值:10000。 默认取值: 缺省值:0 |
|
limit |
是 |
Integer |
参数解释: 条数,每页显示查询的数量。 约束限制: 不涉及。 取值范围: 最小值:1,最大值:1000。 默认取值: 10 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 必传。 取值范围: 最小长度:10,最大长度:32768。 默认取值: 不涉及。 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
histories |
RrHistory object |
参数解释: RR的历史记录。 |
|
total |
Integer |
参数解释: 总数。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
created_time |
Long |
参数解释: 变更RR的时间。 取值范围: 时间戳。 |
|
details |
Array of IrRecordDetail objects |
参数解释: 详细操作(该字段为包含0个或1个元素的数组,包含元素时,其内容表示对某个字段的操作) |
|
operation_type |
String |
参数解释: 操作类型。 取值范围: 不涉及。 |
|
operator |
RrUser object |
参数解释: 变更RR的用户信息。 |
|
rr_id |
String |
参数解释: 历史记录所属RR的id。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
field_id |
String |
参数解释: 操作的字段id。 取值范围: 不涉及。 |
|
field_label |
String |
参数解释: 字段名称。 取值范围: 不涉及。 |
|
new_value |
String |
参数解释: 修改后的值。 取值范围: 不涉及。 |
|
old_value |
String |
参数解释: 修改前的值。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
domain_id |
String |
参数解释: 租户uuid。 取值范围: 不涉及。 |
|
domain_name |
String |
参数解释: 租户名。 取值范围: 不涉及。 |
|
nick_name |
String |
参数解释: 昵称。 取值范围: 不涉及。 |
|
user_id |
String |
参数解释: 用户uuid。 取值范围: 不涉及。 |
|
user_name |
String |
参数解释: 用户名。 取值范围: 不涉及。 |
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误描述 |
状态码:401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
错误码
请参见错误码。