Admin - WorkspaceInfo GetScanResult

  • Odwołanie
Service:
Power BI REST APIs
API Version:
v1.0

Pobiera wynik skanowania dla określonego skanowania.

Wywołanie tego interfejsu API należy wykonać tylko po pomyślnym wywołaniu interfejsu API GetScanStatus . Wynik skanowania pozostanie dostępny przez 24 godziny.

Uprawnienia

Użytkownik musi mieć uprawnienia administratora (takie jak administrator globalny platformy Microsoft 365 lub administrator usługi Power BI) lub uwierzytelnić się przy użyciu jednostki usługi.

W przypadku uruchamiania w ramach uwierzytelniania jednostki usługi aplikacja nie może mieć żadnych uprawnień wymaganych przez administratora dla usługi Power BI ustawionej w Azure Portal.

Zakres wymagany

Tenant.Read.All lub Tenant.ReadWrite.All

Istotne tylko w przypadku uwierzytelniania za pośrednictwem standardowego delegowanego tokenu dostępu administratora. Nie może być obecny, gdy jest używane uwierzytelnianie za pośrednictwem jednostki usługi.

Ograniczenia

Maksymalna liczba żądań 500 na godzinę. 

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
scanId
 path True

string

uuid

Identyfikator skanowania, który jest uwzględniony w odpowiedzi z obszarów roboczych lub Administracja — WorkspaceInfo PostWorkspaceInfo wywołanie interfejsu API, które wyzwoliło skanowanie.

Odpowiedzi

Nazwa Typ Opis
200 OK

WorkspaceInfoResponse

OK

Przykłady

Example

Sample Request

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

Sample Response

Status code:
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"
    }
  ]
}

Definicje

Nazwa Opis
ASMashupExpression

Źródło tabeli zestawu danych
Column

Kolumna zestawu danych
DashboardUser

Wpis prawa dostępu użytkownika usługi Power BI dla pulpitu nawigacyjnego
DashboardUserAccessRight

Prawo dostępu, które użytkownik ma dla pulpitu nawigacyjnego (poziom uprawnień)
DataflowUser

Wpis prawa dostępu użytkownika usługi Power BI dla przepływu danych
DataflowUserAccessRight

Prawo dostępu, które użytkownik ma dla przepływu danych (poziom uprawnień)
datamartState

Bieżący stan elementu datamart
datamartStatus

Stan datamart
datamartType

Typ elementu datamart
DatamartUser

Wpis prawa dostępu użytkownika usługi Power BI dla raportu
DatamartUserAccessRight

Prawo dostępu, które użytkownik ma dla karty datamart (poziom uprawnień)
DatasetUser

Wpis prawa dostępu użytkownika usługi Power BI dla zestawu danych
DatasetUserAccessRight

Prawo dostępu, które użytkownik ma dla zestawu danych (poziom uprawnień)
Datasource

Źródło danych usługi Power BI
DatasourceConnectionDetails

Szczegóły połączenia ze źródłem danych usługi Power BI. Zobacz przykłady w temacie Pobieranie źródeł danych lub Pobieranie źródeł danych w grupie.
DatasourceUsage

Użycie źródła danych
DefaultDatasetStorageFormat

Domyślny format magazynu zestawu danych w grupie
DependentDataflow

Zależny od przepływu danych usługi Power BI
DependentDatamart

Tabela danych zależnych od usługi Power BI
DependentDataset

Zestaw danych zależny od usługi Power BI
EndorsementDetails

Szczegóły poręczenia w usłudze Power BI
Expression

Wyrażenie zestawu danych
GroupUser

Użytkownik usługi Power BI z dostępem do obszaru roboczego
GroupUserAccessRight

Prawo dostępu (poziom uprawnień), które użytkownik ma w obszarze roboczym
Measure

Miara usługi Power BI
PrincipalType

Typ podmiotu zabezpieczeń
ReportUser

Wpis prawa dostępu użytkownika usługi Power BI dla raportu
ReportUserAccessRight

Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień)
Role

Rola w konfiguracji zabezpieczeń na poziomie wiersza zestawu danych
RoleMember

Członek roli
RoleTablePermission

Filtr roli
Row

Wiersz danych w zestawie danych
SensitivityLabel

Informacje o etykietach poufności dla elementu usługi Power BI (na przykład raportu lub pulpitu nawigacyjnego)
ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.
Table

Tabela zestawu danych
WorkspaceInfo

Szczegóły informacji o obszarze roboczym
WorkspaceInfoDashboard

