Staging - Delete Datasource Element

Usługa:
DataAgent
Wersja interfejsu API:
v1

Usuwa element schematu, który nie jest już obecny w schemacie na żywo ze źródła danych przejściowych.

Note

Zarządzanie konfiguracją agenta danych jest obecnie dostępne w wersji zapoznawczej (dowiedz się więcej).

Użyj tego interfejsu API, aby usunąć nieaktualny element ze zapisanego schematu źródła danych po jego usunięciu ze schematu źródła danych na żywo. Ten interfejs API nie usuwa automatycznie elementów po zmianie schematu na żywo, dlatego osoby wywołujące mogą przejrzeć zmianę i zdecydować, czy samodzielnie usunąć zapisany element.

Element można usunąć tylko wtedy, gdy nie jest już obecny w schemacie źródła danych na żywo. Jeśli element nadal istnieje w schemacie źródła danych na żywo, żądanie zakończy się niepowodzeniem.

Uprawnienia

Obiekt wywołujący musi mieć uprawnienia do odczytu i zapisu dla agenta DataAgent.

Wymagane zakresy delegowane

Item.ReadWrite.All lub DataAgent.ReadWrite.All

Tożsamości obsługiwane przez Microsoft Entra

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

Identity Support
User Tak
Główne usługi i Tożsamości zarządzane Tak

Interfejs

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
dataAgentId
 path True

string (uuid)

Identyfikator agenta danych.
datasourceId
 path True

string (uuid)

Identyfikator źródła danych.
workspaceId
 path True

string (uuid)

Identyfikator przestrzeni roboczej.
id
 query True

string

Identyfikator elementu.

Odpowiedzi

Nazwa Typ Opis
200 OK

Żądanie zostało ukończone pomyślnie.
429 Too Many Requests

ErrorResponse

Przekroczono limit szybkości usługi. Serwer zwraca nagłówek wskazujący Retry-After w sekundach, jak długo klient musi czekać przed wysłaniem dodatkowych żądań.

Nagłówki

Retry-After: integer
Other Status Codes

ErrorResponse

Typowe kody błędów:

  • ItemNotFound — żądany element nie został znaleziony.

  • ElementStillAvailable — element nadal istnieje w schemacie źródła danych i nie można go usunąć.

Przykłady

Delete staging DataAgent datasource element example

Przykładowe żądanie

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=

Przykładowa odpowiedź

Kod stanu:
200

Definicje

Nazwa Opis
ErrorRelatedResource

Obiekt szczegółowych informacji o zasobie związanym z błędem.
ErrorResponse

Odpowiedź na błąd.
ErrorResponseDetails

Szczegóły odpowiedzi na błąd.

ErrorRelatedResource

Objekt

Obiekt szczegółowych informacji o zasobie związanym z błędem.

Nazwa Typ Opis
resourceId

string

Identyfikator zasobu powiązany z błędem.
resourceType

string

Typ zasobu powiązanego z błędem.

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

boolean

Jeśli to prawda, żądanie można ponowić. Użyj nagłówka Retry-After odpowiedzi, aby określić opóźnienie, jeśli jest dostępne.
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 (uuid)

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.