Freigeben über


Admin - WorkspaceInfo GetScanResult

Ruft das Scanergebnis für die angegebene Überprüfung ab.

Führen Sie diesen API-Aufruf nur nach einem erfolgreichen GetScanStatus API-Aufruf aus. Das Scanergebnis bleibt 24 Stunden verfügbar.

Erlaubnisse

Der Benutzer muss ein Fabric-Administrator sein oder sich mit einem Dienstprinzipal authentifizieren.

Wenn eine App unter der Dienstprinzipalauthentifizierung ausgeführt wird, darf eine App nicht über erforderliche Administratorberechtigungen für Power BI verfügen, die im Azure-Portal darauf festgelegt sind.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Relevant nur bei der Authentifizierung über ein standardmäßiges delegiertes Administratorzugriffstoken. Darf nicht vorhanden sein, wenn die Authentifizierung über einen Dienstprinzipal verwendet wird.

Begrenzungen

Maximal 500 Anforderungen pro Stunde.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
scanId
path True

string (uuid)

Die Scan-ID, die in der Antwort der Arbeitsbereiche oder des Admin - WorkspaceInfo PostWorkspaceInfo API-Aufruf enthalten ist, der den Scan ausgelöst hat.

Antworten

Name Typ Beschreibung
200 OK

WorkspaceInfoResponse

OKAY

Beispiele

Example

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
ASMashupExpression

Eine Datensatztabellenquelle

Column

Eine Datasetspalte

DashboardUser

Ein Power BI-Benutzerzugriff für ein Dashboard

DashboardUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dashboard hat (Berechtigungsstufe)

DataflowUser

Ein Power BI-Benutzerzugriff für einen Datenfluss

DataflowUserAccessRight

Das Zugriffsrecht, das ein Benutzer für den Datenfluss hat (Berechtigungsstufe)

datamartState

Aktueller Status des Datamart-Objekts

datamartStatus

Der Datamart-Status

datamartType

Der Datentyp

DatamartUser

Ein Power BI-Benutzerzugriffsrecht für einen Bericht

DatamartUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Datamart hat (Berechtigungsstufe)

DatasetUser

Ein Power BI-Benutzerzugriff für ein Dataset

DatasetUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)

Datasource

Eine Power BI-Datenquelle

DatasourceConnectionDetails

Die Power BI-Datenquellenverbindungsdetails. Beispiele finden Sie in Get Datasources oder Get Datasources In Group.

DatasourceUsage

Datenquellennutzung

DefaultDatasetStorageFormat

Das Standardmäßige Datasetspeicherformat in der Gruppe

DependentDataflow

Ein abhängiger Power BI-Datenfluss

DependentDatamart

Power BI-abhängiges Datenmart

DependentDataset

Ein power BI-abhängiges Dataset

EndorsementDetails

Details zur Power BI-Bestätigung

Expression

Ein Datasetausdruck

GroupUser

Ein Power BI-Benutzer mit Zugriff auf den Arbeitsbereich

GroupUserAccessRight

Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer im Arbeitsbereich verfügt

Measure

Ein Power BI-Measure

PrincipalType

Der Prinzipaltyp

ReportUser

Ein Power BI-Benutzerzugriffsrecht für einen Bericht

ReportUserAccessRight

Das Zugriffsrecht, das der Benutzer für den Bericht hat (Berechtigungsstufe)

Role

Eine Rolle in der RLS-Konfiguration eines Datasets

RoleMember

Ein Rollenmitglied

RoleTablePermission

Ein Rollenfilter

Row

Eine Datenzeile in einem Dataset

SensitivityLabel

Informationen zu Vertraulichkeitsbezeichnungen für ein Power BI-Element (z. B. einen Bericht oder ein Dashboard)

ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

Table

Eine Datasettabelle

WorkspaceInfo

Details zu Arbeitsbereichsinformationen

WorkspaceInfoDashboard

Ein Power BI-Dashboard, das von WorkspaceInfo-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste der Dashboardeigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.

WorkspaceInfoDataflow

Die Metadaten eines datenflusses, der von Arbeitsbereichsinfo-APIs zurückgegeben wird. Nachfolgend finden Sie eine Liste der Eigenschaften, die für einen Datenfluss zurückgegeben werden können. Je nach aufgerufener API, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank werden nur eine Teilmenge der Eigenschaften zurückgegeben.

WorkspaceInfoDatamart

