Git - Create Workspace Relation

Palvelu:

Core

Ohjelmointirajapinnan versio:

v1

Luo työtilan suhteen määritetyn työtilan ja liittyvän työtilan välille.

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.

Luo haarasuhteen haaratyötilan ja sen perustyötilan välille.

Permissions

Soittajalla on oltava järjestelmänvalvojan rooli haaran työtilassa sekä osallistuja tai suurempi rooli perustyötilassa.

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.

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

Liittymä

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

URI-parametrit

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

Pyynnön leipäteksti

Nimi	Pakollinen	Tyyppi	Kuvaus
relatedWorkspaceId	True	string (uuid)	Liittyvä työtilan tunnus.
relationType	True	WorkspaceRelationType	Suhteen luotavan liittyvän työtilan tyyppi. Vain Base ja Branch ovat kelvollisia luontia varten.

Vastaukset

Nimi	Tyyppi	Kuvaus
201 Created	WorkspaceRelation	Luonti onnistui.
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: InsufficientPrivileges – Soittajalla ei ole riittäviä työtilan käyttöoikeuksia. WorkspaceNotFound – Määritettyä työtilaa ei löytynyt. WorkspaceRelationAlreadyExists – Määritettyjen työtilojen välinen suhde on jo olemassa. WorkspaceRelationBidirectionalExists – Näiden työtilojen välinen suhde on jo päinvastainen. WorkspaceRelationInvalidArgument – Työtilan relaatiotoiminnolle annetut virheelliset argumentit. WorkspaceRelationInvalidType – Virheellinen työtilan relaatiotyyppi. WorkspaceRelationSelfReferencing – Työtila ei voi liittyä itseensä. WorkspaceRelationBaseIsBranch – Perustyötila on jo toisen työtilan haara. WorkspaceRelationTargetHasBranches – Kohdetyötilassa on jo haaratyötiloja. WorkspaceRelationDifferentBase – Kohdetyötilassa on eri perustyötila. WorkspaceRelationRootDirectoryMismatch – Työtiloja ei ole yhdistetty samaan Git-säilön pääkansioon.

Esimerkit

Create a workspace relation example

Mallipyyntö

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/55555555-5555-5555-5555-555555555555/git/workspaceRelations

{
  "relatedWorkspaceId": "33333333-3333-3333-3333-333333333333",
  "relationType": "Base"
}

Mallivastaus

Tilakoodi:

201

{
  "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
  "workspaceId": "55555555-5555-5555-5555-555555555555",
  "relatedWorkspaceId": "33333333-3333-3333-3333-333333333333",
  "relationType": "Base"
}

Määritelmät

Nimi	Kuvaus
CreateWorkspaceRelationRequest	Pyynnön tiedot työtilasuhteen luomista varten.
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
WorkspaceRelation	Työtilan relaatio-objekti.
WorkspaceRelationType	Liittyvän työtilan tyyppi suhteessa. Muita aiheeseen liittyviä työtilatyyppejä voidaan lisätä ajan kuluessa.

CreateWorkspaceRelationRequest

Kohde

Pyynnön tiedot työtilasuhteen luomista varten.

Nimi	Tyyppi	Kuvaus
relatedWorkspaceId	string (uuid)	Liittyvä työtilan tunnus.
relationType	WorkspaceRelationType	Suhteen luotavan liittyvän työtilan tyyppi. Vain Base ja Branch ovat kelvollisia luontia varten.

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.
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ä.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.

WorkspaceRelation

Kohde

Työtilan relaatio-objekti.

Nimi	Tyyppi	Kuvaus
id	string (uuid)	Työtilan suhteen tunnus.
relatedWorkspaceId	string (uuid)	Liittyvä työtilan tunnus.
relationType	WorkspaceRelationType	Liittyvän työtilan tyyppi suhteessa.
workspaceId	string (uuid)	Työtilan tunnus.

WorkspaceRelationType

Luettelointi

Liittyvän työtilan tyyppi suhteessa. Muita aiheeseen liittyviä työtilatyyppejä voidaan lisätä ajan kuluessa.

Arvo	Kuvaus
Base	Liittyvä työtila on perustyötila (lähde).
Branch	Liittyvä työtila on haaratyötila.
RelatedWorkspace	Liittyvällä työtilalla on yleinen suhde.