Iterations - Get Iteration Work Items

参考

Service:: Work

API Version:: 7.1-preview.1

获取用于迭代的工作项

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

URI 参数

名称	在	必需	类型	说明
iterationId	path	True	string uuid	迭代的 ID
organization	path	True	string	Azure DevOps 组织的名称。
project	path	True	string	项目 ID 或项目名称
team	path		string	团队 ID 或团队名称
api-version	query	True	string	要使用的 API 版本。这应设置为“7.1-preview.1”才能使用此版本的 API。

响应

名称	类型	说明
200 OK	IterationWorkItems	成功的操作

安全性

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

名称	说明
vso.work	授予读取工作项、查询、版块、区域和迭代路径以及其他工作项跟踪相关元数据的能力。此外，还授予执行查询、搜索工作项以及通过服务挂钩接收有关工作项事件的通知的能力。

示例

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

定义

名称	说明
IterationWorkItems	表示迭代积压工作中的工作项
ReferenceLinks	表示 REST 引用链接集合的类。
WorkItemLink	两个工作项之间的链接。
WorkItemReference	包含对工作项的引用。

IterationWorkItems

表示迭代积压工作中的工作项

名称	类型	说明
_links	ReferenceLinks	与资源相关的链接集合
url	string	指向资源的完整 http 链接
workItemRelations	WorkItemLink[]	工作项关系

ReferenceLinks

表示 REST 引用链接集合的类。

名称	类型	说明
links	object	链接的只读视图。由于引用链接是只读的，因此我们只想将其公开为只读。

WorkItemLink

两个工作项之间的链接。

名称	类型	说明
rel	string	链接的类型。
source	WorkItemReference	源工作项。
target	WorkItemReference	目标工作项。

WorkItemReference

包含对工作项的引用。

名称	类型	说明
id	integer	工作项 ID。
url	string	资源的 REST API URL

通过