Items - List Item Access Details

Riferimento

Servizio:: Admin

Versione API:: v1

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

Con parametri facoltativi:

GET https://api.fabric.microsoft.com/v1/admin/workspaces/{workspaceId}/items/{itemId}/users?type={type}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
itemId	path	True	string uuid	ID elemento.
workspaceId	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: Rapporto Cruscotto SemanticModel App Flusso

Nome

Necessario

Tipo

Descrizione

itemId

path

True

string

uuid

ID elemento.

workspaceId

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:

Rapporto
Cruscotto
SemanticModel
App
Flusso

Risposte

Nome	Tipo	Descrizione
200 OK	ItemAccessDetailsResponse	Operazione riuscita.
Other Status Codes	ErrorResponse	Codici di errore comuni: ItemNotFound: l'ID dell'elemento non esiste. InvalidItemType: il tipo di elemento non è valido.

Nome

Tipo

Descrizione

200 OK

ItemAccessDetailsResponse

Operazione riuscita.

Other Status Codes

ErrorResponse

Codici di errore comuni:

ItemNotFound: l'ID dell'elemento non esiste.
InvalidItemType: il tipo di elemento non è valido.

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

HTTP

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

Codice di stato:: 200

{
  "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

HTTP

GET https://api.fabric.microsoft.com/v1/admin/workspaces/7f4496db-9929-47bd-89c0-d7eb2f517a98/items/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

Risposta di esempio

Codice di stato:: 200

{
  "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
ErrorRelatedResource	Oggetto dettagli risorsa correlato all'errore.
ErrorResponse	Risposta di errore.
ErrorResponseDetails	Dettagli della risposta di errore.
GroupDetails	Dettagli specifici del gruppo. Applicabile quando il tipo principale è `Group`.
GroupType	Tipo del gruppo. È possibile aggiungere altri tipi di gruppo nel tempo.
ItemAccessDetail	Dettagli delle autorizzazioni degli elementi, ad esempio di lettura e ricondividere.
ItemAccessDetails	Dettagli di accesso utente per un elemento.
ItemAccessDetailsResponse	Elenco di utenti con accesso a una determinata entità.
ItemPermissions	Autorizzazioni per gli elementi. È possibile aggiungere autorizzazioni aggiuntive per gli elementi nel tempo.
ItemType	Tipo dell'elemento. È possibile aggiungere altri tipi di elemento nel tempo.
Principal	Rappresenta un'identità o un gruppo Microsoft Entra.
PrincipalType	Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo.
ServicePrincipalDetails	Dettagli specifici dell'entità servizio. Applicabile quando il tipo principale è `ServicePrincipal`.
ServicePrincipalProfileDetails	Dettagli del profilo dell'entità servizio. Applicabile quando il tipo principale è `ServicePrincipalProfile`.
UserDetails	Dettagli specifici dell'entità utente. Applicabile quando il tipo principale è `User`.

ErrorRelatedResource

Object

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

Object

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	ErrorResponseDetails[]	Elenco di dettagli aggiuntivi sull'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.
requestId	string	ID della richiesta associata all'errore.

ErrorResponseDetails

Object

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	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.

GroupDetails

Object

Dettagli specifici del gruppo. Applicabile quando il tipo principale è Group.

Nome	Tipo	Descrizione
groupType	GroupType	Tipo del gruppo. È possibile aggiungere altri tipi di gruppo nel tempo.

GroupType

Enumeration

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

Object

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	ItemPermissions[]	Autorizzazioni degli elementi, ad esempio di lettura e ricondividere.
type	ItemType	Tipo di entità.

ItemAccessDetails

Object

Dettagli di accesso utente per un elemento.

Nome	Tipo	Descrizione
itemAccessDetails	ItemAccessDetail	Autorizzazioni per gli elementi per l'utente.
principal	Principal	Informazioni relative all'utente che ha accesso all'entità.

ItemAccessDetailsResponse

Object

Elenco di utenti con accesso a una determinata entità.

Nome	Tipo	Descrizione
accessDetails	ItemAccessDetails[]	Elenco di utenti con accesso a un'entità.

ItemPermissions

Enumeration

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

Enumeration

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

Object

Rappresenta un'identità o un gruppo Microsoft Entra.

Nome	Tipo	Descrizione
displayName	string	Nome visualizzato dell'entità.
groupDetails	GroupDetails	Dettagli specifici del gruppo. Applicabile quando il tipo principale è `Group`.
id	string uuid	ID dell'entità.
servicePrincipalDetails	ServicePrincipalDetails	Dettagli specifici dell'entità servizio. Applicabile quando il tipo principale è `ServicePrincipal`.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Dettagli del profilo dell'entità servizio. Applicabile quando il tipo principale è `ServicePrincipalProfile`.
type	PrincipalType	Tipo dell'entità. È possibile aggiungere altri tipi di entità nel tempo.
userDetails	UserDetails	Dettagli specifici dell'entità utente. Applicabile quando il tipo principale è `User`.

PrincipalType

Enumeration

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

Object

Dettagli specifici dell'entità servizio. Applicabile quando il tipo principale è ServicePrincipal.

Nome	Tipo	Descrizione
aadAppId	string uuid	Microsoft Entra AppId dell'entità servizio.

ServicePrincipalProfileDetails

Object

Dettagli del profilo dell'entità servizio. Applicabile quando il tipo principale è ServicePrincipalProfile.

Nome	Tipo	Descrizione
parentPrincipal	Principal	Entità padre del profilo dell'entità servizio.

UserDetails

Object

Dettagli specifici dell'entità utente. Applicabile quando il tipo principale è User.

Nome	Tipo	Descrizione
userPrincipalName	string	Nome dell'entità utente.

Condividi tramite

Items - List Item Access Details

Autorizzazioni

Ambiti delegati obbligatori

Limitazioni

Identità supportate da Microsoft Entra

Interfaccia

Parametri dell'URI

Risposte

Esempio

List of users for given item ID and type example

Esempio di richiesta

Risposta di esempio

List of users for given item ID example

Esempio di richiesta

Risposta di esempio

Definizioni

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GroupDetails

GroupType

ItemAccessDetail

ItemAccessDetails

ItemAccessDetailsResponse

ItemPermissions

ItemType

Principal

PrincipalType

ServicePrincipalDetails

ServicePrincipalProfileDetails

UserDetails

Risorse aggiuntive