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

Admin - WorkspaceInfo GetScanResult

  • Ссылка
Служба:
Power BI REST APIs
Версия API:
v1.0

Возвращает результат сканирования для указанного сканирования.

Вызов API выполняется только после успешного вызова API GetScanStatus. Результат сканирования останется доступным в течение 24 часов.

Разрешения

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

При выполнении проверки подлинности субъекта-службы приложение не должно иметь необходимые разрешения администратора для power BI, заданные на портале Azure.

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

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

Важно только при проверке подлинности через стандартный делегированный маркер доступа администратора. Не должно присутствовать при использовании проверки подлинности через субъект-службу.

Ограничения

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

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/scanResult/{scanId}

Параметры URI

Имя В Обязательно Тип Описание
scanId
 path True

string

uuid

Идентификатор проверки, который включается в ответ из рабочих областей или администратора — WorkspaceInfo PostWorkspaceInfo вызов API, активировавший проверку.

Ответы

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

WorkspaceInfoResponse

ХОРОШО

Примеры

Example

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

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/scanResult/e7d03602-4873-4760-b37e-1563ef5358e3

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

Код состояния:
200 
{
  "workspaces": [
    {
      "id": "d507422c-8d6d-4361-ac7a-30074a8cd0a1",
      "name": "V2 shared",
      "type": "Workspace",
      "state": "Active",
      "isOnDedicatedCapacity": true,
      "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "defaultDatasetStorageFormat": "Small",
      "reports": [
        {
          "id": "c6d072d1-ed20-4b60-8329-16c4b934203b",
          "name": "CompositeModelParams-RLS",
          "datasetId": "132593c4-bf8d-4548-8f25-1ebb16a1613c",
          "createdDateTime": "2020-06-16T08:22:49.14",
          "modifiedDateTime": "2020-06-16T08:22:49.14",
          "modifiedBy": "john@contoso.com",
          "reportType": "PaginatedReport",
          "endorsementDetails": {
            "endorsement": "Certified",
            "certifiedBy": "john@contoso.com"
          },
          "sensitivityLabel": {
            "labelId": "85b38049-4259-43a2-8feb-244e222d96c0"
          },
          "users": [
            {
              "displayName": "John Nick",
              "emailAddress": "john@contoso.com",
              "appUserAccessRight": "ReadExplore",
              "identifier": "john@contoso.com",
              "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
              "principalType": "User"
            }
          ]
        }
      ],
      "dashboards": [
        {
          "id": "80814ece-9302-49e3-b6bc-bad2f7a86c1a",
          "displayName": "CompositeModelParamsDashboard",
          "isReadOnly": false,
          "tiles": [
            {
              "id": "e687cc21-5b32-48f5-8c5e-4b844f190579",
              "title": "CompositeModelParamsDashboard",
              "reportId": "c6d072d1-ed20-4b60-8329-16c4b934203b",
              "datasetId": "132593c4-bf8d-4548-8f25-1ebb16a1613c"
            }
          ],
          "sensitivityLabel": {
            "labelId": "d9b9581a-0594-4c39-81c5-91ddf40baeda"
          },
          "users": [
            {
              "displayName": "John Nick",
              "emailAddress": "john@contoso.com",
              "appUserAccessRight": "ReadExplore",
              "identifier": "john@contoso.com",
              "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
              "principalType": "User"
            }
          ]
        }
      ],
      "datasets": [
        {
          "id": "e7e8a355-e77b-4418-a7b8-ae5972fdaa03",
          "name": "ExportB",
          "tables": [
            {
              "name": "DW_Revenues",
              "columns": [
                {
                  "name": "RowNumber-2662979B-1795-4F74-8F37-6A1BA8059B61",
                  "dataType": "Int64",
                  "isHidden": true
                }
              ],
              "measures": [
                {
                  "name": "MyMeasure",
                  "expression": "CALCULATE(SELECTEDVALUE('DW_Revenues DW_RevenuesTestToBeDeleted'[Numbers])*10)",
                  "description": "My measure",
                  "isHidden": false
                }
              ],
              "isHidden": false,
              "description": "My table",
              "source": [
                {
                  "expression": "let\n    Source = Revenues,\n    Param = RevenuesParam\nin\n    Source"
                }
              ]
            }
          ],
          "relationships": [],
          "configuredBy": "john@contoso.com",
          "targetStorageMode": "Abf",
          "endorsementDetails": {
            "endorsement": "Certified",
            "certifiedBy": "john@contoso.com"
          },
          "expressions": [
            {
              "name": "Revenues",
              "description": "revenues",
              "expression": "let\n    Source = Sql.Database(\"sqlserver.database.windows.net\", \"DB\"),\n    RevenuesTable = Source{[Schema=\"DB_SCHEMA\",Item=\"DB_SCHEMA_ITEM\"]}[Data]\nin\n    RevenuesTable"
            },
            {
              "name": "RevenuesParam",
              "description": "revenues param",
              "expression": "\"revenues param value\" meta [IsParameterQuery=true, Type=\"Text\", IsParameterQueryRequired=true]"
            }
          ],
          "roles": [
            {
              "name": "Teams",
              "modelPermission": "Read",
              "members": [
                {
                  "memberName": "john@contoso.com",
                  "memberId": "ee96296b-fb71-4f65-a8af-c0ec5a7daced",
                  "memberType": "User",
                  "identityProvider": "AzureAD"
                },
                {
                  "memberName": "group@contoso.com",
                  "memberId": "0a1cdbc3-f82c-4001-8b96-be04ae9d25a3",
                  "memberType": "Group",
                  "identityProvider": "AzureAD"
                }
              ],
              "tablePermissions": [
                {
                  "name": "DW_Revenues DW_RevenuesTest",
                  "filterExpression": "[InTeams] = \"True\""
                }
              ]
            }
          ],
          "upstreamDataflows": [
            {
              "targetDataflowId": "a842dbb1-32ca-46b0-9648-498b2c2d5e38",
              "groupId": "b7416115-7421-42c0-b525-1505ce40d2f0"
            },
            {
              "targetDataflowId": "06898194-2eaf-4122-bacc-133db1f8585d",
              "groupId": "7263838d-80d7-4b8d-a1f6-50fc27e74a97"
            }
          ],
          "datasourceUsages": [
            {
              "datasourceInstanceId": "c79ad907-df19-43fe-a0f7-d9f365d67070"
            }
          ],
          "misconfiguredDatasourceUsages": [
            {
              "datasourceInstanceId": "80ec28bc-fe81-43ea-be52-a07a95cfbcab"
            }
          ],
          "sensitivityLabel": {
            "labelId": "bf3dc57d-d796-41c0-bbe9-a47f5ee3331e"
          },
          "users": [
            {
              "displayName": "John Nick",
              "emailAddress": "john@contoso.com",
              "appUserAccessRight": "ReadExplore",
              "identifier": "john@contoso.com",
              "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
              "principalType": "User"
            }
          ]
        }
      ],
      "dataflows": [
        {
          "objectId": "a842dbb1-32ca-46b0-9648-498b2c2d5e38",
          "name": "Azure SQL",
          "description": "Azure SQL dataflow",
          "configuredBy": "john@contoso.com",
          "modifiedBy": "john@contoso.com",
          "modifiedDateTime": "2020-06-16T08:27:47.783Z",
          "endorsementDetails": {
            "endorsement": "Certified",
            "certifiedBy": "john@contoso.com"
          },
          "datasourceUsages": [
            {
              "datasourceInstanceId": "c79ad907-df19-43fe-a0f7-d9f365d67070"
            }
          ],
          "misconfiguredDatasourceUsages": [
            {
              "datasourceInstanceId": "80ec28bc-fe81-43ea-be52-a07a95cfbcab"
            }
          ],
          "sensitivityLabel": {
            "labelId": "5c9f8c24-2a94-4fd2-a105-9a8b096c5af1"
          },
          "users": [
            {
              "displayName": "John Nick",
              "emailAddress": "john@contoso.com",
              "appUserAccessRight": "ReadExplore",
              "identifier": "john@contoso.com",
              "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
              "principalType": "User"
            }
          ]
        }
      ],
      "datamarts": [
        {
          "id": "9df8d63c-db5b-44c3-a8e3-9f8c8ec1eec2",
          "name": "MyDatamart",
          "description": "SQL datamart",
          "type": "Sql",
          "configuredBy": "john@contoso.com",
          "configuredById": "5c9f8c24-2a94-4fd2-a105-9a8b096cdsew",
          "modifiedBy": "john@contoso.com",
          "modifiedDateTime": "2020-06-16T08:27:47.783Z",
          "sensitivityLabel": {
            "labelId": "5c9f8c24-2a94-4fd2-a105-9a8b096c5af1"
          },
          "endorsementDetails": {
            "endorsement": "Certified",
            "certifiedBy": "john@contoso.com"
          },
          "UpstreamDataflows": [
            {
              "targetDataflowId": "5c9f8c24-2a94-34fd-a105-9a8b096c4555",
              "groupId": "5c9f8c24-4dsc-4fd2-a105-9a8b096c4fgt"
            }
          ],
          "datasourceUsages": [
            {
              "datasourceInstanceId": "c79ad907-df19-43fe-a0f7-d9f365d67070"
            }
          ],
          "Users": [
            {
              "displayName": "John Nick",
              "emailAddress": "john@contoso.com",
              "identifier": "john@contoso.com",
              "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
              "principalType": "User",
              "userType": "User",
              "profile": {
                "id": "45416453",
                "displayName": "John's profile"
              },
              "datamartUserAccessRight": "Read"
            }
          ]
        }
      ],
      "users": [
        {
          "displayName": "John Nick",
          "emailAddress": "john@contoso.com",
          "appUserAccessRight": "ReadExplore",
          "identifier": "john@contoso.com",
          "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
          "principalType": "User"
        }
      ]
    }
  ],
  "datasourceInstances": [
    {
      "datasourceType": "Sql",
      "connectionDetails": {
        "server": "qlserver.database.windows.net",
        "database": "dbo.largest_table"
      },
      "datasourceId": "c79ad907-df19-43fe-a0f7-d9f365d67070",
      "gatewayId": "e820592e-f8cf-4a6f-b1ed-566799d29565"
    }
  ],
  "misconfiguredDatasourceInstances": [
    {
      "datasourceType": "Sql",
      "connectionDetails": {
        "server": "sqlserver.database.windows.net",
        "database": "dbo.table"
      },
      "datasourceId": "80ec28bc-fe81-43ea-be52-a07a95cfbcab",
      "gatewayId": "505a19c1-4190-4e8e-a4f6-dd72722feced"
    }
  ]
}

