查询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 |
错误码
请参见错误码。