Admin - WorkspaceInfo GetScanResult

Referenz

Service:: 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 durch. Das Scanergebnis bleibt 24 Stunden lang verfügbar.

Berechtigungen

Der Benutzer muss über Administratorrechte (z. B. globaler Microsoft 365-Administrator oder Power BI-Dienstadministrator) verfügen oder sich über einen Dienstprinzipal authentifizieren.

Bei der Ausführung unter Dienstprinzipalauthentifizierung dürfen für eine App im Azure-Portal keine erforderlichen Administratorberechtigungen für Power BI festgelegt sein.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

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

Einschränkungen

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 aus den Arbeitsbereichen oder im api-Aufruf von Admin – WorkspaceInfo PostWorkspaceInfo enthalten ist, der die Überprüfung ausgelöst hat.

Antworten

Name	Typ	Beschreibung
200 OK	WorkspaceInfoResponse	OK

Beispiele

Example

Sample Request

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

Sample Response

Status code:: 200

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

Definitionen

Name	Beschreibung
ASMashupExpression	Eine Datasettabellenquelle
Column	Eine Datasetspalte
DashboardUser	Ein Power BI-Benutzerzugriffsrechteintrag für eine Dashboard
DashboardUserAccessRight	Das Zugriffsrecht, das der Benutzer für die Dashboard hat (Berechtigungsstufe)
DataflowUser	Ein Power BI-Benutzerzugriffsrechteintrag für einen Dataflow
DataflowUserAccessRight	Das Zugriffsrecht, das ein Benutzer für den Dataflow hat (Berechtigungsstufe)
datamartState	Der aktuelle Status von datamart
datamartStatus	Datamart-status
datamartType	Der Datamart-Typ
DatamartUser	Ein Power BI-Benutzerzugriffsrechteintrag für einen Bericht
DatamartUserAccessRight	Das Zugriffsrecht, das der Benutzer für den Datamart hat (Berechtigungsstufe)
DatasetUser	Ein Power BI-Benutzerzugriffsrechteintrag für ein Dataset
DatasetUserAccessRight	Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)
Datasource	Eine Power BI-Datenquelle
DatasourceConnectionDetails	Die Verbindungsdetails der Power BI-Datenquelle. Weitere Informationen finden Sie unter Abrufen von Datenquellen oder Abrufen von Datenquellen in Gruppe.
DatasourceUsage	Datenquellennutzung
DefaultDatasetStorageFormat	Das Standarddatasetspeicherformat in der Gruppe
DependentDataflow	Ein abhängiger Power BI-Dataflow
DependentDatamart	Ein abhängiger Power BI-Datamart
DependentDataset	Ein abhängiges Power BI-Dataset
EndorsementDetails	Details zur Power BI-Unterstützung
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-Benutzerzugriffsrechteintrag 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	Vertraulichkeitsbezeichnungsinformationen für ein Power BI-Element (z. B. einen Bericht oder eine Dashboard)
ServicePrincipalProfile	Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.
Table	Eine Datasettabelle
WorkspaceInfo	Details zu Arbeitsbereichsinformationen
WorkspaceInfoDashboard	Eine Power BI-Dashboard von WorkspaceInfo-APIs zurückgegeben. Die API gibt eine Teilmenge der folgenden Liste von Dashboard Eigenschaften zurück. Die Teilmenge hängt von der API namens, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.
WorkspaceInfoDataflow	Die Metadaten eines Dataflows, der von Arbeitsbereichsinformations-APIs zurückgegeben wird. Im Folgenden finden Sie eine Liste der Eigenschaften, die für einen Dataflow zurückgegeben werden können. Nur eine Teilmenge der Eigenschaften wird abhängig von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank zurückgegeben.
WorkspaceInfoDatamart	Ein Power BI-Datenmart, der von Arbeitsbereichsinformations-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste der Datamart-Eigenschaften zurück. Die Teilmenge hängt von der API namens, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.
WorkspaceInfoDataset	Ein Von WorkspaceInfo-APIs zurückgegebenes Power BI-Dataset. Die API gibt eine Teilmenge der folgenden Liste der Dataseteigenschaften zurück. Die Teilmenge hängt von der API namens, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank ab.
WorkspaceInfoReport	Ein Power BI-Bericht, der von Arbeitsbereichsinfo-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste der Berichtseigenschaften zurück. Die Teilmenge hängt von der API namens, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.
WorkspaceInfoResponse	Antwort auf Arbeitsbereichsinformationen
WorkspaceInfoTile	Eine von WorkspaceInfo-APIs zurückgegebene Power BI-Kachel

