Git - List Workspace Relations

Tjeneste:: Core

API-versjon:: v1

Returnerer en liste over arbeidsområderelasjoner for det angitte arbeidsområdet.

Notat

Denne API-en er en del av en forhåndsversjon, og er bare tilgjengelig for evaluerings- og utviklingsformål. Det kan endres basert på tilbakemelding og anbefales ikke for produksjonsbruk.

Denne API-en støtter paginering.

Permissions

Innringeren må ha en visnings- eller høyere arbeidsområderolle.

Nødvendige delegerte omfang

Workspace.Read.All eller Workspace.ReadWrite.All

Microsoft Entra-støttede identiteter

Denne API-en støtter Microsoft -identiteter oppført i denne delen.

Identity	Støtte
User	Ja
tjenestekontohaver og administrerte identiteter	Ja

Grensesnitt

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

Med valgfrie parametere:

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/workspaceRelations?continuationToken={continuationToken}

URI-parametere

Navn	I	Obligatorisk	Type	Beskrivelse
workspaceId	path	True	string (uuid)	Arbeidsområde-ID-en.
continuationToken	query		string	Et token for å hente neste side med resultater.

Svar

Navn Type Beskrivelse

200 OK

Navn	Type	Beskrivelse
200 OK	WorkspaceRelations	Forespørselen er fullført.
429 Too Many Requests	ErrorResponse	Grensen for tjenestesats ble overskredet. Serveren returnerer en `Retry-After` topptekst som angir, i sekunder, hvor lenge klienten må vente før du sender flere forespørsler. Overskrifter Retry-After: integer
Other Status Codes	ErrorResponse	Vanlige feilkoder: InsufficientPrivileges – Innringeren har ikke tilstrekkelige arbeidsområdetillatelser. WorkspaceNotFound – Det angitte arbeidsområdet ble ikke funnet.

WorkspaceRelations

Forespørselen er fullført.

429 Too Many Requests

ErrorResponse

Grensen for tjenestesats ble overskredet. Serveren returnerer en Retry-After topptekst som angir, i sekunder, hvor lenge klienten må vente før du sender flere forespørsler.

Overskrifter

Retry-After: integer

Other Status Codes

ErrorResponse

Vanlige feilkoder:

InsufficientPrivileges – Innringeren har ikke tilstrekkelige arbeidsområdetillatelser.
WorkspaceNotFound – Det angitte arbeidsområdet ble ikke funnet.

Eksempler

List workspace relations example

Eksempelforespørsel

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/66666666-6666-6666-6666-666666666666/git/workspaceRelations

Eksempelsvar

Statuskode:: 200

{
  "value": [
    {
      "id": "ffffffff-ffff-ffff-ffff-ffffffffffff",
      "workspaceId": "66666666-6666-6666-6666-666666666666",
      "relatedWorkspaceId": "88888888-8888-8888-8888-888888888888",
      "relationType": "Base"
    },
    {
      "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "workspaceId": "66666666-6666-6666-6666-666666666666",
      "relatedWorkspaceId": "22222222-2222-2222-2222-222222222222",
      "relationType": "RelatedWorkspace"
    },
    {
      "id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
      "workspaceId": "66666666-6666-6666-6666-666666666666",
      "relatedWorkspaceId": "44444444-4444-4444-4444-444444444444",
      "relationType": "RelatedWorkspace"
    }
  ]
}

Definisjoner

Navn	Beskrivelse
ErrorRelatedResource	Objektet for feilrelaterte ressursdetaljer.
ErrorResponse	Feilsvaret.
ErrorResponseDetails	Feilsvardetaljene.
WorkspaceRelation	Et arbeidsområderelasjonsobjekt.
WorkspaceRelations	En liste over arbeidsområderelasjoner.
WorkspaceRelationType	Typen relatert arbeidsområde i relasjonen. Flere relaterte arbeidsområdetyper kan legges til over tid.

ErrorRelatedResource

Objekt

Objektet for feilrelaterte ressursdetaljer.

Navn	Type	Beskrivelse
resourceId	string	Ressurs-ID-en som er involvert i feilen.
resourceType	string	Typen ressurs som er involvert i feilen.

ErrorResponse

Objekt

Feilsvaret.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
isRetriable	boolean	Når sann, kan forespørselen prøves på nytt. `Retry-After` Bruk svarhodet til å fastslå forsinkelsen, hvis tilgjengelig.
message	string	En menneskelig lesbar representasjon av feilen.
moreDetails	ErrorResponseDetails[]	Liste over flere feildetaljer.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.
requestId	string (uuid)	ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Objekt

Feilsvardetaljene.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.

WorkspaceRelation

Objekt

Et arbeidsområderelasjonsobjekt.

Navn	Type	Beskrivelse
id	string (uuid)	Relasjons-IDen for arbeidsområdet.
relatedWorkspaceId	string (uuid)	Den relaterte arbeidsområde-ID-en.
relationType	WorkspaceRelationType	Typen relatert arbeidsområde i relasjonen.
workspaceId	string (uuid)	Arbeidsområde-ID-en.

WorkspaceRelations

Objekt

En liste over arbeidsområderelasjoner.

Navn	Type	Beskrivelse
continuationToken	string	Tokenet for den neste resultatsettgruppen. Hvis det ikke er flere poster, fjernes den fra svaret.
continuationUri	string	URI-en for neste satsvise resultatsett. Hvis det ikke er flere poster, fjernes den fra svaret.
value	WorkspaceRelation[]	En liste over arbeidsområderelasjoner.

WorkspaceRelationType

Opplisting

Typen relatert arbeidsområde i relasjonen. Flere relaterte arbeidsområdetyper kan legges til over tid.

Verdi	Beskrivelse
Base	Det relaterte arbeidsområdet er det grunnleggende (kilde) arbeidsområdet.
Branch	Det relaterte arbeidsområdet er et arbeidsområde for gren.
RelatedWorkspace	Det relaterte arbeidsområdet har en generell relasjon.