Pull Request Labels - Create
创建标记(如果该标记尚不存在),并将其添加为指定拉取请求的标签(标记)。 唯一必需的字段是新标签的名称(标记)。
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullRequests/{pullRequestId}/labels?api-version=7.1
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullRequests/{pullRequestId}/labels?projectId={projectId}&api-version=7.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”才能使用此版本的 API。 |
|
project
|
query |
string |
项目 ID 或项目名称。 |
请求正文
| 名称 | 类型 | 说明 |
|---|---|---|
| name |
string |
将创建的标记定义的名称。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 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 | 授予读取、更新和删除源代码、访问有关提交、更改集、分支和其他版本控制项目的元数据的能力。 此外,还授予创建和管理拉取请求和代码评审以及通过服务挂钩接收有关版本控制事件的通知的能力。 |
定义
| 名称 | 说明 |
|---|---|
|
Web |
创建通过网络发送的标记定义所需的数据的表示形式。 |
|
Web |
通过网络发送的标记定义的表示形式。 |
WebApiCreateTagRequestData
创建通过网络发送的标记定义所需的数据的表示形式。
| 名称 | 类型 | 说明 |
|---|---|---|
| name |
string |
将创建的标记定义的名称。 |
WebApiTagDefinition
通过网络发送的标记定义的表示形式。
| 名称 | 类型 | 说明 |
|---|---|---|
| active |
boolean |
标记定义是否处于活动状态。 |
| id |
string (uuid) |
标记定义的 ID。 |
| name |
string |
标记定义的名称。 |
| url |
string |
标记定义的资源 URL。 |