Iterations - Post Team Iteration

Riferimento

Service:: Work

API Version:: 7.1-preview.1

Aggiungere un'iterazione al team

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
project	path	True	string	ID progetto o nome progetto
team	path		string	ID team o nome team
api-version	query	True	string	Versione dell'API da usare. Questa opzione deve essere impostata su '7.1-preview.1' per usare questa versione dell'API.

Corpo della richiesta

Nome	Tipo	Descrizione
_links	ReferenceLinks	Raccolta di collegamenti pertinenti alla risorsa
attributes	TeamIterationAttributes	Attributi dell'iterazione, ad esempio data di inizio e fine.
id	string	ID dell'iterazione.
name	string	Nome dell'iterazione.
path	string	Percorso relativo dell'iterazione.
url	string	Collegamento http completo alla risorsa

Risposte

Nome	Tipo	Descrizione
200 OK	TeamSettingsIteration	operazione riuscita

Sicurezza

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

Nome	Descrizione
vso.work_write	Concede la possibilità di leggere, creare e aggiornare elementi di lavoro e query, aggiornare i metadati della scheda di aggiornamento, l'area di lettura e i percorsi di iterazione di altri metadati correlati agli elementi di lavoro, eseguire query e ricevere notifiche sugli eventi dell'elemento di lavoro tramite hook del servizio.

Esempio

Add an iteration to the team

Sample Request

HTTP

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

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

Sample Response

Status code:: 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"
    }
  }
}

Definizioni

Nome	Descrizione
ReferenceLinks	Classe da rappresentare una raccolta di collegamenti di riferimento REST.
TeamIterationAttributes
TeamSettingsIteration	Rappresenta un riferimento superficiale per una singola iterazione.
TimeFrame	Intervallo di tempo dell'iterazione, ad esempio passato, corrente o futuro.

ReferenceLinks

Classe da rappresentare una raccolta di collegamenti di riferimento REST.

Nome	Tipo	Descrizione
links	object	Visualizzazione di lettura dei collegamenti. Poiché i collegamenti di riferimento sono in sola lettura, si vuole esporre solo i collegamenti di riferimento come sola lettura.

TeamIterationAttributes

Nome	Tipo	Descrizione
finishDate	string	Data di fine dell'iterazione. Data-only, corretta annullata a mezzanotte in UTC.
startDate	string	Data di inizio dell'iterazione. Data-only, corretta annullata a mezzanotte in UTC.
timeFrame	TimeFrame	Intervallo di tempo dell'iterazione, ad esempio passato, corrente o futuro.

TeamSettingsIteration

Rappresenta un riferimento superficiale per una singola iterazione.

Nome	Tipo	Descrizione
_links	ReferenceLinks	Raccolta di collegamenti pertinenti alla risorsa
attributes	TeamIterationAttributes	Attributi dell'iterazione, ad esempio data di inizio e fine.
id	string	ID dell'iterazione.
name	string	Nome dell'iterazione.
path	string	Percorso relativo dell'iterazione.
url	string	Collegamento http completo alla risorsa

TimeFrame

Intervallo di tempo dell'iterazione, ad esempio passato, corrente o futuro.

Nome	Tipo	Descrizione
current	string
future	string
past	string

Condividi tramite