# 修改单个自定义报表 - updateReport #### 功能介绍 此接口用于修改自定义测试报表,同页面 测试 -\> 测试质量看板 -\> 右侧重点数据看板最下方 -\> 自定义测试报表 -\> 点击报表右上角三点 -\> 编辑报表 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI PUT /v4/{project_id}/versions/{version_uri}/custom-reports/{report_uri} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | version_uri | 是 | String | 版本uri | | report_uri | 是 | String | 报表uri | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | **参数解释** 报表名称 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | type | 是 | Integer | **参数解释** 报表类型 **约束限制** 不涉及 **取值范围** 1：首页用例库， 2：质量报告 **默认取值** 不涉及 | | workpiece_type | 是 | String | **参数解释** 工件类型 **约束限制** 不涉及 **取值范围** (用例：case,测试套：suite) **默认取值** 不涉及 | | analysis_dim_row | 是 | String | **参数解释** 分析维度 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | compare_dim_column | 是 | String | **参数解释** 对比维度 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | filter | 是 | [ReportFilter] object | **参数解释** 过滤条件 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | 表3ReportFilter | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | creatorIds | 否 | String | **参数解释** 创建人 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | ownerIds | 否 | String | **参数解释** 所属人 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | ranks | 否 | String | **参数解释** 级别 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | releaseIds | 否 | String | **参数解释** releaseId **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | status | 否 | String | **参数解释**: 状态 **取值范围**: - -1，删除。 - 0，新建。 - 5，设计中。 - 6，测试中。 - 7，完成。 - -2，未设置。 | | moduleIds | 否 | String | **参数解释** 级别 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | results | 否 | String | **参数解释** 结果 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | labelIds | 否 | String | **参数解释** 标签 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | startTime | 是 | String | **参数解释** 开始时间 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | endTime | 是 | String | **参数解释** 结束时间 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | isAssociateIssue | 否 | String | **参数解释** 是否关联需求 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | | featureUris | 是 | String | **参数解释** 目录uris **约束限制** 不涉及 **取值范围** 大小限制1000内 **默认取值** 不涉及 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | String | **参数解释** 请求返回的数据 **取值范围** 不涉及 | | status | String | **参数解释**: 调用此接口的响应状态。 **取值范围**: - success，表示接口调用成功。 - failed，表示接口调用失败。 | **状态码：400** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：401** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：404** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：500** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | #### 请求示例 ``` put https://{endpoint}/v4/projects/f3087a82b44744c29a1bd69ab6ada154/versions/2dopbu6aaf/custom-reports/121354 { "type" : "2", "workpiece_type" : "case", "analysis_dim_row" : "CREATORID", "name" : "自定义报表test801", "compare_dim_column" : "STATUS", "filter" : { "startTime" : "2020-09-08 10:42:07", "endTime" : "2020-09-08 10:42:07", "featureUris" : "vsdvs46846vas" } } ``` #### 响应示例 **状态码：200** OK ``` { "value" : "v90200010s29f79t" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。