Annotated Tags - Create
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 |
repository
|
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 |
Información del usuario y fecha de etiquetado. |
|
taggedObject |
Objeto git etiquetado. |
|
url |
string |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
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. |
Ejemplos
Sample Request
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
{
"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 |
---|---|
Git |
Una etiqueta anotada de Git. |
Git |
Identificador de objeto de Git e información de tipo. |
Git |
Tipo de objeto (Commit, Tree, Blob, Tag) |
Git |
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 |
Información del usuario y fecha de etiquetado. |
|
taggedObject |
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 |
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. |
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. |