Udostępnij przez

External Data Shares Provider - Revoke External Data Share

Usługa:
Core
Wersja interfejsu API:
v1

Odwołuje określony zewnętrzny udział danych. Nie można tego cofnąć.

Uprawnienia

Obiekt wywołujący musi mieć uprawnienia do odczytu i udostępniania dalej w elemencie.

Wymagane zakresy delegowane

Interfejsy API elementów mogą mieć jeden z tych zakresów w tokenie:

  • Zakres ogólny: Item.ExternalDataShare.All
  • Określony zakres: itemType. ExternalDataShare.All, na przykład: Lakehouse.ExternalDataShare.All

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

Wymagane ustawienia dzierżawy

Aby użyć tego interfejsu API, włącz przełącznik administratora udostępniania danych zewnętrznych dla nazwy głównej wywołującej.

Ograniczenia

Maksymalnie 10 żądań na minutę.

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}/externalDataShares/{externalDataShareId}/revoke

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
externalDataShareId
 path True

string (uuid)

Identyfikator zewnętrznego udziału danych.
itemId
 path True

string (uuid)

Identyfikator elementu.
workspaceId
 path True

string (uuid)

Identyfikator przestrzeni roboczej.

Odpowiedzi

Nazwa Typ Opis
200 OK

Żądanie zostało ukończone pomyślnie.
Other Status Codes

ErrorResponse

Typowe kody błędów:

  • UnknownError — wystąpił błąd.

Przykłady

Revoke external data share example

Przykładowe żądanie

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715/externalDataShares/dccc162f-7a41-4720-83c3-5c7e81187959/revoke

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.

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.