Queries - Get Queries Batch
获取按 id (最大 1000) 的查询列表
POST https://dev.azure.com/{organization}/{project}/_apis/wit/queriesbatch?api-version=5.0
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
organization
|
path | True |
string |
Azure DevOps 组织的名称。 |
project
|
path | True |
string |
项目 ID 或项目名称 |
api-version
|
query | True |
string |
要使用的 API 版本。 应将其设置为“5.0”才能使用此版本的 API。 |
请求正文
名称 | 类型 | 说明 |
---|---|---|
$expand |
查询的 expand 参数。 可能的选项包括 { None、Wiql、Clauses、All、Minimal } |
|
errorPolicy |
用于控制查询批处理请求中的错误策略的标志。 可能的选项为 { Fail, Omit }。 |
|
ids |
string[] |
请求的查询 ID |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
成功的操作 |
安全性
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 | 授予读取工作项、查询、版块、区域和迭代路径以及其他工作项跟踪相关元数据的能力。 此外,还允许通过服务挂钩执行查询、搜索工作项和接收有关工作项事件的通知。 |
示例
Gets a list of queries by ids
Sample Request
POST https://dev.azure.com/fabrikam/{project}/_apis/wit/queriesbatch?api-version=5.0
{
"ids": [
"c6725763-d9ae-487e-bb42-00222e2f4d9f",
"c19eec2d-07a0-4c20-be57-3f7903792ca6",
"298f94fd-30ea-40f3-8d25-3202c9effa3a"
]
}
Sample Response
{
"count": 3,
"value": [
{
"id": "c6725763-d9ae-487e-bb42-00222e2f4d9f",
"name": "Work Items With Summary Values",
"path": "Shared Queries/Troubleshooting/Work Items With Summary Values",
"createdBy": {
"displayName": "Jamal Hartnett",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"_links": {
"avatar": {
"href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
}
},
"id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"uniqueName": "fabrikamfiber4@hotmail.com",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
},
"createdDate": "2018-09-26T19:01:44.6Z",
"lastModifiedBy": {
"displayName": "Jamal Hartnett",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"_links": {
"avatar": {
"href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
}
},
"id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"uniqueName": "fabrikamfiber4@hotmail.com",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
},
"lastModifiedDate": "2018-09-26T19:01:44.6Z",
"queryType": "oneHop",
"isPublic": true,
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/833d31e3-4fc9-48f4-9eef-4a0e9d8cf21d/_apis/wit/queries/c6725763-d9ae-487e-bb42-00222e2f4d9f"
},
"html": {
"href": "http://localhost:8080/tfs/web/qr.aspx?pguid=833d31e3-4fc9-48f4-9eef-4a0e9d8cf21d&qid=c6725763-d9ae-487e-bb42-00222e2f4d9f"
},
"parent": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/833d31e3-4fc9-48f4-9eef-4a0e9d8cf21d/_apis/wit/queries/0389af80-0be8-4c1b-800e-9e91d081e052"
},
"wiql": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/833d31e3-4fc9-48f4-9eef-4a0e9d8cf21d/_apis/wit/wiql/c6725763-d9ae-487e-bb42-00222e2f4d9f"
}
},
"url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/833d31e3-4fc9-48f4-9eef-4a0e9d8cf21d/_apis/wit/queries/c6725763-d9ae-487e-bb42-00222e2f4d9f"
},
{
"id": "c19eec2d-07a0-4c20-be57-3f7903792ca6",
"name": "Product Planning",
"path": "Shared Queries/Product Planning",
"createdBy": {
"displayName": "Jamal Hartnett",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"_links": {
"avatar": {
"href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
}
},
"id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"uniqueName": "fabrikamfiber4@hotmail.com",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
},
"createdDate": "2018-09-26T19:01:44.6Z",
"lastModifiedBy": {
"displayName": "Jamal Hartnett",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"_links": {
"avatar": {
"href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
}
},
"id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"uniqueName": "fabrikamfiber4@hotmail.com",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
},
"lastModifiedDate": "2018-09-26T19:01:44.6Z",
"queryType": "flat",
"isPublic": true,
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/833d31e3-4fc9-48f4-9eef-4a0e9d8cf21d/_apis/wit/queries/c19eec2d-07a0-4c20-be57-3f7903792ca6"
},
"html": {
"href": "http://localhost:8080/tfs/web/qr.aspx?pguid=833d31e3-4fc9-48f4-9eef-4a0e9d8cf21d&qid=c19eec2d-07a0-4c20-be57-3f7903792ca6"
},
"parent": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/833d31e3-4fc9-48f4-9eef-4a0e9d8cf21d/_apis/wit/queries/06285cdf-e6f2-4230-80fd-66a2e11116d2"
},
"wiql": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/833d31e3-4fc9-48f4-9eef-4a0e9d8cf21d/_apis/wit/wiql/c19eec2d-07a0-4c20-be57-3f7903792ca6"
}
},
"url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/833d31e3-4fc9-48f4-9eef-4a0e9d8cf21d/_apis/wit/queries/c19eec2d-07a0-4c20-be57-3f7903792ca6"
},
{
"id": "298f94fd-30ea-40f3-8d25-3202c9effa3a",
"name": "Current Iteration",
"path": "Shared Queries/Current Iteration",
"createdBy": {
"displayName": "Jamal Hartnett",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"_links": {
"avatar": {
"href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
}
},
"id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"uniqueName": "fabrikamfiber4@hotmail.com",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
},
"createdDate": "2018-09-26T19:01:44.6Z",
"lastModifiedBy": {
"displayName": "Jamal Hartnett",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"_links": {
"avatar": {
"href": "https://dev.azure.com/mseng/_apis/GraphProfile/MemberAvatars/aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
}
},
"id": "d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"uniqueName": "fabrikamfiber4@hotmail.com",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d291b0c4-a05c-4ea6-8df1-4b41d5f39eff",
"descriptor": "aad.YTkzODFkODYtNTYxYS03ZDdiLWJjM2QtZDUzMjllMjM5OTAz"
},
"lastModifiedDate": "2018-09-26T19:01:44.6Z",
"isFolder": true,
"hasChildren": true,
"isPublic": true,
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/833d31e3-4fc9-48f4-9eef-4a0e9d8cf21d/_apis/wit/queries/298f94fd-30ea-40f3-8d25-3202c9effa3a"
},
"html": {
"href": "http://localhost:8080/tfs/web/qr.aspx?pguid=833d31e3-4fc9-48f4-9eef-4a0e9d8cf21d&qid=298f94fd-30ea-40f3-8d25-3202c9effa3a"
},
"parent": {
"href": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/833d31e3-4fc9-48f4-9eef-4a0e9d8cf21d/_apis/wit/queries/06285cdf-e6f2-4230-80fd-66a2e11116d2"
}
},
"url": "https://dev.azure.com/fabrikam/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c/833d31e3-4fc9-48f4-9eef-4a0e9d8cf21d/_apis/wit/queries/298f94fd-30ea-40f3-8d25-3202c9effa3a"
}
]
}
定义
名称 | 说明 |
---|---|
Identity |
描述对标识的引用。 |
Link |
链接查询模式。 |
Logical |
分隔条件子句的逻辑运算符 |
Query |
描述获取查询列表的请求 |
Query |
用于控制查询批处理请求中的错误策略的标志。 可能的选项为 { Fail, Omit }。 |
Query |
查询的 expand 参数。 可能的选项包括 { None、Wiql、Clauses、All、Minimal } |
Query |
表示工作项查询层次结构中的项。 这可以是查询或文件夹。 |
Query |
用于树查询的递归选项。 |
Query |
查询的类型。 |
Reference |
表示 REST 引用链接集合的类。 |
Work |
描述工作项字段操作。 |
Work |
对工作项中字段的引用 |
Work |
表示工作项查询中的 子句。 这显示了工作项查询的结构。 |
Work |
排序列。 |
IdentityReference
描述对标识的引用。
名称 | 类型 | 说明 |
---|---|---|
_links |
此字段包含零个或多个有关图形主题的有趣链接。 可以调用这些链接来获取有关此图主题的其他关系或更详细的信息。 |
|
descriptor |
string |
描述符是在系统运行时引用图形主题的主要方法。 此字段将唯一标识帐户和组织中的同一图形主题。 |
directoryAlias |
string |
|
displayName |
string |
这是图形主题的非唯一显示名称。 若要更改此字段,必须在源提供程序中更改其值。 |
id |
string |
|
imageUrl |
string |
|
inactive |
boolean |
|
isAadIdentity |
boolean |
|
isContainer |
boolean |
|
isDeletedInOrigin |
boolean |
|
name |
string |
旧版 back-compat 属性。 这是常量中特定于 WIT 的值。 将隐藏 (,但在客户端上) 存在,除非它们面向最新版本 |
profileUrl |
string |
|
uniqueName |
string |
|
url |
string |
此 URL 是指向此图主题的源资源的完整路由。 |
LinkQueryMode
链接查询模式。
名称 | 类型 | 说明 |
---|---|---|
linksOneHopDoesNotContain |
string |
仅当没有链接的工作项满足链接和目标条件时,才返回满足源的工作项。 |
linksOneHopMayContain |
string |
返回满足源和链接条件的工作项,即使没有链接的工作项满足目标条件。 |
linksOneHopMustContain |
string |
返回满足源、目标和链接条件的工作项。 |
linksRecursiveDoesNotContain |
string |
|
linksRecursiveMayContain |
string |
返回默认满足源的工作项的层次结构的工作项 |
linksRecursiveMustContain |
string |
|
workItems |
string |
LogicalOperation
分隔条件子句的逻辑运算符
名称 | 类型 | 说明 |
---|---|---|
aND |
string |
|
nONE |
string |
|
oR |
string |
QueryBatchGetRequest
描述获取查询列表的请求
名称 | 类型 | 说明 |
---|---|---|
$expand |
查询的 expand 参数。 可能的选项包括 { None、Wiql、Clauses、All、Minimal } |
|
errorPolicy |
用于控制查询批处理请求中的错误策略的标志。 可能的选项为 { Fail, Omit }。 |
|
ids |
string[] |
请求的查询 ID |
QueryErrorPolicy
用于控制查询批处理请求中的错误策略的标志。 可能的选项为 { Fail, Omit }。
名称 | 类型 | 说明 |
---|---|---|
fail |
string |
|
omit |
string |
QueryExpand
查询的 expand 参数。 可能的选项包括 { None、Wiql、Clauses、All、Minimal }
名称 | 类型 | 说明 |
---|---|---|
all |
string |
展开所有属性 |
clauses |
string |
展开列、链接、ChangeInfo、WIQL 文本和子句 |
minimal |
string |
显示最小属性和 WIQL 文本 |
none |
string |
展开列、链接和 ChangeInfo |
wiql |
string |
展开列、链接、ChangeInfo 和 WIQL 文本 |
QueryHierarchyItem
表示工作项查询层次结构中的项。 这可以是查询或文件夹。
名称 | 类型 | 说明 |
---|---|---|
_links |
链接对相关 REST 资源的引用。 |
|
children |
查询文件夹中的子查询项。 |
|
clauses |
平面查询的 子句。 |
|
columns |
查询的列。 |
|
createdBy |
创建查询项的标识。 |
|
createdDate |
string |
创建查询项时。 |
filterOptions |
链接查询模式。 |
|
hasChildren |
boolean |
如果这是一个查询文件夹,则指示它是否包含任何子文件夹。 |
id |
string |
查询项的 ID。 |
isDeleted |
boolean |
指示是否删除此查询项。 在已删除的查询项上将其设置为 false 将取消删除。 取消删除查询或文件夹不会恢复以前应用于该查询或文件夹的权限更改。 |
isFolder |
boolean |
指示这是查询文件夹还是查询。 |
isInvalidSyntax |
boolean |
指示此查询的 WIQL 是否无效。 这可能是由于语法无效或不再有效的区域/迭代路径。 |
isPublic |
boolean |
指示此查询项是公共的还是私有的。 |
lastExecutedBy |
上次运行查询的标识。 |
|
lastExecutedDate |
string |
上次运行查询时。 |
lastModifiedBy |
上次修改查询项的标识。 |
|
lastModifiedDate |
string |
上次修改查询项时。 |
linkClauses |
链接查询子句。 |
|
name |
string |
查询项的名称。 |
path |
string |
查询项的路径。 |
queryRecursionOption |
用于树查询的递归选项。 |
|
queryType |
查询的类型。 |
|
sortColumns |
查询的排序列。 |
|
sourceClauses |
树或单跃点链接查询中的源子句。 |
|
targetClauses |
树或单跃点链接查询中的目标子句。 |
|
url |
string |
|
wiql |
string |
查询的 WIQL 文本 |
QueryRecursionOption
用于树查询的递归选项。
名称 | 类型 | 说明 |
---|---|---|
childFirst |
string |
返回满足目标条件的工作项,即使没有工作项满足源和链接条件。 |
parentFirst |
string |
返回满足源的工作项,即使没有链接的工作项满足目标和链接条件。 |
QueryType
查询的类型。
名称 | 类型 | 说明 |
---|---|---|
flat |
string |
获取工作项的简单列表。 |
oneHop |
string |
获取工作项及其直接链接的列表。 |
tree |
string |
获取显示其链接层次结构的工作项树。 |
ReferenceLinks
表示 REST 引用链接集合的类。
名称 | 类型 | 说明 |
---|---|---|
links |
object |
链接的只读视图。 由于引用链接是只读的,因此我们只想将其公开为只读。 |
WorkItemFieldOperation
描述工作项字段操作。
名称 | 类型 | 说明 |
---|---|---|
name |
string |
操作的名称。 |
referenceName |
string |
操作的引用名称。 |
WorkItemFieldReference
对工作项中字段的引用
名称 | 类型 | 说明 |
---|---|---|
name |
string |
字段的名称。 |
referenceName |
string |
字段的引用名称。 |
url |
string |
资源的 REST URL。 |
WorkItemQueryClause
表示工作项查询中的 子句。 这显示了工作项查询的结构。
名称 | 类型 | 说明 |
---|---|---|
clauses |
如果当前子句是逻辑运算符,则为子子句 |
|
field |
与条件关联的字段 |
|
fieldValue |
字段与字段比较时条件的右侧 |
|
isFieldValue |
boolean |
确定这是否为字段与字段的比较 |
logicalOperator |
分隔条件子句的逻辑运算符 |
|
operator |
字段运算符 |
|
value |
string |
字段与值比较时条件的右侧 |
WorkItemQuerySortColumn
排序列。
名称 | 类型 | 说明 |
---|---|---|
descending |
boolean |
排序依据的方向。 |
field |
工作项域。 |