Annotated Tags - Create

Référence

Service:: Git

API Version:: 7.1-preview.1

Créez une balise annotée.

Les dépôts ont à la fois un nom et un identificateur. Les identificateurs sont globalement uniques, mais plusieurs projets peuvent contenir un dépôt du même nom. Vous n’avez pas besoin d’inclure le projet si vous spécifiez un dépôt par ID. Toutefois, si vous spécifiez un dépôt par nom, vous devez également spécifier le projet (par nom ou ID).

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
organization	path	True	string	Nom de l’organisation Azure DevOps.
project	path	True	string	ID de projet ou nom du projet
repositoryId	path	True	string	ID ou nom du dépôt.
api-version	query	True	string	Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1-preview.1 » pour utiliser cette version de l’API.

Corps de la demande

Nom	Type	Description
message	string	Message d’étiquetage
name	string	Nom de la balise annotée.
objectId	string	ObjectId (Sha1Id) de la balise.
taggedBy	GitUserDate	Informations utilisateur et date d’étiquetage.
taggedObject	GitObject	Objet git balisé.
url	string

Réponses

Nom	Type	Description
200 OK	GitAnnotatedTag	opération réussie

Sécurité

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

Nom	Description
vso.code_manage	Permet de lire, de mettre à jour et de supprimer le code source, d’accéder aux métadonnées relatives aux commits, aux ensembles de modifications, aux branches et à d’autres artefacts de contrôle de version. Permet également de créer et de gérer des référentiels de code, de créer et de gérer des demandes de tirage et des révisions de code, et de recevoir des notifications sur les événements de contrôle de version via des hooks de service.

Nom

Description

vso.code_manage

Permet de lire, de mettre à jour et de supprimer le code source, d’accéder aux métadonnées relatives aux commits, aux ensembles de modifications, aux branches et à d’autres artefacts de contrôle de version. Permet également de créer et de gérer des référentiels de code, de créer et de gérer des demandes de tirage et des révisions de code, et de recevoir des notifications sur les événements de contrôle de version via des hooks de service.

Exemples

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

Définitions

Nom	Description
GitAnnotatedTag	Balise annotée Git.
GitObject	Informations de type et d’identificateur d’objet Git.
GitObjectType	Type d’objet (Commit, Tree, Blob, Tag)
GitUserDate	Informations utilisateur et date pour les opérations Git.

GitAnnotatedTag

Balise annotée Git.

Nom	Type	Description
message	string	Message d’étiquetage
name	string	Nom de la balise annotée.
objectId	string	ObjectId (Sha1Id) de la balise.
taggedBy	GitUserDate	Informations utilisateur et date d’étiquetage.
taggedObject	GitObject	Objet git balisé.
url	string

GitObject

Informations de type et d’identificateur d’objet Git.

Nom	Type	Description
objectId	string	ID d’objet (Sha1Id).
objectType	GitObjectType	Type d’objet (Commit, Tree, Blob, Tag)

GitObjectType

Type d’objet (Commit, Tree, Blob, Tag)

Nom	Type	Description
bad	string
blob	string
commit	string
ext2	string
ofsDelta	string
refDelta	string
tag	string
tree	string

GitUserDate

Informations utilisateur et date pour les opérations Git.

Nom	Type	Description
date	string	Date de l’opération Git.
email	string	Email adresse de l’utilisateur effectuant l’opération Git.
imageUrl	string	URL de l’avatar de l’utilisateur.
name	string	Nom de l’utilisateur effectuant l’opération Git.

Partager via