Admin - Imports GetImportsAsAdmin

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

Возвращает список импорта для организации.

Разрешения

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

При выполнении с предварительной проверкой подлинности службы в портал Azure приложение не должно иметь необходимых предопределений с согласием администратора для Power BI.

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

Tenant.Read.All или Tenant.ReadWrite.All

Применимо только при проверке подлинности с помощью стандартного маркера доступа делегированного администратора. Не должен присутствовать, если используется проверка подлинности через субъект-службу.

Ограничения

Максимум 200 запросов в час.

GET https://api.powerbi.com/v1.0/myorg/admin/imports

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/imports?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}

Параметры URI

Имя	В	Тип	Описание
$expand	query	string	Разворачивает связанные сущности в встроенном коде
$filter	query	string	Фильтрует результаты на основе логического условия.
$skip	query	integer int32	Пропускает первые n результатов
$top	query	integer int32	Возвращает только первые n результатов

Ответы

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

Примеры

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/imports

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
      "importState": "Succeeded",
      "createdDateTime": "2018-05-08T14:56:18.477Z",
      "updatedDateTime": "2018-05-08T14:56:18.477Z",
      "name": "SalesMarketing",
      "connectionType": "import",
      "source": "Upload",
      "datasets": [
        {
          "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
          "name": "SalesMarketing",
          "webUrl": "https://app.powerbi.com/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229"
        }
      ],
      "reports": [
        {
          "id": "5b218778-e7a5-4d73-8187-f10824047715",
          "name": "SalesMarketing",
          "webUrl": "https://app.powerbi.com/reports/5b218778-e7a5-4d73-8187-f10824047715",
          "embedUrl": "https://app.powerbi.com/reportEmbed?reportId=5b218778-e7a5-4d73-8187-f10824047715"
        }
      ]
    }
  ]
}

Определения

Имя	Описание
Dataset	Набор данных Power BI. API возвращает подмножество из следующего списка свойств набора данных. Подмножество зависит от вызываемого API, разрешений вызывающего объекта и доступности данных в базе данных Power BI.
DatasetQueryScaleOutSettings	Параметры масштабирования запроса для набора данных
DatasetUser	Запись права доступа пользователя Power BI для набора данных
DatasetUserAccessRight	Право доступа, которое пользователь имеет для набора данных (уровень разрешений)
DependentDataflow	Поток данных, зависящий от Power BI
Encryption	Сведения о шифровании для набора данных
EncryptionStatus	Состояние шифрования набора данных
Import	Объект импорта
Imports	Оболочка ответа OData для коллекции импорта Power BI
PrincipalType	Тип участника
Report	Отчет Power BI. API возвращает подмножество из следующего списка свойств отчета. Подмножество зависит от вызываемого API, разрешений вызывающего объекта и доступности данных в базе данных Power BI.
ReportUser	Запись права доступа пользователя Power BI для отчета
ReportUserAccessRight	Право доступа, которое пользователь имеет для отчета (уровень разрешений)
ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для решения Power BI Embedded мультитенантности.
Subscription	Подписка электронной почты на элемент Power BI (например, отчет или панель мониторинга)
SubscriptionUser	Пользователь подписки на электронную почту Power BI

Dataset

Набор данных Power BI. API возвращает подмножество из следующего списка свойств набора данных. Подмножество зависит от вызываемого API, разрешений вызывающего объекта и доступности данных в базе данных Power BI.

Имя	Тип	Описание
ContentProviderType	string	Тип поставщика контента для набора данных
CreateReportEmbedURL	string	URL-адрес внедрения отчета создания набора данных
CreatedDate	string	Дата и время создания набора данных
Encryption	Encryption	Сведения о шифровании набора данных. Применимо, только если `$expand` указан параметр .
IsEffectiveIdentityRequired	boolean	Требуется ли набору данных действующее удостоверение, которое необходимо отправить в вызове API GenerateToken .
IsEffectiveIdentityRolesRequired	boolean	Определяется ли безопасность на уровне строк в PBIX-файле Power BI. Если да, необходимо указать роль.
IsInPlaceSharingEnabled	boolean	Можно ли предоставить доступ к набору данных внешним пользователям для использования в их собственном клиенте
IsOnPremGatewayRequired	boolean	Требуется ли набору данных локальный шлюз данных
IsRefreshable	boolean	Является ли набор данных обновляемым или нет. Обновляемый набор данных Power BI — это набор данных, который обновлялся по крайней мере один раз или для которого существует допустимое расписание обновления.
QnaEmbedURL	string	URL-адрес внедрения набора данных Q&A
addRowsAPIEnabled	boolean	Позволяет ли набор данных добавлять новые строки
configuredBy	string	Владелец набора данных
description	string	Описание набора данных
id	string	Идентификатор набора данных
name	string	Имя набора данных
queryScaleOutSettings	DatasetQueryScaleOutSettings	Параметры масштабирования запроса для набора данных
targetStorageMode	string	Режим хранения набора данных
upstreamDataflows	DependentDataflow[]	Список всех потоков данных, от которые зависит этот элемент
users	DatasetUser[]	(Пустое значение) Сведения о доступе пользователя к набору данных. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Сведения о пользователях элемента Power BI (например, отчет или панель мониторинга) можно получить с помощью API получения набора данных в качестве Администратор API или API PostWorkspaceInfo с параметром `getArtifactUsers` .
webUrl	string	URL-адрес набора данных

