ADO Boards

Azure DevOps Boards 为团队提供服务，用于跟踪工作 - 对于任何语言（全部在单个包中）。

此连接器在以下产品和区域中可用：

Service	Class	区域
逻辑应用程序	标准	除以下各项外的所有 逻辑应用区域 ：      - Azure Government区域      - Azure中国区域      - 美国国防部（DoD）

联系人
名称	Microsoft
URL	Microsoft LogicApps 支持

连接器元数据
发布者	Microsoft

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

列出工作项	返回工作项的列表。
列出工作项类型	检索给定Azure DevOps项目中可访问的工作项类型列表。
列出文件夹中的查询	检索给定项目文件夹中的工作项查询列表。
列出根级查询	检索项目中根级工作项查询的列表。
列出组织	检索用户所属的组织列表。
列出项目	检索组织中的项目列表。
基于查询获取主题	基于查询获取主题
更新工作项	按 ID 更新现有工作项。
获取查询结果（预览版）	检索工作项查询的结果。
获取用户配置文件	获取用户配置文件。

列出工作项

操作 ID:

ListWorkItems

返回工作项的列表。

参数

名称	密钥	必需	类型	说明
组织名称	account	True	string	组织的名称。 可以在实例 URL（例如 {Organization}.visualstudio.com）中找到。 组织应启用“通过 OAuth 进行第三方应用程序访问”，以防止作中出现错误。
项目名称	project	True	string	指定组织内项目的名称。
工作项 ID	ids	True	string	请求的工作项 ID 的逗号分隔列表。

返回

Body

VstsListListWorkItemResponse

列出工作项类型

操作 ID:

ListWorkItemTypes

检索给定Azure DevOps项目中可访问的工作项类型列表。

参数

名称	密钥	必需	类型	说明
组织名称	account	True	string	组织的名称。 可以在实例 URL（例如 {Organization}.visualstudio.com）中找到。 组织应启用“通过 OAuth 进行第三方应用程序访问”，以防止作中出现错误。
项目名称	project	True	string	指定组织内项目的名称。

返回

VSTS 模型的列表。

Body

VstsListWorkItemType

列出文件夹中的查询

操作 ID:

ListQueriesInFolder

检索给定项目文件夹中的工作项查询列表。

参数

名称	密钥	必需	类型	说明
组织名称	account	True	string	组织的名称。 可以在实例 URL（例如 {Organization}.visualstudio.com）中找到。 组织应启用“通过 OAuth 进行第三方应用程序访问”，以防止作中出现错误。
项目名称	project	True	string	指定组织内项目的名称。
文件夹路径	folderPath	True	string	要在其中查找查询的文件夹路径。

返回

VSTS 模型的列表。

Body

VstsListQueryHierarchyItem

列出根级查询

操作 ID:

ListRootQueryFolders

检索项目中根级工作项查询的列表。

参数

名称	密钥	必需	类型	说明
组织名称	account	True	string	组织的名称。 可以在实例 URL（例如 {Organization}.visualstudio.com）中找到。 组织应启用“通过 OAuth 进行第三方应用程序访问”，以防止作中出现错误。
项目名称	project	True	string	指定组织内项目的名称。

返回

VSTS 模型的列表。

Body

VstsListQueryHierarchyItem

列出组织

操作 ID:

ListAccounts

检索用户所属的组织列表。

参数

名称	密钥	必需	类型	说明
成员 ID	memberId	True	string	成员 ID

返回

VSTS 模型的列表。

Body

VstsListAccount

列出项目

操作 ID:

ListProjects

检索组织中的项目列表。

参数

名称	密钥	必需	类型	说明
组织名称	account	True	string	组织的名称。 可以在实例 URL（例如 {Organization}.visualstudio.com）中找到。 组织应启用“通过 OAuth 进行第三方应用程序访问”，以防止作中出现错误。

返回

VSTS 模型的列表。

Body

VstsListProject

基于查询获取主题

操作 ID:

GetSubject

基于查询获取主题

参数

名称	密钥	必需	类型	说明
组织名称	account	True	string	组织的名称。 可以在实例 URL（例如 {Organization}.visualstudio.com）中找到。 组织应启用“通过 OAuth 进行第三方应用程序访问”，以防止作中出现错误。
SearchTerm	query	True	string	搜索词以搜索 Azure Devops 用户或/和组。
SubjectKind	subjectKind	True	array of string	可以同时指定或同时指定用户或组
范围描述符	scopeDescriptor		string	可选参数

返回

图形主题列表。

Body

VstsListSubject

更新工作项

操作 ID:

UpdateWorkItem

按 ID 更新现有工作项。

参数

名称	密钥	必需	类型	说明
组织名称	account	True	string	组织的名称。 可以在实例 URL（例如 {Organization}.visualstudio.com）中找到。 组织应启用“通过 OAuth 进行第三方应用程序访问”，以防止作中出现错误。
工作项 ID	id	True	string	要更新的工作项的唯一 ID。
项目名称	project	True	string	指定组织内项目的名称。
优先级	priority		integer	工作项的优先级。
密钥	key		string	字段的键
value	value		string	字段的值

返回

