Git - Delete Workspace Relation

Usługa:
Core
Wersja interfejsu API:
v1

Usuwa relację obszaru roboczego.

Note

Ten interfejs API jest częścią wersji zapoznawczej i jest dostarczany tylko do celów ewaluacyjnych i programistycznych. Może ona ulec zmianie na podstawie opinii i nie jest zalecana do użytku produkcyjnego.

Usuwa istniejącą relację obszaru roboczego między dwoma obszarami roboczymi zidentyfikowaną przez identyfikator relacji. Podany identyfikator obszaru roboczego może być podstawowym obszarem roboczym lub obszarem roboczym gałęzi.

Permissions

Obiekt wywołujący musi mieć rolę obszaru roboczego administratora w określonym obszarze roboczym.

Wymagane zakresy delegowane

Przestrzeń robocza.OdczytZapis.Wszystko

Tożsamości obsługiwane przez Microsoft Entra

To API obsługuje tożsamości Microsoft wymienione w tej sekcji.

Identity Support
User Yes
Główne usługi i Tożsamości zarządzane Yes

Interfejs

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
workspaceId
 path True

string (uuid)

Identyfikator przestrzeni roboczej.
workspaceRelationId
 path True

string (uuid)

Identyfikator relacji obszaru roboczego.

Odpowiedzi

Nazwa Typ Opis
200 OK

Żądanie zostało ukończone pomyślnie.
429 Too Many Requests

ErrorResponse

Przekroczono limit szybkości usługi. Serwer zwraca nagłówek wskazujący Retry-After w sekundach, jak długo klient musi czekać przed wysłaniem dodatkowych żądań.

Nagłówki

Retry-After: integer
Other Status Codes

ErrorResponse

Typowe kody błędów:

  • InsufficientPrivileges — obiekt wywołujący nie ma wystarczających uprawnień obszaru roboczego.

  • WorkspaceNotFound — nie można odnaleźć określonego obszaru roboczego.

  • WorkspaceRelationNotFound — nie można odnaleźć określonej relacji obszaru roboczego.

  • WorkspaceNotInvolvedInRelation — obszar roboczy nie jest zaangażowany w określoną relację.

  • WorkspaceRelationTypeNotBranch — relacja nie jest relacją gałęzi i nie można jej usunąć za pośrednictwem tego punktu końcowego.

Przykłady

Delete a workspace relation example

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
200

Definicje

Nazwa Opis
ErrorParameter

Parametr ustrukturyzowany zapewniający dodatkowy kontekst czytelny dla maszyny o błędzie.
ErrorRelatedResource

Obiekt szczegółowych informacji o zasobie związanym z błędem.
ErrorResponse

Odpowiedź na błąd.
ErrorResponseDetails

Szczegóły odpowiedzi na błąd.

ErrorParameter

Objekt

Parametr ustrukturyzowany zapewniający dodatkowy kontekst czytelny dla maszyny o błędzie.

Nazwa Typ Opis
message

string

Czytelny dla człowieka opis znaczenia parametru.
name

string

Identyfikator parametru.
value

string

Wartość parametru.

ErrorRelatedResource

Objekt

Obiekt szczegółowych informacji o zasobie związanym z błędem.

Nazwa Typ Opis
resourceId

string

Identyfikator zasobu powiązany z błędem.
resourceType

string

Typ zasobu powiązanego z błędem.

ErrorResponse

Objekt

Odpowiedź na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
isRetriable

boolean

Jeśli to prawda, żądanie można ponowić. Użyj nagłówka Retry-After odpowiedzi, aby określić opóźnienie, jeśli jest dostępne.
message

string

Czytelna reprezentacja błędu przez człowieka.
moreDetails

ErrorResponseDetails[]

Lista dodatkowych szczegółów błędu.
parameters

ErrorParameter[]

Parametry ustrukturyzowane zapewniające dodatkowy kontekst czytelny dla maszyny o błędzie.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.
requestId

string (uuid)

Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Objekt

Szczegóły odpowiedzi na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
parameters

ErrorParameter[]

Parametry ustrukturyzowane zapewniające dodatkowy kontekst czytelny dla maszyny o błędzie.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.