# 修改自定义过滤器 - UpdateCustomizedFilter #### 功能介绍 此接口用于新增自定义过滤器,同页面 测试 -\> 测试用例 -\> 右侧高级过滤 -\> 进行过滤条件筛选 -\> 右下角保存当前条件并过滤 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI PUT /v4/projects/{project_id}/filters/{filter_uri} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | filter_uri | 是 | String | 过滤器URI | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | 自定义过滤器名称 | | service_type | 是 | Integer | **参数解释**: 服务类型 **约束限制**: 不涉及 **取值范围**: - -1，全量用例。 - 0，手工测试。 - 1，接口自动化。 - 7，功能自动化。 - 8，WebUI自动化。 - 100，自定义自动化(工厂)。 - 11，性能自动化。 **默认取值**: 不涉及 | | stage_type | 是 | Integer | 阶段过程（2：测试设计，3：测试执行，4：质量报告） | | filter_content_info | 是 | [FilterContentInfo] object | 过滤信息 | 表3FilterContentInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | status | 否 | Array of strings | **参数解释**: 状态 **取值范围**: - -1，删除。 - 0，新建。 - 5，设计中。 - 6，测试中。 - 7，完成。 - -2，未设置。 **默认取值**: 不涉及 | | ranks | 否 | Array of strings | 级别 | | results | 否 | Array of strings | 结果 | | executors | 否 | Array of strings | 执行者 | | owner_ids | 否 | Array of strings | 处理者ID | | module_ids | 否 | Array of strings | 归属模块 | | issue_id | 否 | String | 需求编号 | | creator_ids | 否 | Array of strings | 创建者 | | release_ids | 否 | Array of strings | 归属迭代 | | start_time | 否 | String | 创建开始时间 | | end_time | 否 | String | 创建结束时间 | | is_dissociation_case | 否 | String | 是否关联需求 | | label_name_list | 否 | Array of strings | 标签 | | execute_start_time | 否 | String | 执行开始时间 | | execute_end_time | 否 | String | 执行结束时间 | | is_keyword | 否 | Array of strings | 关键字 | | test_types | 否 | Array of strings | 类型 | | custom_field_filter | 否 | Map\\> | 自定义字段过滤 | | review_status | 否 | Array of strings | **参数解释**: 用例评审状态 **取值范围**: - 0，未评审。 - 1，已评审。 **默认取值**: 不涉及 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | [CustomizedFilterVo] object | 请求返回的数据 | 表5CustomizedFilterVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | **参数解释** 自定义过滤器URI **取值范围** 不涉及 | | name | String | **参数解释** 自定义过滤器名称 **取值范围** 不涉及 | | filter | String | **参数解释** 过滤器内容 **取值范围** 不涉及 | | updator | String | **参数解释** 更新人 **取值范围** 不涉及 | | region | String | **参数解释** 逻辑Region **取值范围** 不涉及 | | service_type | Integer | **参数解释**: 服务类型 **取值范围**: - -1，全量用例。 - 0，手工测试。 - 1，接口自动化。 - 7，功能自动化。 - 8，WebUI自动化。 - 100，自定义自动化(工厂)。 - 11，性能自动化。 | | stage_type | Integer | **参数解释** 阶段过程 **取值范围** - 2，测试设计。 - 3，测试执行。 - 4，质量报告。 | | user_id | String | **参数解释** 用户ID **取值范围** 不涉及 | | creator | String | **参数解释** 创建人 **取值范围** 不涉及 | | create_time | String | **参数解释** 创建时间 **取值范围** 不涉及 | | create_time_timestamp | Long | **参数解释** 创建时间时间戳 **取值范围** 不涉及 | | update_time | String | **参数解释** 更新时间 **取值范围** 不涉及 | | update_time_timestamp | Long | **参数解释** 更新时间时间戳 **取值范围** 不涉及 | | project_uuid | String | **参数解释** 项目UUID **取值范围** 项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | **状态码：400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：401** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：404** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：500** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | #### 请求示例 ``` put https://{endpoint}/v4/projects/f3087a82b44744c29a1bd69ab6ada154/filters/1231 { "stage_type" : 2, "name" : "新过滤器", "service_type" : 0, "filter_content_info" : { "issue_id" : "23333as2" } } ``` #### 响应示例 **状态码：200** OK ``` { "value" : { "uri" : "v92u00010id84o7m", "name" : "新自定义字段", "service_type" : 0 } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。