Git - Initialize Connection

Servizio:

Core

Versione API:

v1

Inizializzare una connessione per un'area di lavoro connessa a Git.
Questa API supporta operazioni con esecuzione prolungata (LRO).

Per usare questa API, è necessario configurare le credenziali Git del chiamante usando l'API Aggiorna credenziali Git personali. È possibile usare l'API Get My Git Credentials (Ottieni credenziali Git personali ) per controllare la configurazione delle credenziali Git.

Questa API deve essere chiamata dopo una chiamata riuscita all'API Connect . Per completare una sincronizzazione completa dell'area di lavoro, usare l'operazione Azione richiesta per chiamare l'operazione di sincronizzazione pertinente, eseguire il commit in Git o l'aggiornamento da Git.

Permissions

Il chiamante deve avere un ruolo di area di lavoro amministratore .

Ambiti delegati obbligatori

Workspace.ReadWrite.All

Identità supportate da Microsoft Entra

Questa API supporta le identità di Microsoft elencate in questa sezione.

Identity	Support
User	Yes
Principale del servizio e Identità gestite	Yes

Interface

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
workspaceId	path	True	string (uuid)	ID dell'area di lavoro.

Corpo della richiesta

Nome	Tipo	Descrizione
initializationStrategy	InitializationStrategy	Strategia necessaria per un processo di inizializzazione quando il contenuto esiste sia sul lato remoto che sul lato dell'area di lavoro. È possibile aggiungere strategie aggiuntive nel tempo.

Risposte

Nome	Tipo	Descrizione
200 OK	InitializeGitConnectionResponse	Richiesta completata correttamente.
202 Accepted		Richiesta accettata, inizializzare la connessione in corso. Intestazioni Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Codici di errore comuni: WorkspaceNotConnectedToGit: l'area di lavoro non è connessa a Git. WorkspaceHasNoCapacityAssigned: nessuna capacità assegnata all'area di lavoro. MissingInitializationPolicy : manca il criterio di inizializzazione. InsufficientPrivileges: il chiamante non dispone di autorizzazioni sufficienti per l'area di lavoro. PrincipalTypeNotSupported: il tipo di identità del chiamante non è supportato.

Esempio

Initialize the connection of a workspace connected to a Git example

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:

200

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

Codice di stato:

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

Definizioni

Nome	Descrizione
ErrorRelatedResource	Oggetto dettagli risorsa correlato all'errore.
ErrorResponse	Risposta di errore.
ErrorResponseDetails	Dettagli della risposta di errore.
InitializationStrategy	Strategia necessaria per un processo di inizializzazione quando il contenuto esiste sia sul lato remoto che sul lato dell'area di lavoro. È possibile aggiungere strategie aggiuntive nel tempo.
InitializeGitConnectionRequest	Contiene i dati della richiesta di connessione Git inizializzati.
InitializeGitConnectionResponse	Contiene i dati di risposta della connessione Git inizializzati.
RequiredAction	Azione necessaria al termine del processo di inizializzazione. È possibile aggiungere altre azioni nel tempo.

ErrorRelatedResource

Object

Oggetto dettagli risorsa correlato all'errore.

Nome	Tipo	Descrizione
resourceId	string	ID risorsa coinvolto nell'errore.
resourceType	string	Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Object

Risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
moreDetails	ErrorResponseDetails[]	Elenco di dettagli aggiuntivi sull'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.
requestId	string	ID della richiesta associata all'errore.

ErrorResponseDetails

Object

Dettagli della risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.

InitializationStrategy

Enumerazione

Strategia necessaria per un processo di inizializzazione quando il contenuto esiste sia sul lato remoto che sul lato dell'area di lavoro. È possibile aggiungere strategie aggiuntive nel tempo.

Valore	Descrizione
None	Nessuna strategia definita.
PreferRemote	Preferisce il contenuto lato Git remoto.
PreferWorkspace	Preferisce il contenuto sul lato area di lavoro.

InitializeGitConnectionRequest

Object

Contiene i dati della richiesta di connessione Git inizializzati.

Nome	Tipo	Descrizione
initializationStrategy	InitializationStrategy	Strategia necessaria per un processo di inizializzazione quando il contenuto esiste sia sul lato remoto che sul lato dell'area di lavoro. È possibile aggiungere strategie aggiuntive nel tempo.

InitializeGitConnectionResponse

Object

Contiene i dati di risposta della connessione Git inizializzati.

Nome	Tipo	Descrizione
remoteCommitHash	string	Hash di commit SHA completo remoto.
requiredAction	RequiredAction	Azione necessaria al termine del processo di inizializzazione. È possibile aggiungere altre azioni nel tempo.
workspaceHead	string	Hash SHA completo in cui è sincronizzata l'area di lavoro.

RequiredAction

Enumerazione

Azione necessaria al termine del processo di inizializzazione. È possibile aggiungere altre azioni nel tempo.

Valore	Descrizione
None	Non è necessaria alcuna azione.
UpdateFromGit	L'aggiornamento da Git è obbligatorio.
CommitToGit	Il commit in Git è obbligatorio.