Определения

Имя Описание
ASMashupExpression

Источник таблицы набора данных
Column

Столбец набора данных
DashboardUser

Правая запись доступа пользователя Power BI для панели мониторинга
DashboardUserAccessRight

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

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

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

Текущее состояние datamart
datamartStatus

Состояние datamart
datamartType

Тип datamart
DatamartUser

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

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

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

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

Источник данных Power BI
DatasourceConnectionDetails

Сведения о подключении к источнику данных Power BI. См. примеры получения источников данных или получения источников данных в группе.
DatasourceUsage

Использование источника данных
DefaultDatasetStorageFormat

Формат хранилища набора данных по умолчанию в группе
DependentDataflow

Зависимый поток данных Power BI
DependentDatamart

Зависимый объект datamart Power BI
DependentDataset

Зависимый набор данных Power BI
EndorsementDetails

Сведения о подтверждении Power BI
Expression

Выражение набора данных
GroupUser

Пользователь Power BI с доступом к рабочей области
GroupUserAccessRight

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

Мера Power BI
PrincipalType

Тип субъекта
ReportUser

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

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

Роль в конфигурации RLS набора данных
RoleMember

Член роли
RoleTablePermission

Фильтр роли
Row

Строка данных в наборе данных
SensitivityLabel

Сведения о метках конфиденциальности для элемента Power BI (например, отчета или панели мониторинга)
ServicePrincipalProfile

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

