Forks - Create fork sync request

Usługa:

Git

Wersja interfejsu API:

7.1

Zażądaj pobrania do tego odwołania innego repozytorium. Synchronizuje dwa istniejące rozwidlenia. Aby utworzyć rozwidlenie, zobacz punkt końcowy repozytoriów

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

Z parametrami opcjonalnymi:

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryNameOrId}/forkSyncRequests?includeLinks={includeLinks}&api-version=7.1

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
repositoryNameOrId	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.
includeLinks	query		boolean	Wartość True do uwzględnienia łączy

Treść żądania

Nazwa	Typ	Opis
source	GlobalGitRepositoryKey	W pełni kwalifikowany identyfikator dla repozytorium źródłowego.
sourceToTargetRefs	SourceToTargetRef[]	W przypadku dostarczenia zestawu mapowań ref do użycia podczas wykonywania "synchronizacji" lub tworzenia. Jeśli brakuje, wszystkie odwołania zostaną zsynchronizowane.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	GitForkSyncRequest	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.

Definicje

Nazwa	Opis
GitAsyncOperationStatus
GitForkOperationStatusDetail	Informacje o stanie żądanej operacji rozwidlenia.
GitForkSyncRequest	Żądanie synchronizacji danych między dwoma rozwidlami.
GitForkSyncRequestParameters	Parametry tworzenia żądania rozwidlenia
GlobalGitRepositoryKey	Unikatowy klucz globalny dla repozytorium.
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
SourceToTargetRef

GitAsyncOperationStatus

Wyliczanie

Wartość	Opis
abandoned	Operacja została porzucona.
completed	Operacja została ukończona.
failed	Operacja nie powiodła się. Sprawdź komunikat o błędzie.
inProgress	Operacja jest obecnie w toku.
queued	Operacja czeka w kolejce i nie została jeszcze uruchomiona.

GitForkOperationStatusDetail

Objekt

Informacje o stanie żądanej operacji rozwidlenia.

Nazwa	Typ	Opis
allSteps	string[]	Wszystkie prawidłowe kroki procesu rozwidlania
currentStep	integer (int32)	Indeksowanie do allSteps dla bieżącego kroku
errorMessage	string	Komunikat o błędzie, jeśli operacja nie powiodła się.

GitForkSyncRequest

Objekt

Żądanie synchronizacji danych między dwoma rozwidlami.

Nazwa	Typ	Opis
_links	ReferenceLinks	Kolekcja powiązanych linków
detailedStatus	GitForkOperationStatusDetail	Informacje o stanie żądanej operacji rozwidlenia.
operationId	integer (int32)	Unikatowy identyfikator operacji.
source	GlobalGitRepositoryKey	W pełni kwalifikowany identyfikator dla repozytorium źródłowego.
sourceToTargetRefs	SourceToTargetRef[]	W przypadku dostarczenia zestawu mapowań ref do użycia podczas wykonywania "synchronizacji" lub tworzenia. Jeśli brakuje, wszystkie odwołania zostaną zsynchronizowane.
status	GitAsyncOperationStatus

GitForkSyncRequestParameters

Objekt

Parametry tworzenia żądania rozwidlenia

Nazwa	Typ	Opis
source	GlobalGitRepositoryKey	W pełni kwalifikowany identyfikator dla repozytorium źródłowego.
sourceToTargetRefs	SourceToTargetRef[]	W przypadku dostarczenia zestawu mapowań ref do użycia podczas wykonywania "synchronizacji" lub tworzenia. Jeśli brakuje, wszystkie odwołania zostaną zsynchronizowane.

GlobalGitRepositoryKey

Objekt

Unikatowy klucz globalny dla repozytorium.

Nazwa	Typ	Opis
collectionId	string (uuid)	Identyfikator kolekcji projektu zespołowego dla repozytorium.
projectId	string (uuid)	Identyfikator projektu zespołowego dla repozytorium.
repositoryId	string (uuid)	Identyfikator repozytorium.

ReferenceLinks

Objekt

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa	Typ	Opis
links	object	Czytelny widok linków. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

SourceToTargetRef

Objekt

Nazwa	Typ	Opis
sourceRef	string	Odwołanie źródłowe do skopiowania. Na przykład refs/heads/master.
targetRef	string	Docelowy odwołanie do aktualizacji. Na przykład refs/heads/master.