Tags - Delete Tag

Dienst:

Admin

API-Version:

v1

Hinweis

Diese API befindet sich in der Vorschau.

Löschen Sie das angegebene Tag.

Erlaubnisse

Der Aufrufer muss über Administratorrechte verfügen, z. B. Fabric-Administrator.

Erforderliche delegierte Bereiche

Tenant.ReadWrite.All.

Einschränkungen

Maximal 10 Anforderungen pro Minute pro Prinzipal.

Von Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft-Identitäten .

Identität	Unterstützung
Benutzer	Ja
Dienstprinzipal und verwaltete Identitäten	Ja

Schnittstelle

DELETE https://api.fabric.microsoft.com/v1/admin/tags/{tagId}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
tagId	path	True	string (uuid)	Die Tag-ID.

Antworten

Name	Typ	Beschreibung
200 OK		Tag wurde erfolgreich gelöscht.
Other Status Codes	ErrorResponse	Häufige Fehlercodes: UnknownError – Fehler EntityNotFound – Tag-ID ist nicht vorhanden

Beispiele

Delete a tag example

Beispielanforderung

HTTP

DELETE https://api.fabric.microsoft.com/v1/admin/tags/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f

Beispiel für eine Antwort

Statuscode:

200

Definitionen

Name	Beschreibung
ErrorRelatedResource	Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse	Die Fehlerantwort.
ErrorResponseDetails	Die Fehlerantwortdetails.

ErrorRelatedResource

Objekt

Das Fehlerbezogene Ressourcendetails-Objekt.

Name	Typ	Beschreibung
resourceId	string	Die Ressourcen-ID, die an dem Fehler beteiligt ist.
resourceType	string	Der Typ der Ressource, die an dem Fehler beteiligt ist.

ErrorResponse

Objekt

Die Fehlerantwort.

Name	Typ	Beschreibung
errorCode	string	Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message	string	Eine lesbare Darstellung des Fehlers.
moreDetails	ErrorResponseDetails[]	Liste der zusätzlichen Fehlerdetails.
relatedResource	ErrorRelatedResource	Die fehlerbezogenen Ressourcendetails.
requestId	string	ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Objekt

Die Fehlerantwortdetails.

Name	Typ	Beschreibung
errorCode	string	Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message	string	Eine lesbare Darstellung des Fehlers.
relatedResource	ErrorRelatedResource	Die fehlerbezogenen Ressourcendetails.