Таблица набора данных
WorkspaceInfo

Сведения о рабочей области
WorkspaceInfoDashboard

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

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

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

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

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

Ответ сведений о рабочей области
WorkspaceInfoTile

Плитка Power BI, возвращаемая API WorkspaceInfo

ASMashupExpression

Источник таблицы набора данных

Имя Тип Описание
expression

string

Исходное выражение

Column

Столбец набора данных

Имя Тип Описание
dataCategory

string

Необязательный. Строковое значение, используемое для категории данных, описывающей данные в этом столбце.
dataType

string

Тип данных столбца
formatString

string

Необязательный. Формат столбца, указанный в FORMAT_STRING.
isHidden

boolean

Необязательный. Скрыт ли столбец. Значение по умолчанию — false.
name

string

Имя столбца
sortByColumn

string

Необязательный. Строковое имя столбца в той же таблице, используемое для упорядочивания текущего столбца.
summarizeBy

string

Необязательный. Агрегатная функция, используемая для суммирования этого столбца.

DashboardUser

Правая запись доступа пользователя Power BI для панели мониторинга

Имя Тип Описание
dashboardUserAccessRight

DashboardUserAccessRight

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

string

Отображаемое имя субъекта
emailAddress

string

Адрес электронной почты пользователя
graphId

