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	プロジェクト ID またはプロジェクト名
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	一時クエリ項目の ID。

Share via