DatasetQueryScaleOutSettings

Параметры масштабирования запроса для набора данных

Имя	Тип	Описание
autoSyncReadOnlyReplicas	boolean	Указывает, синхронизируется ли набор данных автоматически реплики только для чтения
maxReadOnlyReplicas	integer	Максимальное число реплик только для чтения для набора данных (0–64, –1 для автоматического числа реплик)

DatasetUser

Запись права доступа пользователя Power BI для набора данных

Имя	Тип	Описание
datasetUserAccessRight	DatasetUserAccessRight	Право доступа, которое пользователь имеет для набора данных (уровень разрешений)
displayName	string	Отображаемое имя субъекта
emailAddress	string	Адрес электронной почты пользователя
graphId	string	Идентификатор субъекта в Microsoft Graph. Доступно только для api-интерфейсов администратора.
identifier	string	Идентификатор субъекта
principalType	PrincipalType	Тип участника
profile	ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для решения Power BI Embedded мультитенантности.
userType	string	Тип пользователя.

DatasetUserAccessRight

Право доступа, которое пользователь имеет для набора данных (уровень разрешений)

Имя	Тип	Описание
None	string	Удаляет разрешение на содержимое в наборе данных.
Read	string	Предоставляет доступ на чтение содержимого в наборе данных.
ReadExplore	string	Предоставляет доступ на чтение и просмотр к содержимому в наборе данных.
ReadReshare	string	Предоставляет доступ для чтения и повторного доступа к содержимому в наборе данных.
ReadReshareExplore	string	Предоставляет доступ на чтение, повторное предоставление общего доступа и просмотр к содержимому в наборе данных
ReadWrite	string	Предоставляет доступ на чтение и запись к содержимому в наборе данных.
ReadWriteExplore	string	Предоставляет доступ на чтение, запись и просмотр содержимого в наборе данных
ReadWriteReshare	string	Предоставляет доступ для чтения, записи и повторного доступа к содержимому в наборе данных.
ReadWriteReshareExplore	string	Предоставляет доступ для чтения, записи, повторного доступа и просмотра к содержимому в наборе данных.

DependentDataflow

Поток данных, зависящий от Power BI

Имя	Тип	Описание
groupId	string	Идентификатор целевой группы
targetDataflowId	string	Идентификатор целевого потока данных

Encryption

Сведения о шифровании для набора данных

Имя	Тип	Описание
EncryptionStatus	EncryptionStatus	Состояние шифрования набора данных

EncryptionStatus

Состояние шифрования набора данных

Имя	Тип	Описание
InSyncWithWorkspace	string	Шифрование поддерживается и синхронизируется с параметрами шифрования.
NotInSyncWithWorkspace	string	Шифрование поддерживается, но не синхронизируется с параметрами шифрования
NotSupported	string	Шифрование не поддерживается для этого набора данных
Unknown	string	Состояние шифрования неизвестно из-за повреждения набора данных

Import

Объект импорта

Имя	Тип	Описание
createdDateTime	string	Дата и время создания импорта
datasets	Dataset[]	Наборы данных, связанные с этим импортом
id	string	Идентификатор импорта
importState	enum: Failed Publishing Succeeded	Состояние отправки импорта
name	string	Имя импорта
reports	Report[]	Отчеты, связанные с этим импортом
updatedDateTime	string	Импорт даты и времени последнего обновления

Imports

Оболочка ответа OData для коллекции импорта Power BI

Имя	Тип	Описание
odata.context	string	Контекст OData
value	Import[]	Коллекция импорта

PrincipalType

Тип участника

Имя	Тип	Описание
App	string	Тип субъекта-службы
Group	string	Тип участника группы
None	string	Нет типа субъекта. Используйте для доступа на уровне всей организации.
User	string	Тип участника-пользователя

Report

Отчет Power BI. API возвращает подмножество из следующего списка свойств отчета. Подмножество зависит от вызываемого API, разрешений вызывающего объекта и доступности данных в базе данных Power BI.

