Git - Update From Git

Palvelu:

Core

Ohjelmointirajapinnan versio:

v1

Päivittää työtilan vahvistuksilla, jotka on siirretty yhdistettyyn haaraan.
Tämä ohjelmointirajapinta tukee pitkäkestoisia toimintoja.

Jotta voit käyttää tätä ohjelmointirajapintaa, soittajan Git-tunnistetiedot on määritettävä Käyttämällä Päivitä Omat Git-tunnistetiedot -ohjelmointirajapintaa. Voit tarkistaa Git-tunnistetietojen määritykset Hanki Omat Git-tunnistetiedot -ohjelmointirajapinnan avulla.

Päivitys vaikuttaa vain työtilan kohteisiin, joita on muutettu näissä vahvistuksissa. Jos se kutsutaan Yhdistä - ja Alusta yhteys - ohjelmointirajapintojen jälkeen, se suorittaa koko työtilan täyden päivityksen.

Käyttöoikeudet

Kutsujalla on oltava osallistujan tai suurempi työtilarooli.

Vaaditut delegoidut vaikutusalueet

Workspace.GitUpdate.All

Microsoft Entran tukemat käyttäjätiedot

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Identiteetti	Tuki
Käyttäjä	Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen	Tuetaan vain, kun kaikki toimintoon liittyvät kohteet tukevat palvelun päänimiä

Rajapinta

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

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Description
workspaceId	path	True	string (uuid)	Työtilan tunnus.

Pyynnön leipäteksti

Nimi	Pakollinen	Tyyppi	Description
remoteCommitHash	True	string	Täysi SHA-etähallintatoiminnon hajautus
conflictResolution		WorkspaceConflictResolution	Ristiriidan ratkaisu, jota käytetään Git-toiminnon päivityksessä. Jos kohteet ovat ristiriidassa eikä ristiriitojen ratkaisua ole määritetty, päivitystoimintoa ei aloiteta.
options		UpdateOptions	Git-toiminnon päivityksessä käytettävät asetukset
workspaceHead		string	Koko SHA-hajautustoiminto, johon työtila on synkronoitu. Tämä arvo voi olla tyhjäarvo vasta Alusta yhteys -alustamisen jälkeen. Muissa tapauksissa järjestelmä vahvistaa, että annettu arvo on tasattu järjestelmän tuntemalle johtajalle.

Vastaukset

Nimi	Tyyppi	Description
200 OK		Pyynnön valmistuttua.
202 Accepted		Pyyntö hyväksytty, päivitys gitiltä on meneillään. Otsikot Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Yleiset virhekoodit: WorkspaceNotConnectedToGit – Työtila ei ole yhteydessä Gitiin. WorkspaceHasNoCapacityAssigned – Työtilalle ei ole määritetty kapasiteettia. WorkspaceHeadMismatch: pyynnön johtaja ei vastaa järjestelmän päätä. WorkspacePreviousOperationInProgress – Edellinen toiminto on vielä kesken. MissingDependency – Riippuvuus puuttuu päivitystoiminnosta. PotentialDuplicateDisplayNameAndType – Päivitystoiminto luo näyttönimen ja tyypin kaksoiskappaleen. DependencyDeletionFailed – Päivitystoiminto poistaa kovan riippuvuuden. InsufficientPrivileges – Soittajalla ei ole riittäviä työtilan käyttöoikeuksia. PrincipalTypeNotSupported – Soittajan käyttäjätietotyyppiä ei tueta.

Esimerkit

Update a workspace using data from a Git example

Mallipyyntö

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

Mallivastaus

Tilakoodi:

200

Tilakoodi:

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

Määritelmät

Nimi	Description
ConflictResolutionPolicy	Ristiriitaisten ratkaisukäytäntö. Lisää ristiriitojen ratkaisukäytäntöjä voidaan lisätä ajan mittaan.
ConflictResolutionType	Ristiriidan ratkaisutyyppi. Muita ristiriitojen ratkaisutyyppejä voidaan lisätä ajan mittaan.
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
UpdateFromGitRequest	Sisältää Git-pyyntötietojen päivityksen.
UpdateOptions	Sisältää asetukset, jotka ovat käytössä Git-päivityksessä.
WorkspaceConflictResolution	Peruskonfliktin ratkaisutiedot.

ConflictResolutionPolicy

Luettelointi

Ristiriitaisten ratkaisukäytäntö. Lisää ristiriitojen ratkaisukäytäntöjä voidaan lisätä ajan mittaan.

Arvo	Description
PreferRemote	Suosi etänä ollutTaGit-puolen sisältöä.
PreferWorkspace	Käytä mieluummin työtilan sivusisältöä.

ConflictResolutionType

Luettelointi

Ristiriidan ratkaisutyyppi. Muita ristiriitojen ratkaisutyyppejä voidaan lisätä ajan mittaan.

Arvo	Description
Workspace	Työtilatasoa edustava ristiriitainen ratkaisu.

ErrorRelatedResource

Object

Virheeseen liittyvä resurssitieto-objekti.

Nimi	Tyyppi	Description
resourceId	string	Virheestä liittyvä resurssitunnus.
resourceType	string	Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Object

Virhevastaus.

Nimi	Tyyppi	Description
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
moreDetails	ErrorResponseDetails[]	Luettelo virheiden lisätiedoista.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.
requestId	string	Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Object

Virheen vastauksen tiedot.

Nimi	Tyyppi	Description
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.

UpdateFromGitRequest

Object

Sisältää Git-pyyntötietojen päivityksen.

Nimi	Tyyppi	Description
conflictResolution	WorkspaceConflictResolution	Ristiriidan ratkaisu, jota käytetään Git-toiminnon päivityksessä. Jos kohteet ovat ristiriidassa eikä ristiriitojen ratkaisua ole määritetty, päivitystoimintoa ei aloiteta.
options	UpdateOptions	Git-toiminnon päivityksessä käytettävät asetukset
remoteCommitHash	string	Täysi SHA-etähallintatoiminnon hajautus
workspaceHead	string	Koko SHA-hajautustoiminto, johon työtila on synkronoitu. Tämä arvo voi olla tyhjäarvo vasta Alusta yhteys -alustamisen jälkeen. Muissa tapauksissa järjestelmä vahvistaa, että annettu arvo on tasattu järjestelmän tuntemalle johtajalle.

UpdateOptions

Object

Sisältää asetukset, jotka ovat käytössä Git-päivityksessä.

Nimi	Tyyppi	Description
allowOverrideItems	boolean	Käyttäjä suostuu ohittamaan saapuvat kohteet Git-prosessin päivityksen aikana. Kun saapuvia kohteita on olemassa ja salli ohituskohteita ei määritetä tai ne annetaan epätosi-muodossa, päivitystoimintoa ei aloiteta. Oletusarvo on false.

WorkspaceConflictResolution

Object

Peruskonfliktin ratkaisutiedot.

Nimi	Tyyppi	Description
conflictResolutionPolicy	ConflictResolutionPolicy	Ristiriitaisten ratkaisukäytäntö. Lisää ristiriitojen ratkaisukäytäntöjä voidaan lisätä ajan mittaan.
conflictResolutionType	ConflictResolutionType	Ristiriidan ratkaisutyyppi. Muita ristiriitojen ratkaisutyyppejä voidaan lisätä ajan mittaan.