Condividi tramite


Admin - WorkspaceInfo GetScanResult

Ottiene il risultato dell'analisi per l'analisi specificata.

Effettuare questa chiamata API solo dopo una chiamata API GetScanStatus riuscita . Il risultato dell'analisi rimarrà disponibile per 24 ore.

Autorizzazioni

L'utente deve disporre dei diritti di amministratore (ad esempio Amministratore globale di Microsoft 365 o Amministratore del servizio Power BI) o eseguire l'autenticazione tramite un'entità servizio.

Quando viene eseguita con l'autenticazione dell'entità servizio, un'app non deve avere autorizzazioni necessarie per il consenso amministratore per Power BI impostate nel portale di Azure.

Ambito obbligatorio

Tenant.Read.All o Tenant.ReadWrite.All

Rilevante solo quando si esegue l'autenticazione tramite un token di accesso amministratore delegato standard. Non deve essere presente quando viene usata l'autenticazione tramite un'entità servizio.

Limitazioni

Massimo 500 richieste all'ora.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
scanId
path True

string

uuid

ID di analisi, incluso nella risposta dalle aree di lavoro o dalla chiamata API Amministrazione - WorkspaceInfo PostWorkspaceInfo che ha attivato l'analisi.

Risposte

Nome Tipo Descrizione
200 OK

WorkspaceInfoResponse

OK

Esempio

Example

Sample Request

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

Sample Response

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

Definizioni

Nome Descrizione
ASMashupExpression

Origine tabella del set di dati

Column

Colonna del set di dati

DashboardUser

Voce di diritto di accesso utente di Power BI per un dashboard

DashboardUserAccessRight

Diritto di accesso a cui l'utente ha per il dashboard (livello di autorizzazione)

DataflowUser

Voce di accesso dell'utente di Power BI per un flusso di dati

DataflowUserAccessRight

Diritto di accesso a cui un utente ha per il flusso di dati (livello di autorizzazione)

datamartState

Stato corrente datamart

datamartStatus

Stato datamart

datamartType

Tipo di datamart

DatamartUser

Voce a destra dell'accesso utente di Power BI per un report

DatamartUserAccessRight

Diritto di accesso a cui l'utente ha per il datamart (livello di autorizzazione)

DatasetUser

Voce a destra dell'accesso utente di Power BI per un set di dati

DatasetUserAccessRight

Diritto di accesso a cui l'utente ha per il set di dati (livello di autorizzazione)

Datasource

Origine dati di Power BI

DatasourceConnectionDetails

Dettagli della connessione all'origine dati di Power BI. Vedere esempi in Recupera origini dati o Recupera origini dati in gruppo.

DatasourceUsage

Utilizzo delle origini dati

DefaultDatasetStorageFormat

Formato di archiviazione del set di dati predefinito nel gruppo

DependentDataflow

Flusso di dati dipendente da Power BI

DependentDatamart

Un datamart dipendente da Power BI

DependentDataset

Set di dati dipendenti di Power BI

EndorsementDetails

Dettagli sull'autenticità di Power BI

Expression

Espressione del set di dati

GroupUser

Un utente di Power BI con accesso all'area di lavoro

GroupUserAccessRight

Diritto di accesso (livello di autorizzazione) che un utente ha nell'area di lavoro

Measure

Una misura di Power BI

PrincipalType

Tipo principale

ReportUser

Voce di diritto di accesso utente di Power BI per un report

ReportUserAccessRight

Diritto di accesso a cui l'utente ha per il report (livello di autorizzazione)

Role

Ruolo nella configurazione RLS di un set di dati

RoleMember

Membro del ruolo

RoleTablePermission

Filtro dei ruoli

Row

Riga di dati in un set di dati

SensitivityLabel

Informazioni sull'etichetta di riservatezza per un elemento di Power BI (ad esempio un report o un dashboard)

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.

Table

Tabella del set di dati

WorkspaceInfo

Dettagli sulle informazioni sull'area di lavoro

