Tags - Unapply Tags

Palvelu:

Core

Ohjelmointirajapinnan versio:

v1

Huomautus

Tämä ohjelmointirajapinta on ennakkoversio.

Poista nimiöiden käyttö kohteessa.

Käyttöoikeudet

Kutsujalla on oltava osallistujan tai suurempi rooli työtilassa.

Vaaditut delegoidut vaikutusalueet

ItemMetadata.ReadWrite.All tai nämä vaikutusaluetyypit:

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

Lisätietoja vaikutusalueista on Vaikutusalueet-artikkelissa.

Rajoitukset

Enintään 25 pyyntöä tunnissa pääasiaa kohti.

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	Kyllä

Rajapinta

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

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Description
itemId	path	True	string (uuid)	Kohdetunnus.
workspaceId	path	True	string (uuid)	Työtilan tunnus.

Pyynnön leipäteksti

Nimi	Pakollinen	Tyyppi	Description
tags	True	string[] (uuid)	Tunnisteiden tunnusten matriisi.

Vastaukset

Nimi	Tyyppi	Description
200 OK		Tunnisteiden poistaminen onnistui.
Other Status Codes	ErrorResponse	Yleiset virhekoodit: ItemNotFound - Osoittaa, että palvelin ei löydä pyydettyä kohdetta EntityNotFound – Tunnistetunnusta ei ole InvalidInputs – annettiin virheellinen syöte

Esimerkit

Unapply tags example

Mallipyyntö

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/cfafbeb1-8037-4d0c-896e-a46fb27ff230/unapplyTags

{
  "tags": [
    "97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f",
    "41d5b790-76d9-4ebe-9f06-b34cc280a612",
    "7b8e5ada-2dee-4b97-915e-0b9d3b416b1e"
  ]
}

Mallivastaus

Tilakoodi:

200

Määritelmät

Nimi	Description
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
UnapplyTagsRequest	Pyyntötietosisältö tunnisteiden poistamisesta.

ErrorRelatedResource

Object

Virheeseen liittyvä resurssitieto-objekti.

Nimi	Tyyppi	Description
resourceId	string	Virheestä liittyvä resurssitunnus.
resourceType	string	Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Object

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	Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Object

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.

UnapplyTagsRequest

Object

Pyyntötietosisältö tunnisteiden poistamisesta.

Nimi	Tyyppi	Description
tags	string[] (uuid)	Tunnisteiden tunnusten matriisi.