Admin - InformationProtection RemoveLabelsAsAdmin
アイテム ID によって Power BI アイテム (レポートやダッシュボードなど) から秘密度ラベルを削除します。
使用例については、「 秘密度ラベルの設定または削除」を参照してください。
Permissions
- ユーザーは Fabric 管理者である必要があります。
- 管理者ユーザーには、ラベルを削除するための十分な 使用権限 が必要です。
必要なスコープ
Tenant.ReadWrite.All
制限事項
- 1 時間あたり最大 25 個の要求。
- 各要求では、最大 2,000 個の Power BI 項目を更新できます。
POST https://api.powerbi.com/v1.0/myorg/admin/informationprotection/removeLabels要求本文
| 名前 | 型 | 説明 |
|---|---|---|
| dashboards |
一意のダッシュボード ID の一覧 |
|
| dataflows |
一意のデータフロー ID の一覧 |
|
| datasets |
一意のデータセット ID の一覧 |
|
| reports |
一意のレポート ID の一覧 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
[OK] |
例
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"
}
]
}応答のサンプル
{
"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"
}
]
}定義
| 名前 | 説明 |
|---|---|
|
Artifact |
UUID 形式の Power BI 項目の一意の ID。 ダッシュボード、レポート、およびデータフロー ID は UUID 形式で、データセット ID は UUID または文字列形式にすることができます。 |
|
Artifact |
文字列または UUID 形式の Power BI 項目の一意の ID。 ダッシュボード、レポート、およびデータフロー ID は UUID 形式で、データセット ID は UUID または文字列形式にすることができます。 |
|
Change |
Power BI 項目の一意の ID と情報保護ラベルの変更状態 |
|
Information |
各項目の種類の Power BI 項目 ID の複合。 ID は、情報保護ラベルの更新が必要な Power BI 項目を指定します。 |
|
Information |
種類別に整理された 1 つ以上の Power BI 項目の ID と情報保護ラベルの変更状態の複合 |
| status |
情報保護ラベル変更操作の状態 |
ArtifactId
UUID 形式の Power BI 項目の一意の ID。 ダッシュボード、レポート、およびデータフロー ID は UUID 形式で、データセット ID は UUID または文字列形式にすることができます。
| 名前 | 型 | 説明 |
|---|---|---|
| id |
string (uuid) |
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 |
情報保護ラベル変更操作の状態 |
InformationProtectionArtifactsChangeLabel
各項目の種類の Power BI 項目 ID の複合。 ID は、情報保護ラベルの更新が必要な Power BI 項目を指定します。
| 名前 | 型 | 説明 |
|---|---|---|
| dashboards |
一意のダッシュボード ID の一覧 |
|
| dataflows |
一意のデータフロー ID の一覧 |
|
| datasets |
一意のデータセット ID の一覧 |
|
| reports |
一意のレポート ID の一覧 |
InformationProtectionChangeLabelResponse
種類別に整理された 1 つ以上の Power BI 項目の ID と情報保護ラベルの変更状態の複合
| 名前 | 型 | 説明 |
|---|---|---|
| dashboards |
1 つ以上のダッシュボードの一意の ID と情報保護ラベルの変更状態を含むリスト |
|
| dataflows |
1 つ以上のデータフローの一意の ID と情報保護ラベルの変更状態を含むリスト |
|
| datasets |
1 つ以上のデータセットの一意の ID と情報保護ラベルの変更状態を含むリスト |
|
| reports |
1 つ以上のレポートの一意の ID と情報保護ラベルの変更状態を含むリスト |
status
情報保護ラベル変更操作の状態
| 値 | 説明 |
|---|---|
| Failed |
新しいラベルを設定できませんでした。 再試行してください。 |
| FailedToGetUsageRights |
新しいラベルを設定できませんでした。 Power BI 項目には保護設定を含む秘密度ラベルがあり、Power BI はユーザーがラベルを変更するための十分な使用権限を持っていることを確認できませんでした。 |
| InsufficientUsageRights |
新しいラベルを設定できませんでした。 Power BI 項目には保護設定を含む秘密度ラベルがあり、管理者ユーザー (および提供されている場合は委任されたユーザー) には、ラベルを変更するための十分な使用権限がありません。 |
| NotFound |
Power BI 項目 ID またはラベルが見つかりませんでした |
| Succeeded |
Power BI 項目ラベルが変更されました |