Udostępnij za pośrednictwem

Iterations - Post Team Iteration

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

Dodawanie iteracji do zespołu

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

Parametry identyfikatora URI

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

Treść żądania

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

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_write Umożliwia odczytywanie, tworzenie i aktualizowanie elementów roboczych i zapytań, metadanych tablicy aktualizacji, ścieżek obszaru odczytu i iteracji innych metadanych powiązanych elementów roboczych, wykonywania zapytań i odbierania powiadomień o zdarzeniach elementów roboczych za pośrednictwem punktów zaczepienia usługi.

Przykłady

Add an iteration to the team

Przykładowe żądanie

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

"{\"id\":\"a589a806-bf11-4d4f-a031-c19813331553\"}"

Przykładowa odpowiedź

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

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