Items - List Item Access Details

Referencia

Szolgáltatás:: Admin

API-verzió:: v1

Jegyzet

Ez az API előzetes verzióban érhető el.

Visszaadja a felhasználók listáját (beleértve a csoportokat és a szolgáltatásneveket), és felsorolja a munkaterületi szerepköröket.

Engedélyek

A hívónak háló-rendszergazdának kell lennie, vagy hitelesítést kell végeznie egy szolgáltatásnévvel.

Kötelező delegált hatókörök

Tenant.Read.All vagy Tenant.ReadWrite.All

Korlátozások

Óránként legfeljebb 200 kérelem.

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Azonosság	Támogat
Felhasználó	Igen
szolgáltatásnév és felügyelt identitások	Igen

Interfész

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
itemId	path	True	string (uuid)	Az elem azonosítója.
workspaceId	path	True	string (uuid)	A munkaterület azonosítója.
type	query		string	Az elem típusa. A következő típusok lekérdezéséhez ez a paraméter szükséges: Jelentés Műszerfal SzemanticModel App Adatfolyam

Name

Kötelező

Típus

Description

itemId

path

True

string (uuid)

Az elem azonosítója.

workspaceId

path

True

string (uuid)

A munkaterület azonosítója.

type

query

string

Az elem típusa. A következő típusok lekérdezéséhez ez a paraméter szükséges:

Jelentés
Műszerfal
SzemanticModel
App
Adatfolyam

Válaszok

Name	Típus	Description
200 OK	ItemAccessDetailsResponse	A művelet sikeres volt.
Other Status Codes	ErrorResponse	Gyakori hibakódok: ItemNotFound – Az elemazonosító nem létezik. InvalidItemType – Az elem típusa érvénytelen.

Name

Típus

Description

200 OK

ItemAccessDetailsResponse

A művelet sikeres volt.

Other Status Codes

ErrorResponse

Gyakori hibakódok:

ItemNotFound – Az elemazonosító nem létezik.
InvalidItemType – Az elem típusa érvénytelen.

Példák

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

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:: 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

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:: 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": []
      }
    }
  ]
}

Definíciók

Name	Description
ErrorRelatedResource	A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse	A hibaválasz.
ErrorResponseDetails	A hibaválasz részletei.
GroupDetails	Csoportosítsa a részleteket. Akkor alkalmazható, ha az egyszerű típus `Group`.
GroupType	A csoport típusa. Idővel további csoporttípusok is hozzáadhatók.
ItemAccessDetail	Az elemengedélyek részletei, például olvasási és újraosztása.
ItemAccessDetails	Egy elem felhasználói hozzáférési adatai.
ItemAccessDetailsResponse	Egy adott entitáshoz hozzáféréssel rendelkező felhasználók listája.
ItemPermissions	Elemengedélyek. Idővel további elemengedélyek is hozzáadhatók.
ItemType	Az elem típusa. Idővel további elemtípusok is hozzáadhatók.
Principal	Identitást vagy Microsoft Entra-csoportot jelöl.
PrincipalType	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.
ServicePrincipalDetails	A szolgáltatásnév konkrét részletei. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipal`.
ServicePrincipalProfileDetails	A szolgáltatásnév profiladatai. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipalProfile`.
UserDetails	A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus `User`.

ErrorRelatedResource

Objektum

A hibával kapcsolatos erőforrás-részletek objektum.

Name	Típus	Description
resourceId	string	A hibában érintett erőforrás-azonosító.
resourceType	string	A hibában érintett erőforrás típusa.

ErrorResponse

Objektum

A hibaválasz.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
moreDetails	ErrorResponseDetails[]	További hibaadatok listája.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.
requestId	string	A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

A hibaválasz részletei.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.

GroupDetails

Objektum

Csoportosítsa a részleteket. Akkor alkalmazható, ha az egyszerű típus Group.

Name	Típus	Description
groupType	GroupType	A csoport típusa. Idővel további csoporttípusok is hozzáadhatók.

GroupType

Enumerálás

A csoport típusa. Idővel további csoporttípusok is hozzáadhatók.

Érték	Description
DistributionList	Az egyszerű egy terjesztési lista.
SecurityGroup	Az egyszerű egy biztonsági csoport.
Unknown	Az egyszerű csoport típusa ismeretlen.

ItemAccessDetail

Objektum

Az elemengedélyek részletei, például olvasási és újraosztása.

Name	Típus	Description
additionalPermissions	string[]	Számítási feladatokra vonatkozó engedélyek, például readAll és viewOutput.
permissions	ItemPermissions[]	Elemengedélyek, például olvasási és újramegosztása.
type	ItemType	Entitás típusa.

ItemAccessDetails

Objektum

