Admin - WorkspaceInfo GetScanResult

Referenz

Dienst:: Power BI REST APIs

API-Version:: v1.0

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

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

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	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)

Name	Typ	Beschreibung
None	string	Keine Berechtigung für Inhalte im Dashboard
Owner	string	Gewährt Lese-, Schreib- und Freigabezugriff auf Inhalte im Bericht
Read	string	Gewährt Lesezugriff auf Inhalte im Dashboard
ReadCopy	string	Gewährt Lese- und Kopierzugriff auf Inhalte im Dashboard
ReadReshare	string	Gewährt Lese- und Freigabezugriff auf Inhalte im Dashboard
ReadWrite	string	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)

Name	Typ	Beschreibung
None	string	Entfernt die Berechtigung für Inhalte im Datenfluss.
Owner	string	Gewährt Lese-, Schreib- und Freigabezugriff auf Inhalte im Datenfluss
Read	string	Gewährt Lesezugriff auf Inhalte im Datenfluss
ReadReshare	string	Gewährt Lese- und Freigabezugriff auf Inhalte im Datenfluss
ReadWrite	string	Gewährt Lese- und Schreibzugriff auf Inhalte im Datenfluss

datamartState

Aktueller Status des Datamart-Objekts

Name	Typ	Beschreibung
Active	string	Das Datamart-Objekt ist aktiv.
Deleted	string	Das Datamart-Objekt wurde gelöscht.
Evicted	string	Das Datamart wurde entfernt.
Initialized	string	Das Datamart-Objekt wurde initialisiert.
Invalid	string	Der Datamart-Wert weist einen ungültigen Zustand auf.
Migrating	string	Das Datamart-Objekt wird migriert.

datamartStatus

Der Datamart-Status

Name	Typ	Beschreibung
Available	string	Das Datamart-Objekt ist verfügbar.
Error	string	Der Datamart-Objekt weist den Fehlerstatus auf.
InProgress	string	Das Datamart-Objekt wird ausgeführt.
Invalid	string	Der Datamart-Wert weist einen ungültigen Status auf.
NoCapacity	string	Das Datamart-Objekt hat keine Kapazität.
OutOfRegion	string	Das Datamart-Objekt liegt außerhalb des Bereichs.
SuspendedInCriticalPhase	string	Das Datamart-Objekt wird in kritischer Phase angehalten.

datamartType

Der Datentyp

Name	Typ	Beschreibung
Dataverse	string	Das Datamart-Objekt ist vom Datentyp "Dataverse"
Datawarehouse	string	Das Datamart-Objekt ist vom Datentyp "Datawarehouse"
Ignore	string	Das Datamart-Objekt hat keinen Typ.
Lakehouse	string	Der Datamart-Typ ist vom Lakehouse-Typ.
Sql	string	Das Datamart-Objekt ist vom Sql-Typ
Unset	string	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)

Name	Typ	Beschreibung
Explore	string	Gewährt Den Zugriff auf Inhalte in Datamart
None	string	Keine Berechtigung für Inhalte in datamart
Read	string	Gewährt Lesezugriff auf Inhalte in Datamart
ReadExplore	string	Gewährt Lese- und Erkundungszugriff auf Inhalte in datamart
ReadReshare	string	Gewährt Lese- und Freigabezugriff auf Inhalte in datamart
ReadReshareExplore	string	Gewährt Lese- und Erneutes Freigeben und Erkunden des Zugriffs auf Inhalte in datamart
ReadWrite	string	Gewährt Lese- und Schreibzugriff auf Inhalte in datamart
ReadWriteExplore	string	Gewährt Lese- und Schreibzugriff auf Inhalte in Datamart
ReadWriteReshare	string	Gewährt Lese-, Schreib- und Freigabezugriff auf Inhalte in datamart
ReadWriteReshareExplore	string	Gewährt Lese- und Schreibzugriff und erneute Freigabe und Erkunden des Zugriffs auf Inhalte in datamart
Reshare	string	Gewährt erneuten Zugriff auf Inhalte in datamart
Write	string	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)

Name	Typ	Beschreibung
None	string	Entfernt die Berechtigung für den Inhalt im Dataset.
Read	string	Gewährt Lesezugriff auf den Inhalt im Dataset
ReadExplore	string	Gewährt Lese- und Erkundungszugriff auf den Inhalt im Dataset
ReadReshare	string	Gewährt Lese- und Freigabezugriff auf den Inhalt im Dataset
ReadReshareExplore	string	Gewährt Lese-, Freigabe- und Erkunden des Zugriffs auf den Inhalt im Dataset
ReadWrite	string	Gewährt Lese- und Schreibzugriff auf den Inhalt im Dataset
ReadWriteExplore	string	Gewährt Lese-, Schreib- und Erkunden des Zugriffs auf den Inhalt im Dataset
ReadWriteReshare	string	Gewährt Lese-, Schreib- und Freigabezugriff auf den Inhalt im Dataset
ReadWriteReshareExplore	string	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	Die gebundene Datenquellen-ID, die leer ist, wenn sie nicht an ein Gateway gebunden ist
datasourceType	string	Der Datenquellentyp
gatewayId	string	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	Die Datenquelleninstanz-ID

DefaultDatasetStorageFormat

Das Standardmäßige Datasetspeicherformat in der Gruppe

Name	Typ	Beschreibung
Large	string	Großes Dataset-Speicherformat
Small	string	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

Name	Typ	Beschreibung
Admin	string	Administratorrechte für Arbeitsbereichsinhalte
Contributor	string	Lese- und Erkundungszugriff (ReadExplore) auf Arbeitsbereichsinhalte
Member	string	Lese-, Freigabe- und Erkundungsrechte (ReadReshareExplore) für Arbeitsbereichsinhalte
None	string	Kein Zugriff auf Arbeitsbereichsinhalte
Viewer	string	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	Der Measurename

PrincipalType

Der Prinzipaltyp

Name	Typ	Beschreibung
App	string	Dienstprinzipaltyp
Group	string	Gruppenprinzipaltyp
None	string	Kein Prinzipaltyp. Wird für den Zugriff auf ganze Organisationsebene verwendet.
User	string	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)

Name	Typ	Beschreibung
None	string	Keine Berechtigung für Inhalte im Bericht
Owner	string	Gewährt Lese-, Schreib- und Freigabezugriff auf Inhalte im Bericht
Read	string	Gewährt Lesezugriff auf Inhalte im Bericht
ReadCopy	string	Gewährt Lese- und Kopierzugriff auf Inhalte im Bericht
ReadReshare	string	Gewährt Lese- und Freigabezugriff auf Inhalte im Bericht
ReadWrite	string	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	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	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	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	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	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	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	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	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	Der Inhaltsanbietertyp für das Dataset
configuredBy	string	Der Datasetbesitzer
createdDate	string	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	Datum und Uhrzeit der Berichtserstellung
datasetId	string	Die Dataset-ID des Berichts
datasetWorkspaceId	string	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	Die Berichts-ID
isOwnedByMe	boolean	Ermitteln Sie, ob der Bericht vom aktuellen Benutzer erstellt wird.
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	Datum und Uhrzeit der letzten Änderung des Berichts
name	string	Der Name des Berichts
originalReportId	string	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	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	Die Kachel-ID
reportId	string	Die Berichts-ID. Nur für Kacheln verfügbar, die aus einem Bericht erstellt wurden.
title	string	Der Anzeigename der Kachel

Freigeben über