Ein Power BI-Datenmart, das von Arbeitsbereichs-Info-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste der Datamart-Eigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.

WorkspaceInfoDataset

Ein power BI-Dataset, das von WorkspaceInfo-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste der Dataseteigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank ab.

WorkspaceInfoReport

Ein Power BI-Bericht, der von Arbeitsbereichs-Info-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste der Berichtseigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.

WorkspaceInfoResponse

Antwort auf Arbeitsbereichsinformationen

WorkspaceInfoTile

Eine Power BI-Kachel, die von WorkspaceInfo-APIs zurückgegeben wird

ASMashupExpression

Eine Datensatztabellenquelle

Name Typ Beschreibung
expression

string

Der Quellausdruck

Column

Eine Datasetspalte

Name Typ Beschreibung
dataCategory

string

Wahlfrei. Der für die Datenkategorie zu verwendende Zeichenfolgenwert, der die Daten in dieser Spalte beschreibt.

dataType

string

Der Spaltendatentyp

formatString

string

Wahlfrei. Das Format der Spalte, wie in FORMAT_STRINGangegeben.

isHidden

boolean

Wahlfrei. Gibt an, ob die Spalte ausgeblendet ist. Der Standardwert ist false.

name

string

pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$

Der Spaltenname

sortByColumn

string

Wahlfrei. Zeichenfolgenname einer Spalte in derselben Tabelle, die zum Sortieren der aktuellen Spalte verwendet werden soll.

summarizeBy

string

Wahlfrei. Die Aggregatfunktion, die zum Zusammenfassen dieser Spalte verwendet werden soll.

DashboardUser

Ein Power BI-Benutzerzugriff für ein Dashboard

Name Typ Beschreibung
dashboardUserAccessRight

DashboardUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dashboard hat (Berechtigungsstufe)

displayName

string

Anzeigename des Prinzipals

emailAddress

string

E-Mail-Adresse des Benutzers

graphId

string

Bezeichner des Prinzipals in Microsoft Graph. Nur für Administrator-APIs verfügbar.

identifier

string

Bezeichner des Prinzipals

principalType

PrincipalType

Der Prinzipaltyp

profile

ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

userType

string

Typ des Benutzers.

DashboardUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dashboard hat (Berechtigungsstufe)

Wert Beschreibung
None

Keine Berechtigung für Inhalte im Dashboard

Owner

Gewährt Lese-, Schreib- und Freigabezugriff auf Inhalte im Bericht

Read

Gewährt Lesezugriff auf Inhalte im Dashboard

ReadCopy

Gewährt Lese- und Kopierzugriff auf Inhalte im Dashboard

ReadReshare

Gewährt Lese- und Freigabezugriff auf Inhalte im Dashboard

ReadWrite

Gewährt Lese- und Schreibzugriff auf Inhalte im Dashboard

DataflowUser

Ein Power BI-Benutzerzugriff für einen Datenfluss

Name Typ Beschreibung
DataflowUserAccessRight

DataflowUserAccessRight

Das Zugriffsrecht, das ein Benutzer für den Datenfluss hat (Berechtigungsstufe)

displayName

string

Anzeigename des Prinzipals

emailAddress

string

E-Mail-Adresse des Benutzers

graphId

string

Bezeichner des Prinzipals in Microsoft Graph. Nur für Administrator-APIs verfügbar.

identifier

string

Bezeichner des Prinzipals

principalType

PrincipalType

Der Prinzipaltyp

profile

ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

userType

string

Typ des Benutzers.

DataflowUserAccessRight

Das Zugriffsrecht, das ein Benutzer für den Datenfluss hat (Berechtigungsstufe)

Wert Beschreibung
None

Entfernt die Berechtigung für Inhalte im Datenfluss.

Owner

Gewährt Lese-, Schreib- und Freigabezugriff auf Inhalte im Datenfluss

Read

Gewährt Lesezugriff auf Inhalte im Datenfluss

ReadReshare

Gewährt Lese- und Freigabezugriff auf Inhalte im Datenfluss

ReadWrite

Gewährt Lese- und Schreibzugriff auf Inhalte im Datenfluss

datamartState

Aktueller Status des Datamart-Objekts

Wert Beschreibung
Active

Das Datamart-Objekt ist aktiv.

Deleted

Das Datamart-Objekt wurde gelöscht.

Evicted

Das Datamart wurde entfernt.

Initialized

Das Datamart-Objekt wurde initialisiert.

Invalid

Der Datamart-Wert weist einen ungültigen Zustand auf.

