次の方法で共有


Admin - InformationProtection RemoveLabelsAsAdmin

アイテム 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
{
  "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"
    }
  ]
}

定義

名前 説明
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 項目ラベルが変更されました