次の方法で共有


Reporting Work Item Links - Get

作業項目リンクのバッチを取得する

GET https://dev.azure.com/{organization}/{project}/_apis/wit/reporting/workitemlinks?api-version=4.1
GET https://dev.azure.com/{organization}/{project}/_apis/wit/reporting/workitemlinks?linkTypes={linkTypes}&types={types}&continuationToken={continuationToken}&startDateTime={startDateTime}&api-version=4.1

URI パラメーター

名前 / 必須 説明
organization
path True

string

Azure DevOps 組織の名前です。

project
path

string

プロジェクト ID またはプロジェクト名

api-version
query True

string

使う API のバージョン。 このバージョンの API を使用するには、これを '4.1' に設定する必要があります。

continuationToken
query

string

バッチを開始する continuationToken を指定します。 リンクの最初のバッチを取得するには、このパラメーターを省略します。

linkTypes
query

string

array (string)

結果を特定のリンクの種類にフィルター処理する型の一覧。 すべてのリンクの種類の作業項目リンクを取得するには、このパラメーターを省略します。

startDateTime
query

string

date-time

リンク変更の開始点として使用する日付/時刻。 その日付/時刻より後に発生したリンク変更のみが返されます。 'watermark' パラメーターと組み合わせて使用することはできません。

types
query

string

array (string)

結果を特定の作業項目の種類にフィルター処理する型の一覧。 すべての作業項目の種類の作業項目リンクを取得するには、このパラメーターを省略します。

応答

名前 説明
200 OK

ReportingWorkItemLinksBatch

正常な操作

セキュリティ

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

Sample Request

GET https://dev.azure.com/fabrikam/_apis/wit/reporting/workitemlinks?api-version=4.1

Sample Response

{
  "values": [
    {
      "rel": "System.LinkTypes.Hierarchy",
      "sourceId": 7,
      "targetId": 8,
      "changedDate": "2014-03-18T17:17:52.02Z",
      "isActive": true
    },
    {
      "rel": "System.LinkTypes.Hierarchy",
      "sourceId": 7,
      "targetId": 9,
      "changedDate": "2014-03-18T17:18:03.007Z",
      "isActive": true
    },
    {
      "rel": "System.LinkTypes.Hierarchy",
      "sourceId": 10,
      "targetId": 13,
      "changedDate": "2014-03-18T17:21:27.623Z",
      "isActive": true
    }
  ],
  "nextLink": "https://dev.azure.com/fabrikam/_apis/wit/reporting/workItemLinks?continuationToken=6281123&api-version=2.2",
  "isLastBatch": true
}

定義

ReportingWorkItemLinksBatch

名前 説明
continuationToken

string

isLastBatch

boolean

nextLink

string

values

string[]