ASMashupExpression

Eine Datasettabellenquelle

Name	Typ	Beschreibung
expression	string	Der Quellausdruck

Column

Eine Datasetspalte

Name	Typ	Beschreibung
dataCategory	string	Optional. Der Zeichenfolgenwert, der für die Datenkategorie verwendet werden soll, die die Daten in dieser Spalte beschreibt.
dataType	string	Der Spaltendatentyp
formatString	string	Optional. Das Format der Spalte, wie in FORMAT_STRING angegeben.
isHidden	boolean	Optional. Gibt an, ob die Spalte ausgeblendet ist. Der Standardwert ist `false`.
name	string	Der Spaltenname
sortByColumn	string	Optional. Zeichenfolgenname einer Spalte in der gleichen Tabelle, die zum Sortieren der aktuellen Spalte verwendet werden soll.
summarizeBy	string	Dies ist optional. Die Aggregatfunktion, die zum Zusammenfassen dieser Spalte verwendet werden soll.

DashboardUser

Ein Power BI-Benutzerzugriffsrechteintrag für eine Dashboard

Name	Typ	Beschreibung
dashboardUserAccessRight	DashboardUserAccessRight	Das Zugriffsrecht, das der Benutzer für die 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-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.
userType	string	Typ des Benutzers.

DashboardUserAccessRight

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

Name	Typ	Beschreibung
None	string	Keine Berechtigung für Inhalte in Dashboard
Owner	string	Gewährt Lese-, Schreib- und erneuten Zugriff auf Inhalte im Bericht
Read	string	Gewährt Lesezugriff auf Inhalte in Dashboard
ReadCopy	string	Gewährt Lese- und Kopierzugriff auf Inhalte in Dashboard
ReadReshare	string	Gewährt lese- und erneuten Zugriff auf Inhalte in Dashboard
ReadWrite	string	Gewährt Lese- und Schreibzugriff auf Inhalte in Dashboard

DataflowUser

Ein Power BI-Benutzerzugriffsrechteintrag für einen Dataflow

Name	Typ	Beschreibung
DataflowUserAccessRight	DataflowUserAccessRight	Das Zugriffsrecht, das ein Benutzer für den Dataflow 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-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.
userType	string	Typ des Benutzers.

DataflowUserAccessRight

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

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

datamartState

Der aktuelle Status von datamart

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

datamartStatus

Datamart-status

Name	Typ	Beschreibung
Available	string	Der Datamart ist verfügbar.
Error	string	Der Datamart weist einen Fehler auf, status
InProgress	string	Der Datamart wird ausgeführt.
Invalid	string	Der Datamart weist ungültige status
NoCapacity	string	Der Datamart verfügt über keine Kapazität.
OutOfRegion	string	Der Datamart befindet sich außerhalb der Region.
SuspendedInCriticalPhase	string	Der Datamart wird in der kritischen Phase angehalten.

datamartType

Der Datamart-Typ

Name	Typ	Beschreibung
Dataverse	string	Der Datamart ist vom Dataverse-Typ.
Datawarehouse	string	Der Datamart ist vom Typ Datawarehouse.
Ignore	string	Der Datamart hat keinen Typ.
Lakehouse	string	Der Datamart ist vom Lakehouse-Typ.
Sql	string	Der Datamart hat den Sql-Typ.
Unset	string	Der Datamart-Typ wurde nicht festgelegt.

DatamartUser

Ein Power BI-Benutzerzugriffsrechteintrag für einen Bericht

Name	Typ	Beschreibung
datamartUserAccessRight	DatamartUserAccessRight	Das Zugriffsrecht, das der Benutzer für den 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-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.
userType	string	Typ des Benutzers.

DatamartUserAccessRight