WorkspaceInfoDashboard

Un dashboard di Power BI restituito dalle API WorkspaceInfo. L'API restituisce un subset dell'elenco seguente di proprietà del dashboard. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.

WorkspaceInfoDataflow

Metadati di un flusso di dati restituito dalle API Informazioni sull'area di lavoro. Di seguito è riportato un elenco di proprietà che possono essere restituite per un flusso di dati. Solo un subset delle proprietà verrà restituito a seconda dell'API chiamata, delle autorizzazioni del chiamante e della disponibilità dei dati nel database di Power BI.

WorkspaceInfoDatamart

Datamart di Power BI restituito dalle API Informazioni sull'area di lavoro. L'API restituisce un subset dell'elenco seguente di proprietà datamart. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.

WorkspaceInfoDataset

Set di dati di Power BI restituito dalle API WorkspaceInfo. L'API restituisce un subset dell'elenco seguente di proprietà del set di dati. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.

WorkspaceInfoReport

Report di Power BI restituito dalle API informazioni sull'area di lavoro. L'API restituisce un subset dell'elenco seguente di proprietà del report. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.

WorkspaceInfoResponse

Risposta alle informazioni sull'area di lavoro

WorkspaceInfoTile

Un riquadro di Power BI restituito dalle API WorkspaceInfo

ASMashupExpression

Origine tabella del set di dati

Nome Tipo Descrizione
expression

string

Espressione di origine

Column

Colonna del set di dati

Nome Tipo Descrizione
dataCategory

string

facoltativo. Valore stringa da utilizzare per la categoria di dati che descrive i dati all'interno di questa colonna.

dataType

string

Tipo di dati della colonna

formatString

string

facoltativo. Formato della colonna come specificato in FORMAT_STRING.

isHidden

boolean

facoltativo. Indica se la colonna è nascosta. Il valore predefinito è false.

name

string

Nome della colonna

sortByColumn

string

facoltativo. Nome stringa di una colonna nella stessa tabella da usare per ordinare la colonna corrente.

summarizeBy

string

facoltativo. Funzione di aggregazione da utilizzare per il riepilogo di questa colonna.

DashboardUser

Voce di diritto di accesso utente di Power BI per un dashboard

Nome Tipo Descrizione
dashboardUserAccessRight

DashboardUserAccessRight

Diritto di accesso a cui l'utente ha per il dashboard (livello di autorizzazione)

displayName

string

Nome visualizzato dell'entità

emailAddress

string

Indirizzo di posta elettronica dell'utente

graphId

string

Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.

identifier

string

Identificatore dell'entità

principalType

PrincipalType

Tipo principale

profile

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

userType

string

Tipo dell'utente.

DashboardUserAccessRight

Diritto di accesso a cui l'utente ha per il dashboard (livello di autorizzazione)

Nome Tipo Descrizione
None

string

Nessuna autorizzazione per il contenuto nel dashboard

Owner

string

Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel report

Read

string

Concede l'accesso in lettura al contenuto nel dashboard

ReadCopy

string

Concede l'accesso in lettura e copia al contenuto nel dashboard

ReadReshare

string

Concede l'accesso in lettura e ricondivisione al contenuto nel dashboard

ReadWrite

string

Concede l'accesso in lettura e scrittura al contenuto nel dashboard

DataflowUser

Voce di accesso dell'utente di Power BI per un flusso di dati

Nome Tipo Descrizione
DataflowUserAccessRight

DataflowUserAccessRight

Diritto di accesso che un utente ha per il flusso di dati (livello di autorizzazione)

displayName

string

Nome visualizzato dell'entità

emailAddress

string

Indirizzo di posta elettronica dell'utente

graphId

string

Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.

identifier

string

Identificatore dell'entità

principalType

PrincipalType

Tipo principale

profile

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

userType

string

Tipo dell'utente.

DataflowUserAccessRight

Diritto di accesso a cui un utente ha per il flusso di dati (livello di autorizzazione)