Pulpit nawigacyjny usługi Power BI zwrócony przez interfejsy API WorkspaceInfo. Interfejs API zwraca podzestaw następujących właściwości pulpitu nawigacyjnego. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI.
WorkspaceInfoDataflow

Metadane przepływu danych zwracane przez interfejsy API informacji o obszarze roboczym. Poniżej znajduje się lista właściwości, które mogą być zwracane dla przepływu danych. W zależności od wywoływanego interfejsu API zostanie zwrócony tylko podzbiór właściwości, uprawnienia wywołującego i dostępność danych w bazie danych usługi Power BI.
WorkspaceInfoDatamart

Schemat danych usługi Power BI zwracany przez interfejsy API informacji o obszarze roboczym. Interfejs API zwraca podzbiór następujących właściwości elementu datamart. Podzbiór zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI.
WorkspaceInfoDataset

Zestaw danych usługi Power BI zwrócony przez interfejsy API WorkspaceInfo. Interfejs API zwraca podzestaw następujących właściwości zestawu danych. Podzestaw zależy od interfejsu API o nazwie , uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI.
WorkspaceInfoReport

Raport usługi Power BI zwrócony przez interfejsy API informacji o obszarze roboczym. Interfejs API zwraca podzestaw następujących właściwości raportu. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI.
WorkspaceInfoResponse

Odpowiedź na informacje o obszarze roboczym
WorkspaceInfoTile

Kafelek usługi Power BI zwracany przez interfejsy API WorkspaceInfo

ASMashupExpression

Źródło tabeli zestawu danych

Nazwa Typ Opis
expression

string

Wyrażenie źródłowe

Column

Kolumna zestawu danych

Nazwa Typ Opis
dataCategory

string

Opcjonalny. Wartość ciągu, która ma być używana dla kategorii danych, która opisuje dane w tej kolumnie.
dataType

string

Typ danych kolumny
formatString

string

Opcjonalny. Format kolumny określony w FORMAT_STRING.
isHidden

boolean

Opcjonalny. Określa, czy kolumna jest ukryta. Wartość domyślna to false.
name

string

Nazwa kolumny
sortByColumn

string

Opcjonalny. Nazwa ciągu kolumny w tej samej tabeli, która ma być używana do porządkowania bieżącej kolumny.
summarizeBy

string

Opcjonalny. Funkcja agregacji używana do podsumowywania tej kolumny.

DashboardUser

Wpis prawa dostępu użytkownika usługi Power BI dla pulpitu nawigacyjnego

Nazwa Typ Opis
dashboardUserAccessRight

DashboardUserAccessRight

Prawo dostępu, które użytkownik ma dla pulpitu nawigacyjnego (poziom uprawnień)
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń
emailAddress

string

Adres e-mail użytkownika
graphId

string

Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratora.
identifier

string

Identyfikator podmiotu zabezpieczeń
principalType

PrincipalType

Typ podmiotu zabezpieczeń
profile

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.
userType

string

Typ użytkownika.

DashboardUserAccessRight

Prawo dostępu, które użytkownik ma dla pulpitu nawigacyjnego (poziom uprawnień)

Nazwa Typ Opis
None

string

Brak uprawnień do zawartości na pulpicie nawigacyjnym
Owner

string

Przyznaje prawa dostępu do odczytu, zapisu i udostępniania dalej do zawartości w raporcie
Read

string

Przyznaje dostęp do odczytu do zawartości na pulpicie nawigacyjnym
ReadCopy

string

Przyznaje dostęp do odczytu i kopiowania do zawartości na pulpicie nawigacyjnym
ReadReshare

string

Przyznaje dostęp do odczytu i udostępniania dalej zawartości na pulpicie nawigacyjnym
ReadWrite

string

Przyznaje dostęp do odczytu i zapisu do zawartości na pulpicie nawigacyjnym

DataflowUser

Wpis prawa dostępu użytkownika usługi Power BI dla przepływu danych

Nazwa Typ Opis
DataflowUserAccessRight

DataflowUserAccessRight

Prawo dostępu, które użytkownik ma dla przepływu danych (poziom uprawnień)
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń
emailAddress

string

Adres e-mail użytkownika
graphId

string

Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratora.
identifier

string

Identyfikator podmiotu zabezpieczeń
principalType

PrincipalType

Typ podmiotu zabezpieczeń
profile

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.
userType

string

Typ użytkownika.

DataflowUserAccessRight

