Refs - Update Refs

Referencia

Servicio:: Git

Versión de la API:: 7.1

Creación, actualización o eliminación de referencias (ramas).

Actualizar una referencia significa hacer que apunte a una confirmación diferente a la que usó. Debe especificar tanto la confirmación anterior como la nueva para evitar condiciones de carrera.

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

Con parámetros opcionales:

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/refs?projectId={projectId}&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.
repositoryId	path	True	string	Nombre o identificador del repositorio.
project	path		string	Id. de proyecto o nombre del proyecto
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.
projectId	query		string	Identificador o nombre del proyecto de equipo. Opcional si especifica un identificador para el repositorio.

Cuerpo de la solicitud

Nombre	Tipo	Description
body	GitRefUpdate[]	Lista de actualizaciones ref para intentar realizar

Respuestas

Nombre	Tipo	Description
200 OK	GitRefUpdateResult[]	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_write	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 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

Create/Update/Delete a ref by repositoryId

Solicitud de ejemplo

HTTP

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

[
  {
    "name": "refs/heads/vsts-api-sample/answer-woman-flame",
    "oldObjectId": "0000000000000000000000000000000000000000",
    "newObjectId": "ffe9cba521f00d7f60e322845072238635edb451"
  }
]

Respuesta de muestra

status code:: 200

transfer-Encoding: chunked

{
  "value": [
    {
      "repositoryId": "d3d1760b-311c-4175-a726-20dfc6a7f885",
      "name": "refs/heads/vsts-api-sample/answer-woman-flame",
      "oldObjectId": "0000000000000000000000000000000000000000",
      "newObjectId": "ffe9cba521f00d7f60e322845072238635edb451",
      "isLocked": false,
      "updateStatus": "succeeded",
      "success": true
    }
  ],
  "count": 1
}

Definiciones

Nombre	Description
GitRefUpdate
GitRefUpdateResult
GitRefUpdateStatus	Estado de la actualización desde el servidor TFS.

GitRefUpdate

Object

Nombre	Tipo	Description
isLocked	boolean
name	string
newObjectId	string
oldObjectId	string
repositoryId	string (uuid)

GitRefUpdateResult