Reporting Work Item Revisions - Read Reporting Revisions Post

參考

Service:: Work Item Tracking

API Version:: 4.1

取得工作專案修訂的批次。如果您的欄位清單夠大，因此可能會超過長度限制來執行 URL，則可能會使用此要求。

POST https://dev.azure.com/{organization}/{project}/_apis/wit/reporting/workitemrevisions?api-version=4.1

With optional parameters:

POST https://dev.azure.com/{organization}/{project}/_apis/wit/reporting/workitemrevisions?continuationToken={continuationToken}&startDateTime={startDateTime}&$expand={$expand}&api-version=4.1

URI 參數

名稱	位於	必要	類型	Description
organization	path	True	string	Azure DevOps 組織的名稱。
project	path		string	專案識別碼或專案名稱
api-version	query	True	string	要使用的 API 版本。這應該設定為 '4.1' 以使用此版本的 API。
$expand	query		ReportingRevisionsExpand
continuationToken	query		string	指定要啟動批次的來源浮水印。省略此參數以取得第一批修訂。
startDateTime	query		string date-time	要用來作為修訂起點的日期/時間，所有修訂都會在此日期/時間之後發生。無法與 'watermark' 參數搭配使用。

要求本文

名稱	類型	Description
fields	string[]	要傳回工作專案修訂的欄位清單。省略此參數以取得所有可報告欄位。
includeDeleted	boolean	在結果中包含已刪除的工作專案。
includeIdentityRef	boolean	傳回識別參考，而不是識別欄位的字串值。
includeLatestOnly	boolean	只包含最新版的工作專案，略過工作專案的所有先前修訂。
includeTagRef	boolean	包含標籤參考，而不是 System.Tags 欄位的字串值
types	string[]	將結果篩選為特定工作專案類型的型別清單。省略此參數以取得所有工作專案類型的工作專案修訂。

回應

名稱	類型	Description
200 OK	ReportingWorkItemRevisionsBatch	成功的作業

安全性

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

名稱	Description
vso.work	授與讀取工作專案、查詢、面板、區域和反復專案路徑，以及其他工作專案追蹤相關中繼資料的能力。也授與執行查詢的能力，以及透過服務勾點接收工作專案事件的相關通知。

範例

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/_apis/wit/reporting/workitemrevisions?continuationToken=813;350;1&api-version=4.1

{
  "types": [
    "Bug",
    "Task",
    "Product Backlog Item"
  ],
  "fields": [
    "System.WorkItemType",
    "System.Title",
    "System.AreaPath"
  ],
  "includeIdentityRef": true
}

Sample Response

Status code:: 200

{
  "values": [
    {
      "id": 3,
      "rev": 8,
      "fields": {
        "System.AreaPath": "Fabrikam-Fiber-Git",
        "System.WorkItemType": "Product Backlog Item",
        "System.Title": "Technician can submit invoices on Windows Phone"
      }
    }
  ],
  "nextLink": "https://dev.azure.com/fabrikam/_apis/wit/reporting/workItemRevisions?continuationToken=842;5;3&api-version=2.0",
  "isLastBatch": true
}

定義

名稱	Description
ReportingRevisionsExpand
ReportingWorkItemRevisionsBatch
ReportingWorkItemRevisionsFilter

ReportingRevisionsExpand

名稱	類型	Description
fields	string
none	string

ReportingWorkItemRevisionsBatch

名稱	類型	Description
continuationToken	string
isLastBatch	boolean
nextLink	string
values	string[]

ReportingWorkItemRevisionsFilter

名稱	類型	Description
fields	string[]	要傳回工作專案修訂的欄位清單。省略此參數以取得所有可報告欄位。
includeDeleted	boolean	在結果中包含已刪除的工作專案。
includeIdentityRef	boolean	傳回識別參考，而不是識別欄位的字串值。
includeLatestOnly	boolean	只包含最新版的工作專案，略過工作專案的所有先前修訂。
includeTagRef	boolean	包含標籤參考，而不是 System.Tags 欄位的字串值
types	string[]	將結果篩選為特定工作專案類型的型別清單。省略此參數以取得所有工作專案類型的工作專案修訂。

共用方式為