Git - Delete Workspace Relation

Služba:

Core

Verze rozhraní API:

v1

Odstraní relaci pracovního prostoru.

Note

Toto rozhraní API je součástí verze Preview a poskytuje se pouze pro účely vyhodnocení a vývoje. Může se změnit na základě zpětné vazby a nedoporučuje se pro produkční použití.

Odstraní existující vztah pracovního prostoru mezi dvěma pracovními prostory identifikovaným ID relace. Zadané ID pracovního prostoru může být buď základní pracovní prostor, nebo pracovní prostor větve.

Povolení

Volající musí mít v zadaném pracovním prostoru roli pracovního prostoru správce .

Požadované delegované rozsahy

Workspace.ReadWrite.All

Podporované identity v Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identity	Podpora
User	Ano
Hlavní služba a Spravované identity	Ano

Rozhraní

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

Parametry identifikátoru URI

Název	V	Vyžadováno	Typ	Description
workspaceId	path	True	string (uuid)	Identifikátor pracovního prostoru.
workspaceRelationId	path	True	string (uuid)	ID relace pracovního prostoru.

Odpovědi

Název	Typ	Description
200 OK		Žádost byla úspěšně dokončena.
429 Too Many Requests	ErrorResponse	Byl překročen limit přenosové rychlosti služby. Server vrátí hlavičku Retry-After udávající, kolik sekund musí klient čekat před odesláním dalších požadavků. Hlavičky Retry-After: integer
Other Status Codes	ErrorResponse	Běžné kódy chyb: InsufficientPrivileges – Volající nemá dostatečná oprávnění pracovního prostoru. WorkspaceNotFound – Zadaný pracovní prostor nebyl nalezen. WorkspaceRelationNotFound – Zadaný vztah pracovního prostoru nebyl nalezen. WorkspaceNotInvolvedInRelation – pracovní prostor není součástí zadané relace. WorkspaceRelationTypeNotBranch – Relace není relace větve a nelze ji odstranit prostřednictvím tohoto koncového bodu.

Příklady

Delete a workspace relation example

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:

200

Definice

Název	Description
ErrorParameter	Strukturovaný parametr poskytující další strojově čitelný kontext chyby.
ErrorRelatedResource	Chyba související s objektem podrobností o prostředku.
ErrorResponse	Odpověď na chybu.
ErrorResponseDetails	Podrobnosti o odpovědi na chybu.

ErrorParameter

Objekt

Strukturovaný parametr poskytující další strojově čitelný kontext chyby.

Název	Typ	Description
message	string	Popis významu parametru čitelný člověkem.
name	string	Identifikátor parametru.
value	string	Hodnota parametru.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Název	Typ	Description
resourceId	string	ID prostředku, které je součástí chyby.
resourceType	string	Typ prostředku, který se podílí na chybě.

ErrorResponse

Objekt

Odpověď na chybu.

Název	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
isRetriable	boolean	Pokud je hodnota true, je možné požadavek opakovat. Pomocí hlavičky Retry-After odpovědi určete zpoždění, pokud je k dispozici.
message	string	Lidské čitelné vyjádření chyby.
moreDetails	ErrorResponseDetails[]	Seznam dalších podrobností o chybě
parameters	ErrorParameter[]	Strukturované parametry poskytují další strojově čitelný kontext chyby.
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou
requestId	string (uuid)	ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Název	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
parameters	ErrorParameter[]	Strukturované parametry poskytují další strojově čitelný kontext chyby.
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou