Admin - InformationProtection RemoveLabelsAsAdmin

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

Удаление меток конфиденциальности из элементов Power BI (например, отчетов или панелей мониторинга) по идентификатору элемента.

Пример использования см. в разделе "Установка или удаление меток конфиденциальности".

Разрешения

Пользователь должен иметь права администратора (например, Office 365 глобального администратора или администратора службы Power BI).
Пользователь администратора должен иметь достаточные права на использование для удаления меток.

Требуемая область

Tenant.ReadWrite.All

Ограничения

Не более 25 запросов в час.
Каждый запрос может обновлять до 2000 элементов Power BI.

POST https://api.powerbi.com/v1.0/myorg/admin/informationprotection/removeLabels

Текст запроса

Имя	Тип	Описание
dashboards	ArtifactId[]	Список уникальных идентификаторов панелей мониторинга
dataflows	ArtifactId[]	Список уникальных идентификаторов потоков данных
datasets	ArtifactStringId[]	Список уникальных идентификаторов наборов данных
reports	ArtifactId[]	Список уникальных идентификаторов отчетов

Ответы

Имя	Тип	Описание
200 OK	InformationProtectionChangeLabelResponse	ОК

Примеры

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	Уникальный идентификатор элемента Power BI в формате UUID. Идентификаторы панелей мониторинга, отчетов и потоков данных имеют формат UUID, а идентификаторы наборов данных могут быть в формате UUID или строк.
ArtifactStringId	Уникальный идентификатор элемента Power BI в строковом или формате UUID. Идентификаторы панелей мониторинга, отчетов и потоков данных имеют формат UUID, а идентификаторы наборов данных могут быть в формате UUID или строк.
ChangeLabelStatus	Состояние изменения уникального идентификатора и метки защиты информации для элемента Power BI
InformationProtectionArtifactsChangeLabel	Составной набор идентификаторов элементов Power BI для каждого типа элемента. Идентификаторы указывают, какие элементы Power BI требуют обновления метки защиты информации.
InformationProtectionChangeLabelResponse	Составная часть состояния изменения идентификатора и метки защиты информации для одного или нескольких элементов Power BI, упорядоченных по типу
status	Состояние операции изменения метки защиты информации

ArtifactId

Уникальный идентификатор элемента Power BI в формате UUID. Идентификаторы панелей мониторинга, отчетов и потоков данных имеют формат UUID, а идентификаторы наборов данных могут быть в формате UUID или строк.

Имя	Тип	Описание
id	string	Идентификатор в формате UUID

ArtifactStringId

Уникальный идентификатор элемента Power BI в строковом или формате UUID. Идентификаторы панелей мониторинга, отчетов и потоков данных имеют формат UUID, а идентификаторы наборов данных могут быть в формате UUID или строк.

Имя	Тип	Описание
id	string	Идентификатор в строковом или формате UUID

ChangeLabelStatus

Состояние изменения уникального идентификатора и метки защиты информации для элемента Power BI

Имя	Тип	Описание
id	string	Уникальный идентификатор элемента Power BI. Идентификатор имеет формат UUID для панелей мониторинга, отчетов и потоков данных; и в UUID или строковом формате для наборов данных.
status	status	Состояние операции изменения метки защиты информации

InformationProtectionArtifactsChangeLabel

Составной набор идентификаторов элементов Power BI для каждого типа элемента. Идентификаторы указывают, какие элементы Power BI требуют обновления метки защиты информации.

Имя	Тип	Описание
dashboards	ArtifactId[]	Список уникальных идентификаторов панелей мониторинга
dataflows	ArtifactId[]	Список уникальных идентификаторов потоков данных
datasets	ArtifactStringId[]	Список уникальных идентификаторов наборов данных
reports	ArtifactId[]	Список уникальных идентификаторов отчетов

InformationProtectionChangeLabelResponse

Составная часть состояния изменения идентификатора и метки защиты информации для одного или нескольких элементов Power BI, упорядоченных по типу

Имя	Тип	Описание
dashboards	ChangeLabelStatus[]	Список, содержащий уникальный идентификатор и метку защиты информации, состояние изменения состояния одной или нескольких панелей мониторинга
dataflows	ChangeLabelStatus[]	Список, содержащий уникальный идентификатор и метку защиты информации, состояние изменения состояния одного или нескольких потоков данных
datasets	ChangeLabelStatus[]	Список, содержащий уникальный идентификатор и метку защиты информации, состояние изменения состояния одного или нескольких наборов данных
reports	ChangeLabelStatus[]	Список, содержащий уникальный идентификатор и метку защиты информации, состояние изменения состояния одного или нескольких отчетов

status

Состояние операции изменения метки защиты информации

Имя	Тип	Описание
Failed	string	Не удалось задать новую метку. Повторите попытку.
FailedToGetUsageRights	string	Не удалось задать новую метку. Элемент Power BI имеет метку конфиденциальности с параметрами защиты, и Power BI не удалось убедиться, что у пользователя есть достаточные права на использование для изменения метки.
InsufficientUsageRights	string	Не удалось задать новую метку. Элемент Power BI имеет метку конфиденциальности с параметрами защиты, а администратор (и делегированный пользователь, если он предоставлен) не имеет достаточных прав на использование для изменения метки.
NotFound	string	Идентификатор или метка элемента Power BI не найдены
Succeeded	string	Метка элемента Power BI была изменена

Поделиться через