Prawo dostępu, które użytkownik ma dla przepływu danych (poziom uprawnień)

Nazwa Typ Opis
None

string

Usuwa uprawnienia do zawartości w przepływie danych
Owner

string

Przyznaje prawa dostępu do odczytu, zapisu i udostępniania dalej zawartości w przepływie danych
Read

string

Przyznaje dostęp do odczytu do zawartości w przepływie danych
ReadReshare

string

Przyznaje dostęp do odczytu i udostępniania dalej zawartości w przepływie danych
ReadWrite

string

Przyznaje dostęp do odczytu i zapisu do zawartości w przepływie danych

datamartState

Bieżący stan elementu datamart

Nazwa Typ Opis
Active

string

Datamart jest aktywny
Deleted

string

Datamart został usunięty
Evicted

string

Datamart został eksmitowany
Initialized

string

Datamart został zainicjowany
Invalid

string

Schemat danych ma nieprawidłowy stan
Migrating

string

Migrowanie modułu datamart

datamartStatus

Stan datamart

Nazwa Typ Opis
Available

string

Tabela danych jest dostępna
Error

string

Tabela datamart ma stan błędu
InProgress

string

Datamart jest w toku
Invalid

string

Schemat danych ma nieprawidłowy stan
NoCapacity

string

Tabela danych nie ma pojemności
OutOfRegion

string

Tabela danych jest poza regionem
SuspendedInCriticalPhase

string

Schemat danych jest zawieszony w fazie krytycznej

datamartType

Typ elementu datamart

Nazwa Typ Opis
Dataverse

string

Datamart ma typ Dataverse
Datawarehouse

string

Datamart jest typu Datawarehouse
Ignore

string

Tabela danych nie ma typu
Lakehouse

string

Datamart jest typu Lakehouse
Sql

string

Datamart jest typu Sql
Unset

string

Typ elementu datamart został niezaustawiony

DatamartUser

Wpis prawa dostępu użytkownika usługi Power BI dla raportu

Nazwa Typ Opis
datamartUserAccessRight

DatamartUserAccessRight

Prawo dostępu, które użytkownik ma dla karty datamart (poziom uprawnień)
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń
emailAddress

string

Adres e-mail użytkownika
graphId

string

Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratora.
identifier

string

Identyfikator podmiotu zabezpieczeń
principalType

PrincipalType

Typ podmiotu zabezpieczeń
profile

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.
userType

string

Typ użytkownika.

DatamartUserAccessRight

Prawo dostępu, które użytkownik ma dla karty datamart (poziom uprawnień)

Nazwa Typ Opis
Explore

string

Przyznaje eksplorowanie dostępu do zawartości w narzędziu datamart
None

string

Brak uprawnień do zawartości w elemecie datamart
Read

string

Przyznaje dostęp do odczytu do zawartości w narzędziu datamart
ReadExplore

string

Udziela uprawnień do odczytu i eksplorowania dostępu do zawartości w narzędziu datamart
ReadReshare

string

Przyznaje dostęp do odczytu i udostępniania dalej zawartości w narzędziu datamart
ReadReshareExplore

string

Udziela uprawnień do odczytu i udostępniania dalej oraz eksplorowania dostępu do zawartości w narzędziu datamart
ReadWrite

string

Przyznaje dostęp do odczytu i zapisu do zawartości w narzędziu datamart
ReadWriteExplore

string

Przyznaje uprawnienia do odczytu i zapisu oraz eksplorowania dostępu do zawartości w narzędziu datamart
ReadWriteReshare

string

Przyznaje dostęp do odczytu i zapisu i udostępniania dalej zawartości w narzędziu datamart
ReadWriteReshareExplore

string

Udziela uprawnień do odczytu i zapisu oraz udostępniania dalej oraz eksplorowania dostępu do zawartości w narzędziu datamart
Reshare

string

Udziela dostępu do udostępniania dalej zawartości w narzędziu datamart
Write

string

Udziela dostępu do zapisu do zawartości w elemecie datamart

DatasetUser

Wpis prawa dostępu użytkownika usługi Power BI dla zestawu danych

Nazwa Typ Opis
datasetUserAccessRight

DatasetUserAccessRight

Prawo dostępu, które użytkownik ma dla zestawu danych (poziom uprawnień)
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń
emailAddress

string

Adres e-mail użytkownika
graphId

string

Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratora.
identifier

string

Identyfikator podmiotu zabezpieczeń
principalType

PrincipalType

