Git - Update From Git

Szolgáltatás:: Core

API verzió:: v1

Frissíti a munkaterületet a csatlakoztatott ágba leküldéses véglegesítésekkel.
Ez az API támogatja hosszú ideig futó műveleteket (LRO).

Az API használatához a hívó Git-hitelesítő adatait az Update My Git Credentials API használatával kell konfigurálni. A Git hitelesítő adatainak lekérése API-val ellenőrizheti a Git hitelesítő adatainak konfigurációját.

A frissítés csak a munkaterület azon elemeit érinti, amelyek módosultak ezekben a véglegesítésekben. Ha a Csatlakozás és a Kapcsolat API-k inicializálása után meghívja , a teljes munkaterület teljes frissítését végrehajtja.

Engedélyek

A hívónak közreműködői vagy magasabb munkaterületi szerepkörrel kell rendelkeznie.

Kötelező delegált hatókörök

Workspace.GitUpdate.All

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Személyazonosság	Támogatás
Felhasználó	Igen
szolgáltatásfelelős és felügyelt identitások	Csak akkor támogatott, ha a műveletben részt vevő összes elem támogatja a szolgáltatásnevet

Interfész

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

URI paraméterek

Név	Ban	Szükséges	Típus	Leírás
workspaceId	path	True	string (uuid)	A munkaterület azonosítója.

Kérő Testület

Név	Szükséges	Típus	Leírás
remoteCommitHash	True	string	Távoli teljes SHA véglegesítési kivonat.
conflictResolution		WorkspaceConflictResolution	A Git-művelet frissítésében használandó ütközésfeloldás. Ha az elemek ütköznek, és nincs megadva ütközésfeloldás, a frissítési művelet nem indul el.
options		UpdateOptions	A Git-művelet frissítésében használandó beállítások
workspaceHead		string	Teljes SHA-kivonat, amellyel a munkaterület szinkronizálva van. Ez az érték csak a kapcsolat inicializálása után lehet null értékű. Más esetekben a rendszer ellenőrzi, hogy a megadott érték igazodik-e a rendszer által ismert fejhez.

Válaszok

Név	Típus	Leírás
200 OK		A kérés sikeresen befejeződött.
202 Accepted		A kérelem elfogadva, frissítés folyamatban van a Gittől. Fejlécek Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Túllépte a szolgáltatási sebesség korlátját. A kiszolgáló egy `Retry-After` fejlécet ad vissza másodpercek alatt, amely jelzi, hogy az ügyfélnek mennyi ideig kell várnia a további kérések elküldése előtt. Fejlécek Retry-After: integer
Other Status Codes	ErrorResponse	Gyakori hibakódok: WorkspaceNotConnectedToGit – A munkaterület nincs csatlakoztatva a githez. WorkspaceHasNoCapacityAssigned – Nincs hozzárendelt kapacitás a munkaterülethez. WorkspaceHeadMismatch – A kérelemben szereplő fej nem egyezik a rendszer fejével. WorkspacePreviousOperationInProgress – Az előző művelet még folyamatban van. MissingDependency – Hiányzik egy függőség a frissítési műveletből. PotentialDuplicateDisplayNameAndType – A frissítési művelet ismétlődő megjelenítendő nevet és típust hoz létre. DependencyDeletionFailed – A frissítési művelet törli a kemény függőséget. InsufficientPrivileges – A hívó nem rendelkezik megfelelő munkaterületi engedélyekkel. PrincipalTypeNotSupported – A hívó identitástípus nem támogatott.

Példák

Update a workspace using data from a Git example

Mintakérés

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

Mintaválasz

Állapotkód:: 200

Állapotkó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

Meghatározások

Név	Leírás
ConflictResolutionPolicy	Ütközésfeloldási szabályzat. Idővel további ütközésfeloldási szabályzatok is hozzáadhatók.
ConflictResolutionType	Ütközésfeloldási típus. Idővel további ütközésfeloldási típusok is hozzáadhatók.
ErrorRelatedResource	A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse	A hibaválasz.
ErrorResponseDetails	A hibaválasz részletei.
UpdateFromGitRequest	A Git-kérelem adataiból származó frissítést tartalmazza.
UpdateOptions	A Gitből származó frissítéshez engedélyezett beállításokat tartalmazza.
WorkspaceConflictResolution	Az alapvető ütközésfeloldási adatok.

ConflictResolutionPolicy

Felsorolás

Ütközésfeloldási szabályzat. Idővel további ütközésfeloldási szabályzatok is hozzáadhatók.

Érték	Leírás
PreferRemote	Előnyben részesítse a távoli Git-oldal tartalmát.
PreferWorkspace	Munkaterületoldali tartalom előnyben részesítve.

ConflictResolutionType

Felsorolás

Ütközésfeloldási típus. Idővel további ütközésfeloldási típusok is hozzáadhatók.

Érték	Leírás
Workspace	A munkaterület szintjét képviselő ütközésfeloldás.

ErrorRelatedResource

Tárgy

A hibával kapcsolatos erőforrás-részletek objektum.

Név	Típus	Leírás
resourceId	string	A hibában érintett erőforrás-azonosító.
resourceType	string	A hibában érintett erőforrás típusa.

ErrorResponse

Tárgy

A hibaválasz.

Név	Típus	Leírás
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
moreDetails	ErrorResponseDetails[]	További hibaadatok listája.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.
requestId	string (uuid)	A hibához társított kérés azonosítója.

ErrorResponseDetails

Tárgy

A hibaválasz részletei.

Név	Típus	Leírás
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.

UpdateFromGitRequest

Tárgy

A Git-kérelem adataiból származó frissítést tartalmazza.

Név	Típus	Leírás
conflictResolution	WorkspaceConflictResolution	A Git-művelet frissítésében használandó ütközésfeloldás. Ha az elemek ütköznek, és nincs megadva ütközésfeloldás, a frissítési művelet nem indul el.
options	UpdateOptions	A Git-művelet frissítésében használandó beállítások
remoteCommitHash	string	Távoli teljes SHA véglegesítési kivonat.
workspaceHead	string	Teljes SHA-kivonat, amellyel a munkaterület szinkronizálva van. Ez az érték csak a kapcsolat inicializálása után lehet null értékű. Más esetekben a rendszer ellenőrzi, hogy a megadott érték igazodik-e a rendszer által ismert fejhez.

UpdateOptions

Tárgy

A Gitből származó frissítéshez engedélyezett beállításokat tartalmazza.

Név	Típus	Leírás
allowOverrideItems	boolean	Felhasználói hozzájárulás a bejövő elemek felülbírálásához a Git-folyamatból történő frissítés során. Ha a bejövő elemek jelen vannak, és az engedélyezési felülbírálási elemek nincsenek megadva, vagy hamisként vannak megadva, a frissítési művelet nem indul el. Az alapértelmezett érték hamis.

WorkspaceConflictResolution

Tárgy

Az alapvető ütközésfeloldási adatok.

Név	Típus	Leírás
conflictResolutionPolicy	ConflictResolutionPolicy	Ütközésfeloldási szabályzat. Idővel további ütközésfeloldási szabályzatok is hozzáadhatók.
conflictResolutionType	ConflictResolutionType	Ütközésfeloldási típus. Idővel további ütközésfeloldási típusok is hozzáadhatók.