# 根据工时id删除工时 - DeleteWorkHourOpenApi #### 功能介绍 根据工时id删除工时 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-projectman/projectman_api_1002.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-projectman/projectman_03_Permission.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | codeartsreq:workhour:delete | Write | - | - codeartsreq:Model - codeartsreq:ProjectId | - | - | #### URI DELETE /v1/projects/{project_id}/work-items/{issue_id}/work-hour/{workhour_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目32位ID，项目唯一标识。通过[查询IPD项目列表](https://support.huaweicloud.com/api-projectman/ShowIpdProjectList.html)获取，响应消息体中的**id**字段的值就是项目ID。 **约束限制**： 不涉及。 **取值范围**： 32个字符，由英文字母和数字组成。 **默认取值**： 不涉及。 | | issue_id | 是 | String | **参数解释**： 工作项唯一ID。可以通过[查询工作项列表](https://support.huaweicloud.com/api-projectman/ListIpdProjectIssues.html)或者[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**id**字段的值就是工作项ID。 **约束限制**： 不涉及。 **取值范围**： 18\~19个字符的数字字符串。 **默认取值**： 不涉及。 | | workhour_id | 是 | String | 工时id | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | status | String | **参数解释**： 响应状态。 **取值范围**： - success：创建工时成功 - error：创建工时失败 | | message | String | **参数解释**： 响应消息。当请求失败时返回失败原因。 **取值范围**： 0\~1000个字符。 | | result | [WorkHourTotalVO] object | **参数解释**： 工时信息列表及工时总数。 **取值范围**： 不涉及。 | 表3WorkHourTotalVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | data | Array of [WorkHourVO] objects | 工时信息列表 | | work_hours_total | String | 实际工时总数 | 表4WorkHourVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**： 工时记录ID。 **取值范围**： 18\~19个字符的数字字符串。 | | title | String | **参数解释**： 工时名称。 **取值范围**： 不涉及。 | | operation_id | String | **参数解释**： 操作ID，用于标识具体的操作记录。 **取值范围**： 不涉及。 | | description | String | **参数解释**： 工时工作内容描述。 **取值范围**： 最大10000个字符。 | | workitem_id | String | **参数解释**： 工时关联的工作项ID。可以通过[查询工作项列表](https://support.huaweicloud.com/api-projectman/ListIpdProjectIssues.html)或者[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**id**字段的值就是工作项ID。 **取值范围**： 18\~19个字符的数字字符串。 | | work_date | String | **参数解释**： 工时日期时间戳，单位：毫秒。 **取值范围**： 不涉及。 | | created_by | [UserEntity] object | **参数解释**： 工时记录创建人信息。 | | modified_by | [UserEntity] object | **参数解释**： 工时记录最后修改人信息。 | | work_hour_category | String | **参数解释**： 工时类型。页面展示取值为display_value，唯一标识取值为value。 **取值范围**： 不涉及。 | | work_hours | Double | **参数解释**： 花费工时，单位为"人天"。 **取值范围**： 不涉及。 | 表5UserEntity | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**： 用户ID，可通过[查询项目成员列表](https://support.huaweicloud.com/api-projectman/ListProjectUsers.html)接口获取，响应消息体中的**id**字段的值就是用户ID。 **取值范围**： 不涉及。 | | name | String | **参数解释**： 用户名称。 **取值范围**： 2\~64个字符。 | | nick_name | String | **参数解释**： 用户昵称。 **取值范围**： 2\~30个字符。 | **状态码：400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。 | | error_msg | String | **参数解释**： 错误描述，对error_code的补充解释。 **取值范围**： 不涉及。 | #### 请求示例 根据工时id删除工时 ``` DELETE https://{endpoint}/v1/projects/dbf92424384e46dd9829492abe533829/work-items/1038401818296492033/work-hour/1038556057215868930 ``` #### 响应示例 **状态码：200** 工时信息以及工时总和信息返回 ``` { "status" : "success", "message" : null, "result" : { "data" : [ { "id" : "1038556057215868930", "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "t" } } ], "work_hours_total" : 0 } } ``` **状态码：400** 请求失败的响应。例如无操作权限、项目不存在。 ``` { "error_code" : "PM.02174103", "error_msg" : "无操作权限" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 工时信息以及工时总和信息返回 | | 400 | 请求失败的响应。例如无操作权限、项目不存在。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。