string

Идентификатор субъекта в Microsoft Graph. Доступно только для API администрирования.
identifier

string

Идентификатор субъекта
principalType

PrincipalType

Тип субъекта
profile

ServicePrincipalProfile

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

string

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

DashboardUserAccessRight

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

Имя Тип Описание
None

string

Нет разрешения на содержимое на панели мониторинга
Owner

string

Предоставляет доступ к содержимому в отчете для чтения, записи и повторного доступа к содержимому
Read

string

Предоставляет доступ на чтение к содержимому на панели мониторинга
ReadCopy

string

Предоставляет доступ на чтение и копирование содержимого на панели мониторинга
ReadReshare

string

Предоставляет доступ на чтение и повторное предоставление доступа к содержимому на панели мониторинга
ReadWrite

string

Предоставляет доступ на чтение и запись к содержимому на панели мониторинга

DataflowUser

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

Имя Тип Описание
DataflowUserAccessRight

DataflowUserAccessRight

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

string

Отображаемое имя субъекта
emailAddress

string

Адрес электронной почты пользователя
graphId

string

Идентификатор субъекта в Microsoft Graph. Доступно только для API администрирования.
identifier

string

Идентификатор субъекта
principalType

PrincipalType

Тип субъекта
profile

ServicePrincipalProfile

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

string

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

DataflowUserAccessRight

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

Имя Тип Описание
None

string

Удаляет разрешение на содержимое в потоке данных
Owner

string

Предоставляет доступ для чтения, записи и повторного доступа к содержимому в потоке данных
Read

string

Предоставляет доступ на чтение к содержимому в потоке данных
ReadReshare

string

Предоставляет доступ для чтения и повторного доступа к содержимому в потоке данных
ReadWrite

string

Предоставляет доступ на чтение и запись к содержимому в потоке данных

datamartState

Текущее состояние datamart

Имя Тип Описание
Active

string

Datamart активен
Deleted

string

Datamart удален
Evicted

string

Datamart был вытесщен
Initialized

string

Datamart был инициализирован
Invalid

string

Datamart имеет недопустимое состояние
Migrating

string

Datamart переносится

datamartStatus

Состояние datamart

Имя Тип Описание
Available

string

Datamart доступен
Error

string

Datamart имеет состояние ошибки
InProgress

string

Datamart выполняется
Invalid

string

Datamart имеет недопустимое состояние
NoCapacity

string

Datamart не имеет емкости
OutOfRegion

string

Datamart находится вне региона
SuspendedInCriticalPhase

string

Datamart приостановлен на критическом этапе

datamartType

Тип datamart

Имя Тип Описание
Dataverse

string

Datamart имеет тип Dataverse
Datawarehouse

string

Datamart имеет тип Datawarehouse
Ignore

string

Datamart не имеет типа
Lakehouse

string

Datamart имеет тип Lakehouse
Sql

string

Datamart имеет тип Sql
Unset

string

Тип datamart был не задан

DatamartUser

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

Имя Тип Описание
datamartUserAccessRight

DatamartUserAccessRight

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

string

Отображаемое имя субъекта
emailAddress

string

Адрес электронной почты пользователя
graphId

string

