Admin - Groups UpdateGroupAsAdmin
Aggiorna le proprietà dell'area di lavoro specificata.
Per annullare l'assegnazione di un'area di lavoro Log Analytics, impostare in modo esplicito il valore su Null.
Autorizzazioni
L'utente deve essere un amministratore di Fabric.
Ambito obbligatorio
Tenant.ReadWrite.All
Limitazioni
- Massimo 200 richieste all'ora.
- Per Le capacità condivise, è possibile aggiornare solo il nome e la descrizione.
- Per le capacità Premium, è possibile aggiornare solo il nome, la descrizione, defaultDatasetStorageFormat e l'area di lavoro Log Analytics.
- Il nome deve essere univoco all'interno di un'organizzazione.
PATCH https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
group
|
path | True |
string uuid |
ID dell'area di lavoro |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
id | True |
string |
ID dell'area di lavoro |
capacityId |
string |
ID capacità |
|
dashboards |
Dashboard appartenenti al gruppo |
||
dataflowStorageId |
string |
ID dell'account di archiviazione del flusso di dati di Power BI |
|
dataflows |
Flussi di dati che appartengono al gruppo |
||
datasets |
Set di dati che appartengono al gruppo |
||
defaultDatasetStorageFormat |
Formato di archiviazione del set di dati predefinito nell'area di lavoro. Restituito solo quando |
||
description |
string |
Descrizione del gruppo |
|
hasWorkspaceLevelSettings |
boolean |
Indica se l'area di lavoro ha impostazioni personalizzate |
|
isOnDedicatedCapacity |
boolean |
Indica se il gruppo è assegnato a una capacità dedicata |
|
isReadOnly |
boolean |
Indica se il gruppo è di sola lettura |
|
logAnalyticsWorkspace |
Area di lavoro Log Analytics assegnata al gruppo. Viene restituito solo quando si recupera un singolo gruppo. |
||
name |
string |
Nome del gruppo |
|
pipelineId |
string |
ID della pipeline di distribuzione a cui è assegnata l'area di lavoro. |
|
reports |
Report che appartengono al gruppo |
||
state |
string |
Stato del gruppo |
|
type |
Tipo di gruppo restituito. |
||
users |
(Valore vuoto) Gli utenti che appartengono al gruppo e i relativi diritti di accesso. 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 la chiamata API di di amministrazione |
||
workbooks |
Workbook[] |
Cartelle di lavoro che appartengono al gruppo |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
Esempio
Example of assigning Log Analytics workspace |
Example of unassigning Log Analytics workspace |
Example of updating group description and default |
Example of assigning Log Analytics workspace
Esempio di richiesta
PATCH https://api.powerbi.com/v1.0/myorg/admin/groups/e2284830-c8dc-416b-b19a-8cdcd2729332
{
"logAnalyticsWorkspace": {
"subscriptionId": "d778934f-bda2-41d9-b5c7-6cf41372c1a0",
"resourceGroup": "myResourceGroup",
"resourceName": "myLogAnalyticsWorkspace"
}
}
Risposta di esempio
Example of unassigning Log Analytics workspace
Esempio di richiesta
PATCH https://api.powerbi.com/v1.0/myorg/admin/groups/e2284830-c8dc-416b-b19a-8cdcd2729332
{
"logAnalyticsWorkspace": null
}
Risposta di esempio
Example of updating group description and defaultDatasetStorageFormat
Esempio di richiesta
PATCH https://api.powerbi.com/v1.0/myorg/admin/groups/e2284830-c8dc-416b-b19a-8cdcd2729332
{
"name": "Updated Sales Results",
"description": "Refreshed sales numbers",
"defaultDatasetStorageFormat": "Large"
}
Risposta di esempio
Definizioni
Nome | Descrizione |
---|---|
Admin |
Un dashboard di Power BI restituito dalle API di amministrazione. 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. |
Admin |
Metadati di un flusso di dati restituito dalle API di amministrazione. 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. |
Admin |
Un set di dati di Power BI restituito dalle API di amministrazione. 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. |
Admin |
Un gruppo di Power BI restituito dalle API di amministrazione |
Admin |
Report di Power BI restituito dalle API di amministrazione. 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. |
Admin |
Riquadro di Power BI restituito dalle API di amministrazione. |
Azure |
Risposta che descrive in dettaglio una risorsa di Azure di proprietà dell'utente, ad esempio un'area di lavoro Log Analytics. |
Dashboard |
Voce a destra dell'accesso utente di Power BI per un dashboard |
Dashboard |
Diritto di accesso che l'utente ha per il dashboard (livello di autorizzazione) |
Dataflow |
Immissione del diritto di accesso utente di Power BI per un flusso di dati |
Dataflow |
Diritto di accesso che un utente ha per il flusso di dati (livello di autorizzazione) |
Dataset |
Eseguire query su impostazioni di scalabilità orizzontale di un set di dati |
Dataset |
Voce a destra dell'accesso utente di Power BI per un set di dati |
Dataset |
Diritto di accesso a cui l'utente ha per il set di dati (livello di autorizzazione) |
Default |
Formato di archiviazione del set di dati predefinito nel gruppo |
Dependent |
Flusso di dati dipendente da Power BI |
Encryption |
Informazioni di crittografia per un set di dati |
Encryption |
Stato di crittografia del set di dati |
Group |
Tipo di gruppo |
Group |
Un utente di Power BI con accesso all'area di lavoro |
Group |
Diritto di accesso (livello di autorizzazione) di un utente nell'area di lavoro |
Principal |
Tipo di entità |
Report |
Voce a destra dell'accesso utente di Power BI per un report |
Report |
Diritto di accesso che l'utente ha per il report (livello di autorizzazione) |
Service |
Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded. |
Subscription |
Sottoscrizione di posta elettronica per un elemento di Power BI (ad esempio un report o un dashboard) |
Subscription |
Un utente della sottoscrizione di posta elettronica di Power BI |
Workbook |
Una cartella di lavoro di Power BI |
AdminDashboard
Un dashboard di Power BI restituito dalle API di amministrazione. 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 |
displayName |
string |
Nome visualizzato del dashboard |
embedUrl |
string |
URL di incorporamento del dashboard |
id |
string |
The dashboard ID |
isReadOnly |
boolean |
Indica se il dashboard è di sola lettura |
subscriptions |
(Valore vuoto) Dettagli della sottoscrizione per un elemento di Power BI, ad esempio un report o un dashboard. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare le informazioni sulla sottoscrizione per un report di Power BI usando l'Ottenere sottoscrizioni di report come chiamata API di amministrazione. |
|
tiles |
Riquadri che appartengono al dashboard |
|
users |
(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 |
|
webUrl |
string |
URL Web del dashboard |
workspaceId |
string |
ID area di lavoro (GUID) del dashboard. Questa proprietà verrà restituita solo in GetDashboardsAsAdmin. |
AdminDataflow
Metadati di un flusso di dati restituito dalle API di amministrazione. 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 |
description |
string |
Descrizione del flusso di dati |
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 |
users |
(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 |
|
workspaceId |
string |
ID dell'area di lavoro del flusso di dati. |
AdminDataset
Un set di dati di Power BI restituito dalle API di amministrazione. 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 |
CreateReportEmbedURL |
string |
Il set di dati crea l'URL di incorporamento del report |
Encryption |
Informazioni sulla crittografia del set di dati. Applicabile solo quando si specifica |
|
IsEffectiveIdentityRequired |
boolean |
Indica se il set di dati richiede un'identità efficace, che è necessario inviare in una chiamata API GenerateToken. |
IsEffectiveIdentityRolesRequired |
boolean |
Indica se la sicurezza a livello di riga è definita all'interno del file con estensione pbix di Power BI. In tal caso, è necessario specificare un ruolo. |
IsInPlaceSharingEnabled |
boolean |
Indica se il set di dati può essere condiviso con utenti esterni da utilizzare nel proprio tenant |
IsOnPremGatewayRequired |
boolean |
Indica se il set di dati richiede un gateway dati locale |
IsRefreshable |
boolean |
Questo campo restituisce |
QnaEmbedURL |
string |
Il set di dati Q&UN URL di incorporamento |
addRowsAPIEnabled |
boolean |
Indica se il set di dati consente l'aggiunta di nuove righe |
configuredBy |
string |
Proprietario del set di dati |
createdDate |
string |
Data e ora di creazione del set di dati |
description |
string |
Descrizione del set di dati |
id |
string |
ID set di dati |
name |
string |
Nome del set di dati |
queryScaleOutSettings |
Eseguire query su impostazioni di scalabilità orizzontale di un set di dati |
|
targetStorageMode |
string |
Modalità di archiviazione del set di dati |
upstreamDataflows |
L'elenco di tutti i flussi di dati da cui dipende questo elemento |
|
users |
(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 |
|
webUrl |
string |
URL Web del set di dati |
workspaceId |
string |
ID dell'area di lavoro del set di dati. Questa proprietà verrà restituita solo in GetDatasetsAsAdmin. |
AdminGroup
Un gruppo di Power BI restituito dalle API di amministrazione
Nome | Tipo | Descrizione |
---|---|---|
capacityId |
string |
ID capacità |
dashboards |
Dashboard appartenenti al gruppo |
|
dataflowStorageId |
string |
ID dell'account di archiviazione del flusso di dati di Power BI |
dataflows |
Flussi di dati che appartengono al gruppo |
|
datasets |
Set di dati che appartengono al gruppo |
|
defaultDatasetStorageFormat |
Formato di archiviazione del set di dati predefinito nell'area di lavoro. Restituito solo quando |
|
description |
string |
Descrizione del gruppo |
hasWorkspaceLevelSettings |
boolean |
Indica se l'area di lavoro ha impostazioni personalizzate |
id |
string |
ID dell'area di lavoro |
isOnDedicatedCapacity |
boolean |
Indica se il gruppo è assegnato a una capacità dedicata |
isReadOnly |
boolean |
Indica se il gruppo è di sola lettura |
logAnalyticsWorkspace |
Area di lavoro Log Analytics assegnata al gruppo. Viene restituito solo quando si recupera un singolo gruppo. |
|
name |
string |
Nome del gruppo |
pipelineId |
string |
ID della pipeline di distribuzione a cui è assegnata l'area di lavoro. |
reports |
Report che appartengono al gruppo |
|
state |
string |
Stato del gruppo |
type |
Tipo di gruppo restituito. |
|
users |
(Valore vuoto) Gli utenti che appartengono al gruppo e i relativi diritti di accesso. 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 la chiamata API di di amministrazione |
|
workbooks |
Workbook[] |
Cartelle di lavoro che appartengono al gruppo |
AdminReport
Report di Power BI restituito dalle API di amministrazione. 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. |
createdDateTime |
string |
Data e ora di creazione del report |
datasetId |
string |
ID del set di dati del report |
description |
string |
Descrizione del report |
embedUrl |
string |
URL di incorporamento del report |
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 |
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:
|
Tipo di report |
subscriptions |
(Valore vuoto) Dettagli della sottoscrizione per un elemento di Power BI, ad esempio un report o un dashboard. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare le informazioni sulla sottoscrizione per un report di Power BI usando l'Ottenere sottoscrizioni di report come chiamata API di amministrazione. |
|
users |
(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 |
|
webUrl |
string |
URL Web del report |
workspaceId |
string |
ID dell'area di lavoro (GUID) del report. Questa proprietà verrà restituita solo in GetReportsAsAdmin. |
AdminTile
Riquadro di Power BI restituito dalle API di amministrazione.
Nome | Tipo | Descrizione |
---|---|---|
colSpan |
integer |
Numero di colonne dell'intervallo di riquadri |
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. |
embedData |
string |
Dati di incorporamento per il riquadro |
embedUrl |
string |
URL di incorporamento del riquadro |
id |
string |
ID riquadro |
reportId |
string |
ID report. Disponibile solo per i riquadri creati da un report. |
rowSpan |
integer |
Numero di righe dell'intervallo di riquadri |
title |
string |
Nome visualizzato del riquadro |
AzureResource
Risposta che descrive in dettaglio una risorsa di Azure di proprietà dell'utente, ad esempio un'area di lavoro Log Analytics.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
Identificatore della risorsa all'interno di Power BI. |
resourceGroup |
string |
Gruppo di risorse all'interno della sottoscrizione in cui risiede la risorsa. |
resourceName |
string |
Nome della risorsa. |
subscriptionId |
string |
Sottoscrizione di Azure in cui risiede la risorsa. |
DashboardUser
Voce a destra dell'accesso utente di Power BI per un dashboard
Nome | Tipo | Descrizione |
---|---|---|
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 |
Tipo di entità |
|
profile |
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 |
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 |
Tipo di entità |
|
profile |
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 |
DatasetQueryScaleOutSettings
Eseguire query su impostazioni di scalabilità orizzontale di un set di dati
Nome | Tipo | Descrizione |
---|---|---|
autoSyncReadOnlyReplicas |
boolean |
Indica se il set di dati sincronizza automaticamente le repliche di sola lettura |
maxReadOnlyReplicas |
integer |
Numero massimo di repliche di sola lettura per il set di dati (0-64, -1 per il numero automatico di repliche) |
DatasetUser
Voce a destra dell'accesso utente di Power BI per un set di dati
Nome | Tipo | Descrizione |
---|---|---|
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 |
Tipo di entità |
|
profile |
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 |
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 |
Encryption
Informazioni di crittografia per un set di dati
Nome | Tipo | Descrizione |
---|---|---|
EncryptionStatus |
Stato di crittografia del set di dati |
EncryptionStatus
Stato di crittografia del set di dati
Nome | Tipo | Descrizione |
---|---|---|
InSyncWithWorkspace |
string |
La crittografia è supportata ed è sincronizzata con le impostazioni di crittografia |
NotInSyncWithWorkspace |
string |
La crittografia è supportata ma non è sincronizzata con le impostazioni di crittografia |
NotSupported |
string |
La crittografia non è supportata per questo set di dati |
Unknown |
string |
Lo stato della crittografia è sconosciuto a causa del danneggiamento del set di dati |
GroupType
Tipo di gruppo
Nome | Tipo | Descrizione |
---|---|---|
AdminWorkspace |
string |
Monitoraggio dell'amministratore per gli amministratori dell'infrastruttura |
Group |
string |
Versione V1 dell'area di lavoro condivisa. Questo tipo di aree di lavoro verrà deprecato perché Microsoft esegue la migrazione di tutte le aree di lavoro alla versione più recente dell'area di lavoro condivisa |
Personal |
string |
Tipo speciale di area di lavoro destinata all'elenco di SharePoint e all'integrazione di OneDrive |
PersonalGroup |
string |
"Area di lavoro personale", nota anche come area di lavoro personale |
Workspace |
string |
Area di lavoro condivisa o area di lavoro semplice usata per condividere il contenuto con altri utenti dell'organizzazione |
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 |
Diritto di accesso (livello di autorizzazione) di un utente nell'area di lavoro |
|
identifier |
string |
Identificatore dell'entità |
principalType |
Tipo di entità |
|
profile |
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 |
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 |
Tipo di entità |
|
profile |
Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded. |
|
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 |
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 |
Subscription
Sottoscrizione di posta elettronica per un elemento di Power BI (ad esempio un report o un dashboard)
Nome | Tipo | Descrizione |
---|---|---|
artifactDisplayName |
string |
Nome dell'elemento di Power BI sottoscritto( ad esempio un report o un dashboard) |
artifactId |
string |
ID dell'elemento di Power BI sottoscritto( ad esempio un report o un dashboard) |
artifactType |
string |
Tipo di elemento di Power BI , ad esempio un |
attachmentFormat |
string |
Formato del report allegato nella sottoscrizione di posta elettronica |
endDate |
string |
Data e ora di fine della sottoscrizione di posta elettronica |
frequency |
string |
Frequenza della sottoscrizione di posta elettronica |
id |
string |
ID sottoscrizione |
isEnabled |
boolean |
Indica se la sottoscrizione tramite posta elettronica è abilitata |
linkToContent |
boolean |
Indica se esiste un collegamento di sottoscrizione nella sottoscrizione di posta elettronica |
previewImage |
boolean |
Indica se esiste uno screenshot del report nella sottoscrizione di posta elettronica |
startDate |
string |
Data e ora di inizio della sottoscrizione di posta elettronica |
subArtifactDisplayName |
string |
Nome della pagina dell'elemento di Power BI sottoscritto, se si tratta di un report. |
title |
string |
Nome dell'app |
users |
Dettagli di ogni sottoscrittore di posta elettronica. Quando si usa il Ottenere sottoscrizioni utente come amministratore chiamata API, il valore restituito è una matrice vuota (null). Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare informazioni sulla sottoscrizione in un report o un dashboard di Power BI usando il Ottenere sottoscrizioni di report come amministratore o Ottenere sottoscrizioni dashboard come chiamate API di amministrazione. |
SubscriptionUser
Un utente della sottoscrizione di posta elettronica di Power BI
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 |
Tipo di entità |
|
profile |
Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded. |
|
userType |
string |
Tipo di utente. |
Workbook
Una cartella di lavoro di Power BI
Nome | Tipo | Descrizione |
---|---|---|
datasetId |
string |
ID del set di dati associato a una cartella di lavoro. Si applica solo se la cartella di lavoro ha un set di dati associato. |
name |
string |
Nome della cartella di lavoro |