Admin - InformationProtection SetLabelsAsAdmin

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

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

Permissions

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

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

Tenant.ReadWrite.All

Ограничения

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

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

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

Ответы

Примеры

Example

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

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

{
  "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

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