Идентификатор субъекта в Microsoft Graph. Доступно только для API администрирования.
identifier

string

Идентификатор субъекта
principalType

PrincipalType

Тип субъекта
profile

ServicePrincipalProfile

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

string

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

DatamartUserAccessRight

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

Имя Тип Описание
Explore

string

Предоставляет доступ к содержимому в datamart
None

string

Нет разрешения на содержимое в datamart
Read

string

Предоставляет доступ на чтение к содержимому в datamart
ReadExplore

string

Предоставляет доступ для чтения и изучения содержимого в datamart
ReadReshare

string

Предоставляет доступ для чтения и повторного доступа к содержимому в datamart
ReadReshareExplore

string

Предоставляет доступ к содержимому в datamart для чтения и повторного доступа к содержимому
ReadWrite

string

Предоставляет доступ на чтение и запись к содержимому в datamart
ReadWriteExplore

string

Предоставляет доступ для чтения и записи и изучения содержимого в datamart
ReadWriteReshare

string

Предоставляет доступ для чтения и записи и повторного доступа к содержимому в datamart
ReadWriteReshareExplore

string

Предоставляет доступ к содержимому в datamart для чтения и записи и повторного доступа к содержимому
Reshare

string

Предоставление повторного доступа к содержимому в datamart
Write

string

Предоставляет доступ на запись к содержимому в datamart

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

Предоставляет доступ для чтения, записи, повторного доступа к содержимому в наборе данных

Datasource

Источник данных Power BI

Имя Тип Описание
connectionDetails

DatasourceConnectionDetails

Сведения о подключении к источнику данных
connectionString

string

(не рекомендуется) Строка подключения к источнику данных. Доступно только для DirectQuery.
datasourceId

string

Идентификатор привязанного источника данных, который пуст, если не привязан к шлюзу
datasourceType

string

Тип источника данных
gatewayId

string

Идентификатор привязанного шлюза, который пуст, если он не привязан к шлюзу. При использовании кластера шлюза идентификатор шлюза ссылается на первичный (первый) шлюз в кластере и аналогичен идентификатору кластера шлюза.
name

string

(не рекомендуется) Имя источника данных. Доступно только для DirectQuery.

DatasourceConnectionDetails

Сведения о подключении к источнику данных Power BI. См. примеры получения источников данных или получения источников данных в группе.

Имя Тип Описание
account

string

Учетная запись подключения
classInfo

string

Сведения о классе подключения
database

string

База данных подключения
domain

string

Домен подключения
emailAddress

string

Адрес электронной почты подключения
kind

string

Тип подключения
loginServer

string

Сервер входа для подключения
path

string

Путь подключения
server

string

Сервер подключения
url

string

URL-адрес подключения

DatasourceUsage

Использование источника данных

Имя Тип Описание
datasourceInstanceId

string

Идентификатор экземпляра источника данных

DefaultDatasetStorageFormat

Формат хранилища набора данных по умолчанию в группе

Имя Тип Описание
Large

string

Формат хранилища большого набора данных
Small

string

Формат хранилища небольшого набора данных

DependentDataflow

Зависимый поток данных Power BI

Имя Тип Описание
groupId

string

Идентификатор целевой группы
targetDataflowId

string

Идентификатор целевого потока данных

DependentDatamart

Зависимый объект datamart Power BI

Имя Тип Описание
groupId

string

Идентификатор целевой группы
targetDatamartId

string

Идентификатор целевого объекта datamart

DependentDataset

Зависимый набор данных Power BI

Имя Тип Описание
groupId

string

Идентификатор целевой группы
targetDatasetId

string

Идентификатор целевого набора данных

EndorsementDetails

Сведения о подтверждении Power BI

Имя Тип Описание
certifiedBy

string

Пользователь, сертифицированный элемент Power BI (например, отчет или панель мониторинга)
endorsement

string

Состояние подтверждения

Expression

Выражение набора данных

Имя Тип Описание
description

string

Описание выражения
expression

string

Значение выражения
name

string

Имя выражения

GroupUser

Пользователь Power BI с доступом к рабочей области

Имя Тип Описание
displayName

string

Отображаемое имя субъекта
emailAddress

