Temp Queries - Create

Service:

Work Item Tracking

API Version:

7.1-preview.1

Tworzy zapytanie tymczasowe

Dowiedz się więcej o składni języka zapytań elementów roboczych (WIQL) tutaj.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
project	path	True	string	Identyfikator projektu lub nazwa projektu
api-version	query	True	string	Wersja interfejsu API do użycia. Ta wartość powinna być ustawiona na wartość "7.1-preview.1", aby używać tej wersji interfejsu API.

Treść żądania

Nazwa	Typ	Opis
_links	ReferenceLinks	Linki do powiązanych zasobów REST.
url	string
wiql	string	Tekst WIQL zapytania tymczasowego

Odpowiedzi

Nazwa	Typ	Opis
200 OK	TemporaryQueryResponseModel	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_write	Umożliwia odczytywanie, tworzenie i aktualizowanie elementów roboczych i zapytań, aktualizowanie metadanych tablicy, ścieżki obszaru odczytu i iteracji innych metadanych powiązanych z elementami roboczymi, wykonywanie zapytań i odbieranie powiadomień o zdarzeniach elementów roboczych za pośrednictwem punktów zaczepienia usługi.

Przykłady

Create a temporary query

Sample Request

HTTP

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

{
  "wiql": "Select [System.Id], [System.Title], [System.State] From WorkItems Where [System.WorkItemType] = 'Bug' order by [Microsoft.VSTS.Common.Priority] asc, [System.CreatedDate] desc"
}

Sample Response

Status code:

200

x-VSS-SenderDeploymentId: 2db76d77-1768-4e9f-8fb8-84255eaacced
persistent-Auth: true
lfs-Authenticate: NTLM

Response Body

{
  "id": "ac2ed29e-745d-4272-862d-53a2b58e528f"
}

Definicje

Nazwa	Opis
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
TemporaryQueryRequestModel	Opisuje żądanie utworzenia zapytania tymczasowego
TemporaryQueryResponseModel	Wynik tymczasowego tworzenia zapytania.

ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa	Typ	Opis
links	object	Widok linków w trybie tylko do odczytu. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

TemporaryQueryRequestModel

Opisuje żądanie utworzenia zapytania tymczasowego

Nazwa	Typ	Opis
_links	ReferenceLinks	Linki do powiązanych zasobów REST.
url	string
wiql	string	Tekst WIQL zapytania tymczasowego

TemporaryQueryResponseModel

Wynik tymczasowego tworzenia zapytania.

Nazwa	Typ	Opis
id	string	Identyfikator elementu zapytania tymczasowego.