Admin - WorkspaceInfo GetScanResult

Získá výsledek kontroly pro zadanou kontrolu.

Toto rozhraní API volat pouze po úspěšném volání rozhraní API GetScanStatus . Výsledek kontroly zůstane k dispozici po dobu 24 hodin.

Oprávnění

Uživatel musí mít oprávnění správce (například globální správce Microsoftu 365 nebo správce služby Power BI) nebo ověřování pomocí instančního objektu.

Při spuštění v rámci ověřování instančního objektu nesmí mít aplikace v Azure Portal nastavená oprávnění vyžadovaná správcem pro Power BI.

Požadovaný obor

Tenant.Read.All nebo Tenant.ReadWrite.All

Relevantní pouze při ověřování prostřednictvím standardního delegovaného přístupového tokenu správce. Nesmí být k dispozici při použití ověřování prostřednictvím instančního objektu.

Omezení

Maximálně 500 požadavků za hodinu.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
scanId
path True

string

uuid

ID kontroly, které je součástí odpovědi z pracovních prostorů nebo volání rozhraní API Správa – WorkspaceInfo PostWorkspaceInfo, které tuto kontrolu aktivovalo.

Odpovědi

Name Typ Description
200 OK

WorkspaceInfoResponse

OK

Příklady

Example

Sample Request

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

Sample Response

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

Definice

Name Description
ASMashupExpression

Zdroj tabulky datové sady

Column

Sloupec datové sady

DashboardUser

Položka přístupového práva uživatele Power BI pro řídicí panel

DashboardUserAccessRight

Přístupové právo, které má uživatel k řídicímu panelu (úroveň oprávnění)

DataflowUser

Přístupová práva uživatele Power BI pro tok dat

DataflowUserAccessRight

Přístupové právo, které má uživatel k toku dat (úroveň oprávnění)

datamartState

Aktuální stav datového grafu

datamartStatus

Stav datového diagramu

datamartType

Typ datového grafu

DatamartUser

Položka přístupového práva uživatele Power BI pro sestavu

DatamartUserAccessRight

Přístupové právo, které má uživatel k datovému diagramu (úroveň oprávnění)

DatasetUser

Položka přístupového práva uživatele Power BI pro datovou sadu

DatasetUserAccessRight

Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)

Datasource

Zdroj dat Power BI

DatasourceConnectionDetails

Podrobnosti o připojení ke zdroji dat Power BI Příklady najdete v tématech Získání zdrojů dat nebo Získání zdrojů dat do skupiny.

DatasourceUsage

Využití zdroje dat

DefaultDatasetStorageFormat

Výchozí formát úložiště datové sady ve skupině

DependentDataflow

Tok dat závislý na Power BI

DependentDatamart

Závislý datový diagram Power BI

DependentDataset

Datová sada závislá na Power BI

EndorsementDetails

Podrobnosti o doporučení Power BI

Expression

Výraz datové sady

GroupUser

Uživatel Power BI s přístupem k pracovnímu prostoru

GroupUserAccessRight

Přístupové právo (úroveň oprávnění), které má uživatel v pracovním prostoru

Measure

Míra Power BI

PrincipalType

Typ objektu zabezpečení

ReportUser

Položka přístupového práva uživatele Power BI pro sestavu

ReportUserAccessRight

Přístupové právo, které má uživatel k sestavě (úroveň oprávnění)

Role

Role v konfiguraci zabezpečení na úrovni řádků datové sady

RoleMember

Člen role

RoleTablePermission

Filtr rolí

Row

Řádek dat v datové sadě

SensitivityLabel

Informace o popisku citlivosti pro položku Power BI (například sestavu nebo řídicí panel)

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

Table

Tabulka datové sady

WorkspaceInfo

Podrobnosti o pracovním prostoru

WorkspaceInfoDashboard

Řídicí panel Power BI vrácený rozhraními API WorkspaceInfo. Rozhraní API vrátí podmnožinu následujícího seznamu vlastností řídicího panelu. Podmnožina závisí na rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.

