Git - Update From Git

Služba:

Core

Verzia rozhrania API:

v1

Aktualizuje pracovný priestor potvrdeniami doručenými do pripojenej vetvy.
Toto rozhranie API podporuje dlhotrvajúce operácie (LRO).

Na používanie tohto rozhrania API musia byť poverenia Git volajúceho nakonfigurované pomocou rozhrania API Aktualizovať moje poverenia Git . Na kontrolu konfigurácie poverení Git môžete použiť rozhranie API Načítať moje poverenia Git .

Aktualizácia má vplyv len na položky v pracovnom priestore, ktoré sa v týchto potvrdeniach zmenili. Ak sa zavolá za rozhraníM API pripojenia Pripojiť a inicializovať , vykoná sa úplná aktualizácia celého pracovného priestoru.

Povolenia

Volajúci musí mať rolu prispievateľa alebo vyššieho pracovného priestoru.

Povinné delegované rozsahy

Workspace.GitUpdate.All

Podporované identity v aplikácii Microsoft Entra

Toto rozhranie API podporuje identity Microsoft uvedené v tejto časti.

Identita	Podpora
Používateľ	Áno
Objekt služby a spravované identity	Podporované len v prípade, že všetky položky, ktoré sú súčasťou operácie, podporujú objekty služby

Rozhranie

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

Parametre URI

Name	V	Povinné	Typ	Description
workspaceId	path	True	string (uuid)	ID pracovného priestoru.

Text požiadavky

Name	Povinné	Typ	Description
remoteCommitHash	True	string	Vzdialená úplná hash hlásenia SHA.
conflictResolution		WorkspaceConflictResolution	Riešenie konfliktu, ktoré sa má použiť v aktualizácii z operácie Git. Ak sú položky v konflikte a nie je špecifikované riešenie konfliktov, operácia aktualizácie sa nespustí.
options		UpdateOptions	Možnosti, ktoré sa majú použiť v aktualizácii z operácie Git
workspaceHead		string	Celkový hash SHA, s ktorým je pracovný priestor synchronizovaný. Táto hodnota môže byť null iba po inicializácii pripojenia. V ostatných prípadoch systém overí, či je daná hodnota zarovnaná s hlavicou známou pre systém.

Odpovede

Name	Typ	Description
200 OK		Požiadavka sa úspešne dokončila.
202 Accepted		Žiadosť prijatá, aktualizácia z prebiehajúceho systému Git. Hlavičky Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Prekročil sa limit rýchlosti služby. Server vráti hlavičku Retry-After v sekundách, ako dlho musí klient počkať, kým odošle ďalšie požiadavky. Hlavičky Retry-After: integer
Other Status Codes	ErrorResponse	Bežné kódy chýb: WorkspaceNotConnectedToGit – pracovný priestor nie je pripojený k službe git. WorkspaceHasNoCapacityAssigned – žiadna kapacita priradená k pracovnému priestoru. WorkspaceHeadMismatch – vedúci v žiadosti sa nezhoduje s hlavou v systéme. WorkspacePreviousOperationInProgress – predchádzajúca operácia stále prebieha. MissingDependency – v operácii aktualizácie chýba závislosť. Operácia PotentialDuplicateDisplayNameAndType – operácia Update vytvorí duplicitný zobrazovaný názov a typ. DependencyDeletionFailed – operácia aktualizácie odstráni pevnú závislosť. InsufficientPrivileges – volajúci nemá dostatočné povolenia pracovného priestoru. PrincipalTypeNotSupported – Typ identity volajúceho nie je podporovaný.

Príklady

Update a workspace using data from a Git example

Vzorová požiadavka

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

Vzorová odpoveď

Kód stavu:

200

Kód stavu:

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ície

