Annotated Tags - Create

Service:

Git

API Version:

7.1-preview.1

Vytvořte značku s poznámkami.

Úložiště mají název i identifikátor. Identifikátory jsou globálně jedinečné, ale několik projektů může obsahovat úložiště se stejným názvem. Pokud zadáte úložiště podle ID, nemusíte projekt zahrnovat. Pokud ale zadáte úložiště podle názvu, musíte zadat také projekt (podle názvu nebo ID).

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
organization	path	True	string	Název organizace Azure DevOps.
project	path	True	string	ID projektu nebo název projektu
repositoryId	path	True	string	ID nebo název úložiště.
api-version	query	True	string	Verze rozhraní API, která se má použít. Tato verze rozhraní API by měla být nastavená na 7.1-preview.1.

Text požadavku

Name	Typ	Description
message	string	Zpráva o označování
name	string	Název značky s poznámkami.
objectId	string	ObjectId (Sha1Id) značky.
taggedBy	GitUserDate	Informace o uživateli a datum označení.
taggedObject	GitObject	Objekt Git se značkou.
url	string

Odpovědi

Name	Typ	Description
200 OK	GitAnnotatedTag	úspěšná operace

Zabezpečení

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

Name	Description
vso.code_manage	Uděluje možnost číst, aktualizovat a odstraňovat zdrojový kód a přistupovat k metadatům o potvrzeních, sadách změn, větvích a dalších artefaktech správy verzí. Poskytuje také možnost vytvářet a spravovat úložiště kódu, vytvářet a spravovat žádosti o přijetí změn a revize kódu a přijímat oznámení o událostech správy verzí prostřednictvím volání služeb.

Příklady

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

Definice

Name	Description
GitAnnotatedTag	Značka Git s poznámkami.
GitObject	Informace o identifikátoru a typu objektu Git.
GitObjectType	Typ objektu (Commit, Tree, Blob, Tag)
GitUserDate	Informace o uživateli a datum operací Gitu

GitAnnotatedTag

Značka Git s poznámkami.

Name	Typ	Description
message	string	Zpráva o označování
name	string	Název značky s poznámkami.
objectId	string	ObjectId (Sha1Id) značky.
taggedBy	GitUserDate	Informace o uživateli a datum označení.
taggedObject	GitObject	Objekt Git se značkou.
url	string

GitObject

Informace o identifikátoru a typu objektu Git.

Name	Typ	Description
objectId	string	ID objektu (Sha1Id).
objectType	GitObjectType	Typ objektu (Commit, Tree, Blob, Tag)

GitObjectType

Typ objektu (Commit, Tree, Blob, Tag)

Name	Typ	Description
bad	string
blob	string
commit	string
ext2	string
ofsDelta	string
refDelta	string
tag	string
tree	string

GitUserDate

Informace o uživateli a datum operací Gitu

Name	Typ	Description
date	string	Datum operace Git.
email	string	Email adresu uživatele, který provádí operaci Gitu.
imageUrl	string	Adresa URL avatara uživatele
name	string	Jméno uživatele, který provádí operaci Git.