Git - Update From Git

Servizio:: Core

Versione API:: v1

Aggiorna l'area di lavoro con commit di cui è stato eseguito il push nel ramo connesso.
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.

L'aggiornamento influisce solo sugli elementi nell'area di lavoro modificati in tali commit. Se viene chiamato dopo le API Connect e Initialize Connection , verrà eseguito un aggiornamento completo dell'intera area di lavoro.

Autorizzazioni

Il chiamante deve avere un ruolo di collaboratore o superiore dell'area di lavoro.

Ambiti delegati obbligatori

Workspace.GitUpdate.All

Identità supportate da Microsoft Entra

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

Identità	Assistenza
Utente	Sì
Entità servizio e Identità gestite	Supportato solo quando tutti gli elementi coinvolti nell'operazione supportano le entità servizio

Interfaccia

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

Parametri dell'URI

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

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
remoteCommitHash	True	string	Hash di commit SHA completo remoto.
conflictResolution		WorkspaceConflictResolution	Risoluzione dei conflitti da usare nell'aggiornamento dall'operazione Git. Se gli elementi sono in conflitto e non viene specificata una risoluzione dei conflitti, l'operazione di aggiornamento non verrà avviata.
options		UpdateOptions	Opzioni da usare nell'aggiornamento dall'operazione Git
workspaceHead		string	Hash SHA completo in cui è sincronizzata l'area di lavoro. Questo valore può essere Null solo dopo l'inizializzazione della connessione. In altri casi, il sistema convaliderà che il valore specificato sia allineato alla testa nota al sistema.

Risposte

Nome	Tipo	Descrizione
200 OK		Richiesta completata correttamente.
202 Accepted		Richiesta accettata, aggiornamento da Git 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. WorkspaceHeadMismatch: head nella richiesta non corrisponde all'intestazione nel sistema. WorkspacePreviousOperationInProgress- L'operazione precedente è ancora in corso. MissingDependency: manca una dipendenza nell'operazione di aggiornamento. PotentialDuplicateDisplayNameAndType: l'operazione di aggiornamento creerà un nome visualizzato duplicato e un tipo. DependencyDeletionFailed: l'operazione di aggiornamento eliminerà la dipendenza rigida. InsufficientPrivileges: il chiamante non dispone di autorizzazioni sufficienti per l'area di lavoro. PrincipalTypeNotSupported: il tipo di identità del chiamante non è supportato.

Nome

Tipo

Descrizione

200 OK

Richiesta completata correttamente.

202 Accepted

Richiesta accettata, aggiornamento da Git 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.
WorkspaceHeadMismatch: head nella richiesta non corrisponde all'intestazione nel sistema.
WorkspacePreviousOperationInProgress- L'operazione precedente è ancora in corso.
MissingDependency: manca una dipendenza nell'operazione di aggiornamento.
PotentialDuplicateDisplayNameAndType: l'operazione di aggiornamento creerà un nome visualizzato duplicato e un tipo.
DependencyDeletionFailed: l'operazione di aggiornamento eliminerà la dipendenza rigida.
InsufficientPrivileges: il chiamante non dispone di autorizzazioni sufficienti per l'area di lavoro.
PrincipalTypeNotSupported: il tipo di identità del chiamante non è supportato.

Esempio

Update a workspace using data from a Git example

Esempio di richiesta

HTTP

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

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
  "conflictResolution": {
    "conflictResolutionType": "Workspace",
    "conflictResolutionPolicy": "PreferWorkspace"
  },
  "options": {
    "allowOverrideItems": true
  }
}

Risposta di esempio

Codice di stato:: 200

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
ConflictResolutionPolicy	Criteri di risoluzione dei conflitti. È possibile aggiungere altri criteri di risoluzione dei conflitti nel tempo.
ConflictResolutionType	Tipo di risoluzione dei conflitti. È possibile aggiungere altri tipi di risoluzione dei conflitti nel corso del tempo.
ErrorRelatedResource	Oggetto dettagli risorsa correlato all'errore.
ErrorResponse	Risposta di errore.
ErrorResponseDetails	Dettagli della risposta di errore.
UpdateFromGitRequest	Contiene l'aggiornamento dai dati delle richieste Git.
UpdateOptions	Contiene le opzioni abilitate per l'aggiornamento da Git.
WorkspaceConflictResolution	Dati di base per la risoluzione dei conflitti.

ConflictResolutionPolicy

Enumerazione

Criteri di risoluzione dei conflitti. È possibile aggiungere altri criteri di risoluzione dei conflitti nel tempo.

Valore	Descrizione
PreferRemote	Preferisce il contenuto lato Git remoto.
PreferWorkspace	Preferisce il contenuto sul lato area di lavoro.

ConflictResolutionType

Enumerazione

Tipo di risoluzione dei conflitti. È possibile aggiungere altri tipi di risoluzione dei conflitti nel corso del tempo.

Valore	Descrizione
Workspace	Risoluzione dei conflitti che rappresenta il livello dell'area di lavoro.

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.

UpdateFromGitRequest

Object

Contiene l'aggiornamento dai dati delle richieste Git.

Nome	Tipo	Descrizione
conflictResolution	WorkspaceConflictResolution	Risoluzione dei conflitti da usare nell'aggiornamento dall'operazione Git. Se gli elementi sono in conflitto e non viene specificata una risoluzione dei conflitti, l'operazione di aggiornamento non verrà avviata.
options	UpdateOptions	Opzioni da usare nell'aggiornamento dall'operazione Git
remoteCommitHash	string	Hash di commit SHA completo remoto.
workspaceHead	string	Hash SHA completo in cui è sincronizzata l'area di lavoro. Questo valore può essere Null solo dopo l'inizializzazione della connessione. In altri casi, il sistema convaliderà che il valore specificato sia allineato alla testa nota al sistema.

UpdateOptions

Object

Contiene le opzioni abilitate per l'aggiornamento da Git.

Nome	Tipo	Descrizione
allowOverrideItems	boolean	Consenso dell'utente per eseguire l'override degli elementi in ingresso durante l'aggiornamento dal processo Git. Quando sono presenti elementi in ingresso e gli elementi di override consentiti non vengono specificati o vengono forniti come false, l'operazione di aggiornamento non verrà avviata. Il valore predefinito è false.

WorkspaceConflictResolution

Object

Dati di base per la risoluzione dei conflitti.

Nome	Tipo	Descrizione
conflictResolutionPolicy	ConflictResolutionPolicy	Criteri di risoluzione dei conflitti. È possibile aggiungere altri criteri di risoluzione dei conflitti nel tempo.
conflictResolutionType	ConflictResolutionType	Tipo di risoluzione dei conflitti. È possibile aggiungere altri tipi di risoluzione dei conflitti nel corso del tempo.

Condividi tramite

Git - Update From Git

Autorizzazioni

Ambiti delegati obbligatori

Identità supportate da Microsoft Entra

Interfaccia

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

Update a workspace using data from a Git example

Esempio di richiesta

Risposta di esempio

Definizioni

ConflictResolutionPolicy

ConflictResolutionType

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

UpdateFromGitRequest

UpdateOptions

WorkspaceConflictResolution