Migrating

Das Datamart-Objekt wird migriert.

datamartStatus

Der Datamart-Status

Wert Beschreibung
Available

Das Datamart-Objekt ist verfügbar.

Error

Der Datamart-Objekt weist den Fehlerstatus auf.

InProgress

Das Datamart-Objekt wird ausgeführt.

Invalid

Der Datamart-Wert weist einen ungültigen Status auf.

NoCapacity

Das Datamart-Objekt hat keine Kapazität.

OutOfRegion

Das Datamart-Objekt liegt außerhalb des Bereichs.

SuspendedInCriticalPhase

Das Datamart-Objekt wird in kritischer Phase angehalten.

datamartType

Der Datentyp

Wert Beschreibung
Dataverse

Das Datamart-Objekt ist vom Datentyp "Dataverse"

Datawarehouse

Das Datamart-Objekt ist vom Datentyp "Datawarehouse"

Ignore

Das Datamart-Objekt hat keinen Typ.

Lakehouse

Der Datamart-Typ ist vom Lakehouse-Typ.

Sql

Das Datamart-Objekt ist vom Sql-Typ

Unset

Der Datentyp "datamart" war nicht festgelegt.

DatamartUser

Ein Power BI-Benutzerzugriffsrecht für einen Bericht

Name Typ Beschreibung
datamartUserAccessRight

DatamartUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Datamart hat (Berechtigungsstufe)

displayName

string

Anzeigename des Prinzipals

emailAddress

string

E-Mail-Adresse des Benutzers

graphId

string

Bezeichner des Prinzipals in Microsoft Graph. Nur für Administrator-APIs verfügbar.

identifier

string

Bezeichner des Prinzipals

principalType

PrincipalType

Der Prinzipaltyp

profile

ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

userType

string

Typ des Benutzers.

DatamartUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Datamart hat (Berechtigungsstufe)

Wert Beschreibung
Explore

Gewährt Den Zugriff auf Inhalte in Datamart

None

Keine Berechtigung für Inhalte in datamart

Read

Gewährt Lesezugriff auf Inhalte in Datamart

ReadExplore

Gewährt Lese- und Erkundungszugriff auf Inhalte in datamart

ReadReshare

Gewährt Lese- und Freigabezugriff auf Inhalte in datamart

ReadReshareExplore

Gewährt Lese- und Erneutes Freigeben und Erkunden des Zugriffs auf Inhalte in datamart

ReadWrite

Gewährt Lese- und Schreibzugriff auf Inhalte in datamart

ReadWriteExplore

Gewährt Lese- und Schreibzugriff auf Inhalte in Datamart

ReadWriteReshare

Gewährt Lese-, Schreib- und Freigabezugriff auf Inhalte in datamart

ReadWriteReshareExplore

Gewährt Lese- und Schreibzugriff und erneute Freigabe und Erkunden des Zugriffs auf Inhalte in datamart

Reshare

Gewährt erneuten Zugriff auf Inhalte in datamart

Write

Gewährt Schreibzugriff auf Inhalte in Datamart

DatasetUser

Ein Power BI-Benutzerzugriff für ein Dataset

Name Typ Beschreibung
datasetUserAccessRight

DatasetUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)

displayName

string

Anzeigename des Prinzipals

emailAddress

string

E-Mail-Adresse des Benutzers

graphId

string

Bezeichner des Prinzipals in Microsoft Graph. Nur für Administrator-APIs verfügbar.

identifier

string

Bezeichner des Prinzipals

principalType

PrincipalType

Der Prinzipaltyp

profile

ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

userType

string

Typ des Benutzers.

DatasetUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)

Wert Beschreibung
None

Entfernt die Berechtigung für den Inhalt im Dataset.

Read

Gewährt Lesezugriff auf den Inhalt im Dataset

ReadExplore

Gewährt Lese- und Erkundungszugriff auf den Inhalt im Dataset

ReadReshare

Gewährt Lese- und Freigabezugriff auf den Inhalt im Dataset

ReadReshareExplore

Gewährt Lese-, Freigabe- und Erkunden des Zugriffs auf den Inhalt im Dataset

ReadWrite

Gewährt Lese- und Schreibzugriff auf den Inhalt im Dataset

ReadWriteExplore

Gewährt Lese-, Schreib- und Erkunden des Zugriffs auf den Inhalt im Dataset

ReadWriteReshare

Gewährt Lese-, Schreib- und Freigabezugriff auf den Inhalt im Dataset

