Git - Delete Workspace Relation

Servizio:
Core
Versione API:
v1

Elimina una relazione tra aree di lavoro.

Note

Questa API fa parte di una versione di anteprima e viene fornita solo a scopo di valutazione e sviluppo. Può cambiare in base al feedback e non è consigliato per l'uso in produzione.

Elimina una relazione dell'area di lavoro esistente tra due aree di lavoro, identificate dall'ID relazione. L'ID dell'area di lavoro specificato può essere un'area di lavoro di base o un'area di lavoro del ramo.

Permissions

Il chiamante deve avere un ruolo di area di lavoro amministratore nell'area di lavoro specificata.

Ambiti delegati obbligatori

SpazioDiLavoro.LetturaScrittura.Tutti

Identità supportate da Microsoft Entra

Questa API supporta le identità di Microsoft elencate in questa sezione.

Identity Support
User Sì
Principale del servizio e Identità gestite Sì

Interfaccia

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
workspaceId
 path True

string (uuid)

L’ID dell’area di lavoro.
workspaceRelationId
 path True

string (uuid)

ID relazione dell'area di lavoro.

Risposte

Nome Tipo Descrizione
200 OK

Richiesta completata correttamente.
429 Too Many Requests

ErrorResponse

È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione Retry-After che indica, in secondi, per quanto tempo il client deve attendere prima di inviare richieste aggiuntive.

Intestazioni

Retry-After: integer
Other Status Codes

ErrorResponse

Codici di errore comuni:

  • InsufficientPrivileges: il chiamante non dispone di autorizzazioni sufficienti per l'area di lavoro.

  • WorkspaceNotFound: l'area di lavoro specificata non è stata trovata.

  • WorkspaceRelationNotFound: la relazione dell'area di lavoro specificata non è stata trovata.

  • WorkspaceNotInvolvedInRelation: l'area di lavoro non è coinvolta nella relazione specificata.

  • WorkspaceRelationTypeNotBranch: la relazione non è una relazione di ramo e non può essere eliminata tramite questo endpoint.

Esempio

Delete a workspace relation example

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
200

Definizioni

Nome Descrizione
ErrorRelatedResource

Oggetto dei dettagli della risorsa relativo all'errore.
ErrorResponse

Risposta di errore.
ErrorResponseDetails

Dettagli della risposta di errore.

ErrorRelatedResource

Oggetto

Oggetto dei dettagli della risorsa relativo all'errore.

Nome Tipo Descrizione
resourceId

string

ID risorsa coinvolto nell'errore.
resourceType

string

Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Oggetto

Risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
isRetriable

boolean

Se true, la richiesta può essere ritentata. Usare l'intestazione della Retry-After risposta per determinare il ritardo, se disponibile.
message

string

Rappresentazione leggibile dell'errore.
moreDetails

ErrorResponseDetails[]

Elenco di dettagli aggiuntivi sull'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.
requestId

string (uuid)

ID della richiesta associata all'errore.

ErrorResponseDetails

Oggetto

Dettagli della risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message

string

Rappresentazione leggibile dell'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.