Iterations - Get Iteration Work Items
Pobieranie elementów roboczych na potrzeby iteracji
GET https://dev.azure.com/{organization}/{project}/{team}/_apis/work/teamsettings/iterations/{iterationId}/workitems?api-version=7.1
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
iteration
|
path | True |
string (uuid) |
Identyfikator iteracji |
organization
|
path | True |
string |
Nazwa organizacji usługi Azure DevOps. |
project
|
path | True |
string |
Identyfikator projektu lub nazwa projektu |
team
|
path |
string |
Identyfikator zespołu lub nazwa zespołu |
|
api-version
|
query | True |
string |
Wersja interfejsu API do użycia. Należy ustawić wartość "7.1", aby używać tej wersji interfejsu API. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
operacja zakończona powodzeniem |
Zabezpieczenia
oauth2
Typ:
oauth2
Flow:
accessCode
Adres URL autoryzacji:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Adres URL tokenu:
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
Zakresy
Nazwa | Opis |
---|---|
vso.work | Umożliwia odczytywanie elementów roboczych, zapytań, tablic, ścieżek obszaru i iteracji oraz innych metadanych powiązanych ze śledzeniem elementów roboczych. Ponadto umożliwia wykonywanie zapytań, wyszukiwanie elementów roboczych i odbieranie powiadomień o zdarzeniach elementów roboczych za pośrednictwem punktów zaczepienia usługi. |
Przykłady
Get workitems
Przykładowe żądanie
GET https://dev.azure.com/fabrikam/Fabrikam-Fiber/_apis/work/teamsettings/iterations/a589a806-bf11-4d4f-a031-c19813331553/workitems?api-version=7.1
Przykładowa odpowiedź
{
"workItemRelations": [
{
"rel": null,
"source": null,
"target": {
"id": 1,
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/1"
}
},
{
"rel": "System.LinkTypes.Hierarchy-Forward",
"source": {
"id": 1,
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/1"
},
"target": {
"id": 3,
"url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/3"
}
}
],
"url": "https://dev.azure.com/fabrikam/Fabrikam-Fiber/_apis/work/teamsettings/iterations/a589a806-bf11-4d4f-a031-c19813331553/workitems",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/Fabrikam-Fiber/_apis/work/teamsettings/iterations/a589a806-bf11-4d4f-a031-c19813331553/workitems"
},
"iteration": {
"href": "https://dev.azure.com/fabrikam/Fabrikam-Fiber/_apis/work/teamsettings/iterations/a589a806-bf11-4d4f-a031-c19813331553"
}
}
}
Definicje
Nazwa | Opis |
---|---|
Iteration |
Reprezentuje elementy robocze na liście prac iteracji |
Reference |
Klasa reprezentująca kolekcję linków referencyjnych REST. |
Work |
Połączenie między dwoma elementami roboczymi. |
Work |
Zawiera odwołanie do elementu roboczego. |
IterationWorkItems
Reprezentuje elementy robocze na liście prac iteracji
Nazwa | Typ | Opis |
---|---|---|
_links |
Kolekcja łączy istotnych dla zasobu |
|
url |
string |
Pełny link http do zasobu |
workItemRelations |
Relacje elementów roboczych |
ReferenceLinks
Klasa reprezentująca kolekcję linków referencyjnych REST.
Nazwa | Typ | Opis |
---|---|---|
links |
object |
Czytelny widok linków. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu. |
WorkItemLink
Połączenie między dwoma elementami roboczymi.
Nazwa | Typ | Opis |
---|---|---|
rel |
string |
Typ łącza. |
source |
Źródłowy element roboczy. |
|
target |
Docelowy element roboczy. |
WorkItemReference
Zawiera odwołanie do elementu roboczego.
Nazwa | Typ | Opis |
---|---|---|
id |
integer (int32) |
Identyfikator elementu roboczego. |
url |
string |
Adres URL interfejsu API REST zasobu |