Git - Get Connection Settings

Palvelu:: Core

Ohjelmointirajapinnan versio:: v1

Hakee Gitille yhdistetyn työtilan yhteysasetukset.

Note

Tämä ohjelmointirajapinta on osa esikatseluversiota, ja se on saatavilla vain arviointi- ja kehitystarkoituksiin. Muutos saattaa perustua palautteeseen, eikä sitä suositella tuotantokäyttöön. Lisätietoja.

Palauttaa Gitiin yhdistetyn työtilan yhteysasetukset.

Oikeudet

Kutsujalla on oltava osallistujan tai suurempi työtilarooli.

Vaaditut delegoidut vaikutusalueet

Workspace.Read.All tai Workspace.ReadWrite.All

tuettujen käyttäjätietojen Microsoft Entra

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft identities.

Identity	Tuki
Käyttäjä	Yes
palvelun päänimen ja Hallittujen käyttäjätietojen	Yes

Käyttöliittymä

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/connectionSettings

URI-parametrit

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

Vastaukset

Nimi Tyyppi Kuvaus

200 OK

Nimi	Tyyppi	Kuvaus
200 OK	GitConnectionSettings	Pyynnön valmistuttua.
429 Too Many Requests	ErrorResponse	Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka `Retry-After` ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään. Otsikot Retry-After: integer
Other Status Codes	ErrorResponse	Yleiset virhekoodit: UnknownError – Ilmeni virhe. InsufficientPrivileges – Soittajalla ei ole riittäviä työtilan käyttöoikeuksia. WorkspaceNotConnectedToGit – Työtila ei ole yhteydessä Gitiin.

GitConnectionSettings

Pyynnön valmistuttua.

429 Too Many Requests

ErrorResponse

Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka Retry-After ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään.

Otsikot

Retry-After: integer

Other Status Codes

ErrorResponse

Yleiset virhekoodit:

UnknownError – Ilmeni virhe.
InsufficientPrivileges – Soittajalla ei ole riittäviä työtilan käyttöoikeuksia.
WorkspaceNotConnectedToGit – Työtila ei ole yhteydessä Gitiin.

Esimerkit

Get connection settings example

Mallipyyntö

HTTP

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

Mallivastaus

Tilakoodi:: 200

{
  "additionalRolesAuthorizedToChangeBranch": "None"
}

Määritelmät

Nimi	Kuvaus
ErrorParameter	Jäsennetty parametri, joka antaa koneluettavaa lisäkontekstia virheestä.
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
GitAdditionalBranchChangingRoles	Järjestelmänvalvojan ulkopuoliset muut työtilaroolit, jotka voivat muuttaa yhdistettyä Git-haaraa. Lisäarvoja voidaan lisätä ajan mittaan.
GitConnectionSettings	Sisältää Git-yhteysasetukset.

ErrorParameter

Kohde

Jäsennetty parametri, joka antaa koneluettavaa lisäkontekstia virheestä.

Nimi	Tyyppi	Kuvaus
message	string	Ihmisen luettavissa oleva kuvaus parametrin merkityksestä.
name	string	Parametritunniste.
value	string	Parametriarvo.

ErrorRelatedResource

Kohde

Virheeseen liittyvä resurssitieto-objekti.

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

ErrorResponse

Kohde

Virhevastaus.

Nimi	Tyyppi	Kuvaus
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
isRetriable	boolean	Kun arvo on tosi, pyyntöä voidaan yrittää uudelleen. Määritä viive vastausotsikon `Retry-After` avulla, jos se on käytettävissä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
moreDetails	ErrorResponseDetails[]	Luettelo virheiden lisätiedoista.
parameters	ErrorParameter[]	Jäsennettyjä parametreja, jotka antavat koneluettavaa lisäkontekstia virheestä.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.
requestId	string (uuid)	Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Kohde

Virheen vastauksen tiedot.

Nimi	Tyyppi	Kuvaus
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ä.
parameters	ErrorParameter[]	Jäsennettyjä parametreja, jotka antavat koneluettavaa lisäkontekstia virheestä.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.

GitAdditionalBranchChangingRoles

Luettelointi

Järjestelmänvalvojan ulkopuoliset muut työtilaroolit, jotka voivat muuttaa yhdistettyä Git-haaraa. Lisäarvoja voidaan lisätä ajan mittaan.

Arvo	Kuvaus
None	Muut järjestelmänvalvojan roolit eivät voi vaihtaa haaraa. Tämä on oletusarvo.
MemberAndContributor	Jäsenet ja osallistujat voivat myös vaihtaa haaroja järjestelmänvalvojien lisäksi.

GitConnectionSettings

Kohde

Sisältää Git-yhteysasetukset.

Nimi	Tyyppi	Kuvaus
additionalRolesAuthorizedToChangeBranch	GitAdditionalBranchChangingRoles	Järjestelmänvalvojan ulkopuoliset muut työtilaroolit, jotka voivat muuttaa yhdistettyä Git-haaraa.