Iterations - Post Team Iteration

참조

Service:: Work

API Version:: 7.1-preview.1

팀에 반복 추가

POST https://dev.azure.com/{organization}/{project}/{team}/_apis/work/teamsettings/iterations?api-version=7.1-preview.1

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
organization	path	True	string	Azure DevOps 조직의 이름입니다.
project	path	True	string	프로젝트 ID 또는 프로젝트 이름
team	path		string	팀 ID 또는 팀 이름
api-version	query	True	string	사용할 API의 버전입니다. 이 버전의 api를 사용하려면 '7.1-preview.1'로 설정해야 합니다.

요청 본문

Name	형식	Description
_links	ReferenceLinks	리소스와 관련된 링크 컬렉션
attributes	TeamIterationAttributes	시작 및 종료 날짜와 같은 반복의 특성입니다.
id	string	반복의 ID입니다.
name	string	반복의 이름입니다.
path	string	반복의 상대 경로입니다.
url	string	리소스에 대한 전체 http 링크

응답

Name	형식	Description
200 OK	TeamSettingsIteration	성공한 작업

보안

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Name	Description
vso.work_write	작업 항목 및 쿼리를 읽고, 만들고, 업데이트하고, 보드 메타데이터, 읽기 영역 및 반복 경로를 다른 작업 항목이 관련 메타데이터를 추적하고, 쿼리를 실행하고, 서비스 후크를 통해 작업 항목 이벤트에 대한 알림을 받을 수 있는 기능을 부여합니다.

예제

Add an iteration to the team

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/Fabrikam-Fiber/_apis/work/teamsettings/iterations?api-version=7.1-preview.1

"{\"id\":\"a589a806-bf11-4d4f-a031-c19813331553\"}"

Sample Response

Status code:: 201

{
  "id": "a589a806-bf11-4d4f-a031-c19813331553",
  "name": "Sprint 2",
  "path": "Fabrikam-Fiber\\Release 1\\Sprint 2",
  "attributes": {
    "startDate": null,
    "finishDate": null
  },
  "url": "https://dev.azure.com/fabrikam/6d823a47-2d51-4f31-acff-74927f88ee1e/748b18b6-4b3c-425a-bcae-ff9b3e703012/_apis/work/teamsettings/iterations/a589a806-bf11-4d4f-a031-c19813331553",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/6d823a47-2d51-4f31-acff-74927f88ee1e/748b18b6-4b3c-425a-bcae-ff9b3e703012/_apis/work/teamsettings/iterations/a589a806-bf11-4d4f-a031-c19813331553"
    },
    "project": {
      "href": "https://dev.azure.com/fabrikam/_apis/projects/6d823a47-2d51-4f31-acff-74927f88ee1e"
    },
    "team": {
      "href": "https://dev.azure.com/fabrikam/_apis/projects/6d823a47-2d51-4f31-acff-74927f88ee1e/teams/748b18b6-4b3c-425a-bcae-ff9b3e703012"
    },
    "teamSettings": {
      "href": "https://dev.azure.com/fabrikam/6d823a47-2d51-4f31-acff-74927f88ee1e/748b18b6-4b3c-425a-bcae-ff9b3e703012/_apis/work/teamsettings"
    },
    "teamIterations": {
      "href": "https://dev.azure.com/fabrikam/6d823a47-2d51-4f31-acff-74927f88ee1e/748b18b6-4b3c-425a-bcae-ff9b3e703012/_apis/work/teamsettings/iterations"
    },
    "capacity": {
      "href": "https://dev.azure.com/fabrikam/6d823a47-2d51-4f31-acff-74927f88ee1e/748b18b6-4b3c-425a-bcae-ff9b3e703012/_apis/work/teamsettings/iterations/a589a806-bf11-4d4f-a031-c19813331553/capacities"
    },
    "classificationNode": {
      "href": "https://dev.azure.com/fabrikam/6d823a47-2d51-4f31-acff-74927f88ee1e/_apis/wit/classificationNodes/Iterations/Release%201/Sprint%202"
    },
    "teamDaysOff": {
      "href": "https://dev.azure.com/fabrikam/6d823a47-2d51-4f31-acff-74927f88ee1e/748b18b6-4b3c-425a-bcae-ff9b3e703012/_apis/work/teamsettings/iterations/a589a806-bf11-4d4f-a031-c19813331553/teamdaysoff"
    }
  }
}

정의

Name	Description
ReferenceLinks	REST 참조 링크의 컬렉션을 나타내는 클래스입니다.
TeamIterationAttributes
TeamSettingsIteration	단일 반복에 대한 단순 참조를 나타냅니다.
TimeFrame	과거, 현재 또는 미래와 같은 반복의 시간 프레임입니다.

ReferenceLinks

REST 참조 링크의 컬렉션을 나타내는 클래스입니다.

Name	형식	Description
links	object	링크의 읽기 전용 보기입니다. 참조 링크는 읽기 전용이므로 읽기 전용으로만 노출하려고 합니다.

TeamIterationAttributes

Name	형식	Description
finishDate	string	반복의 완료 날짜입니다. 날짜 전용이며 UTC의 자정에 조정되지 않은 올바른 수정입니다.
startDate	string	반복의 시작 날짜입니다. 날짜 전용이며 UTC의 자정에 조정되지 않은 올바른 수정입니다.
timeFrame	TimeFrame	과거, 현재 또는 미래와 같은 반복의 시간 프레임입니다.

TeamSettingsIteration

단일 반복에 대한 단순 참조를 나타냅니다.

Name	형식	Description
_links	ReferenceLinks	리소스와 관련된 링크 컬렉션
attributes	TeamIterationAttributes	시작 및 종료 날짜와 같은 반복의 특성입니다.
id	string	반복의 ID입니다.
name	string	반복의 이름입니다.
path	string	반복의 상대 경로입니다.
url	string	리소스에 대한 전체 http 링크

TimeFrame

과거, 현재 또는 미래와 같은 반복의 시간 프레임입니다.

Name	형식	Description
current	string
future	string
past	string

다음을 통해 공유