Tags - Unapply Tags

Služba:

Core

Verzia rozhrania API:

v1

Poznámka

Toto rozhranie API je vo verzii Preview.

Zrušenie použitia značiek z položky.

Povolenia

Volajúci musí mať v pracovnom priestore rolu prispievateľa alebo vyššiu.

Povinné delegované rozsahy

ItemMetadata.ReadWrite.All alebo tieto typy rozsahu:

• Všeobecný rozsah: Item.ReadWrite.All
• Konkrétny rozsah: itemType. ReadWrite.All (napríklad: Notebook.ReadWrite.All)

Ďalšie informácie o rozsahoch nájdete v článku Rozsahy.

Obmedzenia

Maximálne 25 požiadaviek za hodinu na hlavného objektu.

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

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

Parametre URI

Name	V	Povinné	Typ	Description
itemId	path	True	string (uuid)	ID položky.
workspaceId	path	True	string (uuid)	ID pracovného priestoru.

Text požiadavky

Name	Povinné	Typ	Description
tags	True	string[] (uuid)	Pole ID značiek.

Odpovede

Name	Typ	Description
200 OK		Značky boli úspešne zrušené.
Other Status Codes	ErrorResponse	Bežné kódy chýb: ItemNotFound – označuje, že server nemôže nájsť požadovanú položku EntityNotFound – ID značky neexistuje InvalidInputs – bol zadaný neplatný vstup.

Príklady

Unapply tags example

Vzorová požiadavka

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"
  ]
}

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.
UnapplyTagsRequest	Objem dát žiadosti o zrušenie použitia značiek.

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.
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	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.

UnapplyTagsRequest

Object

Objem dát žiadosti o zrušenie použitia značiek.

Name	Typ	Description
tags	string[] (uuid)	Pole ID značiek.