Jaa

Items - Delete Item

Palvelu:
Core
Ohjelmointirajapinnan versio:
v1

Poistaa määritetyn kohteen.
Tätä ohjelmointirajapintaa tuetaan useissa kohdetyypeissä. Se etsii tuettuja kohdetyyppejä ja tietoja niiden määritysrakenteesta kohdasta Kohdehallinnan yleiskatsaus. Oletusarvon mukaan tuettujen kohdetyyppien kohde poistetaan pehmeästi.

Muistio

Pehmeästi poistetut kohteet lasketaan mukaan kuhunkin työtilaan sallittujen kohteiden enimmäismäärään.

Käyttöoikeudet

Kutsujalla on oltava kohteen kirjoitusoikeudet pehmeää poistoa varten. Kutsujalle on määritettävä työtilan järjestelmänvalvojan rooli pysyvää ja pysyvää poistamista varten.

Vaaditut delegoidut vaikutusalueet

Kohteiden ohjelmointirajapinnoilla voit käyttää seuraavia vaikutusaluetyyppejä:

  • Yleinen vaikutusalue: Item.ReadWrite.All
  • Tietty vaikutusalue: itemType. ReadWrite.All (esimerkiksi: Notebook.ReadWrite.All)

Lisätietoja vaikutusalueista on vaikutusalueita artikkelissa.

Microsoft Entran tukemat käyttäjätiedot

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Identiteetti Tuki
Käyttäjä Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen Kun kutsun kohdetyyppiä tuetaan. Tarkista vastaava ohjelmointirajapinta kohdetyypille, jota kutsut, ja tarkista, tuetaanko kutsuasi. Esimerkiksi semanttisia malleja tuetaan.

Rajapinta

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

URI-parametrit

Nimi Kohteessa Pakollinen Tyyppi Description
itemId
 path True

string (uuid)

Kohdetunnus.
workspaceId
 path True

string (uuid)

Työtilan tunnus.
hardDelete
 query

boolean

Määrittää, tehdäänkö pysyvä poisto. Kun asetuksena trueon , kohde poistetaan pysyvästi, eikä sitä voi palauttaa. Jos asetuksena false on tai ei määritetty, kohde poistetaan pehmeästi, jos kohdetyyppi tukee sitä.

Vastaukset

Nimi Tyyppi Description
200 OK

Pyynnön valmistuttua.
429 Too Many Requests

ErrorResponse

Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka Retry-After ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään.

Otsikot

Retry-After: integer
Other Status Codes

ErrorResponse

Yleiset virhekoodit:

  • ItemNotFound – Pyydettyä kohdetta ei löytynyt.

  • InsufficientWorkspaceRole – Käyttäjällä ei ole riittävää työtilan roolia.

  • FeatureNotAvailable – Tämä voi johtua siitä, että pehmeä poisto -ominaisuus ei ole käytettävissä.

  • UnsupedItemType – Tämä voi johtua siitä, että pyydetty kohdetyyppi ei tue pehmeää poistotoimintoa.

  • TenantSwitchDisabled – Tämä voi johtua siitä, että vuokraajan järjestelmänvalvoja on poistanut pehmeän poistamisen toiminnon käytöstä.

  • InvalidTargetItemStateForSoftDeletion – Kohde on virheellinen pehmeää poistoa varten.

  • InvalidParentItemStateForSoftDeletion – Kohteen pääkohde ei ole aktiivisessa tilassa.

Esimerkit

Delete an item example
Hard delete an item example

Delete an item example

Mallipyyntö

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

Mallivastaus

Tilakoodi:
200

Hard delete an item example

Mallipyyntö

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

Mallivastaus

Tilakoodi:
200

Määritelmät

Nimi Description
ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse

Virhevastaus.
ErrorResponseDetails

Virheen vastauksen tiedot.

ErrorRelatedResource

Kohde

Virheeseen liittyvä resurssitieto-objekti.

Nimi Tyyppi Description
resourceId

string

Virheestä liittyvä resurssitunnus.
resourceType

string

Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Kohde

Virhevastaus.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
moreDetails

ErrorResponseDetails[]

Luettelo virheiden lisätiedoista.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.
requestId

string (uuid)

Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Kohde

Virheen vastauksen tiedot.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.