Egy elem felhasználói hozzáférési adatai.

Name	Típus	Description
itemAccessDetails	ItemAccessDetail	Elemengedélyek a felhasználó számára.
principal	Principal	Az entitáshoz hozzáféréssel rendelkező felhasználóra vonatkozó információk.

ItemAccessDetailsResponse

Objektum

Egy adott entitáshoz hozzáféréssel rendelkező felhasználók listája.

Name	Típus	Description
accessDetails	ItemAccessDetails[]	Egy entitáshoz hozzáféréssel rendelkező felhasználók listája.

ItemPermissions

Enumerálás

Elemengedélyek. Idővel további elemengedélyek is hozzáadhatók.

Érték	Description
Execute	A felhasználó végrehajthatja és megszakíthatja az elemfeladatokat.
Explore	A felhasználó más elemekre is építhet elemeket.
Read	A felhasználó elolvashatja egy elem metaadatait.
Reshare	A felhasználó megoszthatja az elemet más felhasználókkal.
Write	A felhasználó írási műveleteket hajthat végre egy elemen.

ItemType

Enumerálás

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.

Érték	Description
CopyJob	Másolási feladat.
Dashboard	PowerBI-irányítópult.
DataPipeline	Egy adatfolyam.
Datamart	PowerBI datamart.
Environment	Egy környezet.
Eventhouse	Egy rendezvényház.
Eventstream	Eseménystream.
GraphQLApi	Api a GraphQL-elemhez.
KQLDashboard	KQL-irányítópult.
KQLDatabase	KQL-adatbázis.
KQLQueryset	KQL-lekérdezéskészlet.
Lakehouse	Egy tóház.
MLExperiment	Gépi tanulási kísérlet.
MLModel	Gépi tanulási modell.
MirroredDatabase	Tükrözött adatbázis.
MirroredWarehouse	Egy tükrözött raktár.
MountedDataFactory	A MountedDataFactory.
Notebook	Egy jegyzetfüzet.
PaginatedReport	Többoldalas PowerBI-jelentés.
Reflex	Egy reflex.
Report	PowerBI-jelentés.
SQLDatabase	A SQLDatabase.
SQLEndpoint	EGY SQL-végpont.
SemanticModel	PowerBI szemantikai modell.
SparkJobDefinition	Spark-feladat definíciója.
VariableLibrary	Egy VariableLibrary.
Warehouse	Egy raktár.

Principal

Objektum

Identitást vagy Microsoft Entra-csoportot jelöl.

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
groupDetails	GroupDetails	Csoportosítsa a részleteket. Akkor alkalmazható, ha az egyszerű típus `Group`.
id	string (uuid)	Az igazgató azonosítója.
servicePrincipalDetails	ServicePrincipalDetails	A szolgáltatásnév konkrét részletei. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipal`.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	A szolgáltatásnév profiladatai. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipalProfile`.
type	PrincipalType	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.
userDetails	UserDetails	A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus `User`.

PrincipalType

Enumerálás

A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

Érték	Description
Group	Az egyszerű egy biztonsági csoport.
ServicePrincipal	Az egyszerű szolgáltatásnév a Microsoft Entra szolgáltatásnév.
ServicePrincipalProfile	Az egyszerű szolgáltatásnév egy szolgáltatásnév-profil.
User	Az egyszerű felhasználó a Microsoft Entra egyik egyszerű felhasználója.

ServicePrincipalDetails

Objektum

A szolgáltatásnév konkrét részletei. Akkor alkalmazható, ha az egyszerű típus ServicePrincipal.

Name	Típus	Description
aadAppId	string (uuid)	A szolgáltatásnév Microsoft Entra AppId azonosítója.

ServicePrincipalProfileDetails

Objektum

A szolgáltatásnév profiladatai. Akkor alkalmazható, ha az egyszerű típus ServicePrincipalProfile.

Name	Típus	Description
parentPrincipal	Principal	A szolgáltatásnév-profil szülőnevét.

UserDetails

Objektum

A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus User.

Name	Típus	Description
userPrincipalName	string	A felhasználónév.

Megosztás a következőn keresztül:

Items - List Item Access Details

Engedélyek

Kötelező delegált hatókörök

Korlátozások

Microsoft Entra által támogatott identitások

Interfész

URI-paraméterek

Válaszok

Példák

List of users for given item ID and type example

Mintakérelem

Mintaválasz

List of users for given item ID example

Mintakérelem

Mintaválasz

Definíciók

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GroupDetails

GroupType

ItemAccessDetail

ItemAccessDetails

ItemAccessDetailsResponse

ItemPermissions

ItemType

Principal

PrincipalType

ServicePrincipalDetails

ServicePrincipalProfileDetails

UserDetails

További források