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ö

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.