Annotated Tags - Create
建立註解標記。
存放庫同時具有名稱和識別碼。 識別碼是全域唯一的,但數個專案可能包含相同名稱的存放庫。 如果您依識別碼指定存放庫,則不需要包含專案。 不過,如果您依名稱指定存放庫,您也必須依名稱或識別碼指定專案 () 。
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 |
專案識別碼或專案名稱 |
repository
|
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 |
使用者資訊和標記的日期。 |
|
taggedObject |
標記的 git 物件。 |
|
url |
string |
回應
名稱 | 類型 | Description |
---|---|---|
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
名稱 | Description |
---|---|
vso.code_manage | 授與讀取、更新和刪除原始程式碼、存取認可、變更集、分支和其他版本控制成品的相關中繼資料。 也授與建立和管理程式碼存放庫的能力、建立和管理提取要求和程式碼檢閱,以及透過服務勾點接收版本控制事件的通知。 |
範例
Sample Request
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
{
"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 |
---|---|
Git |
Git 註解標記。 |
Git |
Git 物件識別碼和類型資訊。 |
Git |
物件類型 (Commit、Tree、Blob、Tag) |
Git |
Git 作業的使用者資訊和日期。 |
GitAnnotatedTag
Git 註解標記。
名稱 | 類型 | Description |
---|---|---|
message |
string |
標記訊息 |
name |
string |
註解標記的名稱。 |
objectId |
string |
tag 的 objectId (Sha1Id) 。 |
taggedBy |
使用者資訊和標記的日期。 |
|
taggedObject |
標記的 git 物件。 |
|
url |
string |
GitObject
Git 物件識別碼和類型資訊。
名稱 | 類型 | Description |
---|---|---|
objectId |
string |
物件識別碼 (Sha1Id) 。 |
objectType |
物件類型 (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 作業的日期。 |
string |
執行 Git 作業的使用者Email位址。 |
|
imageUrl |
string |
使用者的虛擬人偶 URL。 |
name |
string |
執行 Git 作業的使用者名稱。 |
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應