Nome Tipo Descrizione
None

string

Rimuove l'autorizzazione per il contenuto nel flusso di dati

Owner

string

Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel flusso di dati

Read

string

Concede l'accesso in lettura al contenuto nel flusso di dati

ReadReshare

string

Concede l'accesso in lettura e ricondivisione al contenuto nel flusso di dati

ReadWrite

string

Concede l'accesso in lettura e scrittura al contenuto nel flusso di dati

datamartState

Stato corrente datamart

Nome Tipo Descrizione
Active

string

Il datamart è attivo

Deleted

string

Il datamart è stato eliminato

Evicted

string

Il datamart è stato rimosso

Initialized

string

Il datamart è stato inizializzato

Invalid

string

Il datamart non ha stato valido

Migrating

string

Il datamart esegue la migrazione

datamartStatus

Stato datamart

Nome Tipo Descrizione
Available

string

Il datamart è disponibile

Error

string

Il datamart ha lo stato di errore

InProgress

string

Il datamart è in corso

Invalid

string

Il datamart non ha stato valido

NoCapacity

string

Datamart non ha capacità

OutOfRegion

string

Il datamart non è compreso nell'area

SuspendedInCriticalPhase

string

Il datamart viene sospeso in fase critica

datamartType

Tipo di datamart

Nome Tipo Descrizione
Dataverse

string

Il datamart è di tipo Dataverse

Datawarehouse

string

Il datamart è di tipo Datawarehouse

Ignore

string

Datamart non ha alcun tipo

Lakehouse

string

Il datamart è di tipo Lakehouse

Sql

string

Il datamart è di tipo Sql

Unset

string

Il tipo datamart non è stato impostato

DatamartUser

Voce a destra dell'accesso utente di Power BI per un report

Nome Tipo Descrizione
datamartUserAccessRight

DatamartUserAccessRight

Diritto di accesso che l'utente ha per il datamart (livello di autorizzazione)

displayName

string

Nome visualizzato dell'entità

emailAddress

string

Indirizzo di posta elettronica dell'utente

graphId

string

Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.

identifier

string

Identificatore dell'entità

principalType

PrincipalType

Tipo principale

profile

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

userType

string

Tipo dell'utente.

DatamartUserAccessRight

Diritto di accesso a cui l'utente ha per il datamart (livello di autorizzazione)

Nome Tipo Descrizione
Explore

string

Concede l'accesso al contenuto in datamart

None

string

Nessuna autorizzazione per il contenuto in datamart

Read

string

Concede l'accesso in lettura al contenuto in datamart

ReadExplore

string

Concede l'accesso in lettura ed esplorare il contenuto in datamart

ReadReshare

string

Concede l'accesso in lettura e ricondivisione al contenuto in datamart

ReadReshareExplore

string

Concede la lettura e la ricondivisione ed esplora l'accesso al contenuto in datamart

ReadWrite

string

Concede l'accesso in lettura e scrittura al contenuto in datamart

ReadWriteExplore

string

Concede l'accesso in lettura e scrittura ed esplora il contenuto in datamart

ReadWriteReshare

string

Concede l'accesso in lettura e scrittura e ricondividi al contenuto in datamart

ReadWriteReshareExplore

string

Concede l'accesso in lettura e scrittura e scrittura ed esplora l'accesso al contenuto in datamart

Reshare

string

Concede l'accesso di ricondividi al contenuto in datamart

Write

string

Concede l'accesso in scrittura al contenuto in datamart

DatasetUser

Voce a destra dell'accesso utente di Power BI per un set di dati

Nome Tipo Descrizione
datasetUserAccessRight

DatasetUserAccessRight

Diritto di accesso che l'utente ha per il set di dati (livello di autorizzazione)

displayName

string

Nome visualizzato dell'entità

emailAddress

string

Indirizzo di posta elettronica dell'utente

graphId

string

Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.

identifier

string

Identificatore dell'entità

principalType

