Reporting Work Item Revisions - Read Reporting Revisions Post

リファレンス

サービス:: Work Item Tracking

API バージョン:: 7.1

作業項目のリビジョンのバッチを取得します。この要求は、フィールドのリストが長さの制限を超えて URL を実行できる十分な大きさの場合に使用できます。

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

省略可能なパラメーターを含む:

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

URI パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前。
project	path		string	プロジェクト ID またはプロジェクト名
api-version	query	True	string	使用する API のバージョン。このバージョンの API を使用するには、これを '7.1' に設定する必要があります。
$expand	query		ReportingRevisionsExpand
continuationToken	query		string	バッチを開始する基準値を指定します。リビジョンの最初のバッチを取得するには、このパラメーターを省略します。
startDateTime	query		string (date-time)	リビジョンの開始点として使用する日付/時刻は、すべてのリビジョンがこの日付/時刻より後に発生します。 'watermark' パラメーターと組み合わせて使用することはできません。

要求本文

名前	型	説明
fields	string[]	作業項目の変更履歴で返されるフィールドの一覧。レポート可能なすべてのフィールドを取得するには、このパラメーターを省略します。
includeDeleted	boolean	削除された作業項目を結果に含めます。
includeIdentityRef	boolean	ID フィールドの文字列値ではなく、ID 参照を返します。
includeLatestOnly	boolean	作業項目の以前のすべてのリビジョンをスキップして、作業項目の最新バージョンのみを含めます。
includeTagRef	boolean	System.Tags フィールドの文字列値の代わりにタグ参照を含める
types	string[]	結果を特定の作業項目の種類にフィルター処理する型の一覧。すべての作業項目の種類の作業項目の変更履歴を取得するには、このパラメーターを省略します。

応答

名前	型	説明
200 OK	ReportingWorkItemRevisionsBatch	成功した操作

セキュリティ

oauth2

型: oauth2
フロー: accessCode
Authorization URL (承認 URL): https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL (トークン 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

スコープ

名前	説明
vso.work	作業項目、クエリ、ボード、領域とイテレーションのパス、およびその他の作業項目追跡関連のメタデータを読み取る機能を付与します。また、クエリを実行したり、作業項目を検索したり、サービスフックを介して作業項目イベントに関する通知を受信したりすることもできます。

例

要求のサンプル

HTTP

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

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

応答のサンプル

状態コード:: 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
}

定義

名前	説明
ReportingRevisionsExpand
ReportingWorkItemRevisionsBatch
ReportingWorkItemRevisionsFilter	このクラスは、レポート作業項目リビジョンファイラーを表します。

ReportingRevisionsExpand

列挙

値	説明
fields	応答にフィールドを追加します。
none	既定の動作。

ReportingWorkItemRevisionsBatch

Object

名前	型	説明
continuationToken	string	ContinuationToken は waterMark として機能します。大規模な結果のクエリ中に使用されます。
isLastBatch	boolean	最後のバッチの場合は 'true' を返し、それ以外の場合は 'false' を返します。
nextLink	string	作業項目の次のリンク。
values	string[] (T)	rel、sourceId、TargetId、ChangedDate、isActive などの値。

ReportingWorkItemRevisionsFilter