Admin - WidelySharedArtifacts PublishedToWeb

Служба:

Power BI REST APIs

Версия API:

v1.0

Возвращает список элементов Power BI (например, отчетов или панелей мониторинга), опубликованных в Интернете.

Permissions

• Пользователь должен быть администратором Fabric или пройти проверку подлинности с помощью субъекта-службы.
• Поддерживаются делегированные разрешения.

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

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

Ограничения

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

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

С использованием необязательных параметров:

GET https://api.powerbi.com/v1.0/myorg/admin/widelySharedArtifacts/publishedToWeb?continuationToken={continuationToken}

Параметры URI

Имя	В	Обязательно	Тип	Описание
continuationToken	query		string	Маркер, необходимый для получения следующего блока результирующий набор

Ответы

Имя	Тип	Описание
200 OK	ArtifactAccessResponse	ХОРОШО

Примеры

Example

Образец запроса

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

Пример ответа

Код состояния:

200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "None",
      "shareType": "PublishToWeb",
      "sharer": {
        "displayName": "John Nick",
        "emailAddress": "john@contoso.com",
        "identifier": "john@contoso.com",
        "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
        "principalType": "User"
      }
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/widelySharedArtifacts/linksSharedToWholeOrganization?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Определения

Имя	Описание
ArtifactAccessEntry	Запись доступа пользователя для элемента Power BI
ArtifactAccessResponse	Оболочка ответа OData для списка элементов Power BI (например, отчетов или панелей мониторинга), к которым пользователь может получить доступ.
ArtifactType	Тип артефакта
PrincipalType	Тип субъекта
ServicePrincipalProfile	Профиль субъекта-службы Power BI. Применимо только для решения Power BI Embedded с несколькими арендами.
User	Пользователь Power BI

ArtifactAccessEntry

Object

Запись доступа пользователя для элемента Power BI

Имя	Тип	Описание
accessRight	string	Право доступа, которое пользователь имеет для элемента Power BI
artifactId	string	Идентификатор элемента Power BI
artifactType	ArtifactType	Тип элемента Power BI
displayName	string	Отображаемое имя элемента Power BI
shareType	string	Тип предоставления доступа элементу Power BI. Доступно только для широко общих API артефактов.
sharer	User	Пользователь, который предоставил общий доступ к элементу Power BI. Доступно только для широко общих API артефактов.

ArtifactAccessResponse

Object

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

Имя	Тип	Описание
@odata.context	string
artifactAccessEntities	ArtifactAccessEntry[]	Список элементов Power BI, к которым пользователь может получить доступ
continuationToken	string	Маркер для следующего блока в результирующем наборе
continuationUri	string	Универсальный код ресурса (URI) следующего блока в результирующем наборе

ArtifactType

Перечисление

Тип артефакта

Значение	Описание
Report	Отчет Power BI
PaginatedReport	Отчет с разбивкой на страницы Power BI
Dashboard	Панель мониторинга Power BI
Dataset	Набор данных Power BI
Dataflow	Поток данных Power BI
PersonalGroup	Объект моей рабочей области
Group	Объект общей рабочей области версии 1
Workspace	Объект общей рабочей области
Capacity	Объект емкости
App	Приложения Power BI

PrincipalType

Перечисление

Тип субъекта

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

ServicePrincipalProfile

Object

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

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

User

Object

Пользователь Power BI

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