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

ArtifactId[]

Список уникальных идентификаторов панелей мониторинга

dataflows

ArtifactId[]

Список уникальных идентификаторов потоков данных

datasets

ArtifactStringId[]

Список уникальных идентификаторов наборов данных

reports

ArtifactId[]

Список уникальных идентификаторов отчетов

Ответы

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

InformationProtectionChangeLabelResponse

ХОРОШО

Примеры

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"
    }
  ]
}

Определения

Имя Описание
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)

Идентификатор в формате 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

Не удалось задать новую метку. Повторите попытку.

FailedToGetUsageRights

Не удалось задать новую метку. Элемент Power BI имеет метку конфиденциальности с параметрами защиты, и Power BI не удалось убедиться, что пользователь имеет достаточные права на использование для изменения метки.

InsufficientUsageRights

Не удалось задать новую метку. Элемент Power BI имеет метку конфиденциальности с параметрами защиты, а пользователь администратора (и делегированный пользователь, если он указан) не имеет достаточных прав на использование для изменения метки.

NotFound

Идентификатор или метка элемента Power BI не найдена

Succeeded

Метка элемента Power BI была изменена