响应

object

获取查询结果（预览版）

操作 ID:

GetQueryResults

检索工作项查询的结果。

参数

名称	密钥	必需	类型	说明
组织名称	account	True	string	组织的名称。 可以在实例 URL（例如 {Organization}.visualstudio.com）中找到。 组织应启用“通过 OAuth 进行第三方应用程序访问”，以防止作中出现错误。
项目名称	project	True	string	指定组织内项目的名称。
查询 ID	queryId	True	string	要运行的存储查询的 ID。

返回

VSTS 模型的列表。

Body

VstsListJObject

获取用户配置文件

操作 ID:

GetProfile

获取用户配置文件。

参数

名称	密钥	必需	类型	说明
配置文件 ID	id	True	string	同一组织中配置文件的 ID，或“me”以获取当前经过身份验证的用户的配置文件。

返回

个人资料

Body

Profile

定义

VstsListAccount

VSTS 模型的列表。

名称	路径	类型	说明
价值	value	array of Account	VSTS 模型

帐户

帐户

名称	路径	类型	说明
账户 ID	accountId	string	帐户的 ID。
帐户 URI	accountUri	string	帐户的 URI。
帐户名	accountName	string	帐户的名称。
帐户所有者	accountOwner	string	帐户的设置所有者。
组织名称	organizationName	string	与帐户对应的组织名称。
帐户类型	accountType	string	帐户的类型。

个人资料

个人资料

名称	路径	类型	说明
displayName	displayName	string	用户的显示名称
id	id	string	配置文件的唯一标识符。
publicAlias	publicAlias	string	公共别名。
电子邮件地址	emailAddress	string	帐户的电子邮件地址。
时间戳	timeStamp	date-time	上次更改此配置文件的时间。
修订	revision	integer	任何属性的最大修订版本号。
CoreRevision	coreRevision	integer	CoreRevision

VstsListProject

VSTS 模型的列表。

名称	路径	类型	说明
价值	value	array of Project	VSTS 模型

项目

项目

名称	路径	类型	说明
项目 ID	id	string	项目的唯一标识符。
项目名称	name	string	项目的名称。
项目 URL	url	string	项目的 API URL。

VstsListQueryHierarchyItem

VSTS 模型的列表。

名称	路径	类型	说明
价值	value	array of QueryHierarchyItem	VSTS 模型

QueryHierarchyItem

查询层次结构项

名称	路径	类型	说明
有孩子	hasChildren	boolean	指定查询层次结构项是否具有子项。
ID	id	string	查询层次结构项的唯一标识器。
Is 文件夹	isFolder	boolean	指定查询层次结构项是否为文件夹。
是公共的	isPublic	boolean	指定查询层次结构项是否为公共项。
名称	name	string	查询层次结构项的名称。
路径	path	string	查询层次结构项的路径。
Links	_links	object	与查询层次结构项相关的链接的集合。
URL	url	string	查询层次结构项的完整 HTTP 链接。

VstsListWorkItemType

VSTS 模型的列表。

名称	路径	类型	说明
价值	value	array of WorkItemType	VSTS 模型。

WorkItemType

工作项类型

名称	路径	类型	说明
说明	description	string	类型的说明。
名称	name	string	类型的名称。
图标 ID	icon.id	string	图标的标识符
图标 URL	icon.url	string	资源的 REST URL
States	states	array of WorkItemStateColor	工作项类型的状态

WorkItemStateColor

工作项状态颜色

名称	路径	类型	说明
状态类别	category	string	状态类别
颜色值	color	string	颜色值
状态名称	name	string	工作项类型状态名称

VstsListListWorkItemResponse

名称	路径	类型	说明
value	value	array of ListWorkItemResponse

ListWorkItemResponse

列表工作项操作的工作项响应

名称	路径	类型	说明
ID	id	integer	工作项的唯一 ID。
区域路径	areaPath	string	工作项的区域路径。
团队项目	teamProject	string	工作项所属的团队项目。
迭代路径	iterationPath	string	工作项的迭代路径。
工作项类型	workItemType	string	工作项的类型。
州	state	string	工作项的状态。
原因	reason	string	输入工作项的原因。
更改日期	updatedAt	string	工作项的日期时间已更改。
截止日期	dueDate	string	工作项的截止日期。
priority	priority	string	priority
标题	title	string	工作项的标题。
标签	tags	string	工作项的标记。
分配到	assignedTo	string	当前拥有工作项的团队成员的电子邮件。
分配给名称	assignedToName	string	当前拥有该工作项的团队成员的名称。

VstsListJObject

VSTS 模型的列表。

名称	路径	类型	说明
价值	value	array of Object	VSTS 模型

VstsListSubject

图形主题列表。

名称	路径	类型	说明
价值	value	array of Subject	图形主题

主题

使用者定义

名称	路径	类型	说明
显示名称	displayName	string	生成定义的唯一标识符。
邮寄地址	mailAddress	string	主题的邮件地址
主要姓名	principalName	string	主题的主体名称
SubjectKind	subjectKind	string	主题的主体名称
Avatar	avatar	string	虚拟形象 URL

对象

对象

这是 'object' 类型。