Refs - Update Refs

Riferimento

Servizio:: Git

Versione API:: 7.1

Creazione, aggiornamento o eliminazione di refs(rami).

L'aggiornamento di un riferimento indica che punta a un commit diverso rispetto a quello usato. È necessario specificare sia il commit precedente che quello nuovo per evitare le race condition.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
repositoryId	path	True	string	Nome o ID del repository.
project	path		string	ID progetto o nome progetto
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '7.1' per usare questa versione dell'API.
projectId	query		string	ID o nome del progetto team. Facoltativo se si specifica un ID per il repository.

Corpo della richiesta

Nome	Tipo	Descrizione
body	GitRefUpdate[]	Elenco di aggiornamenti di riferimento per tentare di eseguire

Risposte

Nome	Tipo	Descrizione
200 OK	GitRefUpdateResult[]	operazione riuscita

Sicurezza

oauth2

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL 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

Ambiti

Nome	Descrizione
vso.code_write	Concede la possibilità di leggere, aggiornare ed eliminare il codice sorgente, accedere ai metadati relativi a commit, insiemi di modifiche, rami e altri artefatti del controllo della versione. Concede inoltre la possibilità di creare e gestire richieste pull e revisioni del codice e di ricevere notifiche sugli eventi di controllo della versione tramite hook del servizio.

Esempio

Create/Update/Delete a ref by repositoryId

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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
}

Definizioni

Nome	Descrizione
GitRefUpdate
GitRefUpdateResult
GitRefUpdateStatus	Stato dell'aggiornamento dal server TFS.

GitRefUpdate

Object

Nome	Tipo	Descrizione
isLocked	boolean
name	string
newObjectId	string
oldObjectId	string
repositoryId	string (uuid)

GitRefUpdateResult