Udostępnij przez

Iterations - Get

  • Odwołanie
Usługa:
Work
Wersja interfejsu API:
7.1

Pobieranie iteracji zespołu według iteracjiId

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
id
 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

TeamSettingsIteration

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 a team's iteration by iterationId

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
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"
    }
  }
}

Definicje

Nazwa Opis
ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.
TeamIterationAttributes
TeamSettingsIteration

Reprezentuje płytki ref dla pojedynczej iteracji.
TimeFrame

Przedział czasu iteracji, na przykład przeszłości, bieżącej lub przyszłej.
Objekt

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.

TeamIterationAttributes

Objekt
Nazwa Typ Opis
finishDate

string (date-time)

Data zakończenia iteracji. Tylko data, popraw nieprzystosowane o północy w formacie UTC.
startDate

string (date-time)

Data rozpoczęcia iteracji. Tylko data, popraw nieprzystosowane o północy w formacie UTC.
timeFrame

TimeFrame

Przedział czasu iteracji, na przykład przeszłości, bieżącej lub przyszłej.

TeamSettingsIteration

Objekt

Reprezentuje płytki ref dla pojedynczej iteracji.

Nazwa Typ Opis
_links

ReferenceLinks

Kolekcja łączy istotnych dla zasobu
attributes

TeamIterationAttributes

Atrybuty iteracji, takie jak data rozpoczęcia i zakończenia.
id

string (uuid)

Identyfikator iteracji.
name

string

Nazwa iteracji.
path

string

Ścieżka względna iteracji.
url

string

Pełny link http do zasobu

TimeFrame

Wyliczanie

Przedział czasu iteracji, na przykład przeszłości, bieżącej lub przyszłej.

Wartość Opis
current
future
past