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

pullRequestId
path True

integer (int32)

拉取请求的 ID。

repositoryId
path True

string

拉取请求的目标分支的存储库 ID。

project
path

string

项目 ID 或项目名称

api-version
query True

string

要使用的 API 版本。 这应设置为“7.1”才能使用此版本的 API。

projectId
query

string

项目 ID 或项目名称。

请求正文

名称 类型 说明
name

string

将创建的标记定义的名称。

响应

名称 类型 说明
200 OK

WebApiTagDefinition

成功作

安全性

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 授予读取、更新和删除源代码、访问有关提交、更改集、分支和其他版本控制项目的元数据的能力。 此外,还授予创建和管理拉取请求和代码评审以及通过服务挂钩接收有关版本控制事件的通知的能力。

定义

名称 说明
WebApiCreateTagRequestData

创建通过网络发送的标记定义所需的数据的表示形式。

WebApiTagDefinition

通过网络发送的标记定义的表示形式。

WebApiCreateTagRequestData

创建通过网络发送的标记定义所需的数据的表示形式。

名称 类型 说明
name

string

将创建的标记定义的名称。

WebApiTagDefinition

通过网络发送的标记定义的表示形式。

名称 类型 说明
active

boolean

标记定义是否处于活动状态。

id

string (uuid)

标记定义的 ID。

name

string

标记定义的名称。

url

string

标记定义的资源 URL。