Items - Delete Graph Model

服務:

GraphModel

API 版本:

v1

刪除指定的 GraphModel。

備註

GraphModel 項目目前處於預覽狀態 （深入瞭解）。

權限

呼叫端必須具有 GraphModel 的 寫入 許可權。

必要的委派範圍

Item.ReadWrite.All

Microsoft Entra 支援的身份

此 API 支援本節中列出的Microsoft 身分識別。

身份	Support
User	Yes
服務主體 和 受控識別	Yes

介面

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/graphModels/{graphModelId}

含選擇性參數:

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

URI 參數

名稱	位於	必要	類型	Description
graphModelId	path	True	string (uuid)	GraphModel ID。
workspaceId	path	True	string (uuid)	工作區識別碼。
hardDelete	query		boolean	指定是否執行硬刪除。 當 設定為 true時，該項目將永久刪除且無法恢復。 若設定為或 false 未指定，若項目類型支援，該項目會被軟刪除。

回應

名稱	類型	Description
200 OK		要求成功完成。
429 Too Many Requests	ErrorResponse	服務費率上限被超標。 伺服器會回傳一個 Retry-After 標頭，以秒數表示客戶端在發送額外請求前必須等待多久。 標題 Retry-After: integer
Other Status Codes	ErrorResponse	常見的錯誤碼： ItemNotFound - 找不到要求的專案。 InsufficientWorkspaceRole - 使用者沒有足夠的工作區角色。 FeatureNotAvailable - 這可能是因為軟刪除功能無法使用。 UnsupportedItemType - 這可能是因為所請求的項目類型不支援軟刪除功能。 TenantSwitchDisabled - 這可能是因為租戶管理員停用了軟刪除功能。 InvalidTargetItemStateForSoftDeletion - 該項目處於軟刪除的無效狀態。 InvalidParentItemStateForSoftDeletion - 該項目的父項目並非處於「活躍」狀態。

範例

Delete a GraphModel example

Hard delete a GraphModel example

Delete a GraphModel example

範例要求

HTTP

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

範例回覆

狀態碼:

200

Hard delete a GraphModel example

範例要求

HTTP

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

範例回覆

狀態碼:

200

定義

名稱	Description
ErrorRelatedResource	錯誤相關的資源詳細資料物件。
ErrorResponse	錯誤回應。
ErrorResponseDetails	錯誤回應詳細數據。

ErrorRelatedResource

Object

錯誤相關的資源詳細資料物件。

名稱	類型	Description
resourceId	string	發生錯誤的資源識別碼。
resourceType	string	發生錯誤的資源類型。

ErrorResponse

Object

錯誤回應。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message	string	錯誤的人類可讀取表示法。
moreDetails	ErrorResponseDetails[]	其他錯誤詳細數據的清單。
relatedResource	ErrorRelatedResource	錯誤相關的資源詳細數據。
requestId	string (uuid)	與錯誤相關聯的要求標識碼。

ErrorResponseDetails

Object

錯誤回應詳細數據。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message	string	錯誤的人類可讀取表示法。
relatedResource	ErrorRelatedResource	錯誤相關的資源詳細數據。