通过

Admin - InformationProtection RemoveLabelsAsAdmin

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

按项 ID 从 Power BI 项中删除敏感度标签（如报表或仪表板）。

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

Permissions

  • 用户必须是 Fabric 管理员。
  • 管理员用户必须具有足够的 使用权限 才能删除标签。

所需范围

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

示例请求

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

定义

名称 说明
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

Object

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

名称 类型 说明
id

string (uuid)

UUID 格式的 ID

ArtifactStringId

Object

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

名称 类型 说明
id

string

字符串或 UUID 格式的 ID

ChangeLabelStatus

Object

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

名称 类型 说明
id

string

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

status

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

InformationProtectionArtifactsChangeLabel

Object

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

名称 类型 说明
dashboards

ArtifactId[]

唯一仪表板 ID 的列表
dataflows

ArtifactId[]

唯一数据流 ID 的列表
datasets

ArtifactStringId[]

唯一数据集 ID 的列表
reports

ArtifactId[]

唯一报表 ID 的列表

InformationProtectionChangeLabelResponse

Object

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

名称 类型 说明
dashboards

ChangeLabelStatus[]

包含一个或多个仪表板的唯一 ID 和信息保护标签更改状态的列表
dataflows

ChangeLabelStatus[]

包含一个或多个数据流的唯一 ID 和信息保护标签更改状态的列表
datasets

ChangeLabelStatus[]

包含一个或多个数据集的唯一 ID 和信息保护标签更改状态的列表
reports

ChangeLabelStatus[]

包含一个或多个报表的唯一 ID 和信息保护标签更改状态的列表

status

枚举

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

值 说明
Failed

未能设置新标签。 请重试。
FailedToGetUsageRights

未能设置新标签。 Power BI 项具有具有保护设置的敏感度标签，并且 Power BI 无法验证用户是否有足够的使用权限来更改标签。
InsufficientUsageRights

未能设置新标签。 Power BI 项具有具有保护设置的敏感度标签，并且管理员用户（如果提供）没有足够的使用权限来更改标签。
NotFound

找不到 Power BI 项 ID 或标签
Succeeded

Power BI 项标签已更改