Typ podmiotu zabezpieczeń
profile

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.
userType

string

Typ użytkownika.

DatasetUserAccessRight

Prawo dostępu, które użytkownik ma dla zestawu danych (poziom uprawnień)

Nazwa Typ Opis
None

string

Usuwa uprawnienia do zawartości w zestawie danych
Read

string

Przyznaje dostęp do odczytu do zawartości w zestawie danych
ReadExplore

string

Przyznaje uprawnienia do odczytu i eksplorowania dostępu do zawartości w zestawie danych
ReadReshare

string

Przyznaje dostęp do odczytu i udostępniania dalej do zawartości w zestawie danych
ReadReshareExplore

string

Przyznaje uprawnienia do odczytu, udostępniania dalej i eksplorowania dostępu do zawartości w zestawie danych
ReadWrite

string

Przyznaje dostęp do odczytu i zapisu do zawartości w zestawie danych
ReadWriteExplore

string

Przyznaje dostęp do zawartości w zestawie danych: odczyt, zapis i eksplorowanie
ReadWriteReshare

string

Udziela dostępu do odczytu, zapisu i udostępniania dalej zawartości w zestawie danych
ReadWriteReshareExplore

string

Przyznaje dostęp do zawartości w zestawie danych: odczyt, zapis, udostępnianie dalej i eksplorowanie

Datasource

Źródło danych usługi Power BI

Nazwa Typ Opis
connectionDetails

DatasourceConnectionDetails

Szczegóły połączenia ze źródłem danych
connectionString

string

(Przestarzałe) Źródło danych parametry połączenia. Dostępne tylko dla trybu DirectQuery.
datasourceId

string

Powiązany identyfikator źródła danych, który jest pusty, gdy nie jest powiązany z bramą
datasourceType

string

Typ źródła danych
gatewayId

string

Powiązany identyfikator bramy, który jest pusty, gdy nie jest powiązany z bramą. W przypadku korzystania z klastra bramy identyfikator bramy odwołuje się do podstawowej (pierwszej) bramy w klastrze i jest podobny do identyfikatora klastra bramy.
name

string

(Przestarzałe) Nazwa źródła danych. Dostępne tylko dla trybu DirectQuery.

DatasourceConnectionDetails

Szczegóły połączenia ze źródłem danych usługi Power BI. Zobacz przykłady w temacie Pobieranie źródeł danych lub Pobieranie źródeł danych w grupie.

Nazwa Typ Opis
account

string

Konto połączenia
classInfo

string

Informacje o klasie połączenia
database

string

Baza danych połączeń
domain

string

Domena połączenia
emailAddress

string

Adres e-mail połączenia
kind

string

Rodzaj połączenia
loginServer

string

Serwer logowania połączenia
path

string

Ścieżka połączenia
server

string

Serwer połączeń
url

string

Adres URL połączenia

DatasourceUsage

Użycie źródła danych

Nazwa Typ Opis
datasourceInstanceId

string

Identyfikator wystąpienia źródła danych

DefaultDatasetStorageFormat

Domyślny format magazynu zestawu danych w grupie

Nazwa Typ Opis
Large

string

Format dużego magazynu zestawu danych
Small

string

Format magazynu małych zestawów danych

DependentDataflow

Zależny od przepływu danych usługi Power BI

Nazwa Typ Opis
groupId

string

Identyfikator grupy docelowej
targetDataflowId

string

Identyfikator docelowego przepływu danych

DependentDatamart

Tabela danych zależnych od usługi Power BI

Nazwa Typ Opis
groupId

string

Identyfikator grupy docelowej
targetDatamartId

string

Identyfikator docelowego schematu danych

DependentDataset

Zestaw danych zależny od usługi Power BI

Nazwa Typ Opis
groupId

string

Identyfikator grupy docelowej
targetDatasetId

string

Identyfikator docelowego zestawu danych

EndorsementDetails

Szczegóły poręczenia w usłudze Power BI

Nazwa Typ Opis
certifiedBy

string

Użytkownik, który certyfikował element usługi Power BI (na przykład raport lub pulpit nawigacyjny)
endorsement

string

Stan poręczenia

Expression

Wyrażenie zestawu danych

Nazwa Typ Opis
description

string

Opis wyrażenia
expression

ASMashupExpression

Źródło tabeli zestawu danych
name

string

Nazwa wyrażenia

GroupUser

Użytkownik usługi Power BI z dostępem do obszaru roboczego

Nazwa Typ Opis
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń
emailAddress

string

