Admin - InformationProtection RemoveLabelsAsAdmin

リファレンス

Service:: Power BI REST APIs

API Version:: v1.0

アイテム ID によって Power BI アイテム (レポートやダッシュボードなど) から秘密度ラベルを削除します。

使用例については、「秘密度ラベルを設定または削除する」を参照してください。

アクセス許可

ユーザーは管理者権限 (Office 365グローバル管理者や Power BI サービス管理者など) を持っている必要があります。
管理者ユーザーには、ラベルを削除するための十分な使用権限が必要です。

必要なスコープ

Tenant.ReadWrite.All

制限事項

1 時間あたり最大 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	OK

例

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	種類別に整理された 1 つ以上の 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

種類別に整理された 1 つ以上の Power BI 項目の ID と情報保護ラベルの変更状態の複合

名前	型	説明
dashboards	ChangeLabelStatus[]	1 つ以上のダッシュボードの一意の ID と情報保護ラベルの変更状態を含むリスト
dataflows	ChangeLabelStatus[]	1 つ以上のデータフローの一意の ID と情報保護ラベルの変更状態を含むリスト
datasets	ChangeLabelStatus[]	1 つ以上のデータセットの一意の ID と情報保護ラベルの変更状態を含むリスト
reports	ChangeLabelStatus[]	1 つまたは複数のレポートの一意の ID と情報保護ラベルの変更状態を含むリスト

status

情報保護ラベル変更操作の状態

名前	型	説明
Failed	string	新しいラベルを設定できませんでした。もう一度お試しください。
FailedToGetUsageRights	string	新しいラベルを設定できませんでした。 Power BI 項目には保護設定を含む秘密度ラベルがあり、Power BI はユーザーがラベルを変更するための十分な使用権限を持っていることを確認できませんでした。
InsufficientUsageRights	string	新しいラベルを設定できませんでした。 Power BI 項目には保護設定を含む秘密度ラベルがあり、管理者ユーザー (および提供されている場合は委任されたユーザー) には、ラベルを変更するための十分な使用権限がありません。
NotFound	string	Power BI 項目 ID またはラベルが見つかりませんでした
Succeeded	string	Power BI 項目ラベルが変更されました

次の方法で共有