共用方式為

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 參數

名稱 位於 必要 類型 Description
organization
 path True

string

Azure DevOps 組織的名稱。
project
 path True

string

項目識別碼或項目名稱
team
 path

string

小組標識碼或小組名稱
api-version
 query True

string

要使用的 API 版本。 這應該設定為 『7.1』 以使用此版本的 API。

要求本文

名稱 類型 Description
_links

ReferenceLinks

與資源相關的連結集合
attributes

TeamIterationAttributes

反覆項目的屬性，例如開始和結束日期。
id

string (uuid)

反覆運算的標識碼。
name

string

反覆項目的名稱。
path

string

反覆運算的相對路徑。
url

string

資源的完整 HTTP 連結

回應

名稱 類型 Description
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

範圍

名稱 Description
vso.work_write 授與讀取、建立和更新工作專案和查詢、更新面板元數據、讀取區域和反覆專案路徑的能力，其他工作專案追蹤相關元數據、執行查詢，以及透過服務攔截接收工作專案事件的通知。

範例

Add an iteration to the team

範例要求

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

定義

名稱 Description
ReferenceLinks

表示 REST 參考連結集合的類別。
TeamIterationAttributes
TeamSettingsIteration

表示單一反覆運算的淺層 ref。
TimeFrame

反覆項目的時間範圍，例如過去、目前或未來。
Object

表示 REST 參考連結集合的類別。

名稱 類型 Description
links

object

連結的只讀檢視。 因為參考連結是只讀的，所以我們只想要將其公開為只讀。

TeamIterationAttributes

Object
名稱 類型 Description
finishDate

string (date-time)

完成反覆專案的日期。 僅限日期，在UTC午夜正確調整。
startDate

string (date-time)

反覆項目的開始日期。 僅限日期，在UTC午夜正確調整。
timeFrame

TimeFrame

反覆項目的時間範圍，例如過去、目前或未來。

TeamSettingsIteration

Object

表示單一反覆運算的淺層 ref。

名稱 類型 Description
_links

ReferenceLinks

與資源相關的連結集合
attributes

TeamIterationAttributes

反覆項目的屬性，例如開始和結束日期。
id

string (uuid)

反覆運算的標識碼。
name

string

反覆項目的名稱。
path

string

反覆運算的相對路徑。
url

string

資源的完整 HTTP 連結

TimeFrame

列舉型別

反覆項目的時間範圍，例如過去、目前或未來。

值 Description
current
future
past