Adres e-mail użytkownika
graphId

string

Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratora.
groupUserAccessRight

GroupUserAccessRight

Prawo dostępu (poziom uprawnień), które użytkownik ma w obszarze roboczym
identifier

string

Identyfikator podmiotu zabezpieczeń
principalType

PrincipalType

Typ podmiotu zabezpieczeń
profile

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.
userType

string

Typ użytkownika.

GroupUserAccessRight

Prawo dostępu (poziom uprawnień), które użytkownik ma w obszarze roboczym

Nazwa Typ Opis
Admin

string

Prawa administratora do zawartości obszaru roboczego
Contributor

string

Odczyt i eksplorowanie (ReadExplore) — dostęp do zawartości obszaru roboczego
Member

string

Prawa dostępu do zawartości obszaru roboczego można odczytywać, udostępniać dalej i eksplorować (ReadReshareExplore)
None

string

Brak dostępu do zawartości obszaru roboczego
Viewer

string

Dostęp tylko do odczytu (odczyt) do zawartości obszaru roboczego

Measure

Miara usługi Power BI

Nazwa Typ Opis
description

string

Opcjonalny. Opis miary.
expression

string

Prawidłowe wyrażenie języka DAX
formatString

string

Opcjonalny. Ciąg opisujący sposób formatowania wartości, gdy jest wyświetlany zgodnie z FORMAT_STRING.
isHidden

boolean

Opcjonalny. Określa, czy miara jest ukryta.
name

string

Nazwa miary

PrincipalType

Typ podmiotu zabezpieczeń

Nazwa Typ Opis
App

string

Typ jednostki usługi
Group

string

Typ podmiotu zabezpieczeń grupy
None

string

Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji.
User

string

Typ podmiotu zabezpieczeń użytkownika

ReportUser

Wpis prawa dostępu użytkownika usługi Power BI dla raportu

Nazwa Typ Opis
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń
emailAddress

string

Adres e-mail użytkownika
graphId

string

Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratora.
identifier

string

Identyfikator podmiotu zabezpieczeń
principalType

PrincipalType

Typ podmiotu zabezpieczeń
profile

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.
reportUserAccessRight

ReportUserAccessRight

Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień)
userType

string

Typ użytkownika.

ReportUserAccessRight

Prawo dostępu, które użytkownik ma dla raportu (poziom uprawnień)

Nazwa Typ Opis
None

string

Brak uprawnień do zawartości w raporcie
Owner

string

Przyznaje prawa dostępu do odczytu, zapisu i udostępniania dalej do zawartości w raporcie
Read

string

Przyznaje dostęp do odczytu do zawartości w raporcie
ReadCopy

string

Przyznaje dostęp do odczytu i kopiowania do zawartości w raporcie
ReadReshare

string

Udziela dostępu do odczytu i udostępniania dalej zawartości w raporcie
ReadWrite

string

Przyznaje dostęp do odczytu i zapisu do zawartości w raporcie

Role

Rola w konfiguracji zabezpieczeń na poziomie wiersza zestawu danych

Nazwa Typ Opis
members

RoleMember

Tablica z listą członków roli
modelPermission

string

Uprawnienia, które ma rola w zestawie danych. Na przykład Odczyt
name

string

Nazwa roli
tablePermissions

RoleTablePermission

Tablica zawierająca listę wszystkich filtrów zdefiniowanych dla roli

RoleMember

Członek roli

Nazwa Typ Opis
identityProvider

string

Dostawca tożsamości członka roli
memberId

string

Identyfikator GUID członka roli przypisany przez dostawcę tożsamości
memberName

string

Nazwa członka roli
memberType

string

Typ członka roli (użytkownik lub grupa)

RoleTablePermission

Filtr roli

Nazwa Typ Opis
filterExpression

string

Wyrażenie filtrujące tabelę określoną w filtrze
name

string

Nazwa tabeli określonej w filtrze

Row

Wiersz danych w zestawie danych

Nazwa Typ Opis
id

string

Unikatowy identyfikator wiersza

SensitivityLabel

Informacje o etykietach poufności dla elementu usługi Power BI (na przykład raportu lub pulpitu nawigacyjnego)

Nazwa Typ Opis
labelId

string

Identyfikator etykiety poufności

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

Nazwa Typ Opis
displayName

string

Nazwa profilu jednostki usługi
id

string

Identyfikator profilu jednostki usługi

Table

Tabela zestawu danych

Nazwa Typ Opis
columns

Column[]

