Admin - WorkspaceInfo GetScanResult

Servizio:

Power BI REST APIs

Versione API:

v1.0

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

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

Autorizzazioni

L'utente deve essere un amministratore di Fabric o eseguire l'autenticazione usando un'entità servizio.

Quando si esegue con l'autenticazione dell'entità servizio, un'app non deve disporre delle autorizzazioni necessarie per il consenso amministratore per Power BI 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 analisi, incluso nella risposta dalle aree di lavoro o dall'Admin - WorkspaceInfo PostWorkspaceInfo chiamata API che ha attivato l'analisi.

Risposte

Nome	Tipo	Descrizione
200 OK	WorkspaceInfoResponse	OK

Esempio

Example

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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 a destra dell'accesso utente di Power BI per un dashboard
DashboardUserAccessRight	Diritto di accesso che l'utente ha per il dashboard (livello di autorizzazione)
DataflowUser	Immissione del diritto di accesso utente di Power BI per un flusso di dati
DataflowUserAccessRight	Diritto di accesso che un utente ha per il flusso di dati (livello di autorizzazione)
datamartState	Stato corrente datamart
datamartStatus	Stato datamart
datamartType	Tipo 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	Un'origine dati di Power BI
DatasourceConnectionDetails	Dettagli della connessione all'origine dati di Power BI. Vedere esempi in Ottenere origini dati o Recupera origini dati in.
DatasourceUsage	Utilizzo dell'origine dati
DefaultDatasetStorageFormat	Formato di archiviazione del set di dati predefinito nel gruppo
DependentDataflow	Flusso di dati dipendente da Power BI
DependentDatamart	Un datamart dipendente di Power BI
DependentDataset	Un set di dati dipendente da 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) di un utente nell'area di lavoro
Measure	Una misura di Power BI
PrincipalType	Tipo di entità
ReportUser	Voce a destra dell'accesso utente di Power BI per un report
ReportUserAccessRight	Diritto di accesso che l'utente ha per il report (livello di autorizzazione)
Role	Ruolo nella configurazione della sicurezza a livello di riga 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 dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.
Table	Tabella del set di dati
WorkspaceInfo	Dettagli delle 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	Un 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	Un 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	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	Opzionale. 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	Opzionale. Formato della colonna come specificato in FORMAT_STRING.
isHidden	boolean	Opzionale. Indica se la colonna è nascosta. Il valore predefinito è false.
name	string	Nome della colonna
sortByColumn	string	Opzionale. Nome stringa di una colonna nella stessa tabella da utilizzare per ordinare la colonna corrente.
summarizeBy	string	Opzionale. Funzione di aggregazione da utilizzare per riepilogare questa colonna.

DashboardUser

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

Nome	Tipo	Descrizione
dashboardUserAccessRight	DashboardUserAccessRight	Diritto di accesso che 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 di entità
profile	ServicePrincipalProfile	Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.
userType	string	Tipo di utente.

DashboardUserAccessRight

Diritto di accesso che 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

Immissione del diritto di accesso 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 di entità
profile	ServicePrincipalProfile	Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.
userType	string	Tipo di utente.

DataflowUserAccessRight

Diritto di accesso che 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	Datamart è attivo
Deleted	string	Datamart eliminato
Evicted	string	Il datamart è stato rimosso
Initialized	string	Datamart inizializzato
Invalid	string	Lo stato di datamart non è valido
Migrating	string	Il datamart sta eseguendo la migrazione

datamartStatus

Stato datamart

Nome	Tipo	Descrizione
Available	string	Il datamart è disponibile
Error	string	Datamart ha lo stato di errore
InProgress	string	Datamart in corso
Invalid	string	Lo stato di datamart non è valido
NoCapacity	string	Datamart non ha capacità
OutOfRegion	string	Il datamart non è disponibile nell'area
SuspendedInCriticalPhase	string	Il datamart viene sospeso in fase critica

datamartType

Tipo datamart

Nome	Tipo	Descrizione
Dataverse	string	Datamart è di tipo Dataverse
Datawarehouse	string	Il datamart è di tipo Datawarehouse
Ignore	string	Datamart non ha alcun tipo
Lakehouse	string	Datamart è di tipo Lakehouse
Sql	string	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 a cui 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 di entità
profile	ServicePrincipalProfile	Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.
userType	string	Tipo di utente.

DatamartUserAccessRight

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

Nome	Tipo	Descrizione
Explore	string	Concede l'accesso all'esplorazione del 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 esplorare 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 la lettura e la scrittura e la ricondivisione ed esplorare 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 a cui 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 di entità
profile	ServicePrincipalProfile	Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.
userType	string	Tipo di 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 ricondivisione al contenuto nel set di dati
ReadWriteReshareExplore	string	Concede l'accesso al contenuto nel set di dati di lettura, scrittura, ricondivisione ed esplora

Datasource

Un'origine dati di Power BI

Nome	Tipo	Descrizione
connectionDetails	DatasourceConnectionDetails	Dettagli della connessione all'origine dati
connectionString	string	(Deprecato) Stringa di connessione dell'origine dati. Disponibile solo per DirectQuery.
datasourceId	string	ID origine dati associata, vuoto quando non associato a un gateway
datasourceType	string	Tipo di origine dati
gatewayId	string	ID del 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 cluster del gateway.
name	string	(Deprecato) Nome dell'origine dati. Disponibile solo per DirectQuery.

DatasourceConnectionDetails

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

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 alla connessione
path	string	Percorso di connessione
server	string	Server di connessione
url	string	URL di connessione

DatasourceUsage

Utilizzo dell'origine 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 set di dati di grandi dimensioni
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 del gruppo di destinazione
targetDataflowId	string	ID flusso di dati di destinazione

DependentDatamart

Un datamart dipendente di Power BI

Nome	Tipo	Descrizione
groupId	string	ID del gruppo di destinazione
targetDatamartId	string	ID datamart di destinazione

DependentDataset

Un set di dati dipendente da Power BI

Nome	Tipo	Descrizione
groupId	string	ID del 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	string	Valore dell'espressione
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 dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.
userType	string	Tipo di utente.

GroupUserAccessRight

Diritto di accesso (livello di autorizzazione) di un utente 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	Diritti di accesso di lettura, ricondivisione ed esplorazione (ReadReshareExplore) al contenuto dell'area di lavoro
None	string	Nessun accesso al contenuto dell'area di lavoro
Viewer	string	Accesso in sola lettura al contenuto dell'area di lavoro

Measure

Una misura di Power BI

Nome	Tipo	Descrizione
description	string	Opzionale. Descrizione della misura.
expression	string	Espressione DAX valida
formatString	string	Opzionale. Stringa che descrive come formattare il valore quando viene visualizzato come specificato in FORMAT_STRING.
isHidden	boolean	Opzionale. Indica se la misura è nascosta.
name	string	Nome della misura

PrincipalType

Tipo di entità

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 a destra dell'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 dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.
reportUserAccessRight	ReportUserAccessRight	Diritto di accesso che l'utente ha per il report (livello di autorizzazione)
userType	string	Tipo di utente.

ReportUserAccessRight

Diritto di accesso che 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 della sicurezza a livello di riga 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à del 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 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 dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.

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	Opzionale. Indica se la tabella del set di dati è nascosta.
measures	Measure[]	Misure all'interno di questa tabella
name	string	Nome della tabella
rows	Row[]	Righe di dati all'interno di questa tabella
source	ASMashupExpression[]	Origine tabella

WorkspaceInfo

Dettagli delle informazioni sull'area di lavoro

Nome	Tipo	Descrizione
capacityId	string	ID capacità dell'area di lavoro
dashboards	WorkspaceInfoDashboard[]	Dashboard associati a questa area di lavoro. L'elenco delle proprietà del dashboard restituite varia per le diverse chiamate API, pertanto è possibile che non vengano visualizzate tutte le proprietà del 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 restituite varia per le diverse chiamate API, pertanto è possibile che non vengano visualizzate tutte le proprietà del flusso di dati in una risposta API.
datamarts	WorkspaceInfoDatamart[]	I datamarts associati a questa area di lavoro. L'elenco delle proprietà di datamart restituite varia per le diverse chiamate API, quindi potrebbe non essere possibile visualizzare tutte le proprietà di datamart 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, pertanto è possibile che non vengano visualizzate tutte le proprietà del 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 dell'area di lavoro
isOnDedicatedCapacity	boolean	Indica se l'area di lavoro è assegnata a una capacità dedicata
name	string	Nome dell'area di lavoro
reports	WorkspaceInfoReport[]	Report associati a questa area di lavoro. L'elenco delle proprietà del report restituite varia per le diverse chiamate API, pertanto è possibile che non vengano visualizzate 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 l'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 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	Indica se il dashboard è di sola lettura
sensitivityLabel	SensitivityLabel	Etichetta di riservatezza
tiles	WorkspaceInfoTile[]	Riquadri che appartengono al dashboard
users	DashboardUser[]	(Valore vuoto) Dettagli di accesso utente del dashboard. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare le informazioni utente in un dashboard di Power BI usando il Ottenere gli utenti del dashboard come chiamata API di amministrazione o la chiamata API PostWorkspaceInfo con il 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[]	L'origine dati non è configurata correttamente
modelUrl	string	URL del file di definizione del flusso di dati (model.json)
name	string	Nome del flusso di dati
objectId	string	ID 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 il Get Dataflow Users as Admin API call oppure la chiamata API PostWorkspaceInfo con il parametro getArtifactUser.

WorkspaceInfoDatamart

Un 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 apportata al 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

Un 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 contenuti per il set di dati
configuredBy	string	Proprietario del set di dati
createdDate	string	Data e ora di creazione del set di dati
datasourceUsages	DatasourceUsage[]	Utilizzo dell'origine dati
description	string	Descrizione del set di dati
endorsementDetails	EndorsementDetails	Dettagli di verifica dell'autenticità
expressions	Expression[]	Espressioni del set di dati
id	string	ID set di dati
misconfiguredDatasourceUsages	DatasourceUsage[]	L'origine dati non è configurata correttamente
name	string	Nome del set di dati
roles	Role[]	Ruoli del set di dati
schemaMayNotBeUpToDate	boolean	Indica 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 da cui dipende questo elemento
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 as Admin o l'API PostWorkspaceInfo con il parametro getArtifactUsers.

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 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 del 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 verifica dell'autenticità
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 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 futura. È possibile recuperare informazioni sull'utente in un report di Power BI usando il Ottenere utenti report come chiamata API di amministrazione o la chiamata API PostWorkspaceInfo con il parametro getArtifactUsers.

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 correttamente dell'origine dati associate a questa analisi
workspaces	WorkspaceInfo[]	Informazioni sull'area di lavoro associate a questa analisi

WorkspaceInfoTile

Riquadro di Power BI restituito dalle API WorkspaceInfo

Nome	Tipo	Descrizione
datasetId	string	ID 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 dell'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