Admin - InformationProtection RemoveLabelsAsAdmin

参考

Service:: Power BI REST APIs

API Version:: v1.0

从 Power BI 项中删除敏感度标签 (，例如按项 ID) 报表或仪表板。

有关使用示例，请参阅 “设置或删除敏感度标签”。

权限

用户必须具有管理员权限 (，例如Office 365全局管理员或 Power BI 服务管理员) 。
管理员用户必须具有足够的使用权限才能删除标签。

所需范围

Tenant.ReadWrite.All

限制

每小时最多 25 个请求。
每个请求最多可以更新 2，000 个 Power BI 项。

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

请求正文

名称	类型	说明
dashboards	ArtifactId[]	唯一仪表板 ID 的列表
dataflows	ArtifactId[]	唯一数据流 ID 的列表
datasets	ArtifactStringId[]	唯一数据集 ID 的列表
reports	ArtifactId[]	唯一报表 ID 的列表

响应

名称	类型	说明
200 OK	InformationProtectionChangeLabelResponse	确定

示例

Example

Sample Request

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

Request Body

{
  "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

Status code:: 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"
    }
  ]
}

定义

名称	说明
ArtifactId	采用 UUID 格式的 Power BI 项的唯一 ID。仪表板、报表和数据流 ID 采用 UUID 格式，数据集 ID 可以采用 UUID 或字符串格式。
ArtifactStringId	字符串或 UUID 格式的 Power BI 项的唯一 ID。仪表板、报表和数据流 ID 采用 UUID 格式，数据集 ID 可以采用 UUID 或字符串格式。
ChangeLabelStatus	Power BI 项的唯一 ID 和信息保护标签更改状态
InformationProtectionArtifactsChangeLabel	每个项类型的 Power BI 项 ID 的组合。 ID 指定哪些 Power BI 项需要信息保护标签更新。
InformationProtectionChangeLabelResponse	按类型组织的一个或多个 Power BI 项的 ID 和信息保护标签更改状态的组合
status	信息保护标签更改操作的状态

ArtifactId

采用 UUID 格式的 Power BI 项的唯一 ID。仪表板、报表和数据流 ID 采用 UUID 格式，数据集 ID 可以采用 UUID 或字符串格式。

名称	类型	说明
id	string	UUID 格式的 ID

ArtifactStringId

字符串或 UUID 格式的 Power BI 项的唯一 ID。仪表板、报表和数据流 ID 采用 UUID 格式，数据集 ID 可以采用 UUID 或字符串格式。

名称	类型	说明
id	string	字符串或 UUID 格式的 ID

ChangeLabelStatus

Power BI 项的唯一 ID 和信息保护标签更改状态

名称	类型	说明
id	string	Power BI 项的唯一 ID。 ID 采用仪表板、报表和数据流的 UUID 格式;以及数据集的 UUID 或字符串格式。
status	status	信息保护标签更改操作的状态

InformationProtectionArtifactsChangeLabel

每个项类型的 Power BI 项 ID 的组合。 ID 指定哪些 Power BI 项需要信息保护标签更新。

名称	类型	说明
dashboards	ArtifactId[]	唯一仪表板 ID 的列表
dataflows	ArtifactId[]	唯一数据流 ID 的列表
datasets	ArtifactStringId[]	唯一数据集 ID 的列表
reports	ArtifactId[]	唯一报表 ID 的列表

InformationProtectionChangeLabelResponse

按类型组织的一个或多个 Power BI 项的 ID 和信息保护标签更改状态的组合

名称	类型	说明
dashboards	ChangeLabelStatus[]	包含一个或多个仪表板的唯一 ID 和信息保护标签更改状态的列表
dataflows	ChangeLabelStatus[]	包含一个或多个数据流的唯一 ID 和信息保护标签更改状态的列表
datasets	ChangeLabelStatus[]	包含一个或多个数据集的唯一 ID 和信息保护标签更改状态的列表
reports	ChangeLabelStatus[]	包含一个或多个报表的唯一 ID 和信息保护标签更改状态的列表

status

信息保护标签更改操作的状态

名称	类型	说明
Failed	string	未能设置新标签。请重试。
FailedToGetUsageRights	string	未能设置新标签。 Power BI 项具有具有保护设置的敏感度标签，并且 Power BI 无法验证用户是否具有足够的使用权限来更改标签。
InsufficientUsageRights	string	未能设置新标签。 Power BI 项具有具有保护设置的敏感度标签，并且管理员用户 (和委派用户（如果提供) 没有足够的使用权限来更改标签）。
NotFound	string	找不到 Power BI 项 ID 或标签
Succeeded	string	Power BI 项标签已更改