Sharing Links - Bulk Remove Sharing Links

參考

服務:: Admin

API 版本:: v1

備註

此 API 處於預覽狀態。

刪除指定網狀架構專案的所有組織共享連結。此動作無法復原。
此 API 支援長時間執行的作業（LRO）。

使用 LinksSharedToWholeOrganization PowerBI 管理員 REST API 取得透過組織共用連結共用的 Power BI 報表。

權限

呼叫端必須是網狀架構系統管理員。

必要的委派範圍

Tenant.ReadWrite.All

局限性

每分鐘最多10個要求。
每個要求都可以刪除最多 500 個網狀架構專案的組織共享連結。
僅支援Power BI報表。

Microsoft Entra 支援的身份識別

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

身份	支援
使用者	是的
服務主體和受控識別	是的

介面

POST https://api.fabric.microsoft.com/v1/admin/items/bulkRemoveSharingLinks

要求本文

名稱	必要	類型	Description
items	True	ItemInfo[]	項目清單。清單包含專案識別碼和類型。
sharingLinkType	True	SharingLinkType	指定每個 Fabric 專案需要刪除的共享連結類型。可能會隨著時間新增其他共用連結類型。

回應

名稱	類型	Description
200 OK	BulkRemoveSharingLinksResponse	要求成功完成。
202 Accepted		已接受要求。正在擷取定義。標題 Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	常見的錯誤碼：禁止 -呼叫端沒有呼叫 API 的許可權。

名稱

類型

Description

200 OK

BulkRemoveSharingLinksResponse

要求成功完成。

202 Accepted

已接受要求。正在擷取定義。

標題

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

常見的錯誤碼：

禁止 -呼叫端沒有呼叫 API 的許可權。

範例

範例要求

HTTP

POST https://api.fabric.microsoft.com/v1/admin/items/bulkRemoveSharingLinks

{
  "items": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542a",
      "type": "Report"
    },
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8b",
      "type": "Report"
    },
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542c",
      "type": "Report"
    },
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8f",
      "type": "Notebook"
    }
  ],
  "sharingLinkType": "OrgLink"
}

範例回覆

狀態碼:: 200

{
  "itemsRemoveSharingLinksStatus": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542a",
      "type": "Report",
      "status": "NotFound"
    },
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8b",
      "type": "Report",
      "status": "Failed"
    },
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542c",
      "type": "Report",
      "status": "Succeeded"
    },
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8f",
      "type": "Notebook",
      "status": "Succeeded"
    }
  ],
  "sharingLinkType": "OrgLink"
}

狀態碼:: 202

Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30

定義

名稱	Description
BulkRemoveSharingLinksRequest	需要移除所有共用連結和相關存取的項目清單。也接受要移除的共享連結類型。
BulkRemoveSharingLinksResponse	拿掉共享連結要求中 Fabric 專案的唯一標識碼和共用連結移除狀態清單
ErrorRelatedResource	錯誤相關的資源詳細資料物件。
ErrorResponse	錯誤回應。
ErrorResponseDetails	錯誤回應詳細數據。
ItemInfo	項目資訊，包括專案標識元和類型。
ItemRemoveSharingLinksStatus	網狀架構專案的唯一標識碼和共用連結移除狀態
ItemType	專案的型別。可能會隨著時間新增其他項目類型。
SharingLinksRemovalStatus	拿掉共享連結的狀態。可能會隨著時間新增其他 `SharingLinksRemovalStatus` 類型。
SharingLinkType	指定每個 Fabric 專案需要刪除的共享連結類型。可能會隨著時間新增其他共用連結類型。

BulkRemoveSharingLinksRequest

Object

需要移除所有共用連結和相關存取的項目清單。也接受要移除的共享連結類型。

名稱	類型	Description
items	ItemInfo[]	項目清單。清單包含專案識別碼和類型。
sharingLinkType	SharingLinkType	指定每個 Fabric 專案需要刪除的共享連結類型。可能會隨著時間新增其他共用連結類型。

BulkRemoveSharingLinksResponse

Object

拿掉共享連結要求中 Fabric 專案的唯一標識碼和共用連結移除狀態清單

名稱	類型	Description
itemsRemoveSharingLinksStatus	ItemRemoveSharingLinksStatus[]	專案清單會移除共用連結狀態。
sharingLinkType	SharingLinkType	指定針對每個 Fabric 專案要求刪除的共享連結類型。可能會隨著時間新增其他共用連結類型。

ErrorRelatedResource

Object

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

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

ErrorResponse

Object

錯誤回應。

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

ErrorResponseDetails

Object

錯誤回應詳細數據。

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

ItemInfo

Object

項目資訊，包括專案標識元和類型。

名稱	類型	Description
id	string (uuid)	UUID 格式的識別碼。
type	ItemType	項目類型。

ItemRemoveSharingLinksStatus

Object

網狀架構專案的唯一標識碼和共用連結移除狀態

名稱	類型	Description
id	string (uuid)	UUID 格式的識別碼。
status	SharingLinksRemovalStatus	共用連結移除作業的狀態。可能會隨著時間新增其他屬性類型。
type	ItemType	項目類型。

ItemType

列舉型別

專案的型別。可能會隨著時間新增其他項目類型。

值	Description
ApacheAirflowJob	ApacheAirflowJob。
CopyJob	複製作業。
Dashboard	PowerBI 儀錶板。
DataPipeline	數據管線。
Dataflow	數據流。
Datamart	PowerBI datamart。
DigitalTwinBuilder	DigitalTwinBuilder。
DigitalTwinBuilderFlow	數字對應項產生器流程。
Environment	環境。
Eventhouse	事件屋。
Eventstream	eventstream。
GraphQLApi	GraphQL 專案的 API。
KQLDashboard	KQL 儀錶板。
KQLDatabase	KQL 資料庫。
KQLQueryset	KQL 查詢集。
Lakehouse	湖屋
MLExperiment	機器學習實驗。
MLModel	機器學習模型。
MirroredAzureDatabricksCatalog	鏡像的 Azure databricks 目錄。
MirroredDatabase	鏡像資料庫。
MirroredWarehouse	鏡像倉儲。
MountedDataFactory	MountedDataFactory。
Notebook	筆記本。
PaginatedReport	PowerBI 編頁報表。
Reflex	反射。
Report	PowerBI 報表。
SQLDatabase	SQLDatabase。
SQLEndpoint	SQL 端點。
SemanticModel	PowerBI 語意模型。
SparkJobDefinition	Spark 作業定義。
VariableLibrary	VariableLibrary。
Warehouse	倉儲。
WarehouseSnapshot	倉儲快照集。

SharingLinksRemovalStatus

列舉型別

拿掉共享連結的狀態。可能會隨著時間新增其他 SharingLinksRemovalStatus 類型。

值	Description
NotFound	找不到網狀架構專案標識碼、標籤或類型。
Succeeded	已移除所有共享連結。

SharingLinkType

列舉型別

指定每個 Fabric 專案需要刪除的共享連結類型。可能會隨著時間新增其他共用連結類型。

值	Description
OrgLink	共用連結會授與整個組織的存取權（預設值）。

共用方式為

Sharing Links - Bulk Remove Sharing Links

權限

必要的委派範圍

局限性

Microsoft Entra 支援的身份識別

介面

要求本文

回應

範例

Remove sharing links for specific items example

範例要求

範例回覆

定義

BulkRemoveSharingLinksRequest

BulkRemoveSharingLinksResponse

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemInfo

ItemRemoveSharingLinksStatus

ItemType

SharingLinksRemovalStatus

SharingLinkType