ReadWriteReshareExplore

Gewährt Lese-, Schreib-, Refreigabe- und Erkunden des Zugriffs auf den Inhalt im Dataset

Datasource

Eine Power BI-Datenquelle

Name Typ Beschreibung
connectionDetails

DatasourceConnectionDetails

Details zur Datenquellenverbindung

connectionString

string

(Veraltet) Die Verbindungszeichenfolge der Datenquelle. Nur für DirectQuery verfügbar.

datasourceId

string (uuid)

Die gebundene Datenquellen-ID, die leer ist, wenn sie nicht an ein Gateway gebunden ist

datasourceType

string

Der Datenquellentyp

gatewayId

string (uuid)

Die gebundene Gateway-ID, die leer ist, wenn sie nicht an ein Gateway gebunden ist. Bei Verwendung eines Gatewayclusters bezieht sich die Gateway-ID auf das primäre (erste) Gateway im Cluster und ähnelt der Gatewaycluster-ID.

name

string

(Veraltet) Der Name der Datenquelle. Nur für DirectQuery verfügbar.

DatasourceConnectionDetails

Die Power BI-Datenquellenverbindungsdetails. Beispiele finden Sie in Get Datasources oder Get Datasources In Group.

Name Typ Beschreibung
account

string

Das Verbindungskonto

classInfo

string

Die Verbindungsklasseninformationen

database

string

Die Verbindungsdatenbank

domain

string

Die Verbindungsdomäne

emailAddress

string

Die E-Mail-Adresse der Verbindung

kind

string

Die Verbindungsart

loginServer

string

Der Verbindungsanmeldungsserver

path

string

Der Verbindungspfad

server

string

Der Verbindungsserver

url

string

Die Verbindungs-URL

DatasourceUsage

Datenquellennutzung

Name Typ Beschreibung
datasourceInstanceId

string (uuid)

Die Datenquelleninstanz-ID

DefaultDatasetStorageFormat

Das Standardmäßige Datasetspeicherformat in der Gruppe

Wert Beschreibung
Large

Großes Dataset-Speicherformat

Small

Kleines Dataset-Speicherformat

DependentDataflow

Ein abhängiger Power BI-Datenfluss

Name Typ Beschreibung
groupId

string

Die Zielgruppen-ID

targetDataflowId

string

Die Zieldatenfluss-ID

DependentDatamart

Power BI-abhängiges Datenmart

Name Typ Beschreibung
groupId

string

Die Zielgruppen-ID

targetDatamartId

string

Die Zieldatenmart-ID

DependentDataset

Ein power BI-abhängiges Dataset

Name Typ Beschreibung
groupId

string

Die Zielgruppen-ID

targetDatasetId

string

Die Ziel-Dataset-ID

EndorsementDetails

Details zur Power BI-Bestätigung

Name Typ Beschreibung
certifiedBy

string

Der Benutzer, der das Power BI-Element zertifiziert hat (z. B. einen Bericht oder ein Dashboard)

endorsement

string

Der Bestätigungsstatus

Expression

Ein Datasetausdruck

Name Typ Beschreibung
description

string

Die Ausdrucksbeschreibung

expression

string

Der Ausdruckswert

name

string

Der Ausdrucksname

GroupUser

Ein Power BI-Benutzer mit Zugriff auf den Arbeitsbereich

Name Typ Beschreibung
displayName

string

Anzeigename des Prinzipals

emailAddress

string

E-Mail-Adresse des Benutzers

graphId

string

Bezeichner des Prinzipals in Microsoft Graph. Nur für Administrator-APIs verfügbar.

groupUserAccessRight

GroupUserAccessRight

Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer im Arbeitsbereich verfügt

identifier

string

Bezeichner des Prinzipals

principalType

PrincipalType

Der Prinzipaltyp

profile

ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

userType

string

Typ des Benutzers.

GroupUserAccessRight

Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer im Arbeitsbereich verfügt

Wert Beschreibung
Admin

Administratorrechte für Arbeitsbereichsinhalte

Contributor

Lese- und Erkundungszugriff (ReadExplore) auf Arbeitsbereichsinhalte

Member

Lese-, Freigabe- und Erkundungsrechte (ReadReshareExplore) für Arbeitsbereichsinhalte

None

Kein Zugriff auf Arbeitsbereichsinhalte

Viewer

Schreibgeschützter (Lesezugriff) auf Arbeitsbereichsinhalte