Das Zugriffsrecht, das der Benutzer für den 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 Untersuchungszugriff auf Inhalte in datamart
ReadReshare	string	Gewährt Lese- und erneuten Zugriff auf Inhalte in datamart
ReadReshareExplore	string	Gewährt lese- und erneuten Freigaben und Untersuchen des Zugriffs auf Inhalte in datamart
ReadWrite	string	Gewährt Lese- und Schreibzugriff auf Inhalte in datamart
ReadWriteExplore	string	Gewährt Lese- und Schreibzugriff sowie Untersuchen des Zugriffs auf Inhalte in datamart
ReadWriteReshare	string	Gewährt Lese- und Schreibzugriff sowie erneutes Freigeben von Zugriff auf Inhalte in datamart
ReadWriteReshareExplore	string	Gewährt Lese- und Schreibzugriff sowie erneutes Freigeben und Untersuchen 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-Benutzerzugriffsrechteintrag 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-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.
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 Erneuten Freigabezugriff auf den Inhalt im Dataset
ReadReshareExplore	string	Gewährt Lese-, Freigabe- und Erkundungszugriff auf den Inhalt im Dataset.
ReadWrite	string	Gewährt Lese- und Schreibzugriff auf den Inhalt im Dataset
ReadWriteExplore	string	Gewährt Lese-, Schreib- und Erkundungszugriff auf den Inhalt im Dataset.
ReadWriteReshare	string	Gewährt Lese-, Schreib- und freigabezugriff auf den Inhalt im Dataset
ReadWriteReshareExplore	string	Gewährt Lese-, Schreib-, Freigabe- und Erkundungszugriff auf den Inhalt im Dataset.

Datasource

Eine Power BI-Datenquelle

Name	Typ	Beschreibung
connectionDetails	DatasourceConnectionDetails	Die Verbindungsdetails der Datenquelle
connectionString	string	(veraltet) Die Datenquelle Verbindungszeichenfolge. 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 Verbindungsdetails der Power BI-Datenquelle. Weitere Informationen finden Sie unter Abrufen von Datenquellen oder Abrufen von Datenquellen in Gruppe.

Name	Typ	Beschreibung
account	string	Das Verbindungskonto
classInfo	string	Informationen zur Verbindungsklasse
database	string	Die Verbindungsdatenbank
domain	string	Die Verbindungsdomäne
emailAddress	string	Die E-Mail-Adresse der Verbindung
kind	string	Verbindungsart
loginServer	string	Verbindungsanmeldungsserver
path	string	Verbindungspfad
server	string	Verbindungsserver
url	string	Die Verbindungs-URL

DatasourceUsage

Datenquellennutzung

Name	Typ	Beschreibung
datasourceInstanceId	string	Die Instance-ID der Datenquelle

DefaultDatasetStorageFormat

Das Standarddatasetspeicherformat in der Gruppe

Name	Typ	Beschreibung
Large	string	Speicherformat für großes Datasets
Small	string	Speicherformat für kleine Datasets

DependentDataflow

Ein abhängiger Power BI-Dataflow

Name	Typ	Beschreibung
groupId	string	Die Zielgruppen-ID
targetDataflowId	string	Die Ziel-Dataflow-ID

DependentDatamart

Ein abhängiger Power BI-Datamart

Name	Typ	Beschreibung
groupId	string	Die Zielgruppen-ID
targetDatamartId	string	Die Ziel-Datamart-ID

DependentDataset

Ein abhängiges Power BI-Dataset

Name	Typ	Beschreibung
groupId	string	Die Zielgruppen-ID
targetDatasetId	string	Die Zieldataset-ID

EndorsementDetails

Details zur Power BI-Unterstützung

Name	Typ	Beschreibung
certifiedBy	string	Der Benutzer, der das Power BI-Element zertifiziert hat (z. B. ein Bericht oder ein Dashboard)
endorsement	string	Die status

Expression

Ein Datasetausdruck

