Reporting Work Item Links - Get
作業項目リンクのバッチを取得する
GET https://dev.azure.com/{organization}/{project}/_apis/wit/reporting/workitemlinks?api-version=7.1-preview.3
GET https://dev.azure.com/{organization}/{project}/_apis/wit/reporting/workitemlinks?linkTypes={linkTypes}&types={types}&continuationToken={continuationToken}&startDateTime={startDateTime}&api-version=7.1-preview.3
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
organization
|
path | True |
string |
Azure DevOps 組織の名前です。 |
project
|
path |
string |
プロジェクト ID またはプロジェクト名 |
|
api-version
|
query | True |
string |
使う API のバージョン。 このバージョンの API を使用するには、これを '7.1-preview.3' に設定する必要があります。 |
continuation
|
query |
string |
バッチを開始する continuationToken を指定します。 リンクの最初のバッチを取得するには、このパラメーターを省略します。 |
|
link
|
query |
string array (string) |
結果を特定のリンクの種類にフィルター処理する型の一覧。 すべてのリンクの種類の作業項目リンクを取得するには、このパラメーターを省略します。 |
|
start
|
query |
string date-time |
リンクの変更の開始点として使用する日付/時刻。 その日時より後に発生したリンク変更のみが返されます。 'watermark' パラメーターと組み合わせて使用することはできません。 |
|
types
|
query |
string array (string) |
結果を特定の作業項目の種類にフィルター処理する型の一覧。 すべての作業項目の種類の作業項目リンクを取得するには、このパラメーターを省略します。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
成功した操作 |
セキュリティ
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=7.1-preview.3
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 |
ContinuationToken は waterMark として機能します。 大きな結果のクエリを実行するときに使用されます。 |
isLastBatch |
boolean |
最後のバッチの場合は 'true' を返し、それ以外の場合は 'false' を返します。 |
nextLink |
string |
作業項目の次のリンク。 |
values |
string[] |
rel、sourceId、TargetId、ChangedDate、isActive などの値。 |