# 获取子工作项 - ListChildIssueV4 #### 功能介绍 获取子工作项 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-projectman/projectman_api_1002.html)。 #### 授权信息 当前API调用无需身份策略权限。 #### URI GET /v4/projects/{project_id}/issues/{issue_id}/child 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目的32位UUID，项目唯一标识，通过[查询项目列表接口](https://support.huaweicloud.com/api-projectman/ListProjectsV4.html)获取，响应消息体中的**project_id**字段的值就是项目ID。 **约束限制**： 32个字符，由英文字母和数字组成。 **取值范围：** 不涉及。 **默认取值**： 不涉及。 | | issue_id | 是 | Integer | **参数解释：** 工作项ID，可通过[高级查询工作项](https://support.huaweicloud.com/api-projectman/ListIssuesV4.html)接口获取，响应消息体中的**id**字段的值就是工作项ID。 **约束限制：** 不涉及。 **取值范围：** ≥0。 **默认取值：** 不涉及。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 不涉及。 **取值范围：** 长度为10\~32768个字符。 **默认取值：** 不涉及。 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | issues | Array of [IssueResponseV4] objects | **参数解释：** 工作项列表。 | | total | Integer | **参数解释：** 总数。 **取值范围：** 不涉及。 | 表4IssueResponseV4 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | actual_work_hours | Double | **参数解释：** 实际工时 **取值范围：** ≥0。 | | assigned_cc_user | Array of [IssueUser] objects | **参数解释：** 抄送人 | | assigned_user | [IssueUser] object | **参数解释：** 处理人 | | begin_time | String | **参数解释：** 预计开始时间，日期格式：YYYY-MM-DD **取值范围：** 不涉及 | | closed_time | String | **参数解释：** 关闭时间，日期格式：YYYY-MM-DD **取值范围：** 不涉及 | | created_time | String | **参数解释：** 创建时间，日期格式：YYYY-MM-DD HH:MM:SS **取值范围：** 不涉及 | | creator | [IssueUser] object | **参数解释：** 创建人 | | custom_fields | Array of [CustomField] objects | **参数解释：** 自定义属性值，不建议使用，建议参考new_custom_fields字段 | | developer | [IssueUser] object | **参数解释：** 开发人员 | | domain | [domain] object | **参数解释：** 领域 | | done_ratio | Integer | **参数解释：** 工作项完成度 ，如20，表示完成度为20%。 **取值范围：** 0-100。 | | end_time | String | **参数解释：** 预计结束时间，日期格式：YYYY-MM-DD 。 **取值范围：** 不涉及 | | expected_work_hours | Double | **参数解释：** 预计工时。 **取值范围：** 最小值：0 | | id | Integer | **参数解释：** 工作项ID。 **取值范围：** ≥0。 | | iteration | [iteration] object | **参数解释：** 迭代。 | | module | [module] object | **参数解释：** 模块。 | | name | String | **参数解释：** 标题 **取值范围：** 不涉及 | | new_custom_fields | Array of [NewCustomField] objects | **参数解释：** 自定义属性值 | | parent_issue | [parent_issue] object | **参数解释：** 父工作项 | | priority | [priority] object | **参数解释：** 工作项优先级 | | project | [IssueProjectResponseV4] object | **参数解释：** 项目信息 | | severity | [severity] object | **参数解释：** 工作项重要程度 | | status | [status] object | **参数解释：** 工作项状态 | | tracker | [tracker] object | **参数解释：** 工作项类型 | | updated_time | String | **参数解释：** 更新时间，日期格式：YYYY-MM-DD HH:MM:SS **取值范围：** 不涉及 | | find_release_dev | String | **参数解释：** 发现版本号。 **取值范围：** 不涉及 | | release_dev | String | **参数解释：** 发布版本号。 **取值范围：** 不涉及 | | env | [IssueAttribute] object | **参数解释：** 发现环境。 **取值范围：** 不涉及 | | tag_list | Array of [TagRelation] objects | **参数解释：** 标签列表。 **取值范围：** 不涉及 | 表5IssueUser | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 用户ID。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 用户名。 **取值范围：** 不涉及。 | | nick_name | String | **参数解释：** 昵称。 **取值范围：** 不涉及。 | | user_id | String | **参数解释：** 用户UUID。 **取值范围：** 不涉及。 | | user_num_id | Integer | **参数解释：** 用户数字ID。 **取值范围：** 不涉及。 | | first_name | String | **参数解释：** 用户名。 **取值范围：** 不涉及。 | 表6CustomField | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 自定义属性名。 **取值范围：** 不涉及。 | | new_name | String | **参数解释：** 自定义属性名。 **取值范围：** 不涉及。 | | value | String | **参数解释：** 自定义属性对应的值。 **取值范围：** 不涉及。 | 表7domain | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 领域id，枚举： 14（性能） 15（功能） 16（可靠性） 17（网络安全） 18（可维护性） 19（其他DFX） 20（可用性） **取值范围：** 14，15，16，17，18，19，20 | | name | String | **参数解释：** 领域名称 **取值范围：** 不涉及 | 表8iteration | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 迭代ID **取值范围：** ≥0。 | | name | String | **参数解释：** 迭代名 **取值范围：** 不涉及 | 表9module | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 模块ID。 **取值范围：** ≥0。 | | name | String | **参数解释：** 模块 **取值范围：** 不涉及 | 表10NewCustomField | 参数 | 参数类型 | 描述 | |:---|:---|:---| | custom_field | String | **参数解释：** 自定义字段，可以通过[查询Scrum工作项自定义字段](https://support.huaweicloud.com/api-projectman/ListIssueCustomFields.html)接口查询Scrum工作项自定义字段中返回的custom_field值获取。 **取值范围：** 不涉及。 | | field_name | String | **参数解释：** 自定义属性对应的值，多个值以英文逗号区分开, 可以通过[查询Scrum工作项自定义字段](https://support.huaweicloud.com/api-projectman/ListIssueCustomFields.html)接口查询Scrum工作项自定义字段中返回的name值获取。 **取值范围：** 不涉及。 | | value | String | **参数解释：** 自定义属性对应的值，多个值以英文逗号区分开, 可以通过[查询Scrum工作项自定义字段](https://support.huaweicloud.com/api-projectman/ListIssueCustomFields.html)接口查询Scrum工作项自定义字段中返回的options值获取。 **取值范围：** 不涉及。 | 表11parent_issue | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 父工作项ID **取值范围：** 最小值：0 | | name | String | **参数解释：** 父工作项 **取值范围：** 不涉及 | 表12priority | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 优先级id，枚举： 1（低） 2（中） 3（高） **取值范围：** - 1（低） - 2（中） - 3（高） | | name | String | **参数解释：** 优先级 **取值范围：** - 低 - 中 - 高 | 表13IssueProjectResponseV4 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | project_id | String | **参数解释：** 项目ID。 **取值范围：** 不涉及。 | | project_name | String | **参数解释：** 项目名称。 **取值范围：** 不涉及。 | | project_num_id | Integer | **参数解释：** 项目数字ID。 **取值范围：** ≥0。 | 表14severity | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 重要程度id，枚举： 10 （关键） 11 （重要） 12 （一般） 13 （提示） **取值范围：** 10，11，12，13 | | name | String | **参数解释：** 重要程度 **取值范围：** 不涉及 | 表15status | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 状态id，枚举： 1（新建） 2（进行中） 3（已解决） 4（测试中） 5（ 已关闭） 6（已拒绝） **取值范围：** 1，2，3，4，5，6 | | name | String | **参数解释：** 状态名称 **取值范围：** 不涉及 | 表16tracker | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 类型id，枚举： 2（任务/Task） 3（缺陷/Bug） 5（Epic） 6（Feature） 7（Story） **取值范围：** 2，3，5，6，7 | | name | String | **参数解释：** 类型名称 **取值范围：** 不涉及 | 表17IssueAttribute | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | 参数解释： 发现环境ID。 取值范围： 不涉及 | | name | String | 参数解释： 发现环境名称。 取值范围： 不涉及 | 表18TagRelation | 参数 | 参数类型 | 描述 | |:---|:---|:---| | relationId | Integer | **参数解释：** 关联ID。 **取值范围：** 不涉及 | | tagId | Integer | **参数解释：** 标签ID。 **取值范围：** 不涉及 | | region | String | **参数解释：** 区域。 **取值范围：** 不涉及 | | name | String | **参数解释：** 标签名称。 **取值范围：** 不涉及 | **状态码：400** 表19响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。 | | error_msg | String | **参数解释**： 错误描述。 **取值范围**： 不涉及。 | **状态码：401** 表20响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。 | | error_msg | String | **参数解释**： 错误描述。 **取值范围**： 不涉及。 | | request_id | String | **参数解释**： 请求的ID，系统自动生成。 **取值范围**： 不涉及。 | #### 请求示例 ``` GET https://{endpoint}/v4/projects/526cefde62004de2b62b5e8dd2c2b3af/issues/4568921/child ``` #### 响应示例 **状态码：200** ``` { "issues" : [ { "actual_work_hours" : 0, "assigned_cc_user" : [ { "id" : 4091, "name" : "demo_user_name", "nick_name" : "张三" } ], "assigned_user" : { "id" : 4091, "name" : "demo_user_name", "nick_name" : "张三" }, "begin_time" : "2020-09-12", "created_time" : "2020-09-13 14:40:11", "creator" : { "id" : 4091, "name" : "demo_user_name", "nick_name" : "张三" }, "custom_fields" : [ { "name" : "customField16", "value" : "多选框", "new_name" : "custom_field16" } ], "new_custom_fields" : [ { "custom_field" : "custom_field16", "field_name" : "field_name", "value" : "多选框1,多选框2" } ], "developer" : { "id" : 4091, "name" : "demo_user_name", "nick_name" : "张三" }, "domain" : { "id" : 14, "name" : "性能" }, "done_ratio" : 0, "end_time" : "2020-09-19", "expected_work_hours" : 9, "id" : 4567, "project" : { "project_id" : "526cefde62004de2b62b5e8dd2c2b3af", "project_name" : "testDemo", "project_num_id" : 78953 }, "iteration" : { "id" : 456, "name" : "迭代1" }, "module" : { "id" : 456, "name" : "Project" }, "name" : "国际化整改", "parent_issue" : { "id" : 123, "name" : "提供查询项目成员的功能" }, "priority" : { "id" : 1, "name" : "低" }, "severity" : { "id" : 12, "name" : "一般" }, "status" : { "id" : 1, "name" : "新建" }, "tracker" : { "id" : 7, "name" : "story" }, "updated_time" : "2020-09-14 14:40:11", "closed_time" : "2020-09-15 14:40:11" } ], "total" : 1 } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。