WorkspaceInfoDataflow

Metadata toku dat vrácená rozhraními API informací o pracovním prostoru Níže je seznam vlastností, které se můžou vrátit pro tok dat. V závislosti na volaných rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI se vrátí jenom podmnožina vlastností.

WorkspaceInfoDatamart

Datový diagram Power BI vrácený rozhraními API informací o pracovním prostoru Rozhraní API vrátí podmnožinu následujícího seznamu vlastností datového grafu. Podmnožina závisí na volaného rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.

WorkspaceInfoDataset

Datová sada Power BI vrácená rozhraními WORKSPACEInfo API. Rozhraní API vrátí podmnožinu následujícího seznamu vlastností datové sady. Podmnožina závisí na volaných rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.

WorkspaceInfoReport

Sestava Power BI vrácená rozhraními API informací o pracovním prostoru Rozhraní API vrátí podmnožinu následujícího seznamu vlastností sestavy. Podmnožina závisí na rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.

WorkspaceInfoResponse

Odpověď na informace o pracovním prostoru

WorkspaceInfoTile

Dlaždice Power BI vrácená rozhraními API WorkspaceInfo

ASMashupExpression

Zdroj tabulky datové sady

Name Typ Description
expression

string

Zdrojový výraz

Column

Sloupec datové sady

Name Typ Description
dataCategory

string

Nepovinný parametr. Hodnota řetězce, která se má použít pro kategorii dat, která popisuje data v tomto sloupci.

dataType

string

Datový typ sloupce

formatString

string

Nepovinný parametr. Formát sloupce zadaný v FORMAT_STRING.

isHidden

boolean

Nepovinný parametr. Určuje, jestli je sloupec skrytý. Výchozí formát je false.

name

string

Název sloupce

sortByColumn

string

Nepovinný parametr. Název řetězce pro sloupec ve stejné tabulce, podle kterého se seřadí aktuální sloupec.

summarizeBy

string

Nepovinný parametr. Agregační funkce, která se má použít pro shrnutí tohoto sloupce.

DashboardUser

Položka přístupového práva uživatele Power BI pro řídicí panel

Name Typ Description
dashboardUserAccessRight

DashboardUserAccessRight

Přístupové právo, které má uživatel k řídicímu panelu (úroveň oprávnění)

displayName

string

Zobrazovaný název objektu zabezpečení

emailAddress

string

E-mailová adresa uživatele

graphId

string

Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.

identifier

string

Identifikátor objektu zabezpečení

principalType

PrincipalType

Typ objektu zabezpečení

profile

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

userType

string

Typ uživatele.

DashboardUserAccessRight

Přístupové právo, které má uživatel k řídicímu panelu (úroveň oprávnění)

Name Typ Description
None

string

Žádná oprávnění k obsahu na řídicím panelu

Owner

string

Uděluje přístup ke čtení, zápisu a sdílení obsahu v sestavě.

Read

string

Udělí oprávnění ke čtení obsahu na řídicím panelu.

ReadCopy

string

Uděluje přístup ke čtení a kopírování obsahu na řídicím panelu.

ReadReshare

string

Uděluje přístup ke čtení a sdílení obsahu na řídicím panelu.

ReadWrite

string

Uděluje přístup ke čtení a zápisu k obsahu na řídicím panelu.

DataflowUser

Přístupová práva uživatele Power BI pro tok dat

Name Typ Description
DataflowUserAccessRight

DataflowUserAccessRight

Přístupové právo, které má uživatel k toku dat (úroveň oprávnění)

displayName

string

Zobrazovaný název objektu zabezpečení

emailAddress

string

E-mailová adresa uživatele

graphId

string

Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.

identifier

string

Identifikátor objektu zabezpečení

principalType

PrincipalType

Typ objektu zabezpečení

profile

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

userType

string

Typ uživatele.

DataflowUserAccessRight

Přístupové právo, které má uživatel k toku dat (úroveň oprávnění)

Name Typ Description
None

