Admin - WidelySharedArtifacts LinksSharedToWholeOrganization

Ссылка

Служба:: Power BI REST APIs

Версия API:: v1.0

Возвращает список отчетов Power BI, которые предоставляются всей организации через ссылки.

Разрешения

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

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

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

Ограничения

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

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

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

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

Параметры URI

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

Ответы

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

Примеры

Example

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

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

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

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

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite",
      "shareType": "Link",
      "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

Запись доступа пользователя для элемента 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

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

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

ArtifactType

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

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

PrincipalType

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

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

ServicePrincipalProfile

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

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

User

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

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

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