string

Адрес электронной почты пользователя
graphId

string

Идентификатор субъекта в Microsoft Graph. Доступно только для API администрирования.
groupUserAccessRight

GroupUserAccessRight

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

string

Идентификатор субъекта
principalType

PrincipalType

Тип субъекта
profile

ServicePrincipalProfile

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

string

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

GroupUserAccessRight

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

Имя Тип Описание
Admin

string

Права администратора на содержимое рабочей области
Contributor

string

Доступ к содержимому рабочей области для чтения и изучения (ReadExplore)
Member

string

Чтение, повторное использование и изучение прав доступа (ReadReshareExplore) к содержимому рабочей области
None

string

Нет доступа к содержимому рабочей области
Viewer

string

Доступ только для чтения (чтение) к содержимому рабочей области

Measure

Мера Power BI

Имя Тип Описание
description

string

Необязательный. Описание меры.
expression

string

Допустимое выражение DAX
formatString

string

Необязательный. Строка, описывающая форматирование значения при отображении, как указано в FORMAT_STRING.
isHidden

boolean

Необязательный. Скрыта ли мера.
name

string

Имя меры

PrincipalType

Тип субъекта

Имя Тип Описание
App

string

Тип субъекта-службы
Group

string

Тип субъекта-группы
None

string

Нет типа субъекта. Используется для доступа на уровне всей организации.
User

string

Тип субъекта-пользователя

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

Предоставляет доступ на чтение и запись к содержимому в отчете

Role

Роль в конфигурации RLS набора данных

Имя Тип Описание
members

RoleMember

Массив, в котором перечислены члены роли
modelPermission

string

Разрешения, которые имеет роль в наборе данных. Например, чтение
name

string

Имя роли
tablePermissions

RoleTablePermission

Массив, который перечисляет все фильтры, определенные для роли

RoleMember

Член роли

Имя Тип Описание
identityProvider

string

Поставщик удостоверений члена роли
memberId

string

GUID члена роли, назначенный поставщиком удостоверений
memberName

string

Имя члена роли
memberType

string

Тип члена роли (пользователь или группа)

RoleTablePermission

Фильтр роли

Имя Тип Описание
filterExpression

string

Выражение, которое фильтрует таблицу, указанную в фильтре
name

string

Имя таблицы, указанной в фильтре

Row

Строка данных в наборе данных

Имя Тип Описание
id

string

Уникальный идентификатор строки

SensitivityLabel

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

Имя Тип Описание
labelId

string

Идентификатор метки конфиденциальности

ServicePrincipalProfile

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

Имя Тип Описание
displayName

string

Имя профиля субъекта-службы
id

string

Идентификатор профиля субъекта-службы

Table

Таблица набора данных

Имя Тип Описание
columns

Column[]

Схема столбцов для этой таблицы
description

string

Описание таблицы
isHidden

boolean

Необязательный. Скрыта ли эта таблица набора данных.
measures

Measure[]

Меры в этой таблице
name

string

Имя таблицы
rows

Row[]

Строки данных в этой таблице
source

ASMashupExpression[]

Источник таблицы

WorkspaceInfo

Сведения о рабочей области

Имя Тип Описание
capacityId

string

Идентификатор емкости рабочей области
dashboards

WorkspaceInfoDashboard[]

Панели мониторинга, связанные с этой рабочей областью. Список возвращаемых свойств панели мониторинга зависит от различных вызовов API, поэтому в ответе API могут не отображаться все свойства панели мониторинга.
dataRetrievalState

string

Состояние извлечения данных рабочей области
dataflows

WorkspaceInfoDataflow[]

Потоки данных, связанные с этой рабочей областью. Список возвращаемых свойств потока данных зависит от различных вызовов API, поэтому в ответе API могут не отображаться все свойства потока данных.
datamarts

WorkspaceInfoDatamart[]

Данные, связанные с этой рабочей областью. Список возвращаемых свойств datamart зависит от различных вызовов API, поэтому в ответе API могут не отображаться все свойства datamart.
datasets

WorkspaceInfoDataset[]

Наборы данных, связанные с этой рабочей областью. Список возвращаемых свойств набора данных зависит от различных вызовов API, поэтому в ответе API могут не отображаться все свойства набора данных.
defaultDatasetStorageFormat

