Admin - WorkspaceInfo GetScanResult

Service:

Power BI REST APIs

API Version:

v1.0

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

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

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