Annotated Tags - Create

Referenz

Service:: Git

API Version:: 7.1-preview.1

Erstellen Sie ein mit Anmerkungen versehenes Tag.

Repositorys haben sowohl einen Namen als auch einen Bezeichner. Bezeichner sind global eindeutig, aber mehrere Projekte können ein Repository mit demselben Namen enthalten. Sie müssen das Projekt nicht einschließen, wenn Sie ein Repository anhand der ID angeben. Wenn Sie jedoch ein Repository anhand des Namens angeben, müssen Sie auch das Projekt (nach Name oder ID) angeben.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
project	path	True	string	Projekt-ID oder Projektname
repositoryId	path	True	string	ID oder Name des Repositorys.
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.1-preview.1" festgelegt werden, um diese Version der API zu verwenden.

Anforderungstext

Name	Typ	Beschreibung
message	string	Die Taggingnachricht
name	string	Der Name des mit Anmerkungen versehenen Tags.
objectId	string	Die objectId (Sha1Id) des Tags.
taggedBy	GitUserDate	Benutzerinformationen und Datum der Markierung.
taggedObject	GitObject	Markiertes Git-Objekt.
url	string

Antworten

Name	Typ	Beschreibung
200 OK	GitAnnotatedTag	Erfolgreicher Vorgang

Sicherheit

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	Beschreibung
vso.code_manage	Ermöglicht das Lesen, Aktualisieren und Löschen von Quellcode, den Zugriff auf Metadaten zu Commits, Changesets, Branches und anderen Versionskontrollartefakten. Bietet außerdem die Möglichkeit, Coderepositorys zu erstellen und zu verwalten, Pull Requests und Code Reviews zu erstellen und zu verwalten sowie Benachrichtigungen zu Versionskontrollereignissen über Diensthooks zu erhalten.

Beispiele

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

Definitionen

Name	Beschreibung
GitAnnotatedTag	Ein Git-Tag mit Anmerkungen.
GitObject	Git-Objektbezeichner und -Typinformationen.
GitObjectType	Objekttyp (Commit, Tree, Blob, Tag)
GitUserDate	Benutzerinformationen und Datum für Git-Vorgänge.

GitAnnotatedTag

Ein Git-Tag mit Anmerkungen.

Name	Typ	Beschreibung
message	string	Die Taggingnachricht
name	string	Der Name des mit Anmerkungen versehenen Tags.
objectId	string	Die objectId (Sha1Id) des Tags.
taggedBy	GitUserDate	Benutzerinformationen und Datum der Markierung.
taggedObject	GitObject	Markiertes Git-Objekt.
url	string

GitObject

Git-Objektbezeichner und -Typinformationen.

Name	Typ	Beschreibung
objectId	string	Objekt-ID (Sha1Id).
objectType	GitObjectType	Objekttyp (Commit, Tree, Blob, Tag)

GitObjectType

Objekttyp (Commit, Tree, Blob, Tag)

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

GitUserDate

Benutzerinformationen und Datum für Git-Vorgänge.

Name	Typ	Beschreibung
date	string	Datum des Git-Vorgangs.
email	string	Email Adresse des Benutzers, der den Git-Vorgang ausführt.
imageUrl	string	URL für den Avatar des Benutzers.
name	string	Name des Benutzers, der den Git-Vorgang ausführt.

Freigeben über