Annotated Tags - Create

Referencia

Service:: Git

API Version:: 7.1-preview.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-preview.1

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	El 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-preview.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

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

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.

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

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

Definiciones

Nombre	Description
GitAnnotatedTag	Una 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 de usuario y fecha para las operaciones de Git.

GitAnnotatedTag

Una 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

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

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

Nombre	Tipo	Description
bad	string
blob	string
commit	string
ext2	string
ofsDelta	string
refDelta	string
tag	string
tree	string

GitUserDate

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

Nombre	Tipo	Description
date	string	Fecha de la operación de Git.
email	string	Email dirección 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.

Compartir a través de