Name	Description
ConflictResolutionPolicy	Politika riešenia konfliktov. Postupne je možné pridať ďalšie politiky riešenia konfliktov.
ConflictResolutionType	Typ riešenia konfliktov. V priebehu času je možné pridať ďalšie typy riešenia konfliktov.
ErrorRelatedResource	Objekt s podrobnosťami o zdroji súvisiacej s chybou.
ErrorResponse	Odpoveď na chybu.
ErrorResponseDetails	Podrobnosti o chybovej odpovedi.
UpdateFromGitRequest	Obsahuje aktualizáciu z údajov požiadavky Git.
UpdateOptions	Obsahuje možnosti, ktoré sú povolené pre aktualizáciu zo systému Git.
WorkspaceConflictResolution	Základné údaje o riešení konfliktov.

ConflictResolutionPolicy

Enumerácia

Politika riešenia konfliktov. Postupne je možné pridať ďalšie politiky riešenia konfliktov.

Hodnota	Description
PreferRemote	Preferujte vzdialený obsah na strane Git.
PreferWorkspace	Preferujte obsah na strane pracovného priestoru.

ConflictResolutionType

Enumerácia

Typ riešenia konfliktov. V priebehu času je možné pridať ďalšie typy riešenia konfliktov.

Hodnota	Description
Workspace	Riešenie konfliktu predstavujúce úroveň pracovného priestoru.

ErrorRelatedResource

Object

Objekt s podrobnosťami o zdroji súvisiacej s chybou.

Name	Typ	Description
resourceId	string	ID prostriedku, ktoré je súčasťou chyby.
resourceType	string	Typ prostriedku, ktorý je zapojený do chyby.

ErrorResponse

Object

Odpoveď na chybu.

Name	Typ	Description
errorCode	string	Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
message	string	Zobrazenie chyby čitateľné ľuďmi.
moreDetails	ErrorResponseDetails[]	Zoznam ďalších podrobností o chybe.
relatedResource	ErrorRelatedResource	Podrobnosti o zdrojoch súvisiacich s chybou.
requestId	string (uuid)	ID požiadavky súvisiacej s chybou.

ErrorResponseDetails

Object

Podrobnosti o chybovej odpovedi.

Name	Typ	Description
errorCode	string	Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
message	string	Zobrazenie chyby čitateľné ľuďmi.
relatedResource	ErrorRelatedResource	Podrobnosti o zdrojoch súvisiacich s chybou.

UpdateFromGitRequest

Object

Obsahuje aktualizáciu z údajov požiadavky Git.

Name	Typ	Description
conflictResolution	WorkspaceConflictResolution	Riešenie konfliktu, ktoré sa má použiť v aktualizácii z operácie Git. Ak sú položky v konflikte a nie je špecifikované riešenie konfliktov, operácia aktualizácie sa nespustí.
options	UpdateOptions	Možnosti, ktoré sa majú použiť v aktualizácii z operácie Git
remoteCommitHash	string	Vzdialená úplná hash hlásenia SHA.
workspaceHead	string	Celkový hash SHA, s ktorým je pracovný priestor synchronizovaný. Táto hodnota môže byť null iba po inicializácii pripojenia. V ostatných prípadoch systém overí, či je daná hodnota zarovnaná s hlavicou známou pre systém.

UpdateOptions

Object

Obsahuje možnosti, ktoré sú povolené pre aktualizáciu zo systému Git.

Name	Typ	Description
allowOverrideItems	boolean	Súhlas používateľa s prepísanie prichádzajúcich položiek počas aktualizácie z procesu Git. Keď sú prichádzajúce položky prítomné a položky umožňujú prepísanie nie sú zadané alebo sú zadané ako false, operácia aktualizácie sa nespustí. Predvolená hodnota je nepravda.

WorkspaceConflictResolution

Object

Základné údaje o riešení konfliktov.

Name	Typ	Description
conflictResolutionPolicy	ConflictResolutionPolicy	Politika riešenia konfliktov. Postupne je možné pridať ďalšie politiky riešenia konfliktov.
conflictResolutionType	ConflictResolutionType	Typ riešenia konfliktov. V priebehu času je možné pridať ďalšie typy riešenia konfliktov.