PrincipalType

Tipo principale

profile

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

userType

string

Tipo dell'utente.

DatasetUserAccessRight

Diritto di accesso a cui l'utente ha per il set di dati (livello di autorizzazione)

Nome Tipo Descrizione
None

string

Rimuove l'autorizzazione per il contenuto nel set di dati

Read

string

Concede l'accesso in lettura al contenuto nel set di dati

ReadExplore

string

Concede l'accesso in lettura ed esplora al contenuto nel set di dati

ReadReshare

string

Concede l'accesso in lettura e ricondivisione al contenuto nel set di dati

ReadReshareExplore

string

Concede l'accesso in lettura, ricondivisione ed esplora al contenuto nel set di dati

ReadWrite

string

Concede l'accesso in lettura e scrittura al contenuto nel set di dati

ReadWriteExplore

string

Concede l'accesso in lettura, scrittura ed esplorazione al contenuto nel set di dati

ReadWriteReshare

string

Concede l'accesso in lettura, scrittura e ricondividi al contenuto nel set di dati

ReadWriteReshareExplore

string

Concede l'accesso in lettura, scrittura, ricondivisione ed esplora al contenuto nel set di dati

Datasource

Origine dati di Power BI

Nome Tipo Descrizione
connectionDetails

DatasourceConnectionDetails

Dettagli della connessione all'origine dati

connectionString

string

(Deprecato) Origine dati stringa di connessione. Disponibile solo per DirectQuery.

datasourceId

string

ID origine dati associato, vuoto quando non associato a un gateway

datasourceType

string

Tipo di origine dati

gatewayId

string

ID gateway associato, vuoto quando non associato a un gateway. Quando si usa un cluster gateway, l'ID gateway fa riferimento al gateway primario (primo) nel cluster ed è simile all'ID del cluster gateway.

name

string

(Deprecato) Nome origine dati. Disponibile solo per DirectQuery.

DatasourceConnectionDetails

Dettagli della connessione all'origine dati di Power BI. Vedere esempi in Recupera origini dati o Recupera origini dati in gruppo.

Nome Tipo Descrizione
account

string

Account di connessione

classInfo

string

Informazioni sulla classe di connessione

database

string

Database di connessione

domain

string

Dominio di connessione

emailAddress

string

Indirizzo di posta elettronica di connessione

kind

string

Tipo di connessione

loginServer

string

Server di accesso della connessione

path

string

Percorso di connessione

server

string

Server di connessione

url

string

URL di connessione

DatasourceUsage

Utilizzo delle origini dati

Nome Tipo Descrizione
datasourceInstanceId

string

ID istanza dell'origine dati

DefaultDatasetStorageFormat

Formato di archiviazione del set di dati predefinito nel gruppo

Nome Tipo Descrizione
Large

string

Formato di archiviazione del set di dati Large

Small

string

Formato di archiviazione di set di dati di piccole dimensioni

DependentDataflow

Flusso di dati dipendente da Power BI

Nome Tipo Descrizione
groupId

string

ID gruppo di destinazione

targetDataflowId

string

ID flusso di dati di destinazione

DependentDatamart

Un datamart dipendente da Power BI

Nome Tipo Descrizione
groupId

string

ID gruppo di destinazione

targetDatamartId

string

ID datamart di destinazione

DependentDataset

Set di dati dipendenti di Power BI

Nome Tipo Descrizione
groupId

string

ID gruppo di destinazione

targetDatasetId

string

ID set di dati di destinazione

EndorsementDetails

Dettagli sull'autenticità di Power BI

Nome Tipo Descrizione
certifiedBy

string

Utente che ha certificato l'elemento di Power BI (ad esempio un report o un dashboard)

endorsement

string

Stato di verifica dell'autenticità

Expression

Espressione del set di dati

Nome Tipo Descrizione
description

string

Descrizione dell'espressione

expression

ASMashupExpression

Origine tabella del set di dati

name

string

Nome dell'espressione

