Temp Queries - Create

Referência

Service:: Work Item Tracking

API Version:: 7.1-preview.1

Cria uma consulta temporária

Saiba mais sobre a sintaxe WIQL (Work Item Query Language) aqui.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
organization	path	True	string	O nome da organização do Azure DevOps.
project	path	True	string	ID do projeto ou nome do projeto
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '7.1-preview.1' para usar essa versão da API.

Corpo da solicitação

Nome	Tipo	Description
_links	ReferenceLinks	Vincular referências a recursos REST relacionados.
url	string
wiql	string	O texto WIQL da consulta temporária

Respostas

Nome	Tipo	Description
200 OK	TemporaryQueryResponseModel	operação bem-sucedida

Segurança

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

Nome	Description
vso.work_write	Concede a capacidade de ler, criar e atualizar itens de trabalho e consultas, atualizar metadados do quadro, ler caminhos de área e iterações de outros itens de trabalho que acompanham metadados relacionados, executar consultas e receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço.

Exemplos

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

Definições

Nome	Description
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
TemporaryQueryRequestModel	Descreve uma solicitação para criar uma consulta temporária
TemporaryQueryResponseModel	O resultado de uma criação de consulta temporária.

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

Nome	Tipo	Description
links	object	A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

TemporaryQueryRequestModel

Descreve uma solicitação para criar uma consulta temporária

Nome	Tipo	Description
_links	ReferenceLinks	Vincular referências a recursos REST relacionados.
url	string
wiql	string	O texto WIQL da consulta temporária

TemporaryQueryResponseModel

O resultado de uma criação de consulta temporária.

Nome	Tipo	Description
id	string	A ID do item de consulta temporária.

Compartilhar via