Git - Initialize Connection

Service:

Core

API-versie:

v1

Initialiseer een verbinding voor een werkruimte die is verbonden met Git.
Deze API ondersteunt langlopende bewerkingen (LRO).

Als u deze API wilt gebruiken, moeten de Git-referenties van de aanroeper worden geconfigureerd met de API Mijn Git-referenties bijwerken . U kunt de API Mijn Git-referenties ophalen gebruiken om de configuratie van git-referenties te controleren.

Deze API moet worden aangeroepen na een geslaagde aanroep naar de Connect-API . Als u een volledige synchronisatie van de werkruimte wilt voltooien, gebruikt u de bewerking Vereiste actie om de relevante synchronisatiebewerking aan te roepen: Doorvoeren naar Git of Bijwerken vanuit Git.

Permissions

De aanroeper moet een beheerderswerkruimterol hebben.

Vereiste gedelegeerde bereiken

Workspace.ReadWrite.All

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft-identiteiten die in deze sectie worden vermeld.

Identity	Support
User	Yes
serviceprincipal en beheerde identiteiten	Yes

Interface

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/initializeConnection

URI-parameters

Name	In	Vereist	Type	Description
workspaceId	path	True	string (uuid)	De werkruimte-id.

Aanvraagbody

Name	Type	Description
initializationStrategy	InitializationStrategy	De strategie die is vereist voor een initialisatieproces wanneer inhoud zowel aan de externe zijde als aan de werkruimtezijde bestaat. Er kunnen in de loop van de tijd extra strategieën worden toegevoegd.

Antwoorden

Name	Type	Description
200 OK	InitializeGitConnectionResponse	De aanvraag is voltooid.
202 Accepted		Aanvraag geaccepteerd, initialiseer de verbinding die wordt uitgevoerd. Kopteksten Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: WorkspaceNotConnectedToGit - Werkruimte is niet verbonden met Git. WorkspaceHasNoCapacityAssigned - Geen capaciteit toegewezen aan Werkruimte. MissingInitializationPolicy - Initialisatiebeleid ontbreekt. InsufficientPrivileges : de aanroeper beschikt niet over voldoende machtigingen voor de werkruimte. PrincipalTypeNotSupported - Identiteitstype beller wordt niet ondersteund.

Voorbeelden

Initialize the connection of a workspace connected to a Git example

Voorbeeldaanvraag

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/1565e6a3-c020-4c0c-dda7-92bafe99eec5/git/initializeConnection

Voorbeeldrespons

Statuscode:

200

{
  "requiredAction": "UpdateFromGit",
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705"
}

Statuscode:

202

Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30

Definities

Name	Description
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	Het foutbericht.
ErrorResponseDetails	De details van het foutbericht.
InitializationStrategy	De strategie die is vereist voor een initialisatieproces wanneer inhoud zowel aan de externe zijde als aan de werkruimtezijde bestaat. Er kunnen in de loop van de tijd extra strategieën worden toegevoegd.
InitializeGitConnectionRequest	Bevat de gegevens van de Git-verbindingsaanvraag initialiseren.
InitializeGitConnectionResponse	Bevat de reactiegegevens van de Git-verbinding initialiseren.
RequiredAction	Vereiste actie nadat het initialisatieproces is voltooid. Er kunnen in de loop van de tijd extra acties worden toegevoegd.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-id die betrokken is bij de fout.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.
requestId	string	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.

InitializationStrategy

Inventarisatie

De strategie die is vereist voor een initialisatieproces wanneer inhoud zowel aan de externe zijde als aan de werkruimtezijde bestaat. Er kunnen in de loop van de tijd extra strategieën worden toegevoegd.

Waarde	Description
None	Er is geen strategie gedefinieerd.
PreferRemote	Geef de voorkeur aan externe Inhoud aan de Git-zijde.
PreferWorkspace	Geef de voorkeur aan inhoud aan de werkruimtezijde.

InitializeGitConnectionRequest

Object

Bevat de gegevens van de Git-verbindingsaanvraag initialiseren.

Name	Type	Description
initializationStrategy	InitializationStrategy	De strategie die is vereist voor een initialisatieproces wanneer inhoud zowel aan de externe zijde als aan de werkruimtezijde bestaat. Er kunnen in de loop van de tijd extra strategieën worden toegevoegd.

InitializeGitConnectionResponse

Object

Bevat de reactiegegevens van de Git-verbinding initialiseren.

Name	Type	Description
remoteCommitHash	string	Externe volledige SHA-doorvoerhash.
requiredAction	RequiredAction	Vereiste actie nadat het initialisatieproces is voltooid. Er kunnen in de loop van de tijd extra acties worden toegevoegd.
workspaceHead	string	Volledige SHA-hash waarmee de werkruimte wordt gesynchroniseerd.

RequiredAction

Inventarisatie

Vereiste actie nadat het initialisatieproces is voltooid. Er kunnen in de loop van de tijd extra acties worden toegevoegd.

Waarde	Description
None	Er is geen actie vereist.
UpdateFromGit	Update van Git is vereist.
CommitToGit	Doorvoeren naar Git is vereist.