Tags - Unapply Tags

Usługa:

Core

Wersja interfejsu API:

v1

Uwaga / Notatka

Ten interfejs API jest w wersji zapoznawczej.

Cofanie stosowania znaczników z elementu.

Uprawnienia

Obiekt wywołujący musi mieć rolę współautora lub wyższą w obszarze roboczym.

Wymagane zakresy delegowane

ItemMetadata.ReadWrite.All lub następujące typy zakresu:

• Zakres ogólny: Item.ReadWrite.All
• Określony zakres: itemType. ReadWrite.All (na przykład: Notebook.ReadWrite.All)

Aby uzyskać więcej informacji na temat zakresów, zobacz artykuł Zakresy .

Ograniczenia

Maksymalnie 25 żądań na godzinę na podmiot zabezpieczeń.

Tożsamości obsługiwane przez Microsoft Entra

To API obsługuje tożsamości Microsoft wymienione w tej sekcji.

Tożsamość	Wsparcie
Użytkownik	Tak
Główne usługi i Tożsamości zarządzane	Tak

Interfejs

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
itemId	path	True	string (uuid)	Identyfikator elementu.
workspaceId	path	True	string (uuid)	Identyfikator przestrzeni roboczej.

Treść żądania

Nazwa	Wymagane	Typ	Opis
tags	True	string[] (uuid)	Tablica identyfikatorów tagów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK		Tagi zostały pomyślnie cofnięte.
Other Status Codes	ErrorResponse	Typowe kody błędów: ItemNotFound — wskazuje, że serwer nie może odnaleźć żądanego elementu EntityNotFound — identyfikator tagu nie istnieje InvalidInputs — podano nieprawidłowe dane wejściowe

Przykłady

Unapply tags example

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

200

Definicje

Nazwa	Opis
ErrorRelatedResource	Obiekt szczegółów zasobu powiązanego z błędem.
ErrorResponse	Odpowiedź na błąd.
ErrorResponseDetails	Szczegóły odpowiedzi na błąd.
UnapplyTagsRequest	Ładunek żądania do cofnięcia stosowania tagów.

ErrorRelatedResource

Objekt

Obiekt szczegółów zasobu powiązanego z błędem.

Nazwa	Typ	Opis
resourceId	string	Identyfikator zasobu, który jest zaangażowany w błąd.
resourceType	string	Typ zasobu, który jest zaangażowany w błąd.

ErrorResponse

Objekt

Odpowiedź na błąd.

Nazwa	Typ	Opis
errorCode	string	Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message	string	Czytelna reprezentacja błędu przez człowieka.
moreDetails	ErrorResponseDetails[]	Lista dodatkowych szczegółów błędu.
relatedResource	ErrorRelatedResource	Szczegóły zasobu powiązanego z błędem.
requestId	string	Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Objekt

Szczegóły odpowiedzi na błąd.

Nazwa	Typ	Opis
errorCode	string	Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message	string	Czytelna reprezentacja błędu przez człowieka.
relatedResource	ErrorRelatedResource	Szczegóły zasobu powiązanego z błędem.

UnapplyTagsRequest

Objekt

Ładunek żądania do cofnięcia stosowania tagów.

Nazwa	Typ	Opis
tags	string[] (uuid)	Tablica identyfikatorów tagów.