查询项目的状态列表
功能介绍
查询项目的状态列表
URI
GET /v4/projects/{project_id}/statuses
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
devcloud项目的32位id |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
offset |
否 |
Integer |
查询偏移量 缺省值:0 |
limit |
否 |
Integer |
一次返回的数据,最小1,最大100 最小值:1 最大值:100 缺省值:10 |
tracker_id |
否 |
Integer |
自定义字段支持的工作项类型 2任务/Task,3缺陷/Bug,5Epic,6Feature,7Story |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
total |
Integer |
状态总数 |
issue_statuses |
Array of IssueStatus objects |
状态列表 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
状态uuid |
status_id |
Integer |
状态数字id |
name |
String |
状态名称 |
tracker_ids |
Array of integers |
关联的工作项类型列表 |
status_attribute |
StatusAttribute object |
状态属性类型 开始态,进行态,结束态 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误描述 |
error_code |
String |
错误码 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误描述 |
error_code |
String |
错误码 |
请求示例
Get https://{endpoint}/v4/projects/0792b7d26cb74bd799cbae80063dc74a/statuses
响应示例
状态码: 200
OK
{ "total" : 1, "issue_statuses" : [ { "id" : "123cefde62004de2b62b5e8dd2c2b3af", "status_id" : 1, "name" : "新建", "tracker_ids" : [ 0 ], "status_attribute" : { "id" : 1, "name" : "string" } } ] }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
错误码
请参见错误码。