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


Admin - Imports GetImportsAsAdmin

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

Разрешения

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

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

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

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

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

Ограничения

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

GET https://api.powerbi.com/v1.0/myorg/admin/imports
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

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

Тип пользователя.