共用方式為


Admin - InformationProtection RemoveLabelsAsAdmin

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

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

權限

  • 使用者必須具有系統管理員許可權 (,例如Office 365全域管理員或 Power BI 服務管理員) 。
  • 系統管理員使用者必須有足夠的 許可權 才能刪除標籤。

必要範圍

Tenant.ReadWrite.All

限制

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

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

要求本文

名稱 類型 Description
dashboards

ArtifactId[]

唯一儀表板識別碼的清單

dataflows

ArtifactId[]

唯一資料流程識別碼的清單

datasets

ArtifactStringId[]

唯一資料集識別碼的清單

reports

ArtifactId[]

唯一報表識別碼的清單

回應

名稱 類型 Description
200 OK

InformationProtectionChangeLabelResponse

確定

範例

Example

Sample Request

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"
    }
  ]
}

Sample Response

{
  "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 專案的唯一識別碼。 儀表板、報表和資料流程識別碼為 UUID 格式,而資料集識別碼可以是 UUID 或字串格式。

ArtifactStringId

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

ChangeLabelStatus

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

InformationProtectionArtifactsChangeLabel

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

InformationProtectionChangeLabelResponse

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

status

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

ArtifactId

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

名稱 類型 Description
id

string

UUID 格式的識別碼

ArtifactStringId

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

名稱 類型 Description
id

string

字串或 UUID 格式的識別碼

ChangeLabelStatus

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

名稱 類型 Description
id

string

Power BI 專案的唯一識別碼。 識別碼為儀表板、報表和資料流程的 UUID 格式;和 ,以 UUID 或資料集的字串格式表示。

status

status

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

InformationProtectionArtifactsChangeLabel

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

名稱 類型 Description
dashboards

ArtifactId[]

唯一儀表板識別碼的清單

dataflows

ArtifactId[]

唯一資料流程識別碼的清單

datasets

ArtifactStringId[]

唯一資料集識別碼的清單

reports

ArtifactId[]

唯一報表識別碼的清單

InformationProtectionChangeLabelResponse

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

名稱 類型 Description
dashboards

ChangeLabelStatus[]

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

dataflows

ChangeLabelStatus[]

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

datasets

ChangeLabelStatus[]

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

reports

ChangeLabelStatus[]

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

status

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

名稱 類型 Description
Failed

string

無法設定新的標籤。 請再試一次。

FailedToGetUsageRights

string

無法設定新的標籤。 Power BI 專案具有具有保護設定的敏感度標籤,且 Power BI 無法確認使用者有足夠的許可權可變更標籤。

InsufficientUsageRights

string

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

NotFound

string

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

Succeeded

string

Power BI 專案標籤已變更