# 查询工作项状态列表 - ShowIpdCategoryStatus #### 功能介绍 查询工作项状态列表 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-projectman/projectman_api_1002.html)。 #### 授权信息 当前API调用无需身份策略权限。 #### URI GET /v1/ipdprojectservice/projects/{project_id}/status 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目32位ID，项目唯一标识。通过[查询IPD项目列表](https://support.huaweicloud.com/api-projectman/ShowIpdProjectList.html)获取，响应消息体中的**id**字段的值就是项目ID。 **约束限制**： 不涉及。 **取值范围**： 32个字符，由英文字母和数字组成。 **默认取值**： 不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | categories | 是 | String | **参数解释**： 工作项类型。 **约束限制**： 2\~128个字符。 **取值范围**： 支持多种工作项类型，使用英文逗号分隔，例如：IR,SR,AR。 - 系统设备类项目：RR、SF、IR、SR、AR、Task、Bug - 独立软件类项目：RR、SF、IR、US、Task、Bug - 云服务类项目：RR、Epic、FE、US、Task、Bug **默认取值**： 不涉及。 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释**： 用户Token。通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制**： 不涉及。 **取值范围**： 10\~32768个字符。 **默认取值**： 不涉及。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | result | [StatusListResult] object | **参数解释**： 状态列表。 | | status | String | **参数解释**： 返回状态。 **取值范围**： success：响应成功。 error：响应失败 | | message | String | **参数解释**： 错误信息。 **取值范围**： 不涉及。 | 表5StatusListResult | 参数 | 参数类型 | 描述 | |:---|:---|:---| | status | Array of [StatusEntity] objects | **参数解释**： 状态列表。 | 表6StatusEntity | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**： 状态ID。 **取值范围**： 不涉及。 | | belonging | String | **参数解释**： 工作项的状态属性。 **取值范围**： START、IN_PROGRESS、END。 | | display_value | String | **参数解释**： 状态名。 **取值范围**： 不涉及。 | | code | String | **参数解释**： 状态唯一标识。 **取值范围**： 不涉及。 | | created_by | String | **参数解释**： 状态创建人。 **取值范围**： 不涉及。 | | created_time | String | **参数解释**： 状态创建时间。 **取值范围**： 不涉及。 | | modified_by | String | **参数解释**： 状态修改人。 **取值范围**： 不涉及。 | | modified_time | String | **参数解释**： 状态最近修改时间。 **取值范围**： 不涉及。 | | category_code | Array of strings | **参数解释**： 状态被哪些工作项使用。 | **状态码：400** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。 | | error_msg | String | **参数解释**： 错误描述，对error_code的补充解释。 **取值范围**： 不涉及。 | #### 请求示例 ``` GET https://{endpoint}/v1/ipdprojectservice/projects/336ad84c67ea4783b2edc1bb5a112da0/status?categories=FE,IR ``` #### 响应示例 **状态码：200** OK ``` { "status" : "success", "message" : null, "result" : { "status" : [ { "id" : "954399210965348356", "belonging" : "START", "display_value" : "初始", "code" : "Start", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "IR", "SR" ] }, { "id" : "954399210965348363", "belonging" : "START", "display_value" : "分析", "code" : "Analyse", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "Bug", "IR", "SR" ] }, { "id" : "958806581085904896", "belonging" : "IN_PROGRESS", "display_value" : "openapi-test", "code" : "s7150727397899378688", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1706526902000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1706526902000", "category_code" : [ "IR" ] }, { "id" : "954399210965348376", "belonging" : "IN_PROGRESS", "display_value" : "测试", "code" : "Test", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "Bug", "IR", "SR" ] }, { "id" : "954399210965348369", "belonging" : "IN_PROGRESS", "display_value" : "开发", "code" : "Develop", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "IR", "SR" ] }, { "id" : "954399210961154063", "belonging" : "IN_PROGRESS", "display_value" : "确认", "code" : "ToBeConfirmed", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "Bug" ] }, { "id" : "954399210965348354", "belonging" : "IN_PROGRESS", "display_value" : "修复", "code" : "Fixed", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "Bug" ] }, { "id" : "954399210961154057", "belonging" : "IN_PROGRESS", "display_value" : "验收", "code" : "Checking", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "Bug" ] }, { "id" : "954399210961154060", "belonging" : "END", "display_value" : "关闭", "code" : "Closed", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "Bug" ] }, { "id" : "954399210965348381", "belonging" : "END", "display_value" : "完成", "code" : "Finish", "created_by" : "a360371833bf4c558f796fd707b44daf", "created_time" : "1705476103000", "modified_by" : "a360371833bf4c558f796fd707b44daf", "modified_time" : "1705476103000", "category_code" : [ "IR", "SR" ] } ] } } ``` **状态码：400** 请求失败的响应。例如无操作权限、项目不存在。 ``` { "error_code" : "PM.02174103", "error_msg" : "无操作权限" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | 请求失败的响应。例如无操作权限、项目不存在。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。