Имя	Тип	Описание
appId	string	Идентификатор приложения, возвращаемый только в том случае, если отчет принадлежит приложению.
datasetId	string	Идентификатор набора данных отчета
description	string	Описание отчета
embedUrl	string	URL-адрес внедрения отчета
id	string	Идентификатор отчета
isOwnedByMe	boolean	Определите, создан ли отчет текущим пользователем.
name	string	Имя отчета
originalReportId	string	Фактический идентификатор отчета при публикации рабочей области в виде приложения.
reportType	enum: PaginatedReport PowerBIReport	Тип отчета
subscriptions	Subscription[]	(Пустое значение) Сведения о подписке для элемента Power BI (например, отчета или панели мониторинга). Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Сведения о подписке для отчета Power BI можно получить с помощью команды Получить подписки на отчеты как Администратор вызов API.
users	ReportUser[]	(Пустое значение) Сведения о доступе пользователей к отчету Power BI. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Вы можете получить сведения о пользователях в отчете Power BI с помощью метода Get Report Users as Администратор API или вызова API PostWorkspaceInfo с параметром `getArtifactUsers` .
webUrl	string	URL-адрес отчета в интернете

ReportUser

Запись права доступа пользователя Power BI для отчета

Имя	Тип	Описание
displayName	string	Отображаемое имя субъекта
emailAddress	string	Адрес электронной почты пользователя
graphId	string	Идентификатор субъекта в Microsoft Graph. Доступно только для api-интерфейсов администратора.
identifier	string	Идентификатор субъекта
principalType	PrincipalType	Тип субъекта
profile	ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.
reportUserAccessRight	ReportUserAccessRight	Право доступа, которое пользователь имеет для отчета (уровень разрешений)
userType	string	Тип пользователя.

ReportUserAccessRight

Право доступа, которое пользователь имеет для отчета (уровень разрешений)

Имя	Тип	Описание
None	string	Нет разрешений на содержимое в отчете
Owner	string	Предоставляет доступ на чтение, запись и повторное предоставление общего доступа к содержимому в отчете
Read	string	Предоставляет доступ на чтение к содержимому в отчете
ReadCopy	string	Предоставляет доступ на чтение и копирование содержимого в отчете
ReadReshare	string	Предоставляет доступ на чтение и повторное предоставление общего доступа к содержимому в отчете
ReadWrite	string	Предоставляет доступ на чтение и запись к содержимому в отчете

ServicePrincipalProfile

Профиль субъекта служба Power BI. Применимо только для решения Power BI Embedded мультитенантности.

Имя	Тип	Описание
displayName	string	Имя профиля субъекта-службы
id	string	Идентификатор профиля субъекта-службы

Subscription

Подписка электронной почты на элемент Power BI (например, отчет или панель мониторинга)

Имя	Тип	Описание
artifactDisplayName	string	Имя подписанного элемента Power BI (например, отчета или панели мониторинга)
artifactId	string	Идентификатор элемента Power BI с подпиской (например, отчета или панели мониторинга)
artifactType	string	Тип элемента Power BI (например `Report`, , `Dashboard`или `Dataset`)
attachmentFormat	string	Формат отчета, вложенного в подписку электронной почты
endDate	string	Дата и время окончания подписки электронной почты
frequency	string	Частота подписки на электронную почту
id	string	Идентификатор подписки
isEnabled	boolean	Включена ли подписка на электронную почту
linkToContent	boolean	Существует ли ссылка на подписку в подписке электронной почты
previewImage	boolean	Существует ли снимок экрана отчета в подписке электронной почты
startDate	string	Дата и время начала подписки на электронную почту
subArtifactDisplayName	string	Имя страницы подписанного элемента Power BI, если это отчет.
title	string	Имя приложения
users	SubscriptionUser[]	Сведения о каждом подписчике электронной почты. При использовании вызова API Get User Subscriptions As Администратор возвращаемым значением является пустой массив (null). Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Сведения о подписке можно получить в отчете или на панели мониторинга Power BI с помощью команд API Получение подписок на отчеты как Администратор или Получение подписок панели мониторинга как Администратор вызовов API.

SubscriptionUser

Пользователь подписки на электронную почту Power BI

Имя	Тип	Описание
displayName	string	Отображаемое имя участника
emailAddress	string	Адрес электронной почты пользователя
graphId	string	Идентификатор участника в Microsoft Graph. Доступно только для api-интерфейсов администратора.
identifier	string	Идентификатор субъекта
principalType	PrincipalType	Тип участника
profile	ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для решения Power BI Embedded мультитенантности.
userType	string	Тип пользователя.

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