Delen via

Items - Delete Graph Model

Service:
GraphModel
API-versie:
v1

Hiermee verwijdert u het opgegeven GraphModel.

Opmerking

GraphModel-item is momenteel in preview (meer informatie).

Permissions

De aanroeper moet schrijfmachtigingen hebben voor het GraphModel.

Vereiste gedelegeerde bereiken

Item.ReadWrite.All

Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft-identiteiten die in deze sectie worden vermeld.

Identiteit Support
User Yes
serviceprincipal en beheerde identiteiten Yes

gebruikersinterface

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/graphModels/{graphModelId}
Met optionele parameters: 
DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/graphModels/{graphModelId}?hardDelete={hardDelete}

URI-parameters

Name In Vereist Type Description
graphModelId
 path True

string (uuid)

De GraphModel-id.
workspaceId
 path True

string (uuid)

De werkruimte-ID.
hardDelete
 query

boolean

Hiermee geeft u op of een harde verwijdering moet worden uitgevoerd. Als dit is ingesteld true, wordt het item definitief verwijderd en kan het niet worden hersteld. Als dit is ingesteld op false of niet is opgegeven, wordt het item voorlopig verwijderd als het itemtype dit ondersteunt.

Antwoorden

Name Type Description
200 OK

De aanvraag is voltooid.
429 Too Many Requests

ErrorResponse

De servicesnelheidslimiet is overschreden. De server retourneert een Retry-After header die in seconden aangeeft hoe lang de client moet wachten voordat extra aanvragen worden verzonden.

Kopteksten

Retry-After: integer
Other Status Codes

ErrorResponse

Veelvoorkomende foutcodes:

  • ItemNotFound : het aangevraagde item is niet gevonden.

  • InsufficientWorkspaceRole - Gebruiker heeft onvoldoende werkruimterol.

  • FeatureNotAvailable: dit kan worden veroorzaakt doordat de functie voor voorlopig verwijderen niet beschikbaar is.

  • UnsupportedItemType: dit kan worden veroorzaakt door de functie voor voorlopig verwijderen die niet wordt ondersteund door het aangevraagde itemtype.

  • TenantSwitchDisabled: dit kan worden veroorzaakt doordat de functie voor voorlopig verwijderen wordt uitgeschakeld door de tenantbeheerder.

  • InvalidTargetItemStateForSoftDeletion : het item heeft ongeldige statussen voor voorlopig verwijderen.

  • InvalidParentItemStateForSoftDeletion : het bovenliggende item van het item heeft de status Actief niet.

Voorbeelden

Delete a GraphModel example
Hard delete a GraphModel example

Delete a GraphModel example

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:
200

Hard delete a GraphModel example

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:
200

Definities

Name Description
ErrorRelatedResource

Het foutgerelateerde resourcedetailsobject.
ErrorResponse

Het foutbericht.
ErrorResponseDetails

De details van het foutbericht.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name Type Description
resourceId

string

De resource-id die betrokken is bij de fout.
resourceType

string

Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message

string

Een leesbare weergave van de fout.
moreDetails

ErrorResponseDetails[]

Lijst met aanvullende foutdetails.
relatedResource

ErrorRelatedResource

De foutgerelateerde resourcedetails.
requestId

string (uuid)

Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message

string

Een leesbare weergave van de fout.
relatedResource

ErrorRelatedResource

De foutgerelateerde resourcedetails.