GroupUser

Un utente di Power BI con accesso all'area di lavoro

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità

emailAddress

string

Indirizzo di posta elettronica dell'utente

graphId

string

Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.

groupUserAccessRight

GroupUserAccessRight

Diritto di accesso (livello di autorizzazione) di un utente nell'area di lavoro

identifier

string

Identificatore dell'entità

principalType

PrincipalType

Tipo di entità

profile

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.

userType

string

Tipo di utente.

GroupUserAccessRight

Diritto di accesso (livello di autorizzazione) che un utente ha nell'area di lavoro

Nome Tipo Descrizione
Admin

string

Diritti di amministratore per il contenuto dell'area di lavoro

Contributor

string

Leggere ed esplorare (ReadExplore) l'accesso al contenuto dell'area di lavoro

Member

string

Leggi, ricondividi ed esplora (ReadReshareExplore) diritti di accesso al contenuto dell'area di lavoro

None

string

Nessun accesso al contenuto dell'area di lavoro

Viewer

string

Accesso di sola lettura (lettura) al contenuto dell'area di lavoro

Measure

Una misura di Power BI

Nome Tipo Descrizione
description

string

facoltativo. Descrizione della misura.

expression

string

Espressione DAX valida

formatString

string

facoltativo. Stringa che descrive come deve essere formattato il valore quando viene visualizzato come specificato in FORMAT_STRING.

isHidden

boolean

facoltativo. Indica se la misura è nascosta.

name

string

Nome della misura

PrincipalType

Tipo principale

Nome Tipo Descrizione
App

string

Tipo di entità servizio

Group

string

Tipo di entità gruppo

None

string

Nessun tipo di entità. Usare per l'accesso a livello di organizzazione intero.

User

string

Tipo di entità utente

ReportUser

Voce di diritto di accesso utente di Power BI per un report

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità

emailAddress

string

Indirizzo di posta elettronica dell'utente

graphId

string

Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.

identifier

string

Identificatore dell'entità

principalType

PrincipalType

Tipo di entità

profile

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.

reportUserAccessRight

ReportUserAccessRight

Diritto di accesso a cui l'utente ha per il report (livello di autorizzazione)

userType

string

Tipo di utente.

ReportUserAccessRight

Diritto di accesso a cui l'utente ha per il report (livello di autorizzazione)

Nome Tipo Descrizione
None

string

Nessuna autorizzazione per il contenuto nel report

Owner

string

Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel report

Read

string

Concede l'accesso in lettura al contenuto nel report

ReadCopy

string

Concede l'accesso in lettura e copia al contenuto nel report

ReadReshare

string

Concede l'accesso in lettura e ricondivisione al contenuto nel report

ReadWrite

string

Concede l'accesso in lettura e scrittura al contenuto nel report

Role

Ruolo nella configurazione RLS di un set di dati

Nome Tipo Descrizione
members

RoleMember

Matrice che elenca i membri del ruolo

modelPermission

string

Autorizzazioni che il ruolo ha nel set di dati. Ad esempio, Lettura

name

string

Nome del ruolo

tablePermissions

RoleTablePermission

Matrice che elenca tutti i filtri definiti per il ruolo

RoleMember

Membro del ruolo

Nome Tipo Descrizione
identityProvider

string

Provider di identità membro del ruolo

memberId

string

GUID del membro del ruolo assegnato dal provider di identità

memberName

string

Nome del membro del ruolo

memberType

string

Tipo di membro del ruolo (utente o gruppo)

RoleTablePermission

Filtro dei ruoli

Nome Tipo Descrizione
filterExpression

string

Espressione che filtra la tabella specificata nel filtro

name

string

Nome della tabella specificata nel filtro

Row

Riga di dati in un set di dati

Nome Tipo Descrizione
id

string

ID di riga univoco

SensitivityLabel

Informazioni sull'etichetta di riservatezza per un elemento di Power BI (ad esempio un report o un dashboard)

