Git - Delete Workspace Relation

Tjänst:
Core
API-version:
v1

Tar bort en arbetsyterelation.

Note

Det här API:et är en del av en förhandsversion och tillhandahålls endast i utvärderings- och utvecklingssyfte. Den kan ändras baserat på feedback och rekommenderas inte för produktionsanvändning.

Tar bort en befintlig arbetsyterelation mellan två arbetsytor som identifieras av relations-ID:t. Det angivna arbetsyte-ID:t kan vara antingen en basarbetsyta eller en grenarbetsyta.

Permissions

Anroparen måste ha en administratörsarbetsyta på den angivna arbetsytan.

Obligatoriska delegerade omfång

Arbetsutrymme.LäsSkriv.Allt

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identity Support
User Ja
Tjänsthuvudnamn och hanterade identiteter Ja

Interface

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

URI-parametrar

Name I Obligatorisk Typ Description
workspaceId
 path True

string (uuid)

Arbetsyte-ID.
workspaceRelationId
 path True

string (uuid)

Arbetsytans relations-ID.

Svar

Name Typ Description
200 OK

Begäran har slutförts.
429 Too Many Requests

ErrorResponse

Gränsen för tjänstfrekvens överskreds. Servern returnerar ett Retry-After huvud som anger i sekunder hur länge klienten måste vänta innan ytterligare begäranden skickas.

Sidhuvuden

Retry-After: integer
Other Status Codes

ErrorResponse

Vanliga felkoder:

  • InsufficientPrivileges – anroparen har inte tillräcklig behörighet för arbetsytan.

  • WorkspaceNotFound – Den angivna arbetsytan hittades inte.

  • WorkspaceRelationNotFound – Det gick inte att hitta den angivna arbetsyterelationen.

  • WorkspaceNotInvolvedInRelation – arbetsytan är inte involverad i den angivna relationen.

  • WorkspaceRelationTypeNotBranch – relationen är inte en grenrelation och kan inte tas bort via den här slutpunkten.

Exempel

Delete a workspace relation example

Exempelbegäran

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

Exempelsvar

Statuskod:
200

Definitioner

Name Description
ErrorRelatedResource

Det felrelaterade resursinformationsobjektet.
ErrorResponse

Felsvaret.
ErrorResponseDetails

Detaljer om felsvaret.

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name Typ Description
resourceId

string

Resurs-ID:t som är inblandat i felet.
resourceType

string

Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
isRetriable

boolean

När det är sant kan begäran göras på nytt. Använd svarshuvudet Retry-After för att fastställa fördröjningen, om den är tillgänglig.
message

string

En mänsklig läsbar representation av felet.
moreDetails

ErrorResponseDetails[]

Lista över ytterligare felinformation.
relatedResource

ErrorRelatedResource

Detaljer om resursen relaterad till felet.
requestId

string (uuid)

ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Detaljer om felsvaret.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
relatedResource

ErrorRelatedResource

Detaljer om resursen relaterad till felet.