string

Odebere oprávnění k obsahu v toku dat.

Owner

string

Uděluje přístup ke čtení, zápisu a sdílení obsahu v toku dat.

Read

string

Uděluje přístup ke čtení obsahu v toku dat.

ReadReshare

string

Uděluje přístup ke čtení a sdílení obsahu v toku dat.

ReadWrite

string

Uděluje přístup ke čtení a zápisu k obsahu v toku dat.

datamartState

Aktuální stav datového grafu

Name Typ Description
Active

string

Datový diagram je aktivní.

Deleted

string

Datový diagram byl odstraněn.

Evicted

string

Datamart byl vyřazen.

Initialized

string

Datamart se inicializoval.

Invalid

string

Datový diagram má neplatný stav.

Migrating

string

Datamart se migruje

datamartStatus

Stav datového diagramu

Name Typ Description
Available

string

Datový diagram je k dispozici.

Error

string

Datový diagram má stav chyby.

InProgress

string

Probíhá datový diagram.

Invalid

string

Datový diagram má neplatný stav.

NoCapacity

string

Datový diagram nemá žádnou kapacitu.

OutOfRegion

string

Datamart je mimo oblast

SuspendedInCriticalPhase

string

Datamart je v kritické fázi pozastavený.

datamartType

Typ datového grafu

Name Typ Description
Dataverse

string

Datamart je typu Dataverse.

Datawarehouse

string

Datamart je typu Datawarehouse.

Ignore

string

Datový diagram nemá žádný typ.

Lakehouse

string

Datamart je typu Lakehouse.

Sql

string

Datamart je typu Sql.

Unset

string

Typ datamartu se nenasadil.

DatamartUser

Položka přístupového práva uživatele Power BI pro sestavu

Name Typ Description
datamartUserAccessRight

DatamartUserAccessRight

Přístupové právo, které má uživatel k datovému diagramu (úroveň oprávnění)

displayName

string

Zobrazovaný název objektu zabezpečení

emailAddress

string

E-mailová adresa uživatele

graphId

string

Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.

identifier

string

Identifikátor objektu zabezpečení

principalType

PrincipalType

Typ objektu zabezpečení

profile

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

userType

string

Typ uživatele.

DatamartUserAccessRight

Přístupové právo, které má uživatel k datovému diagramu (úroveň oprávnění)

Name Typ Description
Explore

string

Uděluje prozkoumání přístupu k obsahu v datovém diagramu

None

string

Žádná oprávnění k obsahu v datamartu

Read

string

Uděluje přístup ke čtení obsahu v datovém diagramu.

ReadExplore

string

Uděluje přístup ke čtení a prozkoumání obsahu v datovém diagramu.

ReadReshare

string

Uděluje přístup ke čtení a sdílení obsahu v datovém diagramu.

ReadReshareExplore

string

Uděluje čtení a sdílení a prozkoumání přístupu k obsahu v datovém diagramu.

ReadWrite

string

Uděluje přístup ke čtení a zápisu k obsahu v datovém diagramu.

ReadWriteExplore

string

Uděluje přístup ke čtení a zápisu a prozkoumání obsahu v datovém diagramu.

ReadWriteReshare

string

Uděluje přístup ke čtení a zápisu a opětovnému sdílení obsahu v datovém diagramu.

ReadWriteReshareExplore

string

Uděluje čtení a zápis a sdílení a prozkoumání přístupu k obsahu v datovém diagramu.

Reshare

string

Udělí opětovné sdílení přístupu k obsahu v datovém diagramu.

Write

string

Uděluje přístup k zápisu k obsahu v datovém diagramu.

DatasetUser

Položka přístupového práva uživatele Power BI pro datovou sadu

Name Typ Description
datasetUserAccessRight

DatasetUserAccessRight

Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)

displayName

string

Zobrazovaný název objektu zabezpečení

emailAddress

string

E-mailová adresa uživatele

graphId

string

Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.

identifier

string

Identifikátor objektu zabezpečení

