Annotated Tags - Create

Servicio:

Git

Versión de la API:

7.1

Cree una etiqueta anotada.

Los repositorios tienen un nombre y un identificador. Los identificadores son únicos globalmente, pero varios proyectos pueden contener un repositorio con el mismo nombre. No es necesario incluir el proyecto si especifica un repositorio por identificador. Sin embargo, si especifica un repositorio por nombre, también debe especificar el proyecto (por nombre o identificador).

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	Nombre de la organización de Azure DevOps.
project	path	True	string	Id. de proyecto o nombre del proyecto
repositoryId	path	True	string	Identificador o nombre del repositorio.
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "7.1" para usar esta versión de la API.

Cuerpo de la solicitud

Nombre	Tipo	Description
message	string	Mensaje de etiquetado
name	string	Nombre de la etiqueta anotada.
objectId	string	ObjectId (Sha1Id) de la etiqueta.
taggedBy	GitUserDate	Información del usuario y fecha de etiquetado.
taggedObject	GitObject	Objeto git etiquetado.
url	string

Respuestas

Nombre	Tipo	Description
200 OK	GitAnnotatedTag	operación correcta

Seguridad

oauth2

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del token: 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

Ámbitos

Nombre

Description

vso.code_manage

Concede la capacidad de leer, actualizar y eliminar código fuente, acceder a metadatos sobre confirmaciones, conjuntos de cambios, ramas y otros artefactos de control de versiones. También concede la capacidad de crear y administrar repositorios de código, crear y administrar solicitudes de incorporación de cambios y revisiones de código, y recibir notificaciones sobre eventos de control de versiones a través de enlaces de servicio.

Ejemplos

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre	Description
GitAnnotatedTag	Etiqueta anotada de Git.
GitObject	Identificador de objeto de Git e información de tipo.
GitObjectType	Tipo de objeto (Commit, Tree, Blob, Tag)
GitUserDate	Información del usuario y fecha de las operaciones de Git.

GitAnnotatedTag

Object

Etiqueta anotada de Git.

Nombre	Tipo	Description
message	string	Mensaje de etiquetado
name	string	Nombre de la etiqueta anotada.
objectId	string	ObjectId (Sha1Id) de la etiqueta.
taggedBy	GitUserDate	Información del usuario y fecha de etiquetado.
taggedObject	GitObject	Objeto git etiquetado.
url	string

GitObject

Object

Identificador de objeto de Git e información de tipo.

Nombre	Tipo	Description
objectId	string	Id. de objeto (Sha1Id).
objectType	GitObjectType	Tipo de objeto (Commit, Tree, Blob, Tag)

GitObjectType

Enumeración

Tipo de objeto (Commit, Tree, Blob, Tag)

Valor	Description
bad
blob
commit
ext2
ofsDelta
refDelta
tag
tree

GitUserDate

Object

Información del usuario y fecha de las operaciones de Git.

Nombre	Tipo	Description
date	string (date-time)	Fecha de la operación de Git.
email	string	Dirección de correo electrónico del usuario que realiza la operación de Git.
imageUrl	string	Dirección URL del avatar del usuario.
name	string	Nombre del usuario que realiza la operación de Git.