查询RR历史记录 - ShowRrHistory

功能介绍

查询RR的历史记录。

调用方法

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
codeartsreq:rawRequirement:get	Read	-	codeartsreq:Model codeartsreq:ProjectId	-	-

URI

GET /v4/rrs/{rr_id}/histories

表1 路径参数
参数	是否必选	参数类型	描述
rr_id	是	String	参数解释： 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

{
  "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
}