principalType

PrincipalType

Typ objektu zabezpečení

profile

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

userType

string

Typ uživatele.

DatasetUserAccessRight

Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)

Name Typ Description
None

string

Odebere oprávnění k obsahu v datové sadě.

Read

string

Udělí oprávnění ke čtení obsahu v datové sadě.

ReadExplore

string

Udělí přístup ke čtení a prozkoumání obsahu v datové sadě.

ReadReshare

string

Uděluje přístup ke čtení a sdílení obsahu v datové sadě.

ReadReshareExplore

string

Uděluje přístup ke čtení, sdílení a prozkoumání obsahu v datové sadě.

ReadWrite

string

Uděluje přístup ke čtení a zápisu k obsahu v datové sadě.

ReadWriteExplore

string

Uděluje přístup ke čtení, zápisu a prozkoumání obsahu v datové sadě.

ReadWriteReshare

string

Uděluje přístup ke čtení, zápisu a sdílení obsahu v datové sadě.

ReadWriteReshareExplore

string

Uděluje přístup ke čtení, zápisu, sdílení a prozkoumání obsahu v datové sadě.

Datasource

Zdroj dat Power BI

Name Typ Description
connectionDetails

DatasourceConnectionDetails

Podrobnosti o připojení ke zdroji dat

connectionString

string

(Zastaralé) Zdroj dat připojovací řetězec. K dispozici pouze pro DirectQuery.

datasourceId

string

ID vázaného zdroje dat, které je prázdné, pokud není vázané na bránu

datasourceType

string

Typ zdroje dat

gatewayId

string

ID vázané brány, které je prázdné, pokud není vázané na bránu. Při použití clusteru brány odkazuje ID brány na primární (první) bránu v clusteru a je podobné ID clusteru brány.

name

string

(Zastaralé) Název zdroje dat. K dispozici pouze pro DirectQuery.

DatasourceConnectionDetails

Podrobnosti o připojení ke zdroji dat Power BI Příklady najdete v tématech Získání zdrojů dat nebo Získání zdrojů dat do skupiny.

Name Typ Description
account

string

Účet připojení

classInfo

string

Informace o třídě připojení

database

string

Databáze připojení

domain

string

Doména připojení

emailAddress

string

E-mailová adresa připojení

kind

string

Druh připojení

loginServer

string

Přihlašovací server připojení

path

string

Cesta k připojení

server

string

Server připojení

url

string

Adresa URL připojení

DatasourceUsage

Využití zdroje dat

Name Typ Description
datasourceInstanceId

string

ID instance zdroje dat

DefaultDatasetStorageFormat

Výchozí formát úložiště datové sady ve skupině

Name Typ Description
Large

string

Velký formát úložiště datové sady

Small

string

Formát malého úložiště datových sad

DependentDataflow

Tok dat závislý na Power BI

Name Typ Description
groupId

string

ID cílové skupiny

targetDataflowId

string

ID cílového toku dat

DependentDatamart

Závislý datový diagram Power BI

Name Typ Description
groupId

string

ID cílové skupiny

targetDatamartId

string

ID cílového datového diagramu

DependentDataset

Datová sada závislá na Power BI

Name Typ Description
groupId

string

ID cílové skupiny

targetDatasetId

string

ID cílové datové sady

EndorsementDetails

Podrobnosti o doporučení Power BI

Name Typ Description
certifiedBy

string

Uživatel, který certifikuje položku Power BI (například sestavu nebo řídicí panel)

endorsement

string

Stav doporučení

Expression

Výraz datové sady

Name Typ Description
description

string

Popis výrazu

expression

ASMashupExpression

Zdroj tabulky datové sady

name

string

Název výrazu

GroupUser

Uživatel Power BI s přístupem k pracovnímu prostoru

Name Typ Description
displayName

string

Zobrazovaný název objektu zabezpečení

emailAddress

string

E-mailová adresa uživatele

graphId

string

Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.

groupUserAccessRight

GroupUserAccessRight

