Git - Delete Workspace Relation

Tjeneste:
Core
API-versjon:
v1

Sletter en arbeidsområderelasjon.

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.

Sletter en eksisterende arbeidsområderelasjon mellom to arbeidsområder, identifisert av relasjons-ID-en. Den angitte arbeidsområde-ID-en kan enten være et grunnleggende arbeidsområde eller et grenarbeidsområde.

Permissions

Innringeren må ha en arbeidsområderolle for administratorer på det angitte arbeidsområdet.

Nødvendige delegerte omfang

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

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

URI-parametere

Navn I Obligatorisk Type Beskrivelse
workspaceId
 path True

string (uuid)

Arbeidsområde-ID-en.
workspaceRelationId
 path True

string (uuid)

Relasjons-IDen for arbeidsområdet.

Svar

Navn Type Beskrivelse
200 OK

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.

  • WorkspaceRelationNotFound – Finner ikke den angitte arbeidsområderelasjonen.

  • WorkspaceNotInvolvedInRelation – Arbeidsområdet er ikke involvert i den angitte relasjonen.

  • WorkspaceRelationTypeNotBranch – relasjonen er ikke en grenrelasjon og kan ikke slettes gjennom dette endepunktet.

Eksempler

Delete a workspace relation example

Eksempelforespørsel

DELETE https://api.fabric.microsoft.com/v1/workspaces/55555555-5555-5555-5555-555555555555/git/workspaceRelations/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa

Eksempelsvar

Statuskode:
200

Definisjoner

Navn Beskrivelse
ErrorRelatedResource

Objektet for feilrelaterte ressursdetaljer.
ErrorResponse

Feilsvaret.
ErrorResponseDetails

Feilsvardetaljene.

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.