Name	Typ	Beschreibung
description	string	Die Ausdrucksbeschreibung
expression	ASMashupExpression	Eine Datasettabellenquelle
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), das ein Benutzer im Arbeitsbereich hat
identifier	string	Bezeichner des Prinzipals
principalType	PrincipalType	Der Prinzipaltyp
profile	ServicePrincipalProfile	Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.
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	Lesen und Erkunden des Zugriffs (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	Optional. Die Measurebeschreibung.
expression	string	Ein gültiger DAX-Ausdruck
formatString	string	Optional. Eine Zeichenfolge, die beschreibt, wie der Wert formatiert werden soll, wenn er wie in FORMAT_STRING angegeben angezeigt wird.
isHidden	boolean	Optional. 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. Verwenden Sie für den Zugriff auf die gesamte organization ebene.
User	string	Benutzerprinzipaltyp

ReportUser

Ein Power BI-Benutzerzugriffsrechteintrag 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-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.
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 erneuten Zugriff 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 erneuten Zugriff 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, über die die Rolle für das Dataset verfügt. 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 Rollenmitglied
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

Vertraulichkeitsbezeichnungsinformationen für ein Power BI-Element (z. B. einen Bericht oder eine Dashboard)

Name	Typ	Beschreibung
labelId	string	Die Vertraulichkeitsbezeichnungs-ID

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.

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	Optional. 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 Dashboard zurückgegebenen Eigenschaften variiert für verschiedene API-Aufrufe, sodass möglicherweise nicht alle Dashboard Eigenschaften in einer API-Antwort angezeigt werden.
dataRetrievalState	string	Der Datenabrufstatus des Arbeitsbereichs
dataflows	WorkspaceInfoDataflow[]	Die diesem Arbeitsbereich zugeordneten Dataflows. Die Liste der zurückgegebenen Datafloweigenschaften variiert für verschiedene API-Aufrufe, sodass möglicherweise nicht alle Datafloweigenschaften in einer API-Antwort angezeigt werden.
datamarts	WorkspaceInfoDatamart[]	Die diesem Arbeitsbereich zugeordneten Datamarts. 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 Standarddatasetspeicherformat im Arbeitsbereich. 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	Arbeitsbereichstyp
users	GroupUser[]	Die Benutzer mit Zugriff auf den Arbeitsbereich. Die Liste wird nur zurückgegeben, wenn sie explizit angefordert wird. Um eine Liste von Benutzern für einen klassischen Arbeitsbereich abzurufen, verwenden Sie die Azure Active Directory-Graph-API.

WorkspaceInfoDashboard

Eine Power BI-Dashboard von WorkspaceInfo-APIs zurückgegeben. Die API gibt eine Teilmenge der folgenden Liste von Dashboard Eigenschaften zurück. Die Teilmenge hängt von der API namens, 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 die 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 Dashboard
id	string	Die Dashboard-ID
isReadOnly	boolean	Gibt an, ob der Dashboard schreibgeschützt ist
sensitivityLabel	SensitivityLabel	Die Vertraulichkeitsbezeichnung
tiles	WorkspaceInfoTile[]	Die Kacheln, die zum Dashboard
users	DashboardUser[]	(Leerer Wert) Die Dashboard Benutzerzugriffsdetails. Diese Eigenschaft wird in einer bevorstehenden Version aus der Nutzlastantwort entfernt. Sie können Benutzerinformationen zu einem Power BI-Dashboard abrufen, indem Sie den Api-Aufruf "Dashboardbenutzer abrufen" als Admin API-Aufruf oder den PostWorkspaceInfo-API-Aufruf mit dem `getArtifactUsers` Parameter verwenden.

WorkspaceInfoDataflow

Die Metadaten eines Dataflows, der von Arbeitsbereichsinformations-APIs zurückgegeben wird. Im Folgenden finden Sie eine Liste der Eigenschaften, die für einen Dataflow zurückgegeben werden können. Nur eine Teilmenge der Eigenschaften wird abhängig von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank zurückgegeben.

Name	Typ	Beschreibung
configuredBy	string	Der Dataflowbesitzer
datasourceUsages	DatasourceUsage[]	Die Datenquellenverwendungen
description	string	Beschreibung des Dataflows
endorsementDetails	EndorsementDetails	Details zur Billigung
misconfiguredDatasourceUsages	DatasourceUsage[]	Falsch konfigurierte Verwendungen der Datenquelle
modelUrl	string	Eine URL zur Dataflowdefinitionsdatei (model.json)
modifiedBy	string	Der Benutzer, der den Dataflow geändert hat
modifiedDateTime	string	Datum und Uhrzeit der letzten Änderung des Dataflows
name	string	Der Dataflowname
objectId	string	Die Dataflow-ID
sensitivityLabel	SensitivityLabel	Die Vertraulichkeitsbezeichnung
upstreamDataflows	DependentDataflow[]	Die Liste aller Dataflows, von der dieses Element abhängt
upstreamDatamarts	DependentDatamart[]	Die Liste aller Datamarts, von der dieses Element abhängt
users	DataflowUser[]	(Leerer Wert) Die Datenflussbenutzerzugriffsdetails. Diese Eigenschaft wird in einer bevorstehenden Version aus der Nutzlastantwort entfernt. Sie können Benutzerinformationen zu einem Power BI-Dataflow abrufen, indem Sie dataflow-Benutzer als Admin API-Aufruf oder den PostWorkspaceInfo-API-Aufruf mit dem `getArtifactUser` Parameter verwenden.

WorkspaceInfoDatamart

Ein Power BI-Datenmart, der von Arbeitsbereichsinformations-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste der Datamart-Eigenschaften zurück. Die Teilmenge hängt von der API namens, 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	Die Datamart-Beschreibung
endorsementDetails	EndorsementDetails	Details zur Datamart-Unterstützung
id	string	Die datamart-ID
modifiedBy	string	Der letzte Benutzer, der den datamart geändert hat
modifiedById	string	Die ID des letzten Benutzers, der den Datamart geändert hat
modifiedDateTime	string	Datum und Uhrzeit der letzten Änderung des Datamart
name	string	Der Datamart-Name
sensitivityLabel	SensitivityLabel	Die Datamart-Vertraulichkeitsbezeichnung
state	datamartState	Der aktuelle Zustand von datamart
status	datamartStatus	Datamart-status
suspendedBatchId	string	datamart-Batch-ID angehalten
type	datamartType	Der Datamart-Typ
upstreamDataflows	DependentDataflow[]	Die Liste aller Dataflows, von der dieses Element abhängt
upstreamDatamarts	DependentDatamart[]	Die Liste aller Datamarts, von der dieses Element abhängt
users	DatamartUser[]	Die Benutzerzugriffsdetails für einen Power BI-Datamart.

WorkspaceInfoDataset

Ein Von WorkspaceInfo-APIs zurückgegebenes Power BI-Dataset. Die API gibt eine Teilmenge der folgenden Liste der Dataseteigenschaften zurück. Die Teilmenge hängt von der API namens, 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
CreatedDate	string	Datum und Uhrzeit der Dataseterstellung
configuredBy	string	Der Datasetbesitzer
datasourceUsages	DatasourceUsage[]	Die Datenquellenverwendungen
description	string	Beschreibung des Datasets
endorsementDetails	EndorsementDetails	Details zur Billigung
expressions	Expression[]	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[]	Datasettabellen
targetStorageMode	string	Der Datasetspeichermodus
upstreamDataflows	DependentDataflow[]	Die Liste aller Dataflows, von der dieses Element abhängt
upstreamDatamarts	DependentDatamart[]	Die Liste aller Datamarts, von der dieses Element abhängt
upstreamDatasets	DependentDataset[]	Die Upstream Datasets
users	DatasetUser[]	(Leerer Wert) Die Details des Datasetbenutzerzugriffs. Diese Eigenschaft wird in einer bevorstehenden Version aus der Nutzlastantwort 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 Arbeitsbereichsinfo-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste der Berichtseigenschaften zurück. Die Teilmenge hängt von der API namens, 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 zugehörigen Datasets, die nur zurückgegeben wird, wenn das zugehörige Dataset zu einem anderen Arbeitsbereich gehört.
description	string	Beschreibung des Berichts
endorsementDetails	EndorsementDetails	Details zur Billigung
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) Die Benutzerzugriffsdetails für einen Power BI-Bericht. Diese Eigenschaft wird in einer bevorstehenden Version aus der Nutzlastantwort entfernt. Sie können Benutzerinformationen für einen Power BI-Bericht abrufen, indem Sie berichtsbenutzer als Admin API-Aufruf oder den PostWorkspaceInfo-API-Aufruf mit dem `getArtifactUsers` Parameter 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 Datenquelleninstanzen
workspaces	WorkspaceInfo[]	Die Arbeitsbereichsinformationen, die dieser Überprüfung zugeordnet sind

WorkspaceInfoTile

Eine von WorkspaceInfo-APIs zurückgegebene Power BI-Kachel

Name	Typ	Beschreibung
datasetId	string	Die Dataset-ID. Verfügbar nur für Kacheln, die aus einem Bericht oder mithilfe eines Datasets erstellt wurden, z. B. Q&A-Kacheln.
datasetWorkspaceId	string	Die Arbeitsbereichs-ID des zugehörigen 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