Temp Queries - Create

Service:

Work Item Tracking

API Version:

7.1-preview.1

Создает временный запрос

Дополнительные сведения о синтаксисе языка запросов рабочих элементов (WIQL) см. здесь.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
organization	path	True	string	Название организации Azure DevOps.
project	path	True	string	Идентификатор или имя проекта
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение 7.1-preview.1.

Текст запроса

Имя	Тип	Описание
_links	ReferenceLinks	Ссылки на связанные ресурсы REST.
url	string
wiql	string	Текст WIQL временного запроса

Ответы

Имя	Тип	Описание
200 OK	TemporaryQueryResponseModel	успешная операция

Безопасность

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

Имя	Описание
vso.work_write	Предоставляет возможность читать, создавать и обновлять рабочие элементы и запросы, обновлять метаданные доски, пути к областям чтения и итерациям других связанных метаданных отслеживания рабочих элементов, выполнять запросы и получать уведомления о событиях рабочих элементов с помощью перехватчиков служб.

Примеры

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

Определения

Имя	Описание
ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
TemporaryQueryRequestModel	Описывает запрос на создание временного запроса.
TemporaryQueryResponseModel	Результат создания временного запроса.

ReferenceLinks

Класс, представляющий коллекцию ссылок REST.

Имя	Тип	Описание
links	object	Представление ссылок только для чтения. Так как ссылочные ссылки доступны только для чтения, мы хотим предоставить их только для чтения.

TemporaryQueryRequestModel

Описывает запрос на создание временного запроса.

Имя	Тип	Описание
_links	ReferenceLinks	Ссылки на связанные ресурсы REST.
url	string
wiql	string	Текст WIQL временного запроса

TemporaryQueryResponseModel

Результат создания временного запроса.

Имя	Тип	Описание
id	string	Идентификатор временного элемента запроса.