添加系统自定义状态 - CreateProjectStatusConfig

功能介绍

添加系统自定义状态。

调用方法

请参见如何调用API。

授权信息

当前API调用无需身份策略权限。

URI

POST /v2/issue-status/project-status-config

请求参数

表1 请求Body参数
参数	是否必选	参数类型	描述
definedName	否	String	参数解释：自定义状态名称。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
description	否	String	参数解释：自定义状态的描述。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
projectUUId	否	String	参数解释：项目的32位uuid，项目唯一标识，通过查询项目列表接口获取，响应消息体中的project_id字段的值就是项目ID。约束限制： 32位的数字和字母组成的字符串。取值范围：不涉及。默认取值：不涉及。
statusAttribute	否	Integer	参数解释：自定义状态的属性id。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
result	result object	参数解释：请求返回结果。
status	String	参数解释：返回结果。取值范围： success: 返回成功。 error: 返回失败。

表3 result
参数	参数类型	描述
definedName	String	参数解释：自定义状态名称。取值范围：不涉及。
flag	Integer	参数解释：状态是否为自定义状态。取值范围： 0（不是自定义状态） 1（是自定义状态）
id	String	参数解释：自定义状态id。取值范围：不涉及。
position	Integer	参数解释：自定义状态在状态管理列表的位置。取值范围：不涉及。
projectUUId	String	参数解释：项目的32位UUID。取值范围：不涉及。
statusAttribute	Integer	参数解释：自定义状态属性。取值范围：不涉及。
statusId	Integer	参数解释：自定义状态数字id。取值范围：不涉及。
description	String	参数解释：自定义状态的描述。取值范围：不涉及。

请求示例

POST http://{endpoint}/v2/issue-status/project-status-config

{
  "projectUUId" : "af2d9ea776204a4395e238dd156b2ca9",
  "definedName" : "test1",
  "description" : "描述示例。",
  "statusAttribute" : 35098945
}

响应示例

状态码：200

CreateProjectStatusConfig接口成功的响应。

{
  "result" : {
    "id" : "827ae86a6b4c431c88a668dd996b74b1",
    "statusId" : 7,
    "definedName" : "test1",
    "position" : 2,
    "flag" : 1,
    "projectUUId" : "af2d9ea776204a4395e238dd156b2ca9",
    "description" : "描述示例。",
    "statusAttribute" : 34746202
  },
  "status" : "success"
}