Pull Request Statuses - Update
更新拉取请求状态集合。 唯一受支持的操作类型是 remove
。
此操作允许在一次调用中删除多个状态。
操作的路径remove
应引用拉取请求状态的 ID。
例如path="/1"
,指的是 ID 为 1 的拉取请求状态。
PATCH https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullRequests/{pullRequestId}/statuses?api-version=7.1-preview.1
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
organization
|
path | True |
string |
Azure DevOps 组织的名称。 |
pull
|
path | True |
integer int32 |
拉取请求的 ID。 |
repository
|
path | True |
string |
拉取请求的目标分支的存储库 ID。 |
project
|
path |
string |
项目 ID 或项目名称 |
|
api-version
|
query | True |
string |
要使用的 API 版本。 应将其设置为“7.1-preview.1”才能使用此版本的 API。 |
请求正文
Media Types: "application/json-patch+json"
名称 | 类型 | 说明 |
---|---|---|
from |
string |
移动/复制操作的复制路径。 |
op |
修补操作 |
|
path |
string |
操作的路径。 对于数组,可以使用从零开始的索引指定数组中的位置 (例如 /饼干/0/name) 。 可以使用“-”字符而不是在数组末尾插入索引, (例如 /biscuits/-) 。 |
value |
object |
操作的值。 这是基元或 JToken。 |
响应
名称 | 类型 | 说明 |
---|---|---|
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.code_write | 授予读取、更新和删除源代码、访问有关提交、更改集、分支和其他版本控制项目的元数据的能力。 此外,还授予创建和管理拉取请求和代码评审以及通过服务挂钩接收有关版本控制事件的通知的能力。 |
vso.code_status | 授予读取和写入提交以及拉取请求状态的能力。 |
示例
Sample Request
PATCH https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pullRequests/{pullRequestId}/statuses?api-version=7.1-preview.1
[
{
"op": "remove",
"path": "/1",
"from": null,
"value": null
},
{
"op": "remove",
"path": "/2",
"from": null,
"value": null
}
]
Sample Response
定义
名称 | 说明 |
---|---|
Json |
JSON 修补程序操作的 JSON 模型 |
Operation |
修补操作 |
JsonPatchDocument
JSON 修补程序操作的 JSON 模型
名称 | 类型 | 说明 |
---|---|---|
from |
string |
移动/复制操作的复制路径。 |
op |
修补操作 |
|
path |
string |
操作的路径。 对于数组,可以使用从零开始的索引指定数组中的位置 (例如 /饼干/0/name) 。 可以使用“-”字符而不是在数组末尾插入索引, (例如 /biscuits/-) 。 |
value |
object |
操作的值。 这是基元或 JToken。 |
Operation
修补操作
名称 | 类型 | 说明 |
---|---|---|
add |
string |
|
copy |
string |
|
move |
string |
|
remove |
string |
|
replace |
string |
|
test |
string |