Pull Request Labels - Create

服務:
Git
API 版本:
7.1

建立標記（如果尚未存在），並將它新增為指定提取要求的標籤（標籤）。 唯一的必要欄位是新標籤的名稱（標籤）。

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 參數

名稱 位於 必要 類型 Description
organization
 path True

string

Azure DevOps 組織的名稱。
pullRequestId
 path True

integer (int32)

提取要求的標識碼。
repositoryId
 path True

string

提取要求目標分支的存放庫標識碼。
project
 path

string

項目識別碼或項目名稱
api-version
 query True

string

要使用的 API 版本。 這應該設定為 『7.1』 以使用此版本的 API。
projectId
 query

string

項目識別碼或項目名稱。

要求本文

名稱 類型 Description
name

string

將要建立的標籤定義名稱。

回應

名稱 類型 Description
200 OK

WebApiTagDefinition

成功作業

安全性

oauth2

類型: oauth2
Flow: 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

範圍

名稱 Description
vso.code_write 授與讀取、更新和刪除原始程式碼、存取認可、變更集、分支和其他版本控制成品的相關元數據的能力。 也授與建立和管理提取要求和程式代碼檢閱的能力，以及透過服務攔截接收版本控制事件的通知。

定義

名稱 Description
WebApiCreateTagRequestData

建立透過網路傳送的標記定義所需的數據表示。
WebApiTagDefinition

透過網路傳送的標記定義表示。

WebApiCreateTagRequestData

Object

建立透過網路傳送的標記定義所需的數據表示。

名稱 類型 Description
name

string

將要建立的標籤定義名稱。

WebApiTagDefinition

Object

透過網路傳送的標記定義表示。

名稱 類型 Description
active

boolean

標籤定義是否為使用中。
id

string (uuid)

標籤定義的識別碼。
name

string

標籤定義的名稱。
url

string

標籤定義的資源 URL。