Measure

Ein Power BI-Measure

Name Typ Beschreibung
description

string

Wahlfrei. Die Measurebeschreibung.

expression

string

Ein gültiger DAX-Ausdruck

formatString

string

Wahlfrei. Eine Zeichenfolge, die beschreibt, wie der Wert formatiert werden soll, wenn er wie in FORMAT_STRINGangegeben angezeigt wird.

isHidden

boolean

Wahlfrei. Gibt an, ob das Measure ausgeblendet ist.

name

string

pattern: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]+$

Der Measurename

PrincipalType

Der Prinzipaltyp

Wert Beschreibung
App

Dienstprinzipaltyp

Group

Gruppenprinzipaltyp

None

Kein Prinzipaltyp. Wird für den Zugriff auf ganze Organisationsebene verwendet.

User

Benutzerprinzipaltyp

ReportUser

Ein Power BI-Benutzerzugriffsrecht für einen Bericht

Name Typ Beschreibung
displayName

string

Anzeigename des Prinzipals

emailAddress

string

E-Mail-Adresse des Benutzers

graphId

string

Bezeichner des Prinzipals in Microsoft Graph. Nur für Administrator-APIs verfügbar.

identifier

string

Bezeichner des Prinzipals

principalType

PrincipalType

Der Prinzipaltyp

profile

ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

reportUserAccessRight

ReportUserAccessRight

Das Zugriffsrecht, das der Benutzer für den Bericht hat (Berechtigungsstufe)

userType

string

Typ des Benutzers.

ReportUserAccessRight

Das Zugriffsrecht, das der Benutzer für den Bericht hat (Berechtigungsstufe)

Wert Beschreibung
None

Keine Berechtigung für Inhalte im Bericht

Owner

Gewährt Lese-, Schreib- und Freigabezugriff auf Inhalte im Bericht

Read

Gewährt Lesezugriff auf Inhalte im Bericht

ReadCopy

Gewährt Lese- und Kopierzugriff auf Inhalte im Bericht

ReadReshare

Gewährt Lese- und Freigabezugriff auf Inhalte im Bericht

ReadWrite

Gewährt Lese- und Schreibzugriff auf Inhalte im Bericht

Role

Eine Rolle in der RLS-Konfiguration eines Datasets

Name Typ Beschreibung
members

RoleMember

Ein Array, das die Mitglieder der Rolle auflistet

modelPermission

string

Die Berechtigungen, die die Rolle für das Dataset besitzt. Beispiel: Lesen

name

string

Der Name der Rolle

tablePermissions

RoleTablePermission

Ein Array, das alle für die Rolle definierten Filter auflistet

RoleMember

Ein Rollenmitglied

Name Typ Beschreibung
identityProvider

string

Der Identitätsanbieter für Rollenmitglieder

memberId

string

Die Vom Identitätsanbieter zugewiesene Rollenmitglieds-GUID

memberName

string

Der Name des Rollenmitglieds

memberType

string

Der Rollenmitgliedstyp (Benutzer oder Gruppe)

RoleTablePermission

Ein Rollenfilter

Name Typ Beschreibung
filterExpression

string

Der Ausdruck, der die im Filter angegebene Tabelle filtert

name

string

Der Name der im Filter angegebenen Tabelle

Row

Eine Datenzeile in einem Dataset

Name Typ Beschreibung
id

string

Die eindeutige Zeilen-ID

SensitivityLabel

Informationen zu Vertraulichkeitsbezeichnungen für ein Power BI-Element (z. B. einen Bericht oder ein Dashboard)

Name Typ Beschreibung
labelId

string (uuid)

Die Vertraulichkeitsbezeichnungs-ID

ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

Name Typ Beschreibung
displayName

string

Der Dienstprinzipalprofilname

id

string (uuid)

Die Dienstprinzipalprofil-ID

Table

Eine Datasettabelle

Name Typ Beschreibung
columns

Column[]

Das Spaltenschema für diese Tabelle

description

string

Die Tabellenbeschreibung

isHidden

boolean

Wahlfrei. Gibt an, ob diese Datasettabelle ausgeblendet ist.

measures

Measure[]

Die Measures in dieser Tabelle

name

string

pattern: ^[\x09\x0A\x0D\x20\x23\x2D\x30-\x39\x40-\x5A\x5E-\x5F\x61-\x7A\x7E-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]{1,100}$

Der Tabellenname

rows

Row[]

Die Datenzeilen in dieser Tabelle

