Admin - InformationProtection SetLabelsAsAdmin

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

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

Чтобы задать метку конфиденциальности с помощью этого API, пользователь администратора или делегированный пользователь (если он указан) должен включить метку в политику меток. Пример использования см. в разделе "Установка и удаление меток конфиденциальности".

Разрешения

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

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

Tenant.ReadWrite.All

Ограничения

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

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

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

Имя	Обязательно	Тип	Описание
artifacts	True	InformationProtectionArtifactsChangeLabel	Составной набор идентификаторов элементов Power BI для каждого типа элемента
labelId	True	string	Идентификатор метки, который должен находиться в политике меток пользователя.
assignmentMethod		assignmentMethod	Указывает, задана ли назначенная метка автоматическим процессом или вручную.
delegatedUser		DelegatedUser	Делегированные сведения о пользователе. Делегированный пользователь — это пользователь в организации, администратор которой устанавливает метку от имени пользователя. Хотя администратор задает метку, делегированный пользователь помечается как издатель меток.

Ответы

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

Примеры

Example

Sample Request

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

Request Body

{
  "artifacts": {
    "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"
      }
    ]
  },
  "labelId": "fe472f5e-636e-4c10-a1c6-7e9edc0b542p",
  "assignmentMethod": "Standard",
  "delegatedUser": {
    "emailAddress": "john@contoso.com"
  }
}

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

ArtifactId

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

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

ArtifactStringId

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

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

assignmentMethod

Указывает, задана ли назначенная метка автоматическим процессом или вручную.

Имя	Тип	Описание
Priviledged	string	Метка была задана вручную
Standard	string	Метка была задана автоматическим процессом (значением по умолчанию)

ChangeLabelStatus

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

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

DelegatedUser

Делегированные сведения о пользователе. Пользователь должен быть существующим пользователем в Power BI и Azure AAD и должен войти в Power BI в течение последних трех месяцев.

Имя	Тип	Описание
emailAddress	string	Адрес электронной почты делегированного пользователя

InformationProtectionArtifactsChangeLabel

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

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

InformationProtectionChangeLabelDetails

Состав данных меток, необходимых для обновления метки защиты информации

Имя	Тип	Описание
artifacts	InformationProtectionArtifactsChangeLabel	Составной набор идентификаторов элементов Power BI для каждого типа элемента
assignmentMethod	assignmentMethod	Указывает, задана ли назначенная метка автоматическим процессом или вручную.
delegatedUser	DelegatedUser	Делегированные сведения о пользователе. Делегированный пользователь — это пользователь в организации, администратор которой устанавливает метку от имени пользователя. Хотя администратор задает метку, делегированный пользователь помечается как издатель меток.
labelId	string	Идентификатор метки, который должен находиться в политике меток пользователя.

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 была изменена

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