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 组织的名称。

pullRequestId
path True

integer

int32

拉取请求的 ID。

repositoryId
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

Operation

修补操作

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

定义

名称 说明
JsonPatchDocument

JSON 修补程序操作的 JSON 模型

Operation

修补操作

JsonPatchDocument

JSON 修补程序操作的 JSON 模型

名称 类型 说明
from

string

移动/复制操作的复制路径。

op

Operation

修补操作

path

string

操作的路径。 对于数组,可以使用从零开始的索引指定数组中的位置 (例如 /饼干/0/name) 。 可以使用“-”字符而不是在数组末尾插入索引, (例如 /biscuits/-) 。

value

object

操作的值。 这是基元或 JToken。

Operation

修补操作

名称 类型 说明
add

string

copy

string

move

string

remove

string

replace

string

test

string