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 rendszergazdai munkaterületi szerepkört 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 Git-szolgáltató a GitHub, és a műveletben részt vevő összes elem támogatja a szolgáltatásnevek használatát

Interfész

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
workspaceId	path	True	string (uuid)	A munkaterület azonosítója.

Kérelem törzse

Name	Kötelező	Típus	Description
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

Name	Típus	Description
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
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érelem

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

Definíciók

Name	Description
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

Enumerálás

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

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

ConflictResolutionType

Enumerálás

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

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

ErrorRelatedResource

Objektum

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

Name	Típus	Description
resourceId	string	A hibában érintett erőforrás-azonosító.
resourceType	string	A hibában érintett erőforrás típusa.

ErrorResponse

Objektum

A hibaválasz.

Name	Típus	Description
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	A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

A hibaválasz részletei.

Name	Típus	Description
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

Objektum

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

Name	Típus	Description
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

Objektum

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

Name	Típus	Description
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

Objektum

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

Name	Típus	Description
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.