Přístupové právo (úroveň oprávnění), které má uživatel v pracovním prostoru

identifier

string

Identifikátor objektu zabezpečení

principalType

PrincipalType

Typ objektu zabezpečení

profile

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

userType

string

Typ uživatele.

GroupUserAccessRight

Přístupové právo (úroveň oprávnění), které má uživatel v pracovním prostoru

Name Typ Description
Admin

string

Práva správce k obsahu pracovního prostoru

Contributor

string

Čtení a zkoumání (ReadExplore) přístup k obsahu pracovního prostoru

Member

string

Číst, znovu sdílet a zkoumat (ReadReshareExplore) přístupová práva k obsahu pracovního prostoru

None

string

Žádný přístup k obsahu pracovního prostoru

Viewer

string

Přístup jen pro čtení (pro čtení) k obsahu pracovního prostoru

Measure

Míra Power BI

Name Typ Description
description

string

Nepovinný parametr. Popis míry.

expression

string

Platný výraz DAX

formatString

string

Nepovinný parametr. Řetězec popisující, jak má být hodnota formátována, když je zobrazena tak, jak je uvedeno v FORMAT_STRING.

isHidden

boolean

Nepovinný parametr. Jestli je míra skrytá.

name

string

Název míry

PrincipalType

Typ objektu zabezpečení

Name Typ Description
App

string

Typ instančního objektu

Group

string

Typ objektu zabezpečení skupiny

None

string

Žádný typ objektu zabezpečení. Používá se pro přístup na úrovni celé organizace.

User

string

Typ objektu zabezpečení uživatele

ReportUser

Položka přístupového práva uživatele Power BI pro sestavu

Name Typ Description
displayName

string

Zobrazovaný název objektu zabezpečení

emailAddress

string

E-mailová adresa uživatele

graphId

string

Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.

identifier

string

Identifikátor objektu zabezpečení

principalType

PrincipalType

Typ objektu zabezpečení

profile

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

reportUserAccessRight

ReportUserAccessRight

Přístupové právo, které má uživatel k sestavě (úroveň oprávnění)

userType

string

Typ uživatele.

ReportUserAccessRight

Přístupové právo, které má uživatel k sestavě (úroveň oprávnění)

Name Typ Description
None

string

Žádná oprávnění k obsahu v sestavě

Owner

string

Uděluje přístup ke čtení, zápisu a sdílení obsahu v sestavě.

Read

string

Uděluje oprávnění ke čtení obsahu v sestavě.

ReadCopy

string

Uděluje přístup ke čtení a kopírování obsahu v sestavě.

ReadReshare

string

Uděluje přístup ke čtení a opětovnému sdílení obsahu v sestavě.

ReadWrite

string

Uděluje přístup ke čtení a zápisu k obsahu v sestavě.

Role

Role v konfiguraci zabezpečení na úrovni řádků datové sady

Name Typ Description
members

RoleMember

Pole se seznamem členů role

modelPermission

string

Oprávnění, která má role k datové sadě. Například Číst

name

string

Název role

tablePermissions

RoleTablePermission

Pole se seznamem všech filtrů definovaných pro roli

RoleMember

Člen role

Name Typ Description
identityProvider

string

Zprostředkovatel identity člena role

memberId

string

Identifikátor GUID člena role přiřazený zprostředkovatelem identity

memberName

string

Název člena role

memberType

string

Typ člena role (uživatel nebo skupina)

RoleTablePermission

Filtr rolí

Name Typ Description
filterExpression

string

Výraz, který filtruje tabulku zadanou ve filtru

name

string

Název tabulky zadané ve filtru

Row

Řádek dat v datové sadě

Name Typ Description
id

string

Jedinečné ID řádku

SensitivityLabel

Informace o popisku citlivosti pro položku Power BI (například sestavu nebo řídicí panel)

Name Typ Description
labelId

string

ID popisku citlivosti

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

Name Typ Description
displayName

string

Název profilu instančního objektu

id

string

ID profilu instančního objektu

