Udostępnij za pośrednictwem


Reporting Work Item Links - Get

Pobieranie partii łączy elementów roboczych

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
organization
path True

string

Nazwa organizacji usługi Azure DevOps.

project
path

string

Identyfikator projektu lub nazwa projektu

api-version
query True

string

Wersja interfejsu API do użycia. Należy ustawić wartość "4.1", aby używać tej wersji interfejsu API.

continuationToken
query

string

Określa parametr continuationToken, aby uruchomić partię z. Pomiń ten parametr, aby uzyskać pierwszą partię łączy.

linkTypes
query

string

array (string)

Lista typów do filtrowania wyników pod kątem określonych typów linków. Pomiń ten parametr, aby uzyskać łącza do elementów roboczych wszystkich typów linków.

startDateTime
query

string

date-time

Data/godzina, która ma być używana jako punkt wyjścia dla zmian linków. Zostaną zwrócone tylko zmiany linków, które wystąpiły po tej dacie/godzinie. Nie można używać w połączeniu z parametrem znaku wodnego.

types
query

string

array (string)

Lista typów do filtrowania wyników pod kątem określonych typów elementów roboczych. Pomiń ten parametr, aby uzyskać linki do elementów roboczych wszystkich typów elementów roboczych.

Odpowiedzi

Nazwa Typ Opis
200 OK

ReportingWorkItemLinksBatch

operacja zakończona powodzeniem

Zabezpieczenia

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

Nazwa Opis
vso.work Umożliwia odczytywanie elementów roboczych, zapytań, tablic, ścieżek obszaru i iteracji oraz innych metadanych powiązanych ze śledzeniem elementów roboczych. Umożliwia również wykonywanie zapytań i odbieranie powiadomień o zdarzeniach elementu roboczego za pośrednictwem punktów zaczepienia usługi.

Przykłady

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
}

Definicje

ReportingWorkItemLinksBatch

Nazwa Typ Opis
continuationToken

string

isLastBatch

boolean

nextLink

string

values

string[]