可以创建项目的迭代。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /organization/{organizationId}/sprints/create HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| organizationId |
string |
是 |
企业标识，也称企业 id，字符串形式，可在云效访问链接中获取，如 https://devops.aliyun.com/organization/【OrganizationId】 |
5ebbc0228123212b59xxxxx |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求结构。 |
|
| name |
string |
是 |
迭代名称 |
示例迭代 |
| spaceIdentifier |
string |
是 |
项目 id，和 projectId 意义相同 |
asd345xxxxx9q9845xxxxx34 |
| startDate |
string |
否 |
开始时间，格式为 YYYY-MM-DD。 |
2021-12-01 |
| endDate |
string |
否 |
结束时间，格式为 YYYY-MM-DD。 |
2021-12-02 |
| staffIds |
array |
是 |
负责人列表 |
|
|
string |
是 |
支持企业用户名，如：张三 或者用户 aliyunPk |
19xx7043xxxxxxx914 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| requestId |
string |
请求 id，每次请求都是唯一值，便于后续排查问题 |
ASSDS-ASSASX-XSAXSA-XSAXSAXS |
| errorMsg |
string |
错误信息 |
error |
| errorCode |
string |
错误码 |
Openapi.RequestError |
| success |
boolean |
true 或者 false |
true |
| sprint |
object |
迭代信息 |
|
| creator |
string |
创建人阿里云 accountId |
19xx7043xxxxxxx914 |
| description |
string |
描述信息 |
xxx |
| gmtCreate |
integer |
创建时间的时间戳，单位毫秒 |
1623916393000 |
| gmtModified |
integer |
修改时间的时间戳，单位毫秒 |
1623916393000 |
| endDate |
integer |
结束时间的时间戳，单位毫秒 |
1623916393000 |
| startDate |
integer |
开始时间的时间戳，单位毫秒 |
1638403200000 |
| identifier |
string |
迭代唯一标识符 |
e8bxxxxxxxxxxxxxxxx23 |
| modifier |
string |
修改人的阿里云 accountId |
19xx7043xxxxxxx914 |
| name |
string |
迭代名称 |
demo示例项目 |
| spaceIdentifier |
string |
项目唯一标识 |
5e70xxxxxxcd000xxxxe96 |
| scope |
string |
可见范围，公开 public，私有 private |
public |
| status |
string |
状态 未开始：Todo 进行中：Doing 已完成：Done |
TODO |
示例
正常返回示例
JSON格式
{
"requestId": "ASSDS-ASSASX-XSAXSA-XSAXSAXS",
"errorMsg": "error",
"errorCode": "Openapi.RequestError",
"success": true,
"sprint": {
"creator": "19xx7043xxxxxxx914",
"description": "xxx",
"gmtCreate": 1623916393000,
"gmtModified": 1623916393000,
"endDate": 1623916393000,
"startDate": 1638403200000,
"identifier": "e8bxxxxxxxxxxxxxxxx23",
"modifier": "19xx7043xxxxxxx914",
"name": "demo示例项目",
"spaceIdentifier": "5e70xxxxxxcd000xxxxe96",
"scope": "public",
"status": "TODO"
}
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | Openapi.RequestError | request error | OpenAPI请求数据错误 |
| 403 | Operate.NoPermission | NoPermission | 没有权限 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。