Nome Tipo Descrizione
labelId

string

ID etichetta di riservatezza

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.

Nome Tipo Descrizione
displayName

string

Nome del profilo dell'entità servizio

id

string

ID del profilo dell'entità servizio

Table

Tabella del set di dati

Nome Tipo Descrizione
columns

Column[]

Schema di colonna per questa tabella

description

string

Descrizione della tabella

isHidden

boolean

facoltativo. Indica se questa tabella del set di dati è nascosta.

measures

Measure[]

Misure all'interno di questa tabella

name

string

Il nome della tabella

rows

Row[]

Righe di dati all'interno di questa tabella

source

ASMashupExpression[]

Origine tabella

WorkspaceInfo

Dettagli sulle informazioni sull'area di lavoro

Nome Tipo Descrizione
capacityId

string

ID capacità dell'area di lavoro

dashboards

WorkspaceInfoDashboard[]

I dashboard associati a questa area di lavoro. L'elenco delle proprietà del dashboard restituite varia per le diverse chiamate API, quindi potrebbe non essere visualizzato tutti i dashboard in una risposta API.

dataRetrievalState

string

Stato di recupero dei dati dell'area di lavoro

dataflows

WorkspaceInfoDataflow[]

Flussi di dati associati a questa area di lavoro. L'elenco delle proprietà del flusso di dati restituito varia per le diverse chiamate API, quindi potrebbe non essere visualizzato tutti i flussi di dati in una risposta API.

datamarts

WorkspaceInfoDatamart[]

I datamarts associati a questa area di lavoro. L'elenco delle proprietà datamart restituite varia per le diverse chiamate API, quindi potrebbe non essere visualizzato tutti i datimart in una risposta API.

datasets

WorkspaceInfoDataset[]

Set di dati associati a questa area di lavoro. L'elenco delle proprietà del set di dati restituito varia per le diverse chiamate API, quindi potrebbe non essere visualizzato tutti i set di dati in una risposta API.

defaultDatasetStorageFormat

DefaultDatasetStorageFormat

Formato di archiviazione del set di dati predefinito nell'area di lavoro. Restituito solo quando isOnDedicatedCapacity è true

description

string

Descrizione dell'area di lavoro

id

string

ID oggetto area di lavoro

isOnDedicatedCapacity

boolean

Indica se l'area di lavoro viene assegnata a una capacità dedicata

name

string

Nome dell'area di lavoro

reports

WorkspaceInfoReport[]

I report associati a questa area di lavoro. L'elenco delle proprietà del report restituite varia per le diverse chiamate API, pertanto potrebbe non essere visualizzata tutte le proprietà del report in una risposta API.

state

string

Stato dell'area di lavoro

type

string

Tipo di area di lavoro

users

GroupUser[]

Gli utenti con accesso all'area di lavoro. L'elenco viene restituito solo quando richiesto in modo esplicito. Per recuperare un elenco di utenti per un'area di lavoro classica, usare il API Graph di Azure Active Directory.

WorkspaceInfoDashboard

Un dashboard di Power BI restituito dalle API WorkspaceInfo. L'API restituisce un subset dell'elenco seguente di proprietà del dashboard. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.

Nome Tipo Descrizione
appId

string

ID dell'app, restituito solo se il dashboard appartiene a un'app

dataClassification

string

Tag di classificazione dei dati di un elemento di Power BI ,ad esempio un report o un dashboard)

displayName

string

Nome visualizzato del dashboard

id

string

The dashboard ID

isReadOnly

boolean

Se il dashboard è di sola lettura

sensitivityLabel

SensitivityLabel

Etichetta di riservatezza

tiles

WorkspaceInfoTile[]

Riquadri appartenenti al dashboard

users

DashboardUser[]

(Valore vuoto) Dettagli dell'accesso utente del dashboard. Questa proprietà verrà rimossa dalla risposta del payload in una versione successiva. È possibile recuperare le informazioni utente in un dashboard di Power BI usando Get Dashboard Users come chiamata API Amministrazione o la chiamata API PostWorkspaceInfo con il getArtifactUsers parametro .