Schemat kolumny dla tej tabeli
description

string

Opis tabeli
isHidden

boolean

Opcjonalny. Określa, czy ta tabela zestawów danych jest ukryta.
measures

Measure[]

Miary w tej tabeli
name

string

Nazwa tabeli
rows

Row[]

Wiersze danych w tej tabeli
source

ASMashupExpression[]

Źródło tabeli

WorkspaceInfo

Szczegóły informacji o obszarze roboczym

Nazwa Typ Opis
capacityId

string

Identyfikator pojemności obszaru roboczego
dashboards

WorkspaceInfoDashboard[]

Pulpity nawigacyjne skojarzone z tym obszarem roboczym. Zwracana lista właściwości pulpitu nawigacyjnego różni się w przypadku różnych wywołań interfejsu API, więc w odpowiedzi interfejsu API może nie być widoczna cała właściwości pulpitu nawigacyjnego.
dataRetrievalState

string

Stan pobierania danych obszaru roboczego
dataflows

WorkspaceInfoDataflow[]

Przepływy danych skojarzone z tym obszarem roboczym. Lista zwracanych właściwości przepływu danych różni się w zależności od różnych wywołań interfejsu API, więc w odpowiedzi interfejsu API może nie być widoczna cała właściwości przepływu danych.
datamarts

WorkspaceInfoDatamart[]

Datamarts skojarzone z tym obszarem roboczym. Lista zwracanych właściwości elementu datamart różni się w zależności od różnych wywołań interfejsu API, więc w odpowiedzi interfejsu API może nie być widoczna wszystkie właściwości elementu datamart.
datasets

WorkspaceInfoDataset[]

Zestawy danych skojarzone z tym obszarem roboczym. Zwracana lista właściwości zestawu danych różni się w przypadku różnych wywołań interfejsu API, więc w odpowiedzi interfejsu API może nie być widoczna cała wartość właściwości zestawu danych.
defaultDatasetStorageFormat

DefaultDatasetStorageFormat

Domyślny format magazynu zestawu danych w obszarze roboczym. Zwracane tylko wtedy, gdy isOnDedicatedCapacity jest true
description

string

Opis obszaru roboczego
id

string

Identyfikator obiektu obszaru roboczego
isOnDedicatedCapacity

boolean

Czy obszar roboczy jest przypisany do pojemności dedykowanej
name

string

Nazwa obszaru roboczego
reports

WorkspaceInfoReport[]

Raporty skojarzone z tym obszarem roboczym. Lista zwracanych właściwości raportu różni się w zależności od różnych wywołań interfejsu API, więc w odpowiedzi interfejsu API może nie być widoczna cała właściwości raportu.
state

string

Stan obszaru roboczego
type

string

Typ obszaru roboczego
users

GroupUser[]

Użytkownicy z dostępem do obszaru roboczego. Lista jest zwracana tylko w przypadku jawnego żądania. Aby pobrać listę użytkowników dla klasycznego obszaru roboczego, użyj interfejs Graph API usługi Azure Active Directory.

WorkspaceInfoDashboard

Pulpit nawigacyjny usługi Power BI zwrócony przez interfejsy API WorkspaceInfo. Interfejs API zwraca podzestaw następujących właściwości pulpitu nawigacyjnego. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI.

Nazwa Typ Opis
appId

string

Identyfikator aplikacji zwrócony tylko wtedy, gdy pulpit nawigacyjny należy do aplikacji
dataClassification

string

Tag klasyfikacji danych elementu usługi Power BI (taki jak raport lub pulpit nawigacyjny)
displayName

string

Nazwa wyświetlana pulpitu nawigacyjnego
id

string

Identyfikator pulpitu nawigacyjnego
isReadOnly

boolean

Czy pulpit nawigacyjny jest tylko do odczytu
sensitivityLabel

SensitivityLabel

Etykieta poufności
tiles

WorkspaceInfoTile[]

Kafelki należące do pulpitu nawigacyjnego
users

DashboardUser[]

(Wartość pusta) Szczegóły dostępu użytkownika pulpitu nawigacyjnego. Ta właściwość zostanie usunięta z odpowiedzi ładunku w nadchodzącej wersji. Informacje o użytkowniku na pulpicie nawigacyjnym usługi Power BI można pobrać przy użyciu wywołania interfejsu API pobierz pulpit nawigacyjny jako Administracja lub wywołania interfejsu API PostWorkspaceInfo z parametrem getArtifactUsers .

WorkspaceInfoDataflow

