调用CreateSprint创建迭代_云效(Apsara Devops)-阿里云帮助中心

可以创建项目的迭代。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

POST /organization/{organizationId}/sprints/create

请求参数

名称	类型	必填	描述	示例值
organizationId	string	是	企业标识，也称企业 id，字符串形式，可在云效访问链接中获取，如 https://devops.aliyun.com/organization/【OrganizationId】	5ebbc0228123212b59xxxxx
body	object	否	请求结构。
name	string	是	迭代名称	示例迭代
spaceIdentifier	string	是	项目 id，和 projectId 意义相同	asd345xxxxx9q9845xxxxx34
startDate	string	否	开始时间	2021-12-01
endDate	string	否	结束时间	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	long	创建时间的时间戳，单位毫秒	1623916393000
gmtModified	long	修改时间的时间戳，单位毫秒	1623916393000
endDate	long	结束时间的时间戳，单位毫秒	1623916393000
startDate	long	开始时间的时间戳，单位毫秒	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	没有权限

访问错误中心查看更多错误码。