Temp Queries - Create

Referência

Serviço:: Work Item Tracking

Versão da API:: 7.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

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' 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

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do Token: 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

Escopos

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

Exemplos

Create a temporary query

Solicitação de exemplo

HTTP

POST https://dev.azure.com/{organization}/{project}/_apis/wit/tempqueries?api-version=7.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"
}

Resposta de exemplo

Código de status:: 200

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

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

Objeto

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

Objeto

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

Objeto

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

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