Git - Initialize Connection

Palvelu:

Core

Ohjelmointirajapinnan versio:

v1

Alusta yhteys työtilaan, joka on yhdistetty Gitiin.
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.

Tämä ohjelmointirajapinta tulee kutsua connect-ohjelmointirajapinnan onnistuneen kutsun jälkeen. Viimeistele työtilan täydellinen synkronointi käyttämällä Pakollinen toiminto - toimintoa asianmukaisen synkronointitoiminnon kutsumiseen (joko Vahvista Gitiin tai Päivitä Gitistä).

Permissions

Soittajalla on oltava järjestelmänvalvojan työtilan rooli.

Vaaditut delegoidut vaikutusalueet

Workspace.ReadWrite.All

Microsoft Entran tukemat käyttäjätiedot

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

Identity	Support
User	Yes
palvelun päänimen ja Hallittujen käyttäjätietojen	Yes

Interface

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

URI-parametrit

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

Pyynnön leipäteksti

Nimi	Tyyppi	Description
initializationStrategy	InitializationStrategy	Alustusprosessin edellyttämä strategia, kun sisältöä on sekä etäpuolella että työtilan puolella. Lisää strategioita voidaan lisätä ajan mittaan.

Vastaukset

Nimi	Tyyppi	Description
200 OK	InitializeGitConnectionResponse	Pyynnön valmistuttua.
202 Accepted		Pyyntö hyväksytty, alusta keskeneräinen yhteys. 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. MissingInitializationPolicy – Alustuskäytäntö puuttuu. InsufficientPrivileges – Soittajalla ei ole riittäviä käyttöoikeuksia työtilaan. PrincipalTypeNotSupported – Soittajan käyttäjätietotyyppiä ei tueta.

Esimerkit

Initialize the connection of a workspace connected to a Git example

Mallipyyntö

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/1565e6a3-c020-4c0c-dda7-92bafe99eec5/git/initializeConnection

Mallivastaus

Tilakoodi:

200

{
  "requiredAction": "UpdateFromGit",
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705"
}

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
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
InitializationStrategy	Alustusprosessin edellyttämä strategia, kun sisältöä on sekä etäpuolella että työtilan puolella. Lisää strategioita voidaan lisätä ajan mittaan.
InitializeGitConnectionRequest	Sisältää Alusta Git-yhteyden pyyntötiedot.
InitializeGitConnectionResponse	Sisältää Alusta Git-yhteyden vastaustiedot.
RequiredAction	Pakollinen toiminto alustusprosessin päätyttyä. Lisää toimintoja voidaan lisätä ajan mittaan.

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.

InitializationStrategy

Luettelointi

Alustusprosessin edellyttämä strategia, kun sisältöä on sekä etäpuolella että työtilan puolella. Lisää strategioita voidaan lisätä ajan mittaan.

Arvo	Description
None	Mitään strategiaa ei ole määritetty.
PreferRemote	Suosi etänä ollutTaGit-puolen sisältöä.
PreferWorkspace	Käytä mieluummin työtilan sivusisältöä.

InitializeGitConnectionRequest

Object

Sisältää Alusta Git-yhteyden pyyntötiedot.

Nimi	Tyyppi	Description
initializationStrategy	InitializationStrategy	Alustusprosessin edellyttämä strategia, kun sisältöä on sekä etäpuolella että työtilan puolella. Lisää strategioita voidaan lisätä ajan mittaan.

InitializeGitConnectionResponse

Object

Sisältää Alusta Git-yhteyden vastaustiedot.

Nimi	Tyyppi	Description
remoteCommitHash	string	Täysi SHA-etähallintatoiminnon hajautus
requiredAction	RequiredAction	Pakollinen toiminto alustusprosessin päätyttyä. Lisää toimintoja voidaan lisätä ajan mittaan.
workspaceHead	string	Koko SHA-hajautustoiminto, johon työtila on synkronoitu.

RequiredAction

Luettelointi

Pakollinen toiminto alustusprosessin päätyttyä. Lisää toimintoja voidaan lisätä ajan mittaan.

Arvo	Description
None	Lisätoimia ei tarvita.
UpdateFromGit	Päivitys Gitistä on pakollinen.
CommitToGit	Lähetä Gitiin on pakollinen.