Sdílet prostřednictvím

Git - Update From Git

Služba:
Core
Verze rozhraní API:
v1

Aktualizuje pracovní prostor potvrzeními nasdílenými do připojené větve.
Toto rozhraní API podporuje dlouhotrvajících operací (LRO).

Pokud chcete toto rozhraní API použít, musí být přihlašovací údaje Git volajícího nakonfigurované pomocí rozhraní UPDATE MY Git CREDENTIALS API. Ke kontrole konfigurace přihlašovacích údajů Gitu můžete použít rozhraní API Získat moje přihlašovací údaje Gitu .

Aktualizace má vliv jenom na položky v pracovním prostoru, které byly změněny v těchto potvrzeních. Pokud se volá po připojení ainicializaci rozhraní API připojení, provede úplnou aktualizaci celého pracovního prostoru.

Dovolení

Volající musí mít roli přispěvatele nebo vyšší roli pracovního prostoru.

Požadované delegovaná rozsahy

Workspace.GitUpdate.All

Podporované identity Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita Podpora
Uživatel Ano
Hlavní služba a Spravované identity Podporováno pouze v případech, kdy všechny položky zahrnuté v operaci podporují instanční objekty.

Rozhraní

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
workspaceId
 path True

string (uuid)

ID pracovního prostoru.

Text požadavku

Name Vyžadováno Typ Description
remoteCommitHash True

string

Vzdálená úplná hodnota hash potvrzení SHA
conflictResolution

WorkspaceConflictResolution

Řešeníkonfliktůch Pokud jsou položky v konfliktu a není zadáno řešení konfliktů, operace aktualizace se nespustí.
options

UpdateOptions

Možnosti, které se mají použít v aktualizaci z operace Gitu
workspaceHead

string

Úplná hodnota hash SHA, se kterou se pracovní prostor synchronizuje. Tato hodnota může být null až po inicializaci připojení. V jiných případech systém ověří, že daná hodnota je v souladu s hlavou známou systémem.

Odpovědi

Name Typ Description
200 OK

Žádost byla úspěšně dokončena.
202 Accepted

Žádost byla přijata, probíhá aktualizace z Gitu.

Hlavičky

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Běžné kódy chyb:

  • WorkspaceNotConnectedToGit – Pracovní prostor není připojený k Gitu.

  • WorkspaceHasNoCapacityAssigned – k pracovnímu prostoru není přiřazena žádná kapacita.

  • WorkspaceHeadMismatch – Hlavička v požadavku neodpovídá hlavičce v systému.

  • WorkspacePreviousOperationInProgress – Probíhá předchozí operace.

  • MissingDependency – V operaci aktualizace chybí závislost.

  • PotentialDuplicateDisplayNameAndType – Operace aktualizace vytvoří duplicitní zobrazovaný název a typ.

  • DependencyDeletionFailed – Operace aktualizace odstraní pevnou závislost.

  • InsufficientPrivileges – Volající nemá dostatečná oprávnění pracovního prostoru.

  • PrincipalTypeNotSupported – Typ identity volajícího není podporován.

Příklady

Update a workspace using data from a Git example

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
200
Stavový kód:
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

Definice

Name Description
ConflictResolutionPolicy

Zásady řešení konfliktů. V průběhu času se můžou přidat další zásady řešení konfliktů.
ConflictResolutionType

Typ řešení konfliktů. V průběhu času se můžou přidat další typy řešení konfliktů.
ErrorRelatedResource

Chyba související s objektem podrobností o prostředku.
ErrorResponse

Odpověď na chybu.
ErrorResponseDetails

Podrobnosti o odpovědi na chybu.
UpdateFromGitRequest

Obsahuje aktualizaci z dat požadavku Gitu.
UpdateOptions

Obsahuje možnosti, které jsou povolené pro aktualizaci z Gitu.
WorkspaceConflictResolution

Základní data řešení konfliktů.

ConflictResolutionPolicy

Výčet

Zásady řešení konfliktů. V průběhu času se můžou přidat další zásady řešení konfliktů.

Hodnota Description
PreferRemote

Preferujte vzdálený obsah na straně Gitu.
PreferWorkspace

Upřednostněte obsah na straně pracovního prostoru.

ConflictResolutionType

Výčet

Typ řešení konfliktů. V průběhu času se můžou přidat další typy řešení konfliktů.

Hodnota Description
Workspace

Řešeníkonfliktůch

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name Typ Description
resourceId

string

ID prostředku, které je součástí chyby.
resourceType

string

Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message

string

Lidské čitelné vyjádření chyby.
moreDetails

ErrorResponseDetails[]

Seznam dalších podrobností o chybě
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou
requestId

string

ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message

string

Lidské čitelné vyjádření chyby.
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou

UpdateFromGitRequest

Objekt

Obsahuje aktualizaci z dat požadavku Gitu.

Name Typ Description
conflictResolution

WorkspaceConflictResolution

Řešeníkonfliktůch Pokud jsou položky v konfliktu a není zadáno řešení konfliktů, operace aktualizace se nespustí.
options

UpdateOptions

Možnosti, které se mají použít v aktualizaci z operace Gitu
remoteCommitHash

string

Vzdálená úplná hodnota hash potvrzení SHA
workspaceHead

string

Úplná hodnota hash SHA, se kterou se pracovní prostor synchronizuje. Tato hodnota může být null až po inicializaci připojení. V jiných případech systém ověří, že daná hodnota je v souladu s hlavou známou systémem.

UpdateOptions

Objekt

Obsahuje možnosti, které jsou povolené pro aktualizaci z Gitu.

Name Typ Description
allowOverrideItems

boolean

Souhlas uživatele s přepsání příchozích položek během aktualizace z procesu Gitu Pokud jsou k dispozici příchozí položky a není zadána možnost přepsání položek nebo je zadána jako nepravda, operace aktualizace se nespustí. Výchozí hodnotou je nepravda.

WorkspaceConflictResolution

Objekt

Základní data řešení konfliktů.

Name Typ Description
conflictResolutionPolicy

ConflictResolutionPolicy

Zásady řešení konfliktů. V průběhu času se můžou přidat další zásady řešení konfliktů.
conflictResolutionType

ConflictResolutionType

Typ řešení konfliktů. V průběhu času se můžou přidat další typy řešení konfliktů.