Items - Delete Report

Služba:

Report

Verze rozhraní API:

v1

Odstraní zadanou sestavu.

Povolení

Volající musí mít pro sestavu oprávnění k zápisu .

Požadované delegovaná rozsahy

Report.ReadWrite.All nebo Item.ReadWrite.All

Podporované identity v Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita	Podpora
Uživatel	Ano
Hlavní služba a Spravované identity	Ano

Rozhraní

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
reportId	path	True	string (uuid)	ID sestavy.
workspaceId	path	True	string (uuid)	Identifikátor pracovního prostoru.
hardDelete	query		boolean	Určuje, jestli se má provést pevné odstranění. Pokud je položka nastavená na truehodnotu , trvale se odstraní a nelze ji obnovit. Pokud je položka nastavená na hodnotu nebo není zadaná false , položka je obnovitelně odstraněna, pokud ji typ položky podporuje.

Odpovědi

Name	Typ	Description
200 OK		Žádost byla úspěšně dokončena.
429 Too Many Requests	ErrorResponse	Byl překročen limit přenosové rychlosti služby. Server vrátí hlavičku označující Retry-After , jak dlouho musí klient čekat před odesláním dalších požadavků. Hlavičky Retry-After: integer
Other Status Codes	ErrorResponse	Běžné kódy chyb: ItemNotFound – Požadovaná položka nebyla nalezena. InsufficientWorkspaceRole – Uživatel nemá dostatečnou roli pracovního prostoru. FeatureNotAvailable – Příčinou může být nedostupná funkce obnovitelného odstranění. Nepodporovaný Typ Položky – Příčinou může být funkce obnovitelného odstranění, kterou požadovaný typ položky nepodporuje. TenantSwitchDisabled – Příčinou může být funkce obnovitelného odstranění zakázaná správcem tenanta. InvalidTargetItemStateForSoftDeletion – Položka je v neplatných stavech pro obnovitelné odstranění. InvalidParentItemStateForSoftDeletion – Nadřazená položka není ve stavu Aktivní.

Příklady

Delete a report example

Hard delete a report example

Delete a report example

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:

200

Hard delete a report example

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:

200

Definice

Name	Description
ErrorRelatedResource	Chyba související s objektem podrobností o prostředku.
ErrorResponse	Odpověď na chybu.
ErrorResponseDetails	Podrobnosti o odpovědi na chybu.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name	Typ	Description
resourceId	string	ID prostředku, které je součástí chyby.
resourceType	string	Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
isRetriable	boolean	Pokud je hodnota true, je možné požadavek opakovat. Pomocí hlavičky Retry-After odpovědi určete zpoždění, pokud je k dispozici.
message	string	Lidské čitelné vyjádření chyby.
moreDetails	ErrorResponseDetails[]	Seznam dalších podrobností o chybě
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou
requestId	string (uuid)	ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou