Staging - Delete Datasource Element

Dienst:
DataAgent
API-Version:
v1

Löscht ein Schemaelement, das nicht mehr im Liveschema vorhanden ist, aus einer Stagingdatenquelle.

Hinweis

Die Verwaltung der Daten-Agent-Konfiguration befindet sich derzeit in der Vorschau (weitere Informationen).

Verwenden Sie diese API, um ein veraltetes Element aus dem gespeicherten Datenquellenschema zu entfernen, nachdem es aus dem Livedatenquellenschema entfernt wurde. Diese API entfernt elemente nicht automatisch, wenn sich das Liveschema ändert, sodass Aufrufer die Änderung überprüfen und entscheiden können, ob das gespeicherte Element selbst gelöscht werden soll.

Ein Element kann nur gelöscht werden, wenn es nicht mehr im Livedatenquellenschema vorhanden ist. Wenn das Element weiterhin im Livedatenquellenschema vorhanden ist, schlägt die Anforderung fehl.

Berechtigungen

Der Aufrufer muss Lese- und Schreibberechtigungen für den DataAgent besitzen.

Erforderliche delegierte Zugriffsbereiche

Item.ReadWrite.All oder DataAgent.ReadWrite.All

Von Microsoft Entra unterstützte Identitäten

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

Identität Support
Benutzer Ja
Service Principal und Verwaltete Identitäten Ja

Schnittstelle

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataAgents/{dataAgentId}/staging/datasources/{datasourceId}/elements?id={id}

URI-Parameter

Name In Erforderlich Typ Beschreibung
dataAgentId
 path True

string (uuid)

Die DataAgent-ID.
datasourceId
 path True

string (uuid)

Die Datenquellen-ID.
workspaceId
 path True

string (uuid)

Die Arbeitsbereichs-ID.
id
 query True

string

Der Elementbezeichner.

Antworten

Name Typ Beschreibung
200 OK

Der Auftrag wurde erfolgreich abgeschlossen.
429 Too Many Requests

ErrorResponse

Der Dienstratenlimit wurde überschritten. Der Server gibt einen Retry-After Header zurück, der in Sekunden angibt, wie lange der Client warten muss, bevor zusätzliche Anforderungen gesendet werden.

Header

Retry-After: integer
Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • ItemNotFound – Das angeforderte Element wurde nicht gefunden.

  • ElementStillAvailable – Das Element ist weiterhin im Datenquellenschema vorhanden und kann nicht gelöscht werden.

Beispiele

Delete staging DataAgent datasource element example

Beispielanforderung

DELETE https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataAgents/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/staging/datasources/c1c6d12f-8d2a-4d5b-9ca1-8bb7b42d4a30/elements?id=U2NoZW1hcy9kYm8vVGFibGVzL1RyaXA=

Beispiel für eine Antwort

Statuscode:
200

Definitionen

Name Beschreibung
ErrorRelatedResource

Das Objekt der fehlerbezogenen Ressourcendetails.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.

ErrorRelatedResource

Objekt

Das Objekt der fehlerbezogenen Ressourcendetails.

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

boolean

Wenn true, kann die Anforderung wiederholt werden. Verwenden Sie den Retry-After Antwortheader, um die Verzögerung zu ermitteln, falls verfügbar.
message

string

Eine menschenlesbare Darstellung des Fehlers.
moreDetails

ErrorResponseDetails[]

Liste der zusätzlichen Fehlerdetails.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.
requestId

string (uuid)

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 menschenlesbare Darstellung des Fehlers.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.