Temp Queries - Create

Référence

Service:: Work Item Tracking

API Version:: 7.1-preview.1

Crée une requête temporaire

En savoir plus sur la syntaxe WIQL (Work Item Query Language) ici.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
organization	path	True	string	Nom de l’organisation Azure DevOps.
project	path	True	string	ID de projet ou nom du projet
api-version	query	True	string	Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1-preview.1 » pour utiliser cette version de l’API.

Corps de la demande

Nom	Type	Description
_links	ReferenceLinks	Lier des références à des ressources REST associées.
url	string
wiql	string	Texte WIQL de la requête temporaire

Réponses

Nom	Type	Description
200 OK	TemporaryQueryResponseModel	opération réussie

Sécurité

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

Nom	Description
vso.work_write	Accorde la possibilité de lire, créer et mettre à jour des éléments de travail et des requêtes, mettre à jour les métadonnées du tableau, les zones de lecture et les itérations chemins d’autres métadonnées associées au suivi des éléments de travail, exécuter des requêtes et recevoir des notifications sur les événements d’élément de travail via des hooks de service.

Exemples

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

Définitions

Nom	Description
ReferenceLinks	Classe pour représenter une collection de liens de référence REST.
TemporaryQueryRequestModel	Décrit une demande de création d’une requête temporaire
TemporaryQueryResponseModel	Résultat d’une création de requête temporaire.

ReferenceLinks

Classe pour représenter une collection de liens de référence REST.

Nom	Type	Description
links	object	Vue en lecture seule des liens. Étant donné que les liens référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

TemporaryQueryRequestModel

Décrit une demande de création d’une requête temporaire

Nom	Type	Description
_links	ReferenceLinks	Lier des références à des ressources REST associées.
url	string
wiql	string	Texte WIQL de la requête temporaire

TemporaryQueryResponseModel

Résultat d’une création de requête temporaire.

Nom	Type	Description
id	string	ID de l’élément de requête temporaire.