# 获取资源修改历史记录 - ShowResourceHistories #### 功能介绍 此接口用于获取资源修改历史记录，同页面 测试 -\> 测试用例 -\> 右侧展示用例列表，点击用例，进入用例详情页 -\> 点击任务栏的操作历史，下方展示历史记录 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/resources/{resource_uri}/histories/batch-query 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | resource_uri | 是 | String | 资源uri | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 必传。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 不涉及。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | conditions | 否 | Array of [SearchCondition] objects | 搜索条件 | | type | 否 | String | 资源类型 | | useOffset | 否 | Boolean | 是否使用offset分页 | | project_uuid | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | version_uri | 是 | String | 分支/迭代uri | | page_no | 否 | Integer | 页码 | | page_size | 是 | Integer | 每页展示条数 | 表4SearchCondition | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | field_name | 否 | String | 字段名 | | field_value | 否 | String | 字段值 | | operator | 否 | String | 数据库字段操作 | | sour_value | 否 | String | 源值 | | tar_value | 否 | String | 目标值 | | field_type | 否 | String | **参数解释**: 字段类型 **约束限制**: 不涉及 **取值范围**: - richText，富文本。 - text，单行文本。 - textArea，多行文本。 - radio，单选框。 - checkBox，多选框。 - date，日期时间。 - onlyDate，日期。 - date，日期时间。 - number，数字（整数）。 - double，数字（小数）。 - checkBoxUser，多选用户。 - user，单选用户。 **默认取值**: 不涉及 | #### 响应参数 **状态码：200** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | **参数解释** 总数 **取值范围** 不小于1的正整数 | | page_no | Integer | **参数解释** 分页编码 **取值范围** 大于0且小于100的正整数 | | page_size | Integer | **参数解释** 分页大小 **取值范围** 大于零且小于20000的正整数 | | value | Array of [ResourceHistoryVo] objects | 请求返回的数据 | 表6ResourceHistoryVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | 资源历史记录Uri | | author | String | 资源历史记录创建人 | | region | String | 逻辑region | | changes | Array of [ResourceChangeVo] objects | 资源历史记录字段变更列表 | | resource_uri | String | 资源uri | | resource_type | String | 资源类型 | | version_uri | String | 分支/迭代uri | | creation_date | String | 创建时间 | | create_date_timestamp | Long | 创建时间时间戳 | | author_name | String | 创建人名称 | | not_empty | Boolean | 非空 | | project_id | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | 表7ResourceChangeVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | only_new_value | Boolean | 只展示新值 | | field_name | String | 变更字段 | | old_value | String | 旧值 | | old_tracker_name | String | 旧工作项类型 | | new_tracker_name | String | 新工作项类型 | | new_value | String | 新值 | | old_key | String | 原key | | new_key | String | 新key | | old_object_value | Object | 旧对象值 | | new_object_value | Object | 新对象值 | | old_object_key | Object | 新object key | | new_object_key | Object | 新object key | | old_tracker_names | Object | 旧tracker_names | | new_tracker_names | Object | 新旧tracker_names | | old_board_info | Array of [JSONObject] objects | 变更前归属看板信息，用例关联工作项信息使用 | | new_board_info | Array of [JSONObject] objects | 变更后归属看板信息，用例关联工作项信息使用 | | old_display_ids | Array of strings | 老值，用于前端展示。IPD和Xboard项目的需求和缺陷sequenceId列表，非IPD和Xboard项目的需求和缺陷Id列表。由于需求只能关联一个，所以需求取第一个值 | | new_display_ids | Array of strings | 新值，用于前端展示。IPD和Xboard项目的需求和缺陷sequenceId列表，非IPD和Xboard项目的需求和缺陷Id列表。由于需求只能关联一个，所以需求取第一个值 | | old_test_item_path_name | String | 变更前路径（目录名称路径） | | new_test_item_path_name | String | 变更后路径（目录名称路径） | | custom_field_type | String | 测试用例自定义字段类型 | 表8JSONObject | 参数 | 参数类型 | 描述 | |:---|:---|:---| | empty | Boolean | 是否为空 | | additionalProperties | Object | 变更后归属看板信息，用例关联工作项信息使用 | **状态码：400** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：401** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：404** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：500** 表12响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | #### 请求示例 获取资源修改历史记录 ``` post https://{endpoint}/v4/resources/v91j0000vq997opk/histories/batch-query { "page_no" : 1, "project_uuid" : "30649eb093c2479d92c74c75d36ef280", "version_uri" : "v91i0000vq98suq1", "page_size" : 10, "type" : "TestCase" } ``` #### 响应示例 **状态码：200** OK ``` { "total" : 2, "page_no" : 1, "page_size" : 10, "value" : [ { "uri" : "v9210000vrmhplil", "author" : "e8d27b5521a64fb28a8fd9c99cd66eb3", "region" : "cn-north-7", "changes" : [ { "field_name" : "defectId", "old_key" : "", "new_key" : "8444611", "new_object_value" : [ "用例3新建" ], "new_object_key" : [ "8444611" ], "new_tracker_names" : [ "Bug" ], "new_board_info" : [ ], "new_display_ids" : [ "8444611" ] } ], "resource_uri" : "v91j0000vq997opk", "resource_type" : "TestCase", "version_uri" : "v91i0000vq98suq1", "creation_date" : "2024-09-10 10:49:43", "create_date_timestamp" : 1725936583000, "author_name" : "xxx" }, { "uri" : "v91i0000vrmh72fb", "author" : "e8d27b5521a64fb28a8fd9c99cd66eb3", "region" : "cn-north-7", "changes" : [ { "field_name" : "svnScriptPath", "new_value" : "fail1.py" } ], "resource_uri" : "v91j0000vq997opk", "resource_type" : "TestCase", "version_uri" : "v91i0000vq98suq1", "creation_date" : "2024-09-10 10:39:34", "create_date_timestamp" : 1725935974000, "author_name" : "xxx" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。