Temp Queries - Create

Reference

Service:: Work Item Tracking

API Version:: 7.1-preview.1

Vytvoří dočasný dotaz.

Další informace o syntaxi jazyka WIQL (Work Item Query Language) najdete tady.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
organization	path	True	string	Název organizace Azure DevOps.
project	path	True	string	ID projektu nebo název projektu
api-version	query	True	string	Verze rozhraní API, která se má použít. Tato verze rozhraní API by měla být nastavená na 7.1-preview.1.

Text požadavku

Name	Typ	Description
_links	ReferenceLinks	Odkazy na související prostředky REST.
url	string
wiql	string	Text JAZYKa WIQL dočasného dotazu

Odpovědi

Name	Typ	Description
200 OK	TemporaryQueryResponseModel	úspěšná operace

Zabezpečení

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	Description
vso.work_write	Uděluje možnost číst, vytvářet a aktualizovat pracovní položky a dotazy, metadata aktualizačního panelu, oblast čtení a iterace cest k jiným metadatům souvisejícím se sledováním pracovních položek, spouštět dotazy a přijímat oznámení o událostech pracovních položek prostřednictvím zachytávání služeb.

Příklady

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

Definice

Name	Description
ReferenceLinks	Třída představující kolekci odkazů REST.
TemporaryQueryRequestModel	Popisuje požadavek na vytvoření dočasného dotazu.
TemporaryQueryResponseModel	Výsledek vytvoření dočasného dotazu.

ReferenceLinks

Třída představující kolekci odkazů REST.

Name	Typ	Description
links	object	Zobrazení odkazů jen pro čtení. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako odkazy jen pro čtení.

TemporaryQueryRequestModel

Popisuje požadavek na vytvoření dočasného dotazu.

Name	Typ	Description
_links	ReferenceLinks	Odkazy na související prostředky REST.
url	string
wiql	string	Text JAZYKa WIQL dočasného dotazu

TemporaryQueryResponseModel

Výsledek vytvoření dočasného dotazu.

Name	Typ	Description
id	string	ID položky dočasného dotazu.

Sdílet prostřednictvím