source

ASMashupExpression[]

Die Tabellenquelle

WorkspaceInfo

Details zu Arbeitsbereichsinformationen

Name Typ Beschreibung
capacityId

string

Die Arbeitsbereichskapazitäts-ID

dashboards

WorkspaceInfoDashboard[]

Die diesem Arbeitsbereich zugeordneten Dashboards. Die Liste der zurückgegebenen Dashboardeigenschaften variiert für unterschiedliche API-Aufrufe, sodass möglicherweise nicht alle Dashboardeigenschaften in einer API-Antwort angezeigt werden.

dataRetrievalState

string

Der Abrufstatus der Arbeitsbereichsdaten

dataflows

WorkspaceInfoDataflow[]

Die diesem Arbeitsbereich zugeordneten Datenflüsse. Die Liste der zurückgegebenen Datenflusseigenschaften variiert für unterschiedliche API-Aufrufe, sodass möglicherweise nicht alle Datenflusseigenschaften in einer API-Antwort angezeigt werden.

datamarts

WorkspaceInfoDatamart[]

Die diesem Arbeitsbereich zugeordneten Datenmarts. Die Liste der zurückgegebenen Datamart-Eigenschaften variiert für unterschiedliche API-Aufrufe, sodass möglicherweise nicht alle Datamart-Eigenschaften in einer API-Antwort angezeigt werden.

datasets

WorkspaceInfoDataset[]

Die Datasets, die diesem Arbeitsbereich zugeordnet sind. Die Liste der zurückgegebenen Dataseteigenschaften variiert für unterschiedliche API-Aufrufe, sodass möglicherweise nicht alle Dataseteigenschaften in einer API-Antwort angezeigt werden.

defaultDatasetStorageFormat

DefaultDatasetStorageFormat

Das Standardspeicherformat des Datasets im Arbeitsbereich. Wird nur zurückgegeben, wenn isOnDedicatedCapacitytrue

description

string

Beschreibung des Arbeitsbereichs

id

string (uuid)

Die Arbeitsbereichsobjekt-ID

isOnDedicatedCapacity

boolean

Gibt an, ob der Arbeitsbereich einer dedizierten Kapazität zugewiesen ist.

name

string

Der Arbeitsbereichsname

reports

WorkspaceInfoReport[]

Die diesem Arbeitsbereich zugeordneten Berichte. Die Liste der zurückgegebenen Berichtseigenschaften variiert für unterschiedliche API-Aufrufe, sodass möglicherweise nicht alle Berichtseigenschaften in einer API-Antwort angezeigt werden.

state

string

Der Arbeitsbereichsstatus

type

string

Der Arbeitsbereichstyp

users

GroupUser[]

Die Benutzer mit Zugriff auf den Arbeitsbereich. Die Liste wird nur zurückgegeben, wenn sie explizit angefordert wird. Verwenden Sie die Azure Active Directory Graph-API, um eine Liste von Benutzern für einen klassischen Arbeitsbereich abzurufen.

WorkspaceInfoDashboard

Ein Power BI-Dashboard, das von WorkspaceInfo-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste der Dashboardeigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.

Name Typ Beschreibung
appId

string

Die App-ID, die nur zurückgegeben wird, wenn das Dashboard zu einer App gehört

dataClassification

string

Das Datenklassifizierungstag eines Power BI-Elements (z. B. ein Bericht oder ein Dashboard)

displayName

string

Der Anzeigename des Dashboards

id

string (uuid)

Die Dashboard-ID

isReadOnly

boolean

Gibt an, ob das Dashboard schreibgeschützt ist.

sensitivityLabel

SensitivityLabel

Die Vertraulichkeitsbezeichnung

tiles

WorkspaceInfoTile[]

Die Kacheln, die zum Dashboard gehören

users

DashboardUser[]

(Leerer Wert) Details des Dashboardbenutzerzugriffs. Diese Eigenschaft wird aus der Nutzlastantwort in einer bevorstehenden Version entfernt. Sie können Benutzerinformationen auf einem Power BI-Dashboard abrufen, indem Sie den Abrufen von Dashboardbenutzern als Administrator- API-Aufruf oder den PostWorkspaceInfo-API-Aufruf mit dem parameter getArtifactUsers verwenden.

WorkspaceInfoDataflow

