Reporting Work Item Revisions - Read Reporting Revisions Post

참조

Service:: Work Item Tracking

API Version:: 7.1-preview.2

작업 항목 수정 버전 일괄 처리를 가져옵니다. 필드 목록이 길이 제한을 초과하여 URL을 실행할 수 있을 만큼 충분히 큰 경우 이 요청을 사용할 수 있습니다.

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

With optional parameters:

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
organization	path	True	string	Azure DevOps 조직의 이름입니다.
project	path		string	프로젝트 ID 또는 프로젝트 이름
api-version	query	True	string	사용할 API의 버전입니다. 이 API 버전을 사용하려면 '7.1-preview.2'로 설정해야 합니다.
$expand	query		ReportingRevisionsExpand
continuationToken	query		string	일괄 처리를 시작할 워터마크를 지정합니다. 이 매개 변수를 생략하여 첫 번째 수정 버전 일괄 처리를 가져옵니다.
startDateTime	query		string date-time	수정 버전에 대한 시작점으로 사용할 날짜/시간이며, 모든 수정 버전은 이 날짜/시간 이후에 발생합니다. '워터마크' 매개 변수와 함께 사용할 수 없습니다.

요청 본문

Name	형식	Description
fields	string[]	작업 항목 수정 버전에서 반환할 필드 목록입니다. 이 매개 변수를 생략하여 모든 보고 가능한 필드를 가져옵니다.
includeDeleted	boolean	결과에 삭제된 작업 항목을 포함합니다.
includeIdentityRef	boolean	ID 필드에 대한 문자열 값 대신 ID 참조를 반환합니다.
includeLatestOnly	boolean	작업 항목의 모든 이전 수정 버전을 건너뛰고 최신 버전의 작업 항목만 포함합니다.
includeTagRef	boolean	System.Tags 필드에 대한 문자열 값 대신 태그 참조 포함
types	string[]	결과를 특정 작업 항목 형식으로 필터링하는 형식 목록입니다. 이 매개 변수를 생략하여 모든 작업 항목 유형의 작업 항목 수정 버전을 가져옵니다.

응답

Name	형식	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

Name	Description
vso.work	작업 항목, 쿼리, 보드, 영역 및 반복 경로 및 기타 작업 항목 추적 관련 메타데이터를 읽을 수 있는 기능을 부여합니다. 또한 쿼리를 실행하고, 작업 항목을 검색하고, 서비스 후크를 통해 작업 항목 이벤트에 대한 알림을 받을 수 있는 기능을 부여합니다.

예제

Sample Request

HTTP

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

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

정의

Name	Description
ReportingRevisionsExpand
ReportingWorkItemRevisionsBatch
ReportingWorkItemRevisionsFilter	클래스는 보고 작업 항목 수정 파일러를 나타냅니다.

ReportingRevisionsExpand

Name	형식	Description
fields	string	응답에 필드를 추가합니다.
none	string	기본 동작

ReportingWorkItemRevisionsBatch

Name	형식	Description
continuationToken	string	ContinuationToken은 워터마크 역할을 합니다. 큰 결과를 쿼리하는 동안 사용됩니다.
isLastBatch	boolean	마지막 일괄 처리인 경우 'true'를 반환하고, 그렇지 않으면 'false'를 반환합니다.
nextLink	string	작업 항목에 대한 다음 링크입니다.
values	string[]	rel, sourceId, TargetId, ChangedDate, isActive와 같은 값입니다.

ReportingWorkItemRevisionsFilter

클래스는 보고 작업 항목 수정 파일러를 나타냅니다.

Name	형식	Description
fields	string[]	작업 항목 수정 버전에서 반환할 필드 목록입니다. 이 매개 변수를 생략하여 모든 보고 가능한 필드를 가져옵니다.
includeDeleted	boolean	결과에 삭제된 작업 항목을 포함합니다.
includeIdentityRef	boolean	ID 필드에 대한 문자열 값 대신 ID 참조를 반환합니다.
includeLatestOnly	boolean	작업 항목의 모든 이전 수정 버전을 건너뛰고 최신 버전의 작업 항목만 포함합니다.
includeTagRef	boolean	System.Tags 필드에 대한 문자열 값 대신 태그 참조 포함
types	string[]	결과를 특정 작업 항목 형식으로 필터링하는 형식 목록입니다. 이 매개 변수를 생략하여 모든 작업 항목 유형의 작업 항목 수정 버전을 가져옵니다.

다음을 통해 공유