Pull Request Reviewers - Update

参考

服务:: Git

API 版本:: 5.1

重置拉取请求上多个审阅者的投票。注意：此终结点仅支持更新投票，但不支持更新所需的审阅者 (使用策略) 或显示名称。

PATCH https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullRequests/{pullRequestId}/reviewers?api-version=5.1

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
pullRequestId	path	True	integer int32	拉取请求的 ID
repositoryId	path	True	string	拉取请求的目标分支的存储库 ID。
project	path		string	项目 ID 或项目名称
api-version	query	True	string	要使用的 API 版本。这应设置为“5.1”才能使用此版本的 API。

请求正文

名称	类型	说明
body	IdentityRefWithVote[]	其投票将重置为零的审阅者的 ID

响应

名称	类型	说明
200 OK		成功的操作

安全性

oauth2

类型: oauth2
流向: accessCode
授权 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
令牌 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

作用域

名称	说明
vso.code_write	授予读取、更新和删除源代码、访问有关提交、更改集、分支和其他版本控制项目元数据的能力。此外，还授予创建和管理拉取请求和代码评审以及通过服务挂钩接收有关版本控制事件的通知的能力。

定义

名称	说明
IdentityRefWithVote	标识信息，包括对拉取请求的投票。
ReferenceLinks	表示 REST 引用链接集合的类。

IdentityRefWithVote

Object

标识信息，包括对拉取请求的投票。

名称	类型	说明
_links	ReferenceLinks	此字段包含零个或多个有关图形主题的有趣链接。可以调用这些链接来获取有关此图主题的其他关系或更详细的信息。
descriptor	string	描述符是在系统运行时引用图形主题的主要方法。此字段将唯一标识帐户和组织中的同一图形主题。
directoryAlias	string	已弃用 - 可通过查询 IdentityRef“_links”字典的“self”条目中引用的 Graph 用户来检索
displayName	string	这是图形主题的非唯一显示名称。若要更改此字段，必须在源提供程序中更改其值。
id	string
imageUrl	string	已弃用 - 在 IdentityRef“_links”字典的“头像”条目中可用
inactive	boolean	已弃用 - 可通过查询 GraphUser“_links”字典的“membershipState”条目中引用的 Graph 成员身份状态来检索
isAadIdentity	boolean	已弃用 - 可以从描述符的主题类型推断 (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	已弃用 - 可以从描述符的主题类型推断 (描述符.IsGroupType)
isDeletedInOrigin	boolean
isRequired	boolean	指示此拉取请求的必需审阅者。分支可以具有要求拉取请求需要特定审阅者的策略。
profileUrl	string	已弃用 - 未在 ToIdentityRef 的大多数预先存在的实现中使用
reviewerUrl	string	用于检索有关此标识信息的 URL
uniqueName	string	已弃用 - 改用 Domain+PrincipalName
url	string	此 URL 是指向此图主题的源资源的完整路由。
vote	integer	对拉取请求投票： 10 - 批准 5 - 批准建议 0 - 没有投票 - 5 - 等待作者 -10 - 拒绝
votedFor	IdentityRefWithVote[]	此审阅者参与的组或团队。组和团队可以是拉取请求的审阅者，但不能直接投票。当组或团队的成员投票时，该投票将汇总到组或团队投票中。 VotedFor 是此类投票的列表。

ReferenceLinks