Die Metadaten eines datenflusses, der von Arbeitsbereichsinfo-APIs zurückgegeben wird. Nachfolgend finden Sie eine Liste der Eigenschaften, die für einen Datenfluss zurückgegeben werden können. Je nach aufgerufener API, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank werden nur eine Teilmenge der Eigenschaften zurückgegeben.

Name Typ Beschreibung
configuredBy

string

Der Datenflussbesitzer

datasourceUsages

DatasourceUsage[]

Die Datenquellenverwendungen

description

string

Die Beschreibung des Datenflusses

endorsementDetails

EndorsementDetails

Die Bestätigungsdetails

misconfiguredDatasourceUsages

DatasourceUsage[]

Falsch konfigurierte Verwendungen der Datenquelle

modelUrl

string

Eine URL zur Datenflussdefinitionsdatei (model.json)

name

string

Der Name des Datenflusses

objectId

string (uuid)

Die Datenfluss-ID

sensitivityLabel

SensitivityLabel

Die Vertraulichkeitsbezeichnung

upstreamDataflows

DependentDataflow[]

Die Liste aller Datenflüsse dieses Elements hängt von

upstreamDatamarts

DependentDatamart[]

Die Liste aller Datenmarts dieses Elements hängt von

users

DataflowUser[]

(Leerer Wert) Die Datenflussbenutzerzugriffsdetails. Diese Eigenschaft wird aus der Nutzlastantwort in einer bevorstehenden Version entfernt. Sie können Benutzerinformationen für einen Power BI-Datenfluss abrufen, indem Sie den Get Dataflow Users as Admin API-Aufruf oder den PostWorkspaceInfo API-Aufruf mit dem parameter getArtifactUser verwenden.

WorkspaceInfoDatamart

Ein Power BI-Datenmart, das von Arbeitsbereichs-Info-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste der Datamart-Eigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.

Name Typ Beschreibung
configuredBy

string

Der Name des Datamart-Besitzers

configuredById

string

Die ID des Datamart-Besitzers

datasourceUsages

DatasourceUsage[]

Die Datenquellenverwendungen

description

string

Beschreibung des Datamart-Objekts

endorsementDetails

EndorsementDetails

Details zur Datamart-Bestätigung

id

string (uuid)

Die Datamart-ID

modifiedBy

string

Der letzte Benutzer, der das Datamart geändert hat

modifiedById

string

Die ID des letzten Benutzers, der das Datamart geändert hat

modifiedDateTime

string (date-time)

Datum und Uhrzeit der letzten Änderung des Datamart-Objekts

name

string

Der Name des Datamart-Objekts

sensitivityLabel

SensitivityLabel

Die Vertraulichkeitsbezeichnung "datamart"

state

datamartState

Aktueller Status des Datamart-Objekts

status

datamartStatus

Der Datamart-Status

suspendedBatchId

string

datamart suspended batch id

type

datamartType

Der Datentyp

upstreamDataflows

DependentDataflow[]

Die Liste aller Datenflüsse dieses Elements hängt von

upstreamDatamarts

DependentDatamart[]

Die Liste aller Datenmarts dieses Elements hängt von

users

DatamartUser[]

Der Benutzer greift auf Details für ein Power BI-Datenmart zu.

WorkspaceInfoDataset

Ein power BI-Dataset, das von WorkspaceInfo-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste der Dataseteigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank ab.

Name Typ Beschreibung
ContentProviderType

string

Eine veraltete Eigenschaft, die ignoriert werden soll.

configuredBy

string

Der Datasetbesitzer

createdDate

string (date-time)

Datum und Uhrzeit der Datensatzerstellung

datasourceUsages

DatasourceUsage[]

Die Datenquellenverwendungen

description

string

Beschreibung des Datasets

endorsementDetails

EndorsementDetails

Die Bestätigungsdetails

expressions

Expression[]

Die Datasetausdrücke

id

string

Die Dataset-ID

misconfiguredDatasourceUsages

DatasourceUsage[]

Falsch konfigurierte Verwendungen der Datenquelle

name

string

Der Datasetname

roles

Role[]

Die Datasetrollen

schemaMayNotBeUpToDate

boolean

Gibt an, ob das Datasetschema möglicherweise nicht auf dem neuesten Stand ist

schemaRetrievalError

string

Fehler beim Abrufen des Datasetschemas

sensitivityLabel

SensitivityLabel

Die Vertraulichkeitsbezeichnung

tables

Table[]

Die Datasettabellen

targetStorageMode

string

Der Datasetspeichermodus

upstreamDataflows

DependentDataflow[]

