Iterations - Post Team Iteration

Referencia

Service:: Work

API Version:: 7.1-preview.1

Agregar una iteración al equipo

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	El nombre de la organización de Azure DevOps.
project	path	True	string	Id. de proyecto o nombre del proyecto
team	path		string	Id. de equipo o nombre del equipo
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "7.1-preview.1" para usar esta versión de la API.

Cuerpo de la solicitud

Nombre	Tipo	Description
_links	ReferenceLinks	Colección de vínculos relevantes para el recurso
attributes	TeamIterationAttributes	Atributos de la iteración, como la fecha de inicio y finalización.
id	string	Identificador de la iteración.
name	string	Nombre de la iteración.
path	string	Ruta de acceso relativa de la iteración.
url	string	Vínculo HTTP completo al recurso

Respuestas

Nombre	Tipo	Description
200 OK	TeamSettingsIteration	operación correcta

Seguridad

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

Nombre	Description
vso.work_write	Concede la capacidad de leer, crear y actualizar elementos de trabajo y consultas, actualizar metadatos del panel, leer áreas de lectura e iteraciones rutas de acceso a otros metadatos relacionados de seguimiento de elementos de trabajo, ejecutar consultas y recibir notificaciones sobre eventos de elementos de trabajo a través de enlaces de servicio.

Ejemplos

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"
    }
  }
}

Definiciones

Nombre	Description
ReferenceLinks	Clase que representa una colección de vínculos de referencia de REST.
TeamIterationAttributes
TeamSettingsIteration	Representa una referencia superficial para una sola iteración.
TimeFrame	Período de tiempo de la iteración, como pasado, actual o futuro.

ReferenceLinks

Clase que representa una colección de vínculos de referencia de REST.

Nombre	Tipo	Description
links	object	Vista de solo lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.

TeamIterationAttributes

Nombre	Tipo	Description
finishDate	string	Fecha de finalización de la iteración. Solo fecha, correcto sin ajustar a medianoche en UTC.
startDate	string	Fecha de inicio de la iteración. Solo fecha, correcto sin ajustar a medianoche en UTC.
timeFrame	TimeFrame	Período de tiempo de la iteración, como pasado, actual o futuro.

TeamSettingsIteration

Representa una referencia superficial para una sola iteración.

Nombre	Tipo	Description
_links	ReferenceLinks	Colección de vínculos relevantes para el recurso
attributes	TeamIterationAttributes	Atributos de la iteración, como la fecha de inicio y finalización.
id	string	Identificador de la iteración.
name	string	Nombre de la iteración.
path	string	Ruta de acceso relativa de la iteración.
url	string	Vínculo HTTP completo al recurso

TimeFrame

Período de tiempo de la iteración, como pasado, actual o futuro.

Nombre	Tipo	Description
current	string
future	string
past	string

Compartir a través de