Items - List Item Access Details
Nota
Questa API è in anteprima.
Restituisce un elenco di utenti (inclusi i gruppi e le entità servizio) ed elenca i ruoli dell'area di lavoro.
Autorizzazioni
Il chiamante deve essere un amministratore di Fabric o eseguire l'autenticazione usando un'entità servizio.
Ambiti delegati obbligatori
Tenant.Read.All o Tenant.ReadWrite.All
Limitazioni
Massimo 200 richieste all'ora.
Identità supportate da Microsoft Entra
Questa API supporta le identità di Microsoft elencate in questa sezione.
Identità | Appoggiare |
---|---|
Utente | Sì |
'entità servizio e identità gestite | Sì |
Interfaccia
GET https://api.fabric.microsoft.com/v1/admin/workspaces/{workspaceId}/items/{itemId}/users
GET https://api.fabric.microsoft.com/v1/admin/workspaces/{workspaceId}/items/{itemId}/users?type={type}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
item
|
path | True |
string uuid |
ID elemento. |
workspace
|
path | True |
string uuid |
ID dell'area di lavoro. |
type
|
query |
string |
Tipo dell'elemento. Quando si eseguono query per i tipi seguenti, questo parametro è obbligatorio:
|
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Operazione riuscita. |
|
Other Status Codes |
Codici di errore comuni:
|
Esempio
List of users for given item ID and type example |
List of users for given item ID example |
List of users for given item ID and type example
Esempio di richiesta
GET https://api.fabric.microsoft.com/v1/admin/workspaces/7f4496db-9929-47bd-89c0-d7eb2f517a98/items/f089354e-8366-4e18-aea3-4cb4a3a50b48/users?type=Report
Risposta di esempio
{
"accessDetails": [
{
"principal": {
"id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
"displayName": "Jacob Hancock",
"type": "User",
"userDetails": {
"userPrincipalName": "jacob@example.com"
}
},
"itemAccessDetails": {
"type": "Report",
"permissions": [
"Read",
"Reshare"
],
"additionalPermissions": [
"ReadAll"
]
}
}
]
}
List of users for given item ID example
Esempio di richiesta
GET https://api.fabric.microsoft.com/v1/admin/workspaces/7f4496db-9929-47bd-89c0-d7eb2f517a98/items/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
Risposta di esempio
{
"accessDetails": [
{
"principal": {
"id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
"displayName": "Jacob Hancock",
"type": "User",
"userDetails": {
"userPrincipalName": "jacob@example.com"
}
},
"itemAccessDetails": {
"type": "Notebook",
"permissions": [
"Read",
"Reshare"
],
"additionalPermissions": [
"ReadAll",
"viewOutput"
]
}
},
{
"principal": {
"id": "c7db8e03-c8cb-4d4c-9f64-1dcd327c9d3c",
"displayName": "Eric Solomon",
"type": "User",
"userDetails": {
"userPrincipalName": "eric@example.com"
}
},
"itemAccessDetails": {
"type": "Notebook",
"permissions": [
"Read",
"Reshare",
"Explore"
],
"additionalPermissions": [
"ReadAll"
]
}
},
{
"principal": {
"id": "f51b705f-a409-4d40-9197-c5d5f349e2f0",
"displayName": "TestSecurityGroup",
"type": "Group",
"groupDetails": {
"groupType": "SecurityGroup"
}
},
"itemAccessDetails": {
"type": "Notebook",
"permissions": [
"Read",
"Reshare"
],
"additionalPermissions": []
}
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Error |
Oggetto dettagli risorsa correlato all'errore. |
Error |
Risposta di errore. |
Error |
Dettagli della risposta di errore. |
Group |
Dettagli specifici del gruppo. Applicabile quando il tipo principale è |
Group |
Tipo del gruppo. È possibile aggiungere altri tipi di gruppo nel tempo. |
Item |
Dettagli delle autorizzazioni degli elementi, ad esempio di lettura e ricondividere. |
Item |
Dettagli di accesso utente per un elemento. |
Item |
Elenco di utenti con accesso a una determinata entità. |
Item |
Autorizzazioni per gli elementi. È possibile aggiungere autorizzazioni aggiuntive per gli elementi nel tempo. |
Item |
Tipo dell'elemento. È possibile aggiungere altri tipi di elemento nel tempo. |
Principal |
Rappresenta un'identità o un gruppo Microsoft Entra. |
Principal |
Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo. |
Service |
Dettagli specifici dell'entità servizio. Applicabile quando il tipo principale è |
Service |
Dettagli del profilo dell'entità servizio. Applicabile quando il tipo principale è |
User |
Dettagli specifici dell'entità utente. Applicabile quando il tipo principale è |
ErrorRelatedResource
Oggetto dettagli risorsa correlato all'errore.
Nome | Tipo | Descrizione |
---|---|---|
resourceId |
string |
ID risorsa coinvolto nell'errore. |
resourceType |
string |
Tipo della risorsa coinvolta nell'errore. |
ErrorResponse
Risposta di errore.
Nome | Tipo | Descrizione |
---|---|---|
errorCode |
string |
Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti. |
message |
string |
Rappresentazione leggibile dell'errore. |
moreDetails |
Elenco di dettagli aggiuntivi sull'errore. |
|
relatedResource |
Dettagli della risorsa correlati all'errore. |
|
requestId |
string |
ID della richiesta associata all'errore. |
ErrorResponseDetails
Dettagli della risposta di errore.
Nome | Tipo | Descrizione |
---|---|---|
errorCode |
string |
Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti. |
message |
string |
Rappresentazione leggibile dell'errore. |
relatedResource |
Dettagli della risorsa correlati all'errore. |
GroupDetails
Dettagli specifici del gruppo. Applicabile quando il tipo principale è Group
.
Nome | Tipo | Descrizione |
---|---|---|
groupType |
Tipo del gruppo. È possibile aggiungere altri tipi di gruppo nel tempo. |
GroupType
Tipo del gruppo. È possibile aggiungere altri tipi di gruppo nel tempo.
Valore | Descrizione |
---|---|
DistributionList |
Principal è una lista di distribuzione. |
SecurityGroup |
Principal è un gruppo di sicurezza. |
Unknown |
Il tipo di gruppo principale è sconosciuto. |
ItemAccessDetail
Dettagli delle autorizzazioni degli elementi, ad esempio di lettura e ricondividere.
Nome | Tipo | Descrizione |
---|---|---|
additionalPermissions |
string[] |
Autorizzazioni del carico di lavoro, ad esempio readAll e viewOutput. |
permissions |
Autorizzazioni degli elementi, ad esempio di lettura e ricondividere. |
|
type |
Tipo di entità. |
ItemAccessDetails
Dettagli di accesso utente per un elemento.
Nome | Tipo | Descrizione |
---|---|---|
itemAccessDetails |
Autorizzazioni per gli elementi per l'utente. |
|
principal |
Informazioni relative all'utente che ha accesso all'entità. |
ItemAccessDetailsResponse
Elenco di utenti con accesso a una determinata entità.
Nome | Tipo | Descrizione |
---|---|---|
accessDetails |
Elenco di utenti con accesso a un'entità. |
ItemPermissions
Autorizzazioni per gli elementi. È possibile aggiungere autorizzazioni aggiuntive per gli elementi nel tempo.
Valore | Descrizione |
---|---|
Execute |
L'utente può eseguire e annullare processi di elemento. |
Explore |
L'utente può creare elementi su altri elementi. |
Read |
L'utente può leggere i metadati relativi a un elemento. |
Reshare |
L'utente può condividere un elemento con altri utenti. |
Write |
L'utente può eseguire operazioni di scrittura su un elemento. |
ItemType
Tipo dell'elemento. È possibile aggiungere altri tipi di elemento nel tempo.
Valore | Descrizione |
---|---|
Dashboard |
Dashboard di Power BI. |
DataPipeline |
Una pipeline di dati. |
Datamart |
Datamart di PowerBI. |
Environment |
Un ambiente. |
Eventhouse |
Una casa eventi. |
Eventstream |
Flusso di eventi. |
GraphQLApi |
API per l'elemento GraphQL. |
KQLDashboard |
Dashboard KQL. |
KQLDatabase |
Un database KQL. |
KQLQueryset |
Set di query KQL. |
Lakehouse |
Una lakehouse. |
MLExperiment |
Esperimento di Machine Learning. |
MLModel |
Modello di Machine Learning. |
MirroredDatabase |
Database con mirroring. |
MirroredWarehouse |
Magazzino con mirroring. |
MountedDataFactory |
Oggetto MountedDataFactory. |
Notebook |
Un notebook. |
PaginatedReport |
Report impaginato di Power BI. |
Reflex |
Un riflesso. |
Report |
Report di Power BI. |
SQLDatabase |
A SQLDatabase. |
SQLEndpoint |
Endpoint SQL. |
SemanticModel |
Modello semantico di PowerBI. |
SparkJobDefinition |
Definizione di processo Spark. |
Warehouse |
Un magazzino. |
Principal
Rappresenta un'identità o un gruppo Microsoft Entra.
Nome | Tipo | Descrizione |
---|---|---|
displayName |
string |
Nome visualizzato dell'entità. |
groupDetails |
Dettagli specifici del gruppo. Applicabile quando il tipo principale è |
|
id |
string uuid |
ID dell'entità. |
servicePrincipalDetails |
Dettagli specifici dell'entità servizio. Applicabile quando il tipo principale è |
|
servicePrincipalProfileDetails |
Dettagli del profilo dell'entità servizio. Applicabile quando il tipo principale è |
|
type |
Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo. |
|
userDetails |
Dettagli specifici dell'entità utente. Applicabile quando il tipo principale è |
PrincipalType
Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo.
Valore | Descrizione |
---|---|
Group |
Principal è un gruppo di sicurezza. |
ServicePrincipal |
Principal è un'entità servizio Microsoft Entra. |
ServicePrincipalProfile |
Principal è un profilo dell'entità servizio. |
User |
Principal è un'entità utente di Microsoft Entra. |
ServicePrincipalDetails
Dettagli specifici dell'entità servizio. Applicabile quando il tipo principale è ServicePrincipal
.
Nome | Tipo | Descrizione |
---|---|---|
aadAppId |
string uuid |
Microsoft Entra AppId dell'entità servizio. |
ServicePrincipalProfileDetails
Dettagli del profilo dell'entità servizio. Applicabile quando il tipo principale è ServicePrincipalProfile
.
Nome | Tipo | Descrizione |
---|---|---|
parentPrincipal |
Entità padre del profilo dell'entità servizio. |
UserDetails
Dettagli specifici dell'entità utente. Applicabile quando il tipo principale è User
.
Nome | Tipo | Descrizione |
---|---|---|
userPrincipalName |
string |
Nome dell'entità utente. |