Die Liste aller Datenflüsse dieses Elements hängt von

upstreamDatamarts

DependentDatamart[]

Die Liste aller Datenmarts dieses Elements hängt von

upstreamDatasets

DependentDataset[]

Die upstream-Datasets

users

DatasetUser[]

(Leerer Wert) Die Details des Datasetbenutzerzugriffs. Diese Eigenschaft wird aus der Nutzlastantwort in einer bevorstehenden Version entfernt. Sie können Benutzerinformationen zu einem Power BI-Element (z. B. einem Bericht oder einem Dashboard) abrufen, indem Sie die Get Dataset Users as Admin API oder die PostWorkspaceInfo API mit dem getArtifactUsers Parameter verwenden.

WorkspaceInfoReport

Ein Power BI-Bericht, der von Arbeitsbereichs-Info-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste der Berichtseigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.

Name Typ Beschreibung
appId

string

Die App-ID, die nur zurückgegeben wird, wenn der Bericht zu einer App gehört

createdBy

string

Der Berichtsbesitzer. Nur für Berichte verfügbar, die nach Juni 2019 erstellt wurden.

createdById

string

Die ID des Berichtsbesitzers. Nur für Berichte verfügbar, die nach Juni 2019 erstellt wurden.

createdDateTime

string (date-time)

Datum und Uhrzeit der Berichtserstellung

datasetId

string

Die Dataset-ID des Berichts

datasetWorkspaceId

string (uuid)

Die Arbeitsbereichs-ID des verknüpften Datasets, die nur zurückgegeben wird, wenn das zugehörige Dataset zu einem anderen Arbeitsbereich gehört

description

string

Beschreibung des Berichts

endorsementDetails

EndorsementDetails

Die Bestätigungsdetails

id

string (uuid)

Die Berichts-ID

isOwnedByMe

boolean

Gibt an, ob der aktuelle Benutzer entweder eine Kopie des Berichts ändern oder erstellen kann.

modifiedBy

string

Der letzte Benutzer, der den Bericht geändert hat

modifiedById

string

Die ID des letzten Benutzers, der den Bericht geändert hat

modifiedDateTime

string (date-time)

Datum und Uhrzeit der letzten Änderung des Berichts

name

string

Der Name des Berichts. App-Berichte beginnen mit dem Präfix [App].

originalReportId

string (uuid)

Die tatsächliche Berichts-ID, wenn der Arbeitsbereich als App veröffentlicht wird.

reportType enum:
  • PaginatedReport
  • PowerBIReport

Der Berichtstyp

sensitivityLabel

SensitivityLabel

Die Vertraulichkeitsbezeichnung

users

ReportUser[]

(Leerer Wert) Der Benutzer greift auf Details für einen Power BI-Bericht zu. Diese Eigenschaft wird aus der Nutzlastantwort in einer bevorstehenden Version entfernt. Sie können Benutzerinformationen in einem Power BI-Bericht abrufen, indem Sie die Abrufen von Berichtsbenutzern als Administrator- API-Aufruf oder den PostWorkspaceInfo API-Aufruf mit dem parameter getArtifactUsers verwenden.

WorkspaceInfoResponse

Antwort auf Arbeitsbereichsinformationen

Name Typ Beschreibung
datasourceInstances

Datasource[]

Die dieser Überprüfung zugeordneten Datenquelleninstanzen

misconfiguredDatasourceInstances

Datasource[]

Die mit dieser Überprüfung verknüpften falsch konfigurierten Instanzen der Datenquelle

workspaces

WorkspaceInfo[]

Die Arbeitsbereichsinformationen, die dieser Überprüfung zugeordnet sind

WorkspaceInfoTile

Eine Power BI-Kachel, die von WorkspaceInfo-APIs zurückgegeben wird

Name Typ Beschreibung
datasetId

string

Die Dataset-ID. Nur für Kacheln verfügbar, die aus einem Bericht oder mithilfe eines Datasets erstellt wurden, z. B. Q&A-Kacheln.

datasetWorkspaceId

string (uuid)

Die Arbeitsbereichs-ID des verknüpften Datasets, die nur zurückgegeben wird, wenn das zugehörige Dataset zu einem anderen Arbeitsbereich gehört

id

string (uuid)

Die Kachel-ID

reportId

string (uuid)

Die Berichts-ID. Nur für Kacheln verfügbar, die aus einem Bericht erstellt wurden.

title

string

Der Anzeigename der Kachel