Annotated Tags - Create

Hizmet:

Git

API Sürümü:

7.1

Açıklamalı etiket oluşturun.

Depoların hem adı hem de tanımlayıcısı vardır. Tanımlayıcılar genel olarak benzersizdir, ancak birkaç proje aynı ada sahip bir depo içerebilir. Kimliğine göre bir depo belirtirseniz projeyi eklemeniz gerekmez. Ancak, ada göre bir depo belirtirseniz, projeyi de belirtmeniz gerekir (ada veya kimlikle).

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
project	path	True	string	Proje kimliği veya proje adı
repositoryId	path	True	string	Deponun kimliği veya adı.
api-version	query	True	string	Kullanılacak API'nin sürümü. Bu, API'nin bu sürümünü kullanmak için '7.1' olarak ayarlanmalıdır.

İstek Gövdesi

Name	Tür	Description
message	string	etiketleme İletisi
name	string	Açıklamalı etiketin adı.
objectId	string	Etiketin objectId (Sha1Id) değeri.
taggedBy	GitUserDate	Kullanıcı bilgileri ve etiketleme tarihi.
taggedObject	GitObject	Etiketli git nesnesi.
url	string

Yanıtlar

Name	Tür	Description
200 OK	GitAnnotatedTag	başarılı işlem

Güvenlik

oauth2

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Belirteç URL'si: 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

Kapsamlar

Name	Description
vso.code_manage	Kaynak kodu okuma, güncelleştirme ve silme, işlemeler, değişiklik kümeleri, dallar ve diğer sürüm denetimi yapıtları hakkındaki meta verilere erişme olanağı sağlar. Ayrıca kod depoları oluşturup yönetme, çekme istekleri ve kod gözden geçirmeleri oluşturup yönetme ve hizmet kancaları aracılığıyla sürüm denetimi olayları hakkında bildirim alma olanağı sağlar.

Örnekler

Örnek isteği

HTTP

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

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

Örnek yanıt

Durum kodu:

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"
}

Tanımlar

Name	Description
GitAnnotatedTag	Git açıklamalı etiketi.
GitObject	Git nesne tanımlayıcısı ve tür bilgileri.
GitObjectType	Nesne türü (İşleme, Ağaç, Blob, Etiket)
GitUserDate	Git işlemleri için kullanıcı bilgileri ve tarih.

GitAnnotatedTag

Object

Git açıklamalı etiketi.

Name	Tür	Description
message	string	etiketleme İletisi
name	string	Açıklamalı etiketin adı.
objectId	string	Etiketin objectId (Sha1Id) değeri.
taggedBy	GitUserDate	Kullanıcı bilgileri ve etiketleme tarihi.
taggedObject	GitObject	Etiketli git nesnesi.
url	string

GitObject

Object

Git nesne tanımlayıcısı ve tür bilgileri.

Name	Tür	Description
objectId	string	Nesne Kimliği (Sha1Id).
objectType	GitObjectType	Nesne türü (İşleme, Ağaç, Blob, Etiket)

GitObjectType

Listeleme

Nesne türü (İşleme, Ağaç, Blob, Etiket)

Değer	Description
bad
blob
commit
ext2
ofsDelta
refDelta
tag
tree

GitUserDate

Object

Git işlemleri için kullanıcı bilgileri ve tarih.

Name	Tür	Description
date	string (date-time)	Git işleminin tarihi.
email	string	Git işlemini gerçekleştiren kullanıcının e-posta adresi.
imageUrl	string	Kullanıcının avatarı url'si.
name	string	Git işlemini gerçekleştiren kullanıcının adı.