Annotated Tags - Create

Riferimento

Service:: Git

API Version:: 7.1-preview.1

Creare un tag con annotazioni.

I repository hanno sia un nome che un identificatore. Gli identificatori sono univoci a livello globale, ma diversi progetti possono contenere un repository con lo stesso nome. Non è necessario includere il progetto se si specifica un repository in base all'ID. Tuttavia, se si specifica un repository in base al nome, è necessario specificare anche il progetto (in base al nome o all'ID).

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
project	path	True	string	ID progetto o nome del progetto
repositoryId	path	True	string	ID o nome del repository.
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '7.1-preview.1' per usare questa versione dell'API.

Corpo della richiesta

Nome	Tipo	Descrizione
message	string	Messaggio di assegnazione di tag
name	string	Nome del tag con annotazioni.
objectId	string	ObjectId (Sha1Id) del tag.
taggedBy	GitUserDate	Informazioni sull'utente e data di assegnazione di tag.
taggedObject	GitObject	Oggetto Git contrassegnato.
url	string

Risposte

Nome	Tipo	Descrizione
200 OK	GitAnnotatedTag	operazione riuscita

Sicurezza

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

Nome	Descrizione
vso.code_manage	Concede la possibilità di leggere, aggiornare ed eliminare il codice sorgente, accedere ai metadati relativi a commit, insiemi di modifiche, rami e altri artefatti del controllo della versione. Concede inoltre la possibilità di creare e gestire repository di codice, creare e gestire richieste pull e revisioni del codice e ricevere notifiche sugli eventi di controllo della versione tramite hook del servizio.

Nome

Descrizione

vso.code_manage

Concede la possibilità di leggere, aggiornare ed eliminare il codice sorgente, accedere ai metadati relativi a commit, insiemi di modifiche, rami e altri artefatti del controllo della versione. Concede inoltre la possibilità di creare e gestire repository di codice, creare e gestire richieste pull e revisioni del codice e ricevere notifiche sugli eventi di controllo della versione tramite hook del servizio.

Esempio

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

Definizioni

Nome	Descrizione
GitAnnotatedTag	Tag con annotazioni Git.
GitObject	Informazioni sull'identificatore e sul tipo dell'oggetto Git.
GitObjectType	Tipo di oggetto (Commit, Albero, BLOB, Tag)
GitUserDate	Informazioni utente e data per le operazioni Git.

GitAnnotatedTag

Tag con annotazioni Git.

Nome	Tipo	Descrizione
message	string	Messaggio di assegnazione di tag
name	string	Nome del tag con annotazioni.
objectId	string	ObjectId (Sha1Id) del tag.
taggedBy	GitUserDate	Informazioni sull'utente e data di assegnazione di tag.
taggedObject	GitObject	Oggetto Git contrassegnato.
url	string

GitObject

Informazioni sull'identificatore e sul tipo dell'oggetto Git.

Nome	Tipo	Descrizione
objectId	string	ID oggetto (Sha1Id).
objectType	GitObjectType	Tipo di oggetto (Commit, Albero, BLOB, Tag)

GitObjectType

Tipo di oggetto (Commit, Albero, BLOB, Tag)

Nome	Tipo	Descrizione
bad	string
blob	string
commit	string
ext2	string
ofsDelta	string
refDelta	string
tag	string
tree	string

GitUserDate

Informazioni utente e data per le operazioni Git.

Nome	Tipo	Descrizione
date	string	Data dell'operazione Git.
email	string	Email indirizzo dell'utente che esegue l'operazione Git.
imageUrl	string	URL dell'avatar dell'utente.
name	string	Nome dell'utente che esegue l'operazione Git.

Condividi tramite