Metadane przepływu danych zwracane przez interfejsy API informacji o obszarze roboczym. Poniżej znajduje się lista właściwości, które mogą być zwracane dla przepływu danych. W zależności od wywoływanego interfejsu API zostanie zwrócony tylko podzbiór właściwości, uprawnienia wywołującego i dostępność danych w bazie danych usługi Power BI.

Nazwa Typ Opis
configuredBy

string

Właściciel przepływu danych
datasourceUsages

DatasourceUsage[]

Użycie źródła danych
description

string

Opis przepływu danych
endorsementDetails

EndorsementDetails

Szczegóły poręczenia
misconfiguredDatasourceUsages

DatasourceUsage[]

Nieprawidłowo skonfigurowane użycie źródła danych
modelUrl

string

Adres URL pliku definicji przepływu danych (model.json)
modifiedBy

string

Użytkownik, który zmodyfikował przepływ danych
modifiedDateTime

string

Data i godzina ostatniej modyfikacji przepływu danych
name

string

Nazwa przepływu danych
objectId

string

Identyfikator przepływu danych
sensitivityLabel

SensitivityLabel

Etykieta poufności
upstreamDataflows

DependentDataflow[]

Lista wszystkich przepływów danych, od których zależy ten element
upstreamDatamarts

DependentDatamart[]

Lista wszystkich modułów danych, od których zależy ten element
users

DataflowUser[]

(Pusta wartość) Szczegóły dostępu użytkownika przepływu danych. Ta właściwość zostanie usunięta z odpowiedzi ładunku w nadchodzącej wersji. Informacje o użytkowniku w przepływie danych usługi Power BI można pobrać przy użyciu wywołania interfejsu API pobierz przepływ danych jako Administracja interfejsu API lub wywołania interfejsu API PostWorkspaceInfo z parametrem getArtifactUser .

WorkspaceInfoDatamart

Schemat danych usługi Power BI zwracany przez interfejsy API informacji o obszarze roboczym. Interfejs API zwraca podzbiór następujących właściwości elementu datamart. Podzbiór zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI.

Nazwa Typ Opis
configuredBy

string

Nazwa właściciela elementu datamart
configuredById

string

Identyfikator właściciela elementu datamart
datasourceUsages

DatasourceUsage[]

Użycie źródła danych
description

string

Opis elementu datamart
endorsementDetails

EndorsementDetails

Szczegóły poręczenia datamart
id

string

Identyfikator elementu datamart
modifiedBy

string

Ostatni użytkownik, który zmodyfikował element datamart
modifiedById

string

Identyfikator ostatniego użytkownika, który zmodyfikował schemat danych
modifiedDateTime

string

Data i godzina ostatniej modyfikacji elementu datamart
name

string

Nazwa elementu datamart
sensitivityLabel

SensitivityLabel

Etykieta poufności datamart
state

datamartState

Bieżący stan elementu datamart
status

datamartStatus

Stan datamart
suspendedBatchId

string

datamart zawieszony identyfikator partii
type

datamartType

Typ elementu datamart
upstreamDataflows

DependentDataflow[]

Lista wszystkich przepływów danych, od których zależy ten element
upstreamDatamarts

DependentDatamart[]

Lista wszystkich modułów danych, od których zależy ten element
users

DatamartUser[]

Szczegóły dostępu użytkownika dla zestawu danych usługi Power BI.

WorkspaceInfoDataset

Zestaw danych usługi Power BI zwrócony przez interfejsy API WorkspaceInfo. Interfejs API zwraca podzestaw następujących właściwości zestawu danych. Podzestaw zależy od interfejsu API o nazwie , uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI.

Nazwa Typ Opis
ContentProviderType

string

Typ dostawcy zawartości dla zestawu danych
CreatedDate

string

Data i godzina utworzenia zestawu danych
configuredBy

string

Właściciel zestawu danych
datasourceUsages

DatasourceUsage[]

Użycie źródła danych
description

string

Opis zestawu danych
endorsementDetails

EndorsementDetails

Szczegóły poręczenia
expressions

Expression[]

Wyrażenia zestawu danych
id

string

Identyfikator zestawu danych
misconfiguredDatasourceUsages

DatasourceUsage[]

Nieprawidłowo skonfigurowane użycie źródła danych
name

string

Nazwa zestawu danych
roles

Role[]

Role zestawu danych
schemaMayNotBeUpToDate

boolean

Czy schemat zestawu danych może nie być aktualny
schemaRetrievalError