WorkspaceInfoDataflow

Metadati di un flusso di dati restituito dalle API Informazioni sull'area di lavoro. Di seguito è riportato un elenco di proprietà che possono essere restituite per un flusso di dati. Solo un subset delle proprietà verrà restituito a seconda dell'API chiamata, delle autorizzazioni del chiamante e della disponibilità dei dati nel database di Power BI.

Nome Tipo Descrizione
configuredBy

string

Proprietario del flusso di dati

datasourceUsages

DatasourceUsage[]

Utilizzo dell'origine dati

description

string

Descrizione del flusso di dati

endorsementDetails

EndorsementDetails

Dettagli di verifica dell'autenticità

misconfiguredDatasourceUsages

DatasourceUsage[]

Utilizzo non configurato correttamente dell'origine dati

modelUrl

string

URL del file di definizione del flusso di dati (model.json)

modifiedBy

string

Utente che ha modificato il flusso di dati

modifiedDateTime

string

Data e ora dell'ultima modifica del flusso di dati

name

string

Nome del flusso di dati

objectId

string

ID del flusso di dati

sensitivityLabel

SensitivityLabel

Etichetta di riservatezza

upstreamDataflows

DependentDataflow[]

L'elenco di tutti i flussi di dati da cui dipende questo elemento

upstreamDatamarts

DependentDatamart[]

L'elenco di tutti i datamarts da cui dipende questo elemento

users

DataflowUser[]

(Valore vuoto) Dettagli di accesso utente del flusso di dati. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare informazioni utente su un flusso di dati di Power BI usando Recupera utenti flusso di dati come chiamata API Amministrazione o l'API PostWorkspaceInfo con il getArtifactUser parametro .

WorkspaceInfoDatamart

Datamart di Power BI restituito dalle API Informazioni sull'area di lavoro. L'API restituisce un subset dell'elenco seguente di proprietà datamart. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.

Nome Tipo Descrizione
configuredBy

string

Nome del proprietario datamart

configuredById

string

ID del proprietario datamart

datasourceUsages

DatasourceUsage[]

Utilizzo dell'origine dati

description

string

Descrizione datamart

endorsementDetails

EndorsementDetails

Dettagli sull'autenticità di datamart

id

string

The datamart ID

modifiedBy

string

Ultimo utente che ha modificato il datamart

modifiedById

string

ID dell'ultimo utente che ha modificato il datamart

modifiedDateTime

string

Data e ora dell'ultima modifica del datamart

name

string

Nome datamart

sensitivityLabel

SensitivityLabel

Etichetta di riservatezza datamart

state

datamartState

Stato corrente datamart

status

datamartStatus

Stato datamart

suspendedBatchId

string

id batch sospeso datamart

type

datamartType

Tipo datamart

upstreamDataflows

DependentDataflow[]

L'elenco di tutti i flussi di dati da cui dipende questo elemento

upstreamDatamarts

DependentDatamart[]

L'elenco di tutti i datamarts da cui dipende questo elemento

users

DatamartUser[]

Dettagli di accesso utente per un datamart di Power BI.

WorkspaceInfoDataset

Set di dati di Power BI restituito dalle API WorkspaceInfo. L'API restituisce un subset dell'elenco seguente di proprietà del set di dati. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.

Nome Tipo Descrizione
ContentProviderType

string

Tipo di provider di contenuto per il set di dati

CreatedDate

string

Data e ora di creazione del set di dati

configuredBy

string

Proprietario del set di dati

datasourceUsages

DatasourceUsage[]

Utilizzo dell'origine dati

description

string

Descrizione del set di dati

endorsementDetails

EndorsementDetails

Dettagli di approvazione

expressions

Expression[]

Espressioni del set di dati

id

string

ID del set di dati

misconfiguredDatasourceUsages

