Condividi tramite


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
'entità servizio e identità gestite

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
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.

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

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

ErrorResponseDetails[]

Elenco di dettagli aggiuntivi sull'errore.

relatedResource

ErrorRelatedResource

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

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.

GroupDetails

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

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

ItemPermissions[]

Autorizzazioni degli elementi, ad esempio di lettura e ricondividere.

type

ItemType

Tipo di entità.

ItemAccessDetails

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

Elenco di utenti con accesso a una determinata entità.

Nome Tipo Descrizione
accessDetails

ItemAccessDetails[]

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

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

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

Principal

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.