Git - Delete Workspace Relation

Servicio:
Core
Versión de la API:
v1

Elimina una relación de área de trabajo.

Note

Esta API forma parte de una versión preliminar y solo se proporciona con fines de evaluación y desarrollo. Puede cambiar en función de los comentarios y no se recomienda para su uso en producción.

Elimina una relación de área de trabajo existente entre dos áreas de trabajo, identificadas por el identificador de relación. El identificador de área de trabajo proporcionado puede ser un área de trabajo base o un área de trabajo de rama.

Permisos

El autor de la llamada debe tener un rol de área de trabajo de administrador en el área de trabajo especificada.

Ámbitos delegados necesarios

Workspace.ReadWrite.All

Identidades admitidas de Microsoft Entra

Esta API admite las identidades de Microsoft enumeradas en esta sección.

Identity Apoyo
Usuario Sí
Entidad de servicio e Identidades administradas Sí

Interface

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
workspaceId
 path True

string (uuid)

El identificador del área de trabajo.
workspaceRelationId
 path True

string (uuid)

Identificador de relación del área de trabajo.

Respuestas

Nombre Tipo Description
200 OK

Solicitud completada correctamente.
429 Too Many Requests

ErrorResponse

Se superó el límite de frecuencia de servicio. El servidor devuelve un Retry-After encabezado que indica, en segundos, cuánto tiempo debe esperar el cliente antes de enviar solicitudes adicionales.

Encabezados

Retry-After: integer
Other Status Codes

ErrorResponse

Códigos de error comunes:

  • InsufficientPrivileges: el autor de la llamada no tiene suficientes permisos de área de trabajo.

  • WorkspaceNotFound: no se encontró el área de trabajo especificada.

  • WorkspaceRelationNotFound: no se encontró la relación del área de trabajo especificada.

  • WorkspaceNotInvolvedInRelation: el área de trabajo no participa en la relación especificada.

  • WorkspaceRelationTypeNotBranch: la relación no es una relación de rama y no se puede eliminar a través de este punto de conexión.

Ejemplos

Delete a workspace relation example

Solicitud de ejemplo

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

Respuesta de muestra

status code:
200

Definiciones

Nombre Description
ErrorRelatedResource

Objeto de detalles del recurso relacionado con el error.
ErrorResponse

Respuesta de error.
ErrorResponseDetails

Detalles de la respuesta de error.

ErrorRelatedResource

Objeto

Objeto de detalles del recurso relacionado con el error.

Nombre Tipo Description
resourceId

string

ID de recurso que está involucrado en el error.
resourceType

string

Tipo del recurso implicado en el error.

ErrorResponse

Objeto

Respuesta de error.

Nombre Tipo Description
errorCode

string

Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
isRetriable

boolean

Cuando es true, se puede reintentar la solicitud. Use el Retry-After encabezado de respuesta para determinar el retraso, si está disponible.
message

string

Representación comprensible para humanos del error.
moreDetails

ErrorResponseDetails[]

Lista de detalles de error adicionales.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.
requestId

string (uuid)

Identificador de la solicitud asociada al error.

ErrorResponseDetails

Objeto

Detalles de la respuesta de error.

Nombre Tipo Description
errorCode

string

Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message

string

Representación comprensible para humanos del error.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.