Compartir a través de

External Data Shares Provider - Delete External Data Share

Servicio:
Core
Versión de la API:
v1

Elimina el recurso compartido de datos externo especificado.

Permisos

El autor de la llamada debe tener permisos de lectura y volver a compartir en el elemento.

Ámbitos delegados necesarios

Las API de elemento pueden tener uno de estos ámbitos en su token:

  • Ámbito genérico: Item.ExternalDataShare.All
  • Ámbito específico: itemType. ExternalDataShare.All, por ejemplo: Lakehouse.ExternalDataShare.All

Para obtener más información sobre los ámbitos, consulte el artículo ámbitos.

Configuración de inquilino necesaria

Para usar esta API, habilite el modificador Administrador de uso compartido de datos externos para la entidad de seguridad de llamada.

Limitaciones

Máximo de 10 solicitudes por minuto.

Identidades admitidas de Microsoft Entra

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

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

Interfaz

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/externalDataShares/{externalDataShareId}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
externalDataShareId
 path True

string (uuid)

Identificador del recurso compartido de datos externo.
itemId
 path True

string (uuid)

Identificador del elemento.
workspaceId
 path True

string (uuid)

El identificador del área de trabajo.

Respuestas

Nombre Tipo Description
200 OK

Solicitud completada correctamente.
Other Status Codes

ErrorResponse

Códigos de error comunes:

  • UnknownError: se produjo un error.

Ejemplos

Delete external data share example

Solicitud de ejemplo

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715/externalDataShares/dccc162f-7a41-4720-83c3-5c7e81187959

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

Object

Objeto de detalles del recurso relacionado con el error.

Nombre Tipo Description
resourceId

string

Identificador de recurso implicado en el error.
resourceType

string

Tipo del recurso implicado en el error.

ErrorResponse

Object

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 legible del error.
moreDetails

ErrorResponseDetails[]

Lista de detalles de error adicionales.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.
requestId

string

Identificador de la solicitud asociada al error.

ErrorResponseDetails

Object

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 legible del error.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.