Table

Tabulka datové sady

Name Typ Description
columns

Column[]

Schéma sloupců pro tuto tabulku

description

string

Popis tabulky

isHidden

boolean

Nepovinný parametr. Určuje, jestli je tato tabulka datové sady skrytá.

measures

Measure[]

Míry v této tabulce

name

string

Název tabulky

rows

Row[]

Řádky dat v této tabulce

source

ASMashupExpression[]

Zdroj tabulky

WorkspaceInfo

Podrobnosti o pracovním prostoru

Name Typ Description
capacityId

string

ID kapacity pracovního prostoru

dashboards

WorkspaceInfoDashboard[]

Řídicí panely přidružené k tomuto pracovnímu prostoru Seznam vrácených vlastností řídicího panelu se u různých volání rozhraní API liší, takže v odpovědi rozhraní API se nemusí zobrazit všechny vlastnosti řídicího panelu.

dataRetrievalState

string

Stav načítání dat pracovního prostoru

dataflows

WorkspaceInfoDataflow[]

Toky dat přidružené k tomuto pracovnímu prostoru. Seznam vrácených vlastností toku dat se u různých volání rozhraní API liší, takže v odpovědi rozhraní API se nemusí zobrazit všechny vlastnosti toku dat.

datamarts

WorkspaceInfoDatamart[]

Datová tržiště přidružená k tomuto pracovnímu prostoru. Seznam vrácených vlastností datového tržiště se u různých volání rozhraní API liší, takže v odpovědi rozhraní API se nemusí zobrazit všechny vlastnosti datového tržiště.

datasets

WorkspaceInfoDataset[]

Datové sady přidružené k tomuto pracovnímu prostoru. Seznam vrácených vlastností datové sady se pro různá volání rozhraní API liší, takže v odpovědi rozhraní API se nemusí zobrazit všechny vlastnosti datové sady.

defaultDatasetStorageFormat

DefaultDatasetStorageFormat

Výchozí formát úložiště datové sady v pracovním prostoru. Vráceno pouze v případech, kdy isOnDedicatedCapacity je true

description

string

Popis pracovního prostoru

id

string

ID objektu pracovního prostoru

isOnDedicatedCapacity

boolean

Určuje, jestli je pracovní prostor přiřazený k vyhrazené kapacitě.

name

string

Název pracovního prostoru

reports

WorkspaceInfoReport[]

Sestavy přidružené k tomuto pracovnímu prostoru Seznam vrácených vlastností sestavy se pro různá volání rozhraní API liší, takže v odpovědi rozhraní API se nemusí zobrazit všechny vlastnosti sestavy.

state

string

Stav pracovního prostoru

type

string

Typ pracovního prostoru

users

GroupUser[]

Uživatelé s přístupem k pracovnímu prostoru Seznam se vrátí jenom v případech, kdy je to explicitně požadováno. Pokud chcete načíst seznam uživatelů pro klasický pracovní prostor, použijte Graph API Azure Active Directory.

WorkspaceInfoDashboard

Řídicí panel Power BI vrácený rozhraními API WorkspaceInfo. Rozhraní API vrátí podmnožinu následujícího seznamu vlastností řídicího panelu. Podmnožina závisí na rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.

Name Typ Description
appId

string

ID aplikace, které se vrátí jenom v případě, že řídicí panel patří do aplikace

dataClassification

string

Značka klasifikace dat položky Power BI (například sestavy nebo řídicího panelu)

displayName

string

Zobrazovaný název řídicího panelu

id

string

ID řídicího panelu

isReadOnly

boolean

Určuje, jestli je řídicí panel jen pro čtení

sensitivityLabel

SensitivityLabel

Popisek citlivosti

tiles

WorkspaceInfoTile[]

Dlaždice, které patří do řídicího panelu

users

DashboardUser[]