string

Błąd pobierania schematu zestawu danych
sensitivityLabel

SensitivityLabel

Etykieta poufności
tables

Table[]

Tabele zestawu danych
targetStorageMode

string

Tryb przechowywania zestawu danych
upstreamDataflows

DependentDataflow[]

Lista wszystkich przepływów danych, od których zależy ten element
upstreamDatamarts

DependentDatamart[]

Lista wszystkich modułów danych, od których zależy ten element
upstreamDatasets

DependentDataset[]

Nadrzędne zestawy danych
users

DatasetUser[]

(Pusta wartość) Szczegóły dostępu użytkownika zestawu danych. Ta właściwość zostanie usunięta z odpowiedzi ładunku w nadchodzącej wersji. Informacje o użytkowniku w elemencie usługi Power BI (takim jak raport lub pulpit nawigacyjny) można pobrać przy użyciu interfejsu API pobierz zestaw danych jako interfejsu API Administracja lub interfejsu API PostWorkspaceInfo z parametrem getArtifactUsers .

WorkspaceInfoReport

Raport usługi Power BI zwrócony przez interfejsy API informacji o obszarze roboczym. Interfejs API zwraca podzestaw następujących właściwości raportu. Podzestaw zależy od interfejsu API o nazwie, uprawnieniach wywołującego i dostępności danych w bazie danych usługi Power BI.

Nazwa Typ Opis
appId

string

Identyfikator aplikacji zwrócony tylko wtedy, gdy raport należy do aplikacji
createdBy

string

Właściciel raportu. Dostępne tylko dla raportów utworzonych po czerwcu 2019 r.
createdById

string

Identyfikator właściciela raportu. Dostępne tylko dla raportów utworzonych po czerwcu 2019 r.
createdDateTime

string

Data i godzina utworzenia raportu
datasetId

string

Identyfikator zestawu danych raportu
datasetWorkspaceId

string

Identyfikator obszaru roboczego powiązanego zestawu danych zwrócony tylko wtedy, gdy powiązany zestaw danych należy do innego obszaru roboczego
description

string

Opis raportu
endorsementDetails

EndorsementDetails

Szczegóły poręczenia
id

string

Identyfikator raportu
modifiedBy

string

Ostatni użytkownik, który zmodyfikował raport
modifiedById

string

Identyfikator ostatniego użytkownika, który zmodyfikował raport
modifiedDateTime

string

Data i godzina ostatniej modyfikacji raportu
name

string

Nazwa raportu
originalReportId

string

Rzeczywisty identyfikator raportu po opublikowaniu obszaru roboczego jako aplikacja.
reportType enum:
  • PaginatedReport
  • PowerBIReport

Typ raportu
sensitivityLabel

SensitivityLabel

Etykieta poufności
users

ReportUser[]

(Wartość pusta) Szczegóły dostępu użytkownika dla raportu usługi Power BI. Ta właściwość zostanie usunięta z odpowiedzi ładunku w nadchodzącej wersji. Informacje o użytkowniku w raporcie usługi Power BI można pobrać przy użyciu wywołania interfejsu API Pobierz użytkowników raportu jako Administracja lub wywołania interfejsu API PostWorkspaceInfo z parametrem getArtifactUsers .

WorkspaceInfoResponse

Odpowiedź na informacje o obszarze roboczym

Nazwa Typ Opis
datasourceInstances

Datasource[]

Wystąpienia źródła danych skojarzone z tym skanowaniem
misconfiguredDatasourceInstances

Datasource[]

Nieprawidłowo skonfigurowane wystąpienia źródła danych skojarzone z tym skanowaniem
workspaces

WorkspaceInfo[]

Informacje o obszarze roboczym skojarzone z tym skanowaniem

WorkspaceInfoTile

Kafelek usługi Power BI zwracany przez interfejsy API WorkspaceInfo

Nazwa Typ Opis
datasetId

string

Identyfikator zestawu danych. Dostępne tylko dla kafelków utworzonych na podstawie raportu lub przy użyciu zestawu danych, takiego jak kafelki Q&A.
datasetWorkspaceId

string

Identyfikator obszaru roboczego powiązanego zestawu danych zwrócony tylko wtedy, gdy powiązany zestaw danych należy do innego obszaru roboczego
id

string

Identyfikator kafelka
reportId

string

Identyfikator raportu. Dostępne tylko dla kafelków utworzonych na podstawie raportu.
title

string

Nazwa wyświetlana kafelka