DefaultDatasetStorageFormat

Формат хранилища набора данных по умолчанию в рабочей области. Возвращается только в том случае, если isOnDedicatedCapacitytrue
description

string

Описание рабочей области
id

string

Идентификатор объекта рабочей области
isOnDedicatedCapacity

boolean

Назначена ли рабочая область выделенной емкости
name

string

Имя рабочей области
reports

WorkspaceInfoReport[]

Отчеты, связанные с этой рабочей областью. Список возвращаемых свойств отчета зависит от различных вызовов API, поэтому в ответе API могут не отображаться все свойства отчета.
state

string

Состояние рабочей области
type

string

Тип рабочей области
users

GroupUser[]

Пользователи с доступом к рабочей области. Список возвращается только при явном запросе. Чтобы получить список пользователей для классической рабочей области, используйте API Graph Azure Active Directory.

WorkspaceInfoDashboard

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

Имя Тип Описание
appId

string

Идентификатор приложения, возвращенный только в том случае, если панель мониторинга принадлежит приложению
dataClassification

string

Тег классификации данных элемента Power BI (например, отчет или панель мониторинга)
displayName

string

Отображаемое имя панели мониторинга
id

string

Идентификатор панели мониторинга
isReadOnly

boolean

Является ли панель мониторинга доступной только для чтения
sensitivityLabel

SensitivityLabel

Метка конфиденциальности
tiles

WorkspaceInfoTile[]

Плитки, принадлежащие панели мониторинга
users

DashboardUser[]

(Пустое значение) Сведения о доступе пользователя к панели мониторинга. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Вы можете получить сведения о пользователях на панели мониторинга Power BI с помощью вызова API получения пользователей панели мониторинга в качестве администратора или вызова API PostWorkspaceInfo с параметром getArtifactUsers.

WorkspaceInfoDataflow

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

Имя Тип Описание
configuredBy

string

Владелец потока данных
datasourceUsages

DatasourceUsage[]

Использование источника данных
description

string

Описание потока данных
endorsementDetails

EndorsementDetails

Сведения о подтверждении
misconfiguredDatasourceUsages

DatasourceUsage[]

Неправильно настроенные использование источника данных
modelUrl

string

URL-адрес файла определения потока данных (model.json)
name

string

Имя потока данных
objectId

string

Идентификатор потока данных
sensitivityLabel

SensitivityLabel

Метка конфиденциальности
upstreamDataflows

DependentDataflow[]

Список всех потоков данных этого элемента зависит от
upstreamDatamarts

DependentDatamart[]

Список всех данных, от которой зависит этот элемент
users

DataflowUser[]

(Пустое значение) Сведения о доступе пользователей потока данных. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Вы можете получить сведения о потоке данных Power BI с помощью вызова API Получения пользователей потока данных в качестве администратора или вызова API PostWorkspaceInfo с параметром getArtifactUser.

WorkspaceInfoDatamart

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

Имя Тип Описание
configuredBy

string

Имя владельца datamart
configuredById

string

Идентификатор владельца datamart
datasourceUsages

DatasourceUsage[]

Использование источника данных
description

string

Описание datamart
endorsementDetails

EndorsementDetails

Сведения о подтверждении datamart
id

string

Идентификатор datamart
modifiedBy

string

Последний пользователь, изменивший datamart
modifiedById

string

Идентификатор последнего пользователя, изменившего datamart
modifiedDateTime

string

Дата и время последнего изменения datamart
name

string

Имя datamart
sensitivityLabel

SensitivityLabel

Метка конфиденциальности datamart
state

datamartState

Текущее состояние datamart
status

datamartStatus

Состояние datamart
suspendedBatchId

string

идентификатор приостановленной пакетной службы datamart
type

datamartType

Тип datamart
upstreamDataflows

DependentDataflow[]

Список всех потоков данных этого элемента зависит от
upstreamDatamarts

DependentDatamart[]

Список всех данных, от которой зависит этот элемент
users

DatamartUser[]

Сведения о доступе пользователя для datamart Power BI.

WorkspaceInfoDataset

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

