Admin - InformationProtection RemoveLabelsAsAdmin
Удалите метки конфиденциальности из элементов Power BI (например, отчетов или панелей мониторинга) по идентификатору элемента.
Пример использования см. в разделе Установка или удаление меток конфиденциальности.
Разрешения
- Пользователь должен быть администратором Fabric.
- У пользователя администратора должно быть достаточно прав на использование для удаления меток.
Требуемая область
Tenant.ReadWrite.All
Ограничения
- Максимум 25 запросов в час.
- Каждый запрос может обновлять до 2000 элементов Power BI.
POST https://api.powerbi.com/v1.0/myorg/admin/informationprotection/removeLabels
Текст запроса
| Имя | Тип | Описание |
|---|---|---|
| dashboards |
Список уникальных идентификаторов панелей мониторинга |
|
| dataflows |
Список уникальных идентификаторов потоков данных |
|
| datasets |
Список уникальных идентификаторов наборов данных |
|
| reports |
Список уникальных идентификаторов отчетов |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 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 |
Уникальный идентификатор элемента Power BI в формате UUID. Идентификаторы панелей мониторинга, отчетов и потоков данных находятся в формате UUID, а идентификаторы наборов данных могут находиться в формате UUID или строковом формате. |
|
Artifact |
Уникальный идентификатор элемента Power BI в строковом или формате UUID. Идентификаторы панелей мониторинга, отчетов и потоков данных находятся в формате UUID, а идентификаторы наборов данных могут находиться в формате UUID или строковом формате. |
|
Change |
Состояние изменения уникального идентификатора и метки защиты информации для элемента Power BI |
|
Information |
Составной набор идентификаторов элементов Power BI для каждого типа элемента. Идентификаторы указывают, какие элементы Power BI требуют обновления метки защиты информации. |
|
Information |
Составная часть состояния изменения метки идентификации и защиты информации для одного или нескольких элементов Power BI, организованных по типу |
| status |
Состояние операции изменения метки защиты информации |
ArtifactId
Уникальный идентификатор элемента Power BI в формате UUID. Идентификаторы панелей мониторинга, отчетов и потоков данных находятся в формате UUID, а идентификаторы наборов данных могут находиться в формате UUID или строковом формате.
| Имя | Тип | Описание |
|---|---|---|
| id |
string (uuid) |
Идентификатор в формате UUID |
ArtifactStringId
Уникальный идентификатор элемента Power BI в строковом или формате UUID. Идентификаторы панелей мониторинга, отчетов и потоков данных находятся в формате UUID, а идентификаторы наборов данных могут находиться в формате UUID или строковом формате.
| Имя | Тип | Описание |
|---|---|---|
| id |
string |
Идентификатор в строковом или формате UUID |
ChangeLabelStatus
Состояние изменения уникального идентификатора и метки защиты информации для элемента Power BI
| Имя | Тип | Описание |
|---|---|---|
| id |
string |
Уникальный идентификатор элемента Power BI. Идентификатор находится в формате UUID для панелей мониторинга, отчетов и потоков данных; и в формате UUID или строкового формата для наборов данных. |
| status |
Состояние операции изменения метки защиты информации |
InformationProtectionArtifactsChangeLabel
Составной набор идентификаторов элементов Power BI для каждого типа элемента. Идентификаторы указывают, какие элементы Power BI требуют обновления метки защиты информации.
| Имя | Тип | Описание |
|---|---|---|
| dashboards |
Список уникальных идентификаторов панелей мониторинга |
|
| dataflows |
Список уникальных идентификаторов потоков данных |
|
| datasets |
Список уникальных идентификаторов наборов данных |
|
| reports |
Список уникальных идентификаторов отчетов |
InformationProtectionChangeLabelResponse
Составная часть состояния изменения метки идентификации и защиты информации для одного или нескольких элементов Power BI, организованных по типу
| Имя | Тип | Описание |
|---|---|---|
| dashboards |
Список с уникальным идентификатором и меткой защиты информации об изменении состояния одной или нескольких панелей мониторинга |
|
| dataflows |
Список, содержащий уникальный идентификатор и метку защиты информации, состояние изменения одного или нескольких потоков данных |
|
| datasets |
Список, содержащий уникальный идентификатор и метку защиты информации об изменении состояния одного или нескольких наборов данных. |
|
| reports |
Список с уникальным идентификатором и меткой защиты информации об изменении состояния одного или нескольких отчетов |
status
Состояние операции изменения метки защиты информации
| Значение | Описание |
|---|---|
| Failed |
Не удалось задать новую метку. Повторите попытку. |
| FailedToGetUsageRights |
Не удалось задать новую метку. Элемент Power BI имеет метку конфиденциальности с параметрами защиты, и Power BI не удалось убедиться, что пользователь имеет достаточные права на использование для изменения метки. |
| InsufficientUsageRights |
Не удалось задать новую метку. Элемент Power BI имеет метку конфиденциальности с параметрами защиты, а пользователь администратора (и делегированный пользователь, если он указан) не имеет достаточных прав на использование для изменения метки. |
| NotFound |
Идентификатор или метка элемента Power BI не найдена |
| Succeeded |
Метка элемента Power BI была изменена |