Compartir a través de

Iterations - Get Iteration Work Items

  • Referencia
Servicio:
Work
Versión de la API:
7.1

Obtención de elementos de trabajo para la iteración

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
iterationId
 path True

string (uuid)

Identificador de la iteración
organization
 path True

string

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" para usar esta versión de la API.

Respuestas

Nombre Tipo Description
200 OK

IterationWorkItems

operación correcta

Seguridad

oauth2

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del 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

Ámbitos

Nombre Description
vso.work Concede la capacidad de leer elementos de trabajo, consultas, paneles, rutas de acceso de área e iteraciones y otros metadatos relacionados con el seguimiento de elementos de trabajo. También concede la capacidad de ejecutar consultas, buscar elementos de trabajo y recibir notificaciones sobre eventos de elementos de trabajo a través de enlaces de servicio.

Ejemplos

Get workitems

Solicitud de ejemplo

GET https://dev.azure.com/fabrikam/Fabrikam-Fiber/_apis/work/teamsettings/iterations/a589a806-bf11-4d4f-a031-c19813331553/workitems?api-version=7.1

Respuesta de muestra

status code:
200 
{
  "workItemRelations": [
    {
      "rel": null,
      "source": null,
      "target": {
        "id": 1,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/1"
      }
    },
    {
      "rel": "System.LinkTypes.Hierarchy-Forward",
      "source": {
        "id": 1,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/1"
      },
      "target": {
        "id": 3,
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/3"
      }
    }
  ],
  "url": "https://dev.azure.com/fabrikam/Fabrikam-Fiber/_apis/work/teamsettings/iterations/a589a806-bf11-4d4f-a031-c19813331553/workitems",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/Fabrikam-Fiber/_apis/work/teamsettings/iterations/a589a806-bf11-4d4f-a031-c19813331553/workitems"
    },
    "iteration": {
      "href": "https://dev.azure.com/fabrikam/Fabrikam-Fiber/_apis/work/teamsettings/iterations/a589a806-bf11-4d4f-a031-c19813331553"
    }
  }
}

Definiciones

Nombre Description
IterationWorkItems

Representa elementos de trabajo en un trabajo pendiente de iteración.
ReferenceLinks

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

Vínculo entre dos elementos de trabajo.
WorkItemReference

Contiene referencia a un elemento de trabajo.

IterationWorkItems

Object

Representa elementos de trabajo en un trabajo pendiente de iteración.

Nombre Tipo Description
_links

ReferenceLinks

Colección de vínculos relevantes para el recurso
url

string

Vínculo http completo al recurso
workItemRelations

WorkItemLink[]

Relaciones de elementos de trabajo
Object

Clase que representa una colección de vínculos de referencia 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.
Object

Vínculo entre dos elementos de trabajo.

Nombre Tipo Description
rel

string

Tipo de vínculo.
source

WorkItemReference

Elemento de trabajo de origen.
target

WorkItemReference

Elemento de trabajo de destino.

WorkItemReference

Object

Contiene referencia a un elemento de trabajo.

Nombre Tipo Description
id

integer (int32)

Identificador del elemento de trabajo.
url

string

DIRECCIÓN URL de la API REST del recurso