Имя Тип Описание
ContentProviderType

string

Тип поставщика контента для набора данных
configuredBy

string

Владелец набора данных
createdDate

string

Дата и время создания набора данных
datasourceUsages

DatasourceUsage[]

Использование источника данных
description

string

Описание набора данных
endorsementDetails

EndorsementDetails

Сведения о подтверждении
expressions

Expression[]

Выражения набора данных
id

string

Идентификатор набора данных
misconfiguredDatasourceUsages

DatasourceUsage[]

Неправильно настроенные использование источника данных
name

string

Имя набора данных
roles

Role[]

Роли набора данных
schemaMayNotBeUpToDate

boolean

Может ли схема набора данных быть актуальной
schemaRetrievalError

string

Ошибка извлечения схемы набора данных
sensitivityLabel

SensitivityLabel

Метка конфиденциальности
tables

Table[]

Таблицы набора данных
targetStorageMode

string

Режим хранения набора данных
upstreamDataflows

DependentDataflow[]

Список всех потоков данных этого элемента зависит от
upstreamDatamarts

DependentDatamart[]

Список всех данных, от которой зависит этот элемент
upstreamDatasets

DependentDataset[]

Наборы данных вышестоящего потока
users

DatasetUser[]

(Пустое значение) Сведения о доступе пользователя к набору данных. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Вы можете получить сведения о пользователе в элементе Power BI (например, отчете или панели мониторинга) с помощью API Получения пользователей набора данных в качестве администратора или API PostWorkspaceInfo с параметром getArtifactUsers.

WorkspaceInfoReport

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

Имя Тип Описание
appId

string

Идентификатор приложения, возвращенный только в том случае, если отчет принадлежит приложению
createdBy

string

Владелец отчета. Доступно только для отчетов, созданных после июня 2019 года.
createdById

string

Идентификатор владельца отчета. Доступно только для отчетов, созданных после июня 2019 года.
createdDateTime

string

Дата и время создания отчета
datasetId

string

Идентификатор набора данных отчета
datasetWorkspaceId

string

Идентификатор рабочей области связанного набора данных, возвращаемый только в том случае, если связанный набор данных принадлежит другой рабочей области.
description

string

Описание отчета
endorsementDetails

EndorsementDetails

Сведения о подтверждении
id

string

Идентификатор отчета
isOwnedByMe

boolean

Определите, создается ли отчет текущим пользователем.
modifiedBy

string

Последний пользователь, изменивший отчет
modifiedById

string

Идентификатор последнего пользователя, изменившего отчет
modifiedDateTime

string

Дата и время последнего изменения отчета
name

string

Имя отчета
originalReportId

string

Фактический идентификатор отчета при публикации рабочей области в качестве приложения.
reportType enum:
  • PaginatedReport
  • PowerBIReport

Тип отчета
sensitivityLabel

SensitivityLabel

Метка конфиденциальности
users

ReportUser[]

(Пустое значение) Сведения о доступе пользователей к отчету Power BI. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Вы можете получить сведения о пользователях в отчете Power BI с помощью вызова API получения пользователей отчета в качестве администратора или вызова API PostWorkspaceInfo с параметром getArtifactUsers.

WorkspaceInfoResponse

Ответ сведений о рабочей области

Имя Тип Описание
datasourceInstances

Datasource[]

Экземпляры источника данных, связанные с этой проверкой
misconfiguredDatasourceInstances

Datasource[]

Неправильно настроенные экземпляры источника данных, связанные с этой проверкой
workspaces

WorkspaceInfo[]

Сведения о рабочей области, связанные с этой проверкой

WorkspaceInfoTile

Плитка Power BI, возвращаемая API WorkspaceInfo

Имя Тип Описание
datasetId

string

Идентификатор набора данных. Доступно только для плиток, созданных из отчета или с помощью набора данных, например Q&плитки A.
datasetWorkspaceId

string

Идентификатор рабочей области связанного набора данных, возвращаемый только в том случае, если связанный набор данных принадлежит другой рабочей области.
id

string

Идентификатор плитки
reportId

string

Идентификатор отчета. Доступно только для плиток, созданных из отчета.
title

string

Отображаемое имя плитки