Condividi tramite

Iterations - Post Team Iteration

  • Riferimento
Servizio:
Work
Versione API:
7.1

Aggiungere un'iterazione al team

POST https://dev.azure.com/{organization}/{project}/{team}/_apis/work/teamsettings/iterations?api-version=7.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. Deve essere impostato su '7.1' per usare questa versione dell'API.

Corpo della richiesta

Nome Tipo Descrizione
_links

ReferenceLinks

Raccolta di collegamenti rilevanti per la risorsa
attributes

TeamIterationAttributes

Attributi dell'iterazione, ad esempio data di inizio e fine.
id

string (uuid)

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

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL token: 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

Ambiti

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

Esempio

Add an iteration to the team

Esempio di richiesta

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

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

Risposta di esempio

Codice di stato:
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 per 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.
Object

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome Tipo Descrizione
links

object

Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura.

TeamIterationAttributes

Object
Nome Tipo Descrizione
finishDate

string (date-time)

Data di fine dell'iterazione. Solo data, corretta annullata a mezzanotte in formato UTC.
startDate

string (date-time)

Data di inizio dell'iterazione. Solo data, corretta annullata a mezzanotte in formato UTC.
timeFrame

TimeFrame

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

TeamSettingsIteration

Object

Rappresenta un riferimento superficiale per una singola iterazione.

Nome Tipo Descrizione
_links

ReferenceLinks

Raccolta di collegamenti rilevanti per la risorsa
attributes

TeamIterationAttributes

Attributi dell'iterazione, ad esempio data di inizio e fine.
id

string (uuid)

ID dell'iterazione.
name

string

Nome dell'iterazione.
path

string

Percorso relativo dell'iterazione.
url

string

Collegamento HTTP completo alla risorsa

TimeFrame

Enumerazione

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

Valore Descrizione
current
future
past