华为云用户手册

响应示例 状态码： 200 根据快照版本查询特性集返回体 { "status" : "success", "message" : null, "result" : [ { "id" : "981644262727655424", "number" : "FS20240401737948", "parent_id" : null, "title" : "mod1-min-0325-1特性树", "position_float" : 2, "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "created_date" : "1711971830000", "modified_date" : "1711971830000", "child_fs" : [ { "id" : "978983008897904641", "number" : "FS20240325720621", "parent_id" : "981644262727655424", "title" : "mod1-min-0325-1 特性树", "position_float" : 1, "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "created_date" : "1711337337000", "modified_date" : "1711971830000", "child_fs" : [ { "id" : "981644718250041344", "number" : "FS20240401737949", "parent_id" : "978983008897904641", "title" : "1-1", "position_float" : 1, "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "created_date" : "1711971938000", "modified_date" : "1711971938000", "child_fs" : [ { "id" : "981847412113842176", "number" : "FS20240402738983", "parent_id" : "981644718250041344", "title" : "11", "position_float" : 1, "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "created_date" : "1712020264000", "modified_date" : "1712020264000", "child_fs" : null } ] }, { "id" : "981644750294523904", "number" : "FS20240401737950", "parent_id" : "978983008897904641", "title" : "1-2", "position_float" : 2, "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "created_date" : "1711971946000", "modified_date" : "1711971946000", "child_fs" : [ { "id" : "981644805718056960", "number" : "FS20240401737951", "parent_id" : "981644750294523904", "title" : "1-2-1", "position_float" : 1, "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "created_date" : "1711971959000", "modified_date" : "1711971959000", "child_fs" : null }, { "id" : "981644911709302785", "number" : "FS20240401738018", "parent_id" : "981644750294523904", "title" : "1-2-2", "position_float" : 2, "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "测试账号" }, "created_date" : "1711971985000", "modified_date" : "1711972027000", "child_fs" : null } ] } ] } ] } ] }

URI GET /v1/ipdprojectservice/projects/{project_id}/feature-set/query 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id 表2 Query参数 参数 是否必选 参数类型 描述 snapshot_version_id 否 String 特性集快照版本id，不传则查询当前版本特性集，传值则查询对应版本的特性集

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 records Array of WorkitemStatusRecords objects 操作历史 total Integer 总数 表5 WorkitemStatusRecords 参数 参数类型 描述 work_item_record_id String 工作项的记录id，一个工作项对应一条记录 最小长度：32 最大长度：32 work_item_id String 工作项id project_id String devcloud项目的32位id 最小长度：32 最大长度：32 work_item_statuses Array of WorkitemStatus objects 操作历史 表6 WorkitemStatus 参数 参数类型 描述 id String 工作项状态变更记录的id,每次变更产生一条新的记录id 最小长度：1 最大长度：32 status status object 工作项的状态 表7 status 参数 参数类型 描述 id String 工作项的状态id 最小长度：1 最大长度：32 name String 状态名称 最小长度：1 最大长度：60 type String 工作项状态的类型， BACK LOG ( "初始化"), READY("待启动"), IN_PROGRESS("进行中"), COMPLETE("已完成"), DONE("已结束"), description String 工作项状态的描述 parent_status_id String 工作项状态的父状态id 最小长度：1 最大长度：32 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表9 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

响应示例 状态码： 200 OK { "records" : [ { "work_item_record_id" : "7401906a85de466c81fd90e22824eb19", "work_item_id" : "4633454879781163008", "project_id" : "526cefde62004de2b62b5e8dd2c2b3af", "work_item_statuses" : [ { "id" : "7401906a85de466c81fd90e22824eb19", "status" : { "id" : "d25fe91f7f6b489db5f804e66ac3b360", "name" : "7401906a85de466c81fd90e22824eb19", "type" : "BACKLOG", "description" : "demo", "parent_status_id" : "7401906a85de466c81fd90e22824aaaa" } } ] } ], "total" : 1 }

URI GET /v4/projects/{project_id}/work-items/status-records 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String devcloud项目的32位id 最小长度：32 最大长度：32 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量 从0开始 最小值：0 缺省值：0 limit 否 Integer 每页数量 最小1,最大100 最小值：1 最大值：100 缺省值：100

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 fails Array of strings 计算失败的工作项id,一般指未关闭的工作项 data Array of data objects 计算失败的工作项id,一般指未关闭的工作项 total_stay_time Long 停留时间求和（单位：秒） total Integer 停留时间求和的工作项个数 表4 data 参数 参数类型 描述 id String 工作项id字符串 stay_time Long 停留时间（单位：秒） 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表2 请求Body参数 参数 是否必选 参数类型 描述 project_id 否 String 项目uuid issue_ids 否 Array of strings 工作项id字符串列表

请求示例 Post https://{endpoint}/v4/projects/work-hours { "limit" : 1, "offset" : 0, "end_time" : "2020-08-14", "project_ids" : [ "e2da96a5d2c845e284f0ad47f8ca8cb2", "a2da96a5d2c845e284f0ad47f8ca8cef" ] }

响应示例 状态码： 200 ok { "work_hours" : [ { "project_name" : "项目名称", "nick_name" : "用户昵称", "user_id" : "09d75cdd9a00d44d2f17c01875483f26", "user_name" : "用户名", "work_date" : "2020-02-19", "work_hours_num" : "2.0", "summary" : "做了XXXXX", "work_hours_type_name" : "后端开发", "issue_id" : 123456, "issue_type" : "Story", "subject" : "工作项标题", "created_time" : "2019-12-17", "closed_time" : "2019-12-20", "work_hours_created_time" : "2019-12-17 09:00:00", "work_hours_updated_time" : "2019-12-20 15:00:00" } ], "total" : 1 }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：10 最大长度：32768 表2 请求Body参数 参数 是否必选 参数类型 描述 project_ids 否 Array of strings 查询的项目id列表 user_ids 否 Array of strings 查询的用户id列表 work_hours_types 否 String 工时类型，以逗号分隔,21:研发设计,22:后端开发,23:前端开发(Web),24:前端开发(小程序),25:前端开发(App),26:测试验证,27:缺陷修复,28:UI设计,29:会议,30:公共事务,31:培训,32:研究,33:其它,34:调休请假 work_hours_dates 否 String 工时日期，以逗号分隔，年-月-日 begin_time 否 String 工时开始日期，年-月-日 end_time 否 String 工时结束日期，年-月-日 offset 是 Integer 偏移量,offset是limit的整数倍，limit=10,offset=0,10,20... 最小值：0 limit 是 Integer 每页显示数量，每页最多显示100条 最小值：1 最大值：100

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 work_hours Array of work_hours objects 工时列表 total Integer 总数 表4 work_hours 参数 参数类型 描述 project_name String 项目名称 nick_name String 用户昵称 user_id String 用户id user_name String 用户名 work_date String 工时日期 work_hours_num String 工时花费 summary String 工时内容 work_hours_type_name String 工时类型 issue_id Integer 工作项id issue_type String 工作项类型 subject String 工作项标题 created_time String 工作项创建时间 closed_time String 工作项结束时间 work_hours_created_time String 工时创建时间 work_hours_updated_time String 工时更新时间 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

响应示例 状态码： 200 OK { "total" : 1, "modules" : [ { "module_id" : 1, "module_name" : "demo", "owner" : { "user_id" : "09d75cde5180d4481f91c018e89cb8e2", "user_num_id" : 4091, "user_name" : "demo_user_name_06", "nick_name" : "demo" }, "deepth" : 1, "is_parent" : true, "children" : [ { "module_id" : 1, "module_name" : "demo", "owner" : { "user_id" : "09d75cde5180d4481f91c018e89cb8e2", "user_num_id" : 4091, "user_name" : "demo_user_name_06", "nick_name" : "demo" }, "deepth" : 1, "is_parent" : true, "parent_module_id" : 1 } ] } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 模块总数 modules Array of ProjectModule objects 模块列表 表5 ProjectModule 参数 参数类型 描述 module_id Integer 模块id module_name String 模块名称 owner ModuleOwner object 模块责任人 deepth Integer 模块层级 is_parent Boolean 是否是父级，true 父模块， false 非父模块 children Array of ProjectChildModule objects 子模块信息 表6 ProjectChildModule 参数 参数类型 描述 module_id Integer 模块id module_name String 模块名称 owner ModuleOwner object 模块责任人 deepth Integer 模块层级 is_parent Boolean 是否是父级，true 父模块， false 非父模块 parent_module_id Integer 父模块id 表7 ModuleOwner 参数 参数类型 描述 user_id String 用户32位字符串id user_num_id Integer 用户数字id user_name String 用户名称 nick_name String 用户昵称 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表9 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

URI GET /v4/projects/{project_id}/modules 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String devcloud项目的32位id 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 查询偏移量 缺省值：0 limit 否 Integer 一次返回的数据,最小1,最大100 最小值：1 最大值：100 缺省值：10

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 迭代总数 iterations Array of iterations objects 迭代信息 表5 iterations 参数 参数类型 描述 description String 迭代描述 end_time String 迭代结束时间 id Integer 迭代id name String 迭代标题 begin_time String 迭代开始时间 status String 迭代状态 updated_time Long 迭代更新时间，长整型时间戳 deleted Boolean 迭代是否已经删除，false, 未删除， true已经删除 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

响应示例 状态码： 200 OK { "total" : 3, "iterations" : [ { "description" : "description", "end_time" : "2019-10-17", "id" : 9725885, "name" : "完成html", "begin_time" : "2019-10-10", "status" : "0", "updated_time" : 1640231944000, "deleted" : false } ] }

URI GET /v4/projects/{project_id}/iterations 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String devcloud项目的32位id 最小长度：32 最大长度：32 表2 Query参数 参数 是否必选 参数类型 描述 updated_time_interval 否 String 更新迭代的时间(查询的起始时间,查询的结束时间) include_deleted 否 Boolean 是否包含被删除的迭代,默认false不包含被删除的迭代

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 records Array of IssueAttrHistoryRecord objects 历史记录 total Integer 总数 表5 IssueAttrHistoryRecord 参数 参数类型 描述 field_key String 操作的字段 field_name String 操作字段的含义 id Long 历史记录id issue_id Long 工作项id new_value String 变更后的值,json字符串 old_value String 变更前的值,json字符串 operated_time Long 变更的时间 operation String 操作类型,新建，修改，删除 operator IssueUser object 操作者 property String 变更的属性 表6 IssueUser 参数 参数类型 描述 user_id String 用户uuid user_num_id Integer 用户数字id id Integer 用户id name String 用户名 nick_name String 昵称 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

响应示例 状态码： 200 OK { "records" : [ { "field_key" : "status", "field_name" : "状态", "id" : 789, "issue_id" : 123, "new_value" : "{\"id\":\"2\", \"name\":\"开发中\"}", "old_value" : "{\"id\":\"1\", \"name\":\"创建\"}", "operated_time" : 1601175640000, "operation" : "修改", "operator" : { "id" : 4091, "name" : "demo_user_name", "nick_name" : "张三" }, "property" : "attr" } ], "total" : 1 }

URI GET /v4/projects/{project_id}/issues/records 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String devcloud项目的32位id 最小长度：32 最大长度：32 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量 从0开始,offset是limit的整数倍，limit=10,offset=0,10,20... 最小值：0 缺省值：0 limit 否 Integer 每页数量 最小1,最大100 最小值：1 最大值：100 缺省值：100 operated_time_interval 否 String 变更工作项的时间(查询的起始时间,查询的结束时间)

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 领域总数 domains Array of CreateProjectDomainResponseBody objects 领域列表 表5 CreateProjectDomainResponseBody 参数 参数类型 描述 domain_name String 领 域名 称 domain_id String 领域id 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

URI GET /v4/projects/{project_id}/domains 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String devcloud项目的32位id 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 查询偏移量 缺省值：0 limit 否 Integer 一次返回的数据,最小1,最大100 最小值：1 最大值：100 缺省值：10

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 demand_statistics Array of DemandStatisticResponseV4 objects 需求统计 表4 DemandStatisticResponseV4 参数 参数类型 描述 closed_num Integer 已关闭数量 module String 模块 new_num Integer 新建的数量 process_num Integer 开发中的数量 rejected_num Integer 已拒绝数量 solved_num Integer 已解决数量 test_num Integer 测试中的数量 total Integer 总数 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

响应示例 状态码： 200 OK { "demand_statistics" : [ { "closed_num" : 1, "module" : "计费", "new_num" : 1, "process_num" : 1, "rejected_num" : 1, "solved_num" : 1, "test_num" : 1, "total" : 1 } ] }

响应示例 状态码： 200 OK { "total" : 1, "histories" : [ { "iteration_id" : 123454, "project_id" : "19274e1adffb4cc0b866ef6dd3ad0100", "operator" : { "user_id" : "0a938608ac00f2271f2ec01cccb94c19", "user_name" : "Banna", "nick_name" : "红海", "domain_id" : "9b33eb1d219140fea54d3b5ac689b073", "domain_name" : "devcloud_test" }, "operate" : "NEW", "operate_time" : "1665473746000", "details" : [ { "operate_field_name" : "name", "old_value" : null, "new_value" : "test" }, { "operate_field_name" : "description", "old_value" : null, "new_value" : null }, { "operate_field_name" : "end_time", "old_value" : null, "new_value" : "1664380800000" }, { "operate_field_name" : "status", "old_value" : null, "new_value" : "0" }, { "operate_field_name" : "begin_time", "old_value" : null, "new_value" : "1663776000000" }, { "operate_field_name" : "program_version_id", "old_value" : null, "new_value" : "-1" } ] } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 总数 histories Array of IterationHistory objects 历史记录 表5 IterationHistory 参数 参数类型 描述 iteration_id String 迭代ID project_id String 项目ID operator operator object 变更操作人 operate String 操作类型 operate_time String 操作时间 details Array of details objects 操作详情 表6 operator 参数 参数类型 描述 user_id String 用户uuid user_name String 用户名 nick_name String 昵称 domain_id String 租户uuid domain_name String 租户名 表7 details 参数 参数类型 描述 operate_field_name String 变更的字段 new_value String 操作后的值 old_value String 操作前的值 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表9 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

URI GET /v4/iterations/{iteration_id}/histories 表1 路径参数 参数 是否必选 参数类型 描述 iteration_id 是 Integer 迭代id 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量 最小值：0 缺省值：0 limit 否 Integer 每页数量，最大为100 最小值：1 最大值：100 缺省值：10

响应示例 状态码： 200 OK { "id" : 1221, "created_time" : "1597116605000", "records" : [ { "id" : 1234, "created_time" : 1617764919000, "user" : { "user_num_id" : 4091, "user_name" : "demo_user_name", "nick_name" : "aaa", "user_id" : "a360371833bf4c558f796fd707b44daf" }, "details" : [ { "property" : 1, "old_value" : 1, "new_value" : 2, "operation" : "批量编辑", "id" : 3597, "name" : "标题" } ] } ], "total" : 1 }

URI GET /v4/projects/{project_id}/issue/{issue_id}/records 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String devcloud项目的32位id 最小长度：32 最大长度：32 issue_id 是 Integer 工作项id 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 分页索引，偏移量,offset是limit的整数倍，limit=10,offset=0,10,20... 最小值：0 缺省值：0 limit 否 Integer 每页显示的数量,每页最多显示100条 最小值：1 最大值：1000 缺省值：10

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 id Integer 操作记录id (已废弃) created_time Long 创建时间 (已废弃) records Array of IssueRecordV4 objects 历史记录 total Integer 操作记录总数 表5 IssueRecordV4 参数 参数类型 描述 id Integer 操作记录id created_time Long 操作记录创建时间 user user object 工作项操作的用户 details Array of details objects 操作的记录 表6 user 参数 参数类型 描述 user_num_id Integer 用户数字id user_name String 登录名 nick_name String 昵称 user_id String 用户32位的uuid 表7 details 参数 参数类型 描述 property String 操作属性 old_value String 上次的记录 new_value String 当前值 operation String 操作 id Integer 操作记录的id name String 操作的字段 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表9 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码