DatasourceUsage[]

Utilizzo non configurato correttamente dell'origine dati

name

string

Nome del set di dati

roles

Role[]

Ruoli del set di dati

schemaMayNotBeUpToDate

boolean

Se lo schema del set di dati potrebbe non essere aggiornato

schemaRetrievalError

string

Errore di recupero dello schema del set di dati

sensitivityLabel

SensitivityLabel

Etichetta di riservatezza

tables

Table[]

Tabelle del set di dati

targetStorageMode

string

Modalità di archiviazione del set di dati

upstreamDataflows

DependentDataflow[]

L'elenco di tutti i flussi di dati dipende da

upstreamDatamarts

DependentDatamart[]

L'elenco di tutti i datamarts da cui dipende questo elemento

upstreamDatasets

DependentDataset[]

Set di dati upstream

users

DatasetUser[]

(Valore vuoto) Dettagli di accesso utente del set di dati. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare informazioni utente su un elemento di Power BI , ad esempio un report o un dashboard, usando l'API Get Dataset Users (Ottieni utenti del set di dati) come API Amministrazione o l'API PostWorkspaceInfo con il getArtifactUsers parametro .

WorkspaceInfoReport

Report di Power BI restituito dalle API informazioni sull'area di lavoro. L'API restituisce un subset dell'elenco seguente di proprietà del report. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.

Nome Tipo Descrizione
appId

string

ID dell'app, restituito solo se il report appartiene a un'app

createdBy

string

Proprietario del report. Disponibile solo per i report creati dopo giugno 2019.

createdById

string

ID del proprietario del report. Disponibile solo per i report creati dopo giugno 2019.

createdDateTime

string

Data e ora di creazione del report

datasetId

string

ID set di dati del report

datasetWorkspaceId

string

ID dell'area di lavoro del set di dati correlato, restituito solo se il set di dati correlato appartiene a un'area di lavoro diversa

description

string

Descrizione del report

endorsementDetails

EndorsementDetails

Dettagli di approvazione

id

string

The report ID

isOwnedByMe

boolean

Determinare se il report viene creato dall'utente corrente.

modifiedBy

string

Ultimo utente che ha modificato il report

modifiedById

string

ID dell'ultimo utente che ha modificato il report

modifiedDateTime

string

Data e ora dell'ultima modifica del report

name

string

Nome del report

originalReportId

string

ID del report effettivo quando l'area di lavoro viene pubblicata come app.

reportType enum:
  • PaginatedReport
  • PowerBIReport

Tipo di report

sensitivityLabel

SensitivityLabel

Etichetta di riservatezza

users

ReportUser[]

(Valore vuoto) Dettagli di accesso utente per un report di Power BI. Questa proprietà verrà rimossa dalla risposta del payload in una versione successiva. È possibile recuperare le informazioni utente in un report di Power BI usando get report Users come chiamata API Amministrazione o la chiamata API PostWorkspaceInfo con il getArtifactUsers parametro .

WorkspaceInfoResponse

Risposta alle informazioni sull'area di lavoro

Nome Tipo Descrizione
datasourceInstances

Datasource[]

Istanze dell'origine dati associate a questa analisi

misconfiguredDatasourceInstances

Datasource[]

Istanze non configurate dell'origine dati associate a questa analisi

workspaces

WorkspaceInfo[]

Informazioni sull'area di lavoro associate a questa analisi

WorkspaceInfoTile

Un riquadro di Power BI restituito dalle API WorkspaceInfo

Nome Tipo Descrizione
datasetId

string

ID del set di dati. Disponibile solo per i riquadri creati da un report o usando un set di dati, ad esempio Q&riquadri A.

datasetWorkspaceId

string

ID area di lavoro del set di dati correlato, restituito solo se il set di dati correlato appartiene a un'area di lavoro diversa

id

string

ID riquadro

reportId

string

ID report. Disponibile solo per i riquadri creati da un report.

title

string

Nome visualizzato del riquadro