Iterations - Get Iteration Work Items

Referência

Service:: Work

API Version:: 7.1-preview.1

Obter itens de trabalho para iteração

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
iterationId	path	True	string uuid	ID da iteração
organization	path	True	string	O nome da organização do Azure DevOps.
project	path	True	string	ID do projeto ou nome do projeto
team	path		string	ID da equipe ou nome da equipe
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '7.1-preview.1' para usar essa versão da API.

Respostas

Nome	Tipo	Description
200 OK	IterationWorkItems	operação bem-sucedida

Segurança

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	Description
vso.work	Concede a capacidade de ler itens de trabalho, consultas, quadros, caminhos de área e iterações e outros metadados relacionados ao acompanhamento de itens de trabalho. Também concede a capacidade de executar consultas, pesquisar itens de trabalho e receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço.

Exemplos

Get workitems

Sample Request

HTTP

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

Sample Response

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

Definições

Nome	Description
IterationWorkItems	Representa itens de trabalho em uma lista de pendências de iteração
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
WorkItemLink	Um link entre dois itens de trabalho.
WorkItemReference	Contém referência a um item de trabalho.

IterationWorkItems

Representa itens de trabalho em uma lista de pendências de iteração

Nome	Tipo	Description
_links	ReferenceLinks	Coleção de links relevantes para o recurso
url	string	Link http completo para o recurso
workItemRelations	WorkItemLink[]	Relações de item de trabalho

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

Nome	Tipo	Description
links	object	A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

WorkItemLink

Um link entre dois itens de trabalho.

Nome	Tipo	Description
rel	string	O tipo de link.
source	WorkItemReference	O item de trabalho de origem.
target	WorkItemReference	O item de trabalho de destino.

WorkItemReference

Contém referência a um item de trabalho.

Nome	Tipo	Description
id	integer	ID do item de trabalho.
url	string	URL da API REST do recurso

Partilhar via