Items - Delete Report

Služba:

Report

Verzia rozhrania API:

v1

Odstráni zadanú zostavu.

Povolenia

Volajúci musí mať povolenia na zápis pre zostavu.

Povinné delegované rozsahy

Report.ReadWrite.All alebo Item.ReadWrite.All

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

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/reports/{reportId}

S voliteľnými parametrami:

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/reports/{reportId}?hardDelete={hardDelete}

Parametre URI

Name	V	Povinné	Typ	Description
reportId	path	True	string (uuid)	ID zostavy.
workspaceId	path	True	string (uuid)	ID pracovného priestoru.
hardDelete	query		boolean	Určuje, či sa má vykonať pevné odstránenie. Ak je nastavená možnosť true, položka sa natrvalo odstráni a nedá sa obnoviť. Ak je nastavená na false hodnotu alebo nie je zadaná, položka sa odstráni bez odstránenia, ak ju podporuje typ položky.

Odpovede

Name	Typ	Description
200 OK		Požiadavka sa úspešne dokončila.
429 Too Many Requests	ErrorResponse	Prekročil sa limit rýchlosti služby. Server vráti hlavičku Retry-After v sekundách, ako dlho musí klient počkať, kým odošle ďalšie požiadavky. Hlavičky Retry-After: integer
Other Status Codes	ErrorResponse	Bežné kódy chýb: ItemNotFound – požadovaná položka sa nenašla. InsufficientWorkspaceRole – používateľ nemá dostatočnú rolu pracovného priestoru. FeatureNotAvailable – Môže to byť z dôvodu nedostupnosti funkcie obnoviteľného odstránenia. UnsupportedItemType – Môže to byť spôsobené tým, že funkcia obnoviteľného odstránenia nie je podporovaná požadovaným typom položky. TenantSwitchDisabled – môže to byť spôsobené tým, že správca nájomníka zakázal funkciu obnoviteľného odstránenia. InvalidTargetItemStateForSoftDeletion – položka je v neplatných stavoch na obnoviteľné odstránenie. InvalidParentItemStateForSoftDeletion – nadradená položka položky nie je v stave Aktívny.

Príklady

Delete a report example

Hard delete a report example

Delete a report example

Vzorová požiadavka

HTTP

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/reports/5b218778-e7a5-4d73-8187-f10824047715

Vzorová odpoveď

Kód stavu:

200

Hard delete a report example

Vzorová požiadavka

HTTP

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/reports/5b218778-e7a5-4d73-8187-f10824047715?hardDelete=True

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.
isRetriable	boolean	Ak je hodnota true, žiadosť sa môže zopakovať. Retry-After Ak je k dispozícii, oneskorenie môžete určiť pomocou hlavičky odpovede.
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 (uuid)	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.