Iterations - List

Referensi

Service:: Work

API Version:: 7.1-preview.1

Mendapatkan iterasi tim menggunakan filter jangka waktu

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

With optional parameters:

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
organization	path	True	string	Nama organisasi Azure DevOps.
project	path	True	string	ID proyek atau nama proyek
team	path		string	ID tim atau nama tim
api-version	query	True	string	Versi API yang akan digunakan. Ini harus diatur ke '7.1-preview.1' untuk menggunakan versi api ini.
$timeframe	query		string	Filter yang perulangannya dikembalikan berdasarkan waktu relatif. Hanya Saat Ini yang didukung saat ini.

Respons

Nama	Jenis	Deskripsi
200 OK	TeamSettingsIteration[]	operasi berhasil

Keamanan

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

Nama	Deskripsi
vso.work	Memberikan kemampuan untuk membaca item kerja, kueri, papan, jalur area dan iterasi, dan metadata terkait pelacakan item kerja lainnya. Juga memberikan kemampuan untuk menjalankan kueri, mencari item kerja, dan menerima pemberitahuan tentang peristiwa item kerja melalui kait layanan.

Contoh

Get a team's iterations using timeframe filter

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/Fabrikam-Fiber/_apis/work/teamsettings/iterations?$timeframe=current&api-version=7.1-preview.1

Sample Response

Status code:: 200

{
  "values": [
    {
      "id": "a589a806-bf11-4d4f-a031-c19813331553",
      "name": "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"
    }
  ]
}

Definisi

Nama	Deskripsi
ReferenceLinks	Kelas untuk mewakili kumpulan tautan referensi REST.
TeamIterationAttributes
TeamSettingsIteration	Mewakili ref dangkal untuk satu iterasi.
TimeFrame	Jangka waktu perulangan, seperti masa lalu, saat ini, atau masa depan.

ReferenceLinks

Kelas untuk mewakili kumpulan tautan referensi REST.

Nama	Jenis	Deskripsi
links	object	Tampilan baca-saja dari tautan. Karena tautan Referensi bersifat baca-saja, kami hanya ingin mengeksposnya sebagai baca saja.

TeamIterationAttributes

Nama	Jenis	Deskripsi
finishDate	string	Tanggal selesai perulangan. Tanggal-saja, benar tidak diaduh pada tengah malam di UTC.
startDate	string	Tanggal mulai perulangan. Tanggal-saja, benar tidak diaduh pada tengah malam di UTC.
timeFrame	TimeFrame	Jangka waktu perulangan, seperti masa lalu, saat ini, atau masa depan.

TeamSettingsIteration

Mewakili ref dangkal untuk satu iterasi.

Nama	Jenis	Deskripsi
_links	ReferenceLinks	Kumpulan tautan yang relevan dengan sumber daya
attributes	TeamIterationAttributes	Atribut perulangan seperti tanggal mulai dan berakhir.
id	string	Id perulangan.
name	string	Nama perulangan.
path	string	Jalur relatif perulangan.
url	string	Tautan http penuh ke sumber daya

TimeFrame

Jangka waktu perulangan, seperti masa lalu, saat ini, atau masa depan.

Nama	Jenis	Deskripsi
current	string
future	string
past	string

Share via