External Data Shares Provider - Revoke External Data Share

Služba:

Core

Verzia rozhrania API:

v1

Zruší zadaný podiel externých údajov. Túto akciu nie je možné vrátiť späť.

Povolenia

Volajúci musí mať pre položku povolenia na čítanie a opätovné zdieľanie .

Povinné delegované rozsahy

Rozhrania API položiek môžu mať jeden z týchto rozsahov vo svojom tokene:

• Všeobecný rozsah: Item.ExternalDataShare.All
• Konkrétny rozsah: itemType. ExternalDataShare.All, napríklad: Lakehouse.ExternalDataShare.All

Ďalšie informácie o rozsahoch nájdete v článku o rozsahoch.

Požadované nastavenia nájomníka

Ak chcete použiť toto rozhranie API, povoľte prepínač Správca externého zdieľania údajov pre volajúci objekt.

Obmedzenia

Maximálne 10 žiadostí za minútu.

Podporované identity v aplikácii Microsoft Entra

Toto rozhranie API podporuje identity Microsoft uvedené v tejto časti.

Identita	Podpora
Používateľ	Áno
Objekt služby a spravované identity	Áno

Rozhranie

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

Parametre URI

Name	V	Povinné	Typ	Description
externalDataShareId	path	True	string (uuid)	Id externého zdieľania údajov.
itemId	path	True	string (uuid)	ID položky.
workspaceId	path	True	string (uuid)	ID pracovného priestoru.

Odpovede

Name	Typ	Description
200 OK		Požiadavka sa úspešne dokončila.
Other Status Codes	ErrorResponse	Bežné kódy chýb: UnknownError – vyskytla sa chyba.

Príklady

Revoke external data share example

Vzorová požiadavka

HTTP

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

Vzorová odpoveď

Kód stavu:

200

Definície

Name	Description
ErrorRelatedResource	Objekt s podrobnosťami o zdroji súvisiacej s chybou.
ErrorResponse	Odpoveď na chybu.
ErrorResponseDetails	Podrobnosti o chybovej odpovedi.

ErrorRelatedResource

Object

Objekt s podrobnosťami o zdroji súvisiacej s chybou.

Name	Typ	Description
resourceId	string	ID prostriedku, ktoré je súčasťou chyby.
resourceType	string	Typ prostriedku, ktorý je zapojený do chyby.

ErrorResponse

Object

Odpoveď na chybu.

Name	Typ	Description
errorCode	string	Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
message	string	Zobrazenie chyby čitateľné ľuďmi.
moreDetails	ErrorResponseDetails[]	Zoznam ďalších podrobností o chybe.
relatedResource	ErrorRelatedResource	Podrobnosti o zdrojoch súvisiacich s chybou.
requestId	string	ID požiadavky súvisiacej s chybou.

ErrorResponseDetails

Object

Podrobnosti o chybovej odpovedi.

Name	Typ	Description
errorCode	string	Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
message	string	Zobrazenie chyby čitateľné ľuďmi.
relatedResource	ErrorRelatedResource	Podrobnosti o zdrojoch súvisiacich s chybou.