External Data Shares Provider - Delete External Data Share

Tjänst:
Core
API-version:
v1

Tar bort den angivna externa dataresursen.

Behörigheter

Anroparen måste ha läs- och delningsbehörigheter för objektet.

Obligatoriska delegerade omfång

Objekt-API:er kan ha något av dessa omfång i sin token:

  • Allmänt omfång: Item.ExternalDataShare.All
  • Specifikt omfång: itemType. ExternalDataShare.All, till exempel: Lakehouse.ExternalDataShare.All

Mer information om omfång finns i artikeln om omfång.

Nödvändiga klientinställningar

Om du vill använda det här API:et aktiverar du administratörsväxeln extern datadelning för det anropande huvudnamnet.

Begränsningar

Maximalt 10 begäranden per minut.

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identitet Stöd
Användare Ja
Tjänsthuvudnamn och hanterade identiteter Ja

Gränssnitt

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/externalDataShares/{externalDataShareId}

URI-parametrar

Name I Obligatorisk Typ Description
externalDataShareId
 path True

string (uuid)

Det externa dataresurs-ID:t.
itemId
 path True

string (uuid)

Objekt-ID:t.
workspaceId
 path True

string (uuid)

Arbetsyte-ID.

Svar

Name Typ Description
200 OK

Begäran har slutförts.
429 Too Many Requests

ErrorResponse

Gränsen för tjänstfrekvens överskreds. Servern returnerar ett Retry-After huvud som anger i sekunder hur länge klienten måste vänta innan ytterligare begäranden skickas.

Sidhuvuden

Retry-After: integer
Other Status Codes

ErrorResponse

Vanliga felkoder:

  • UnknownError – Ett fel uppstod.

Exempel

Delete external data share example

Exempelbegäran

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

Exempelsvar

Statuskod:
200

Definitioner

Name Description
ErrorRelatedResource

Det felrelaterade resursinformationsobjektet.
ErrorResponse

Felsvaret.
ErrorResponseDetails

Information om felsvar.

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name Typ Description
resourceId

string

Det resurs-ID som ingår i felet.
resourceType

string

Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
isRetriable

boolean

När det är sant kan begäran göras på nytt. Använd svarshuvudet Retry-After för att fastställa fördröjningen, om den är tillgänglig.
message

string

En mänsklig läsbar representation av felet.
moreDetails

ErrorResponseDetails[]

Lista över ytterligare felinformation.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.
requestId

string (uuid)

ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Information om felsvar.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.