(Prázdná hodnota) Podrobnosti o přístupu uživatele řídicího panelu Tato vlastnost se odebere z odpovědi datové části v nadcházející verzi. Informace o uživatelích na řídicím panelu Power BI můžete načíst pomocí volání Získat uživatele řídicího panelu jako Správa rozhraní API nebo volání rozhraní API PostWorkspaceInfo s parametrem getArtifactUsers .

WorkspaceInfoDataflow

Metadata toku dat vrácená rozhraními API informací o pracovním prostoru Níže je seznam vlastností, které se můžou vrátit pro tok dat. V závislosti na volaných rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI se vrátí jenom podmnožina vlastností.

Name Typ Description
configuredBy

string

Vlastník toku dat

datasourceUsages

DatasourceUsage[]

Využití zdroje dat

description

string

Popis toku dat

endorsementDetails

EndorsementDetails

Podrobnosti o doporučení

misconfiguredDatasourceUsages

DatasourceUsage[]

Chybně nakonfigurovaná využití zdroje dat

modelUrl

string

Adresa URL definičního souboru toku dat (model.json)

modifiedBy

string

Uživatel, který upravil tok dat

modifiedDateTime

string

Datum a čas poslední změny toku dat

name

string

Název toku dat

objectId

string

ID toku dat

sensitivityLabel

SensitivityLabel

Popisek citlivosti

upstreamDataflows

DependentDataflow[]

Seznam všech toků dat, na které tato položka závisí

upstreamDatamarts

DependentDatamart[]

Seznam všech datových grafů, na které tato položka závisí

users

DataflowUser[]

(Prázdná hodnota) Podrobnosti o přístupu uživatele toku dat Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o uživatelích v toku dat Power BI můžete načíst pomocí volání Získat uživatele toku dat jako Správa rozhraní API nebo volání rozhraní API PostWorkspaceInfo s parametremgetArtifactUser.

WorkspaceInfoDatamart

Datový diagram Power BI vrácený rozhraními API informací o pracovním prostoru Rozhraní API vrátí podmnožinu následujícího seznamu vlastností datového grafu. Podmnožina závisí na volaného rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.

Name Typ Description
configuredBy

string

Jméno vlastníka datamartu

configuredById

string

ID vlastníka datamartu

datasourceUsages

DatasourceUsage[]

Využití zdroje dat

description

string

Popis datového diagramu

endorsementDetails

EndorsementDetails

Podrobnosti o doporučení datamartu

id

string

ID datového diagramu

modifiedBy

string

Poslední uživatel, který upravil datamart

modifiedById

string

ID posledního uživatele, který upravil datamart

modifiedDateTime

string

Datum a čas poslední změny datového diagramu

name

string

Název datového diagramu

sensitivityLabel

SensitivityLabel

Popisek citlivosti datového grafu

state

datamartState

Aktuální stav datového grafu

status

datamartStatus

Stav datového diagramu

suspendedBatchId

string

id pozastavené dávky datamartu

type

datamartType

Typ datového grafu

upstreamDataflows

DependentDataflow[]

Seznam všech toků dat, na které tato položka závisí

upstreamDatamarts

DependentDatamart[]

Seznam všech datových grafů, na které tato položka závisí

users

DatamartUser[]

Podrobnosti o přístupu uživatele k datovému diagramu Power BI

WorkspaceInfoDataset

Datová sada Power BI vrácená rozhraními WORKSPACEInfo API. Rozhraní API vrátí podmnožinu následujícího seznamu vlastností datové sady. Podmnožina závisí na volaných rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.

Name Typ Description
ContentProviderType

string

Typ poskytovatele obsahu pro datovou sadu

CreatedDate

string

Datum a čas vytvoření datové sady

configuredBy

string

Vlastník datové sady

datasourceUsages

DatasourceUsage[]

Využití zdroje dat

description

string

Popis datové sady

endorsementDetails

EndorsementDetails

Podrobnosti o doporučení

expressions

Expression[]

Výrazy datové sady

id

string

ID datové sady

misconfiguredDatasourceUsages

DatasourceUsage[]

Chybně nakonfigurované využití zdroje dat

name

string

Název datové sady

roles

Role[]

Role datové sady

schemaMayNotBeUpToDate

boolean

Jestli schéma datové sady nemusí být aktuální

schemaRetrievalError

string

Chyba načítání schématu datové sady

sensitivityLabel

SensitivityLabel

Popisek citlivosti

tables

Table[]

Tabulky datových sad

targetStorageMode

string

Režim úložiště datové sady

upstreamDataflows

DependentDataflow[]

Seznam všech toků dat, na které tato položka závisí

upstreamDatamarts

DependentDatamart[]

Seznam všech datových grafů, na které tato položka závisí

upstreamDatasets

DependentDataset[]

Upstreamové datové sady

users

DatasetUser[]

(Prázdná hodnota) Podrobnosti o přístupu uživatele k datové sadě Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o uživatelích u položky Power BI (například sestavy nebo řídicího panelu) můžete načíst pomocí rozhraní API Get Dataset Users as Správa nebo rozhraní API PostWorkspaceInfo s parametrem getArtifactUsers .

WorkspaceInfoReport

Sestava Power BI vrácená rozhraními API informací o pracovním prostoru Rozhraní API vrátí podmnožinu následujícího seznamu vlastností sestavy. Podmnožina závisí na rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.

Name Typ Description
appId

string

ID aplikace, které se vrátí jenom v případě, že sestava patří aplikaci

createdBy

string

Vlastník sestavy. K dispozici pouze pro sestavy vytvořené po červnu 2019.

createdById

string

ID vlastníka sestavy. K dispozici pouze pro sestavy vytvořené po červnu 2019.

createdDateTime

string

Datum a čas vytvoření sestavy

datasetId

string

ID datové sady sestavy

datasetWorkspaceId

string

ID pracovního prostoru související datové sady, které se vrátí pouze v případě, že související datová sada patří do jiného pracovního prostoru

description

string

Popis sestavy

endorsementDetails

EndorsementDetails

Podrobnosti o doporučení

id

string

ID sestavy

modifiedBy

string

Poslední uživatel, který sestavu upravil

modifiedById

string

ID posledního uživatele, který sestavu upravil

modifiedDateTime

string

Datum a čas poslední změny sestavy

name

string

Název sestavy

originalReportId

string

Skutečné ID sestavy, když je pracovní prostor publikovaný jako aplikace.

reportType enum:
  • PaginatedReport
  • PowerBIReport

Typ sestavy

sensitivityLabel

SensitivityLabel

Popisek citlivosti

users

ReportUser[]

(Prázdná hodnota) Podrobnosti o přístupu uživatele pro sestavu Power BI. Tato vlastnost se odebere z odpovědi datové části v nadcházející verzi. Informace o uživatelích v sestavě Power BI můžete načíst pomocí volání Získat uživatele sestavy jako Správa rozhraní API nebo volání rozhraní API PostWorkspaceInfo s parametrem getArtifactUsers .

WorkspaceInfoResponse

Odpověď na informace o pracovním prostoru

Name Typ Description
datasourceInstances

Datasource[]

Instance zdroje dat přidružené k této kontrole

misconfiguredDatasourceInstances

Datasource[]

Chybně nakonfigurované instance zdroje dat přidružené k této kontrole

workspaces

WorkspaceInfo[]

Informace o pracovním prostoru přidružené k této kontrole

WorkspaceInfoTile

Dlaždice Power BI vrácená rozhraními API WorkspaceInfo

Name Typ Description
datasetId

string

ID datové sady. K dispozici pouze pro dlaždice vytvořené ze sestavy nebo pomocí datové sady, jako jsou dlaždice Q&A.

datasetWorkspaceId

string

ID pracovního prostoru související datové sady, které se vrátí pouze v případě, že související datová sada patří do jiného pracovního prostoru

id

string

ID dlaždice

reportId

string

ID sestavy. K dispozici pouze pro dlaždice vytvořené ze sestavy.

title

string

Zobrazovaný název dlaždice