共用方式為

Admin - InformationProtection RemoveLabelsAsAdmin

服務:
Power BI REST APIs
API 版本:
v1.0

依專案識別碼從 Power BI 專案 （例如報表或儀表板） 移除敏感度標籤。

如需使用範例，請參閱 設定或移除敏感度標籤。

權限

  • 使用者必須是 Fabric 系統管理員。
  • 管理員使用者必須具有足夠的 使用權限 才能刪除標籤。

必要範圍

租戶.ReadWrite.All

局限性

  • 每小時最多 25 個請求。
  • 每個要求最多可以更新 2,000 個 Power BI 專案。 

POST https://api.powerbi.com/v1.0/myorg/admin/informationprotection/removeLabels

要求本文

名稱 類型 Description
dashboards

ArtifactId[]

唯一儀表板 ID 清單
dataflows

ArtifactId[]

唯一資料流程ID清單
datasets

ArtifactStringId[]

唯一資料集 ID 清單
reports

ArtifactId[]

唯一報表 ID 清單

回應

名稱 類型 Description
200 OK

InformationProtectionChangeLabelResponse

OK

範例

Example

範例要求

POST https://api.powerbi.com/v1.0/myorg/admin/informationprotection/removeLabels
要求本文
{
  "dashboards": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542a"
    },
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8b"
    }
  ],
  "reports": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542c"
    }
  ],
  "datasets": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542e"
    },
    {
      "id": "myDatabaseName"
    }
  ],
  "dataflows": [
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8g"
    }
  ]
}

範例回覆

狀態碼:
200 
{
  "dashboards": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542a",
      "status": "NotFound"
    },
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8b",
      "status": "Failed"
    }
  ],
  "reports": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542c",
      "status": "Succeeded"
    }
  ],
  "datasets": [
    {
      "id": "fe472f5e-636e-4c10-a1c6-7e9edc0b542e",
      "status": "InsufficientUsageRights"
    },
    {
      "id": "myDatabaseName",
      "status": "FailedToGetUsageRights"
    }
  ],
  "dataflows": [
    {
      "id": "476fcafe-b514-495d-b13f-ca9a4f0b1d8g",
      "status": "Succeeded"
    }
  ]
}

定義

名稱 Description
ArtifactId

UUID 格式的 Power BI 專案的唯一識別碼。 儀表板、報表和資料流程ID是UUID格式，資料集ID可以是UUID或字串格式。
ArtifactStringId

字串或 UUID 格式的 Power BI 專案的唯一識別碼。 儀表板、報表和資料流程ID是UUID格式，資料集ID可以是UUID或字串格式。
ChangeLabelStatus

Power BI 專案的唯一識別碼和資訊保護標籤變更狀態
InformationProtectionArtifactsChangeLabel

每個項目類型的 Power BI 項目識別碼複合。 識別碼會指定哪些 Power BI 專案需要資訊保護標籤更新。
InformationProtectionChangeLabelResponse

依類型組織的一或多個 Power BI 專案的識別碼和資訊保護標籤變更狀態的複合
status

資訊保護標籤變更作業的狀態

ArtifactId

Object

UUID 格式的 Power BI 專案的唯一識別碼。 儀表板、報表和資料流程ID是UUID格式，資料集ID可以是UUID或字串格式。

名稱 類型 Description
id

string (uuid)

UUID 格式的 ID

ArtifactStringId

Object

字串或 UUID 格式的 Power BI 專案的唯一識別碼。 儀表板、報表和資料流程ID是UUID格式，資料集ID可以是UUID或字串格式。

名稱 類型 Description
id

string

字串或UUID格式的ID

ChangeLabelStatus

Object

Power BI 專案的唯一識別碼和資訊保護標籤變更狀態

名稱 類型 Description
id

string

Power BI 專案的唯一識別碼。 ID採用儀表板、報表和資料流的UUID格式;以及資料集的 UUID 或字串格式。
status

status

資訊保護標籤變更作業的狀態

InformationProtectionArtifactsChangeLabel

Object

每個項目類型的 Power BI 項目識別碼複合。 識別碼會指定哪些 Power BI 專案需要資訊保護標籤更新。

名稱 類型 Description
dashboards

ArtifactId[]

唯一儀表板 ID 清單
dataflows

ArtifactId[]

唯一資料流程ID清單
datasets

ArtifactStringId[]

唯一資料集 ID 清單
reports

ArtifactId[]

唯一報表 ID 清單

InformationProtectionChangeLabelResponse

Object

依類型組織的一或多個 Power BI 專案的識別碼和資訊保護標籤變更狀態的複合

名稱 類型 Description
dashboards

ChangeLabelStatus[]

包含一或多個儀表板的唯一 ID 和資訊保護標籤變更狀態的清單
dataflows

ChangeLabelStatus[]

包含一或多個資料流程的唯一識別碼和資訊保護標籤變更狀態的清單
datasets

ChangeLabelStatus[]

包含一或多個資料集的唯一 ID 和資訊保護標籤變更狀態的清單
reports

ChangeLabelStatus[]

包含一或多個報告的唯一識別碼和資訊保護標籤變更狀態的清單

status

列舉型別

資訊保護標籤變更作業的狀態

值 Description
Failed

無法設定新標籤。 請重試。
FailedToGetUsageRights

無法設定新標籤。 Power BI 專案具有具有保護設定的敏感度標籤，而 Power BI 無法確認使用者有足夠的使用權限來變更標籤。
InsufficientUsageRights

無法設定新標籤。 Power BI 專案具有具有保護設定的敏感度標籤，而系統管理員使用者 （和委派的使用者，如果提供） 沒有足夠的使用權限來變更標籤。
NotFound

找不到 Power BI 專案識別碼或標籤
Succeeded

Power BI 專案標籤已變更