Iterations - Post Team Iteration

Служба:

Work

Версия API:

7.1

Добавление итерации в команду

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
organization	path	True	string	Имя организации Azure DevOps.
project	path	True	string	Идентификатор проекта или имя проекта
team	path		string	Идентификатор команды или имя команды
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение "7.1".

Текст запроса

Имя	Тип	Описание
_links	ReferenceLinks	Коллекция ссылок, относящихся к ресурсу
attributes	TeamIterationAttributes	Атрибуты итерации, такие как дата начала и окончания.
id	string (uuid)	Идентификатор итерации.
name	string	Имя итерации.
path	string	Относительный путь итерации.
url	string	Полная ссылка http на ресурс

Ответы

Имя	Тип	Описание
200 OK	TeamSettingsIteration	успешная операция

Безопасность

oauth2

Тип: oauth2
Flow: accessCode
URL-адрес авторизации: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
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

Области

Имя	Описание
vso.work_write	Предоставляет возможность читать, создавать и обновлять рабочие элементы и запросы, метаданные доски обновления, области чтения и итерации пути других связанных метаданных рабочих элементов, выполнять запросы и получать уведомления о событиях рабочих элементов с помощью перехватчиков служб.

Примеры

Add an iteration to the team

Образец запроса

HTTP

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

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

Пример ответа

Код состояния:

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"
    }
  }
}

Определения

Имя	Описание
ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
TeamIterationAttributes
TeamSettingsIteration	Представляет мелкое ссылка для одной итерации.
TimeFrame	Период времени итерации, например прошлого, текущего или будущего.

ReferenceLinks

Object

Класс, представляющий коллекцию ссылок REST.

Имя	Тип	Описание
links	object	Режим чтения ссылок. Так как ссылки ссылки доступны только для чтения, мы хотим предоставлять их только как доступные только для чтения.

TeamIterationAttributes

Object

Имя	Тип	Описание
finishDate	string (date-time)	Дата окончания итерации. Только дата, исправлена в полночь в формате UTC.
startDate	string (date-time)	Дата начала итерации. Только дата, исправлена в полночь в формате UTC.
timeFrame	TimeFrame	Период времени итерации, например прошлого, текущего или будущего.

TeamSettingsIteration

Object

Представляет мелкое ссылка для одной итерации.

Имя	Тип	Описание
_links	ReferenceLinks	Коллекция ссылок, относящихся к ресурсу
attributes	TeamIterationAttributes	Атрибуты итерации, такие как дата начала и окончания.
id	string (uuid)	Идентификатор итерации.
name	string	Имя итерации.
path	string	Относительный путь итерации.
url	string	Полная ссылка http на ресурс

TimeFrame

Перечисление

Период времени итерации, например прошлого, текущего или будущего.

Значение	Описание
current
future
past