Reporting Work Item Links - Get

Referenz

Service:: Work Item Tracking

API Version:: 4.1

Abrufen eines Batches von Arbeitselementlinks

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

With optional parameters:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
project	path		string	Projekt-ID oder Projektname
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "4.1" festgelegt werden, um diese Version der API zu verwenden.
continuationToken	query		string	Gibt das continuationToken an, mit dem der Batch gestartet werden soll. Lassen Sie diesen Parameter aus, um den ersten Batch von Links abzurufen.
linkTypes	query		string array (string)	Eine Liste von Typen zum Filtern der Ergebnisse nach bestimmten Linktypen. Lassen Sie diesen Parameter aus, um Arbeitselementlinks aller Linktypen abzurufen.
startDateTime	query		string date-time	Datum/Uhrzeit, die als Ausgangspunkt für Linkänderungen verwendet werden soll. Nur Linkänderungen, die nach diesem Datum/dieser Uhrzeit aufgetreten sind, werden zurückgegeben. Kann nicht in Verbindung mit dem Parameter "Watermark" verwendet werden.
types	query		string array (string)	Eine Liste von Typen zum Filtern der Ergebnisse nach bestimmten Arbeitselementtypen. Lassen Sie diesen Parameter aus, um Arbeitselementlinks aller Arbeitselementtypen abzurufen.

Antworten

Name	Typ	Beschreibung
200 OK	ReportingWorkItemLinksBatch	Erfolgreicher Vorgang

Sicherheit

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	Beschreibung
vso.work	Ermöglicht das Lesen von Arbeitselementen, Abfragen, Boards, Bereichs- und Iterationspfaden und anderen Metadaten zur Nachverfolgung von Arbeitselementen. Ermöglicht außerdem das Ausführen von Abfragen und das Empfangen von Benachrichtigungen zu Arbeitselementereignissen über Diensthooks.

Beispiele

Sample Request

HTTP

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

Sample Response

Status code:: 200

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

Definitionen

ReportingWorkItemLinksBatch

Name	Typ	Beschreibung
continuationToken	string
isLastBatch	boolean
nextLink	string
values	string[]

Share via