Refs - Update Refs

Odwołanie

Usługa:: Git

Wersja interfejsu API:: 7.1

Tworzenie, aktualizowanie lub usuwanie elementów refs(gałęzi).

Aktualizowanie odwołania oznacza, że wskazuje ono na inne zatwierdzenie niż używane. Należy określić zarówno stare, jak i nowe zatwierdzenie, aby uniknąć warunków wyścigu.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
repositoryId	path	True	string	Nazwa lub identyfikator repozytorium.
project	path		string	Identyfikator projektu lub nazwa projektu
api-version	query	True	string	Wersja interfejsu API do użycia. Należy ustawić wartość "7.1", aby używać tej wersji interfejsu API.
projectId	query		string	Identyfikator lub nazwa projektu zespołowego. Opcjonalnie, jeśli określono identyfikator repozytorium.

Treść żądania

Nazwa	Typ	Opis
body	GitRefUpdate[]	Lista aktualizacji ref do wykonania

Odpowiedzi

Nazwa	Typ	Opis
200 OK	GitRefUpdateResult[]	operacja zakończona powodzeniem

Zabezpieczenia

oauth2

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Adres URL tokenu: 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

Zakresy

Nazwa	Opis
vso.code_write	Umożliwia odczytywanie, aktualizowanie i usuwanie kodu źródłowego, uzyskiwanie dostępu do metadanych dotyczących zatwierdzeń, zestawów zmian, gałęzi i innych artefaktów kontroli wersji. Ponadto umożliwia tworzenie żądań ściągnięcia i przeglądów kodu oraz zarządzanie nimi oraz odbieranie powiadomień o zdarzeniach kontroli wersji za pośrednictwem punktów zaczepienia usługi.

Przykłady

Create/Update/Delete a ref by repositoryId

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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
}

Definicje

Nazwa	Opis
GitRefUpdate
GitRefUpdateResult
GitRefUpdateStatus	Stan aktualizacji z serwera TFS.

GitRefUpdate

Objekt

Nazwa	Typ	Opis
isLocked	boolean
name	string
newObjectId	string
oldObjectId	string
repositoryId	string (uuid)

GitRefUpdateResult