Annotated Tags - Create

參考

Service:: Git

API Version:: 7.1-preview.1

建立註解標記。

存放庫同時具有名稱和識別碼。識別碼是全域唯一的，但數個專案可能包含相同名稱的存放庫。如果您依識別碼指定存放庫，則不需要包含專案。不過，如果您依名稱指定存放庫，您也必須依名稱或識別碼指定專案 () 。

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/annotatedtags?api-version=7.1-preview.1

URI 參數

名稱	位於	必要	類型	Description
organization	path	True	string	Azure DevOps 組織的名稱。
project	path	True	string	專案識別碼或專案名稱
repositoryId	path	True	string	存放庫的識別碼或名稱。
api-version	query	True	string	要使用的 API 版本。這應該設定為 '7.1-preview.1' 以使用此版本的 API。

要求本文

名稱	類型	Description
message	string	標記訊息
name	string	註解標記的名稱。
objectId	string	tag 的 objectId (Sha1Id) 。
taggedBy	GitUserDate	使用者資訊和標記的日期。
taggedObject	GitObject	標記的 git 物件。
url	string

回應

名稱	類型	Description
200 OK	GitAnnotatedTag	成功作業

安全性

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

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

範例

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/c34d5807-1734-4541-ad1c-d16e9ac1faca/_apis/git/repositories/{repositoryId}/annotatedtags?api-version=7.1-preview.1

{
  "name": "v0.1-beta",
  "taggedObject": {
    "objectId": "c60be62ebf0e86b5aa01dbb98657b4b7e5905234"
  },
  "message": "First beta release"
}

Sample Response

Status code:: 201

{
  "name": "refs/tags/v0.1-beta",
  "objectId": "bc57849b33949a15fa3cb889bb82d9ce21d5b6ee",
  "taggedObject": {
    "objectId": "c60be62ebf0e86b5aa01dbb98657b4b7e5905234",
    "objectType": "commit"
  },
  "taggedBy": {
    "name": "Norman Paulk",
    "email": "Fabrikamfiber16@hotmail.com",
    "date": "2017-06-22T05:09:23"
  },
  "message": "First beta release",
  "url": "https://dev.azure.com/fabrikam/c34d5807-1734-4541-ad1c-d16e9ac1faca/_apis/git/repositories/ca93c3a5-87bb-4b5b-a62f-1f971d677c79/annotatedTags/bc57849b33949a15fa3cb889bb82d9ce21d5b6ee"
}

定義

名稱	Description
GitAnnotatedTag	Git 註解標記。
GitObject	Git 物件識別碼和類型資訊。
GitObjectType	物件類型 (Commit、Tree、Blob、Tag)
GitUserDate	Git 作業的使用者資訊和日期。

GitAnnotatedTag

Git 註解標記。

名稱	類型	Description
message	string	標記訊息
name	string	註解標記的名稱。
objectId	string	tag 的 objectId (Sha1Id) 。
taggedBy	GitUserDate	使用者資訊和標記的日期。
taggedObject	GitObject	標記的 git 物件。
url	string

GitObject

Git 物件識別碼和類型資訊。

名稱	類型	Description
objectId	string	物件識別碼 (Sha1Id) 。
objectType	GitObjectType	物件類型 (Commit、Tree、Blob、Tag)

GitObjectType

物件類型 (Commit、Tree、Blob、Tag)

名稱	類型	Description
bad	string
blob	string
commit	string
ext2	string
ofsDelta	string
refDelta	string
tag	string
tree	string

GitUserDate

Git 作業的使用者資訊和日期。

名稱	類型	Description
date	string	Git 作業的日期。
email	string	執行 Git 作業的使用者Email位址。
imageUrl	string	使用者的虛擬人偶 URL。
name	string	執行 Git 作業的使用者名稱。

共用方式為