Items - Delete Dataflow

Service:: Dataflow

Version d'API:: v1

Supprime le dataflow spécifié.

Autorisations

L’appelant doit disposer d’autorisations d’écriture pour le flux de données.

Étendues déléguées requises

Dataflow.ReadWrite.All ou Item.ReadWrite.All

Identités prises en charge par Microsoft Entra

Cette API prend en charge les identités Microsoft répertoriées dans cette section.

Identité	Soutien
Utilisateur	Oui
Service principal et identités gérées	Oui

Interface

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataflows/{dataflowId}

Avec des paramètres facultatifs:

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataflows/{dataflowId}?hardDelete={hardDelete}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
dataflowId	path	True	string (uuid)	ID de dataflow.
workspaceId	path	True	string (uuid)	Identifiant de l’espace de travail.
hardDelete	query		boolean	Spécifie s’il faut effectuer une suppression en dur. Lorsqu’il est défini `true`sur , l’élément est définitivement supprimé et ne peut pas être récupéré. Lorsqu’il est défini `false` sur ou non spécifié, l’élément est supprimé de manière réversible si le type d’élément le prend en charge.

Réponses

Nom Type Description

200 OK

Nom	Type	Description
200 OK		La demande s’est terminée avec succès.
429 Too Many Requests	ErrorResponse	La limite de débit de service a été dépassée. Le serveur retourne un `Retry-After` en-tête indiquant, en secondes, combien de temps le client doit attendre avant d’envoyer des demandes supplémentaires. En-têtes Retry-After: integer
Other Status Codes	ErrorResponse	Codes d’erreur courants : ItemNotFound : l’élément demandé n’a pas été trouvé. InsufficientWorkspaceRole : l’utilisateur n’a pas de rôle d’espace de travail suffisant. FeatureNotAvailable : cela peut être dû à la fonctionnalité de suppression réversible qui n’est pas disponible. Non pris en chargeItemType : cela peut être dû à la fonctionnalité de suppression réversible non prise en charge par le type d’élément demandé. TenantSwitchDisabled : cela peut être dû à la fonctionnalité de suppression réversible désactivée par l’administrateur du locataire. InvalidTargetItemStateForSoftDeletion : l’élément est dans des états non valides pour la suppression réversible. InvalidParentItemStateForSoftDeletion : l’élément parent de l’élément n’est pas dans l’état Actif.

La demande s’est terminée avec succès.

429 Too Many Requests

ErrorResponse

La limite de débit de service a été dépassée. Le serveur retourne un Retry-After en-tête indiquant, en secondes, combien de temps le client doit attendre avant d’envoyer des demandes supplémentaires.

En-têtes

Retry-After: integer

Other Status Codes

ErrorResponse

Codes d’erreur courants :

ItemNotFound : l’élément demandé n’a pas été trouvé.
InsufficientWorkspaceRole : l’utilisateur n’a pas de rôle d’espace de travail suffisant.
FeatureNotAvailable : cela peut être dû à la fonctionnalité de suppression réversible qui n’est pas disponible.
Non pris en chargeItemType : cela peut être dû à la fonctionnalité de suppression réversible non prise en charge par le type d’élément demandé.
TenantSwitchDisabled : cela peut être dû à la fonctionnalité de suppression réversible désactivée par l’administrateur du locataire.
InvalidTargetItemStateForSoftDeletion : l’élément est dans des états non valides pour la suppression réversible.
InvalidParentItemStateForSoftDeletion : l’élément parent de l’élément n’est pas dans l’état Actif.

Exemples

Delete a Dataflow example

Hard delete a Dataflow example

Delete a Dataflow example

Exemple de requête

HTTP

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/dataflows/5b218778-e7a5-4d73-8187-f10824047715

Exemple de réponse

Code d’état:: 200

Hard delete a Dataflow example

Exemple de requête

HTTP

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/dataflows/5b218778-e7a5-4d73-8187-f10824047715?hardDelete=True

Exemple de réponse

Code d’état:: 200

Définitions

Nom	Description
ErrorRelatedResource	Objet de détails de ressource associé à l’erreur.
ErrorResponse	Réponse d’erreur.
ErrorResponseDetails	Détails de la réponse d’erreur.

ErrorRelatedResource

Objet

Objet de détails de ressource associé à l’erreur.

Nom	Type	Description
resourceId	string	ID de ressource impliqué dans l’erreur.
resourceType	string	Type de la ressource impliquée dans l’erreur.

ErrorResponse

Objet

Réponse d’erreur.

Nom	Type	Description
errorCode	string	Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
isRetriable	boolean	Lorsque la valeur est true, la requête peut être retentée. Utilisez l’en-tête `Retry-After` de réponse pour déterminer le délai, le cas échéant.
message	string	Représentation lisible humaine de l’erreur.
moreDetails	ErrorResponseDetails[]	Liste des détails d’erreur supplémentaires.
relatedResource	ErrorRelatedResource	Détails de la ressource associée à l’erreur.
requestId	string (uuid)	ID de la demande associée à l’erreur.

ErrorResponseDetails

Objet

Détails de la réponse d’erreur.

Nom	Type	Description
errorCode	string	Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
message	string	Représentation lisible humaine de l’erreur.
relatedResource	ErrorRelatedResource	Détails de la ressource associée à l’erreur.