共用方式為

Iterations - Get

  • 參考
服務:
Work
API 版本:
7.1

依iterationId取得小組的反覆專案

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

URI 參數

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

string (uuid)

反覆項目的標識碼
organization
 path True

string

Azure DevOps 組織的名稱。
project
 path True

string

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

string

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

string

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

回應

名稱 類型 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 授與讀取工作項目、查詢、面板、區域和反覆項目路徑，以及其他工作專案追蹤相關元數據的能力。 同時授與執行查詢、搜尋工作專案，以及透過服務攔截接收工作專案事件的通知的能力。

範例

Get a team's iteration by iterationId

範例要求

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

範例回覆

狀態碼:
200 
{
  "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