Items - Delete Item

Tjänst:: Core

API-version:: v1

Tar bort det angivna objektet.
Det här API:et stöds för ett antal objekttyper, hittar objekttyper som stöds och information om deras definitionsstruktur i Översikt över objekthantering. Standardbeteendet är att mjukt ta bort objektet för objekttyper som stöds.

Anmärkning

De mjukt borttagna objekten räknas mot det maximala antalet objekt som tillåts på varje arbetsyta.

Behörigheter

Anroparen måste ha skrivbehörighet för objektet för mjuk borttagning. Anroparen måste ha arbetsytans administratörsroll tilldelad för hård/permanent borttagning.

Obligatoriska delegerade omfång

För objekt-API:er använder du följande omfångstyper:

Allmänt omfång: Item.ReadWrite.All
Specifikt omfång: itemType. ReadWrite.All (till exempel: Notebook.ReadWrite.All)

Mer information om omfång finns i artikeln om omfång.

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identitet	Stöd
Användare	Ja
Tjänsthuvudnamn och hanterade identiteter	När objekttypen i anropet stöds. Kontrollera motsvarande API för den objekttyp som du anropar för att se om ditt anrop stöds. Semantiska modeller stöds till exempel.

Gränssnitt

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

Med valfria parametrar:

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
itemId	path	True	string (uuid)	Objekt-ID:t.
workspaceId	path	True	string (uuid)	Arbetsyte-ID.
hardDelete	query		boolean	Anger om du vill utföra en hård borttagning. När det är inställt på `true`tas objektet bort permanent och kan inte återställas. När objektet har angetts till `false` eller inte har angetts tas det bort mjukt om objekttypen stöder det.

Svar

Name Typ Description

200 OK

Name	Typ	Description
200 OK		Begäran har slutförts.
429 Too Many Requests	ErrorResponse	Gränsen för tjänstfrekvens överskreds. Servern returnerar ett `Retry-After` huvud som anger i sekunder hur länge klienten måste vänta innan ytterligare begäranden skickas. Sidhuvuden Retry-After: integer
Other Status Codes	ErrorResponse	Vanliga felkoder: ItemNotFound – Det begärda objektet hittades inte. InsufficientWorkspaceRole – Användaren har inte tillräcklig arbetsyteroll. FeatureNotAvailable – Det kan bero på att funktionen för mjuk borttagning inte är tillgänglig. Stöds inteItemType – det kan bero på att funktionen för mjuk borttagning inte stöds av den begärda objekttypen. TenantSwitchDisabled – Det kan bero på att funktionen för mjuk borttagning inaktiveras av klientadministratören. InvalidTargetItemStateForSoftDeletion – objektet är i ogiltiga tillstånd för mjuk borttagning. InvalidParentItemStateForSoftDeletion – objektets överordnade objekt är inte i aktivt tillstånd.

Begäran har slutförts.

429 Too Many Requests

ErrorResponse

Gränsen för tjänstfrekvens överskreds. Servern returnerar ett Retry-After huvud som anger i sekunder hur länge klienten måste vänta innan ytterligare begäranden skickas.

Sidhuvuden

Retry-After: integer

Other Status Codes

ErrorResponse

Vanliga felkoder:

ItemNotFound – Det begärda objektet hittades inte.
InsufficientWorkspaceRole – Användaren har inte tillräcklig arbetsyteroll.
FeatureNotAvailable – Det kan bero på att funktionen för mjuk borttagning inte är tillgänglig.
Stöds inteItemType – det kan bero på att funktionen för mjuk borttagning inte stöds av den begärda objekttypen.
TenantSwitchDisabled – Det kan bero på att funktionen för mjuk borttagning inaktiveras av klientadministratören.
InvalidTargetItemStateForSoftDeletion – objektet är i ogiltiga tillstånd för mjuk borttagning.
InvalidParentItemStateForSoftDeletion – objektets överordnade objekt är inte i aktivt tillstånd.

Exempel

Delete an item example

Hard delete an item example

Delete an item example

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:: 200

Hard delete an item example

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:: 200

Definitioner

Name	Description
ErrorRelatedResource	Det felrelaterade resursinformationsobjektet.
ErrorResponse	Felsvaret.
ErrorResponseDetails	Information om felsvar.

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name	Typ	Description
resourceId	string	Det resurs-ID som ingår i felet.
resourceType	string	Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name	Typ	Description
errorCode	string	En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message	string	En mänsklig läsbar representation av felet.
moreDetails	ErrorResponseDetails[]	Lista över ytterligare felinformation.
relatedResource	ErrorRelatedResource	Felrelaterad resursinformation.
requestId	string (uuid)	ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Information om felsvar.

Name	Typ	Description
errorCode	string	En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message	string	En mänsklig läsbar representation av felet.
relatedResource	ErrorRelatedResource	Felrelaterad resursinformation.