Items - List Item Access Details

サービス:: Admin

API バージョン:: v1

ユーザー (グループとサービスプリンシパルを含む) の一覧を返し、ワークスペースロールを一覧表示します。

Note

この API はプレビューリリースの一部であり、評価と開発のみを目的として提供されます。フィードバックに基づいて変更される可能性があり、運用環境での使用はお勧めしません。

Permissions

呼び出し元は、ファブリック管理者であるか、サービスプリンシパルを使用して認証されている必要があります。

必要な委任されたスコープ

Tenant.Read.All または Tenant.ReadWrite.All

Limitations

1 時間あたり最大 200 要求。

Microsoft Entra でサポートされている ID

この API では、このセクションに記載されている Microsoft ID がサポートされています。

Identity	Support
User	Yes
サービスプリンシパルとマネージド ID	Yes

Interface

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}

URI パラメーター

名前	/	必須	型	説明
itemId	path	True	string (uuid)	アイテム ID。
workspaceId	path	True	string (uuid)	ワークスペース ID。
type	query		string	アイテムの種類。次の型のクエリを実行するときは、このパラメーターが必要です。レポート Dashboard SemanticModel App Dataflow

名前

必須

型

説明

itemId

path

True

string (uuid)

アイテム ID。

workspaceId

path

True

string (uuid)

ワークスペース ID。

type

query

string

アイテムの種類。次の型のクエリを実行するときは、このパラメーターが必要です。

レポート
Dashboard
SemanticModel
App
Dataflow

応答

名前	型	説明
200 OK	ItemAccessDetailsResponse	操作が成功しました。
Other Status Codes	ErrorResponse	一般的なエラーコード: ItemNotFound - 項目 ID が存在しません。 InvalidItemType - 項目の種類が無効です。

名前

型

説明

200 OK

ItemAccessDetailsResponse

操作が成功しました。

Other Status Codes

ErrorResponse

一般的なエラーコード:

ItemNotFound - 項目 ID が存在しません。
InvalidItemType - 項目の種類が無効です。

例

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

要求のサンプル

HTTP

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

応答のサンプル

状態コード:: 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

要求のサンプル

HTTP

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

応答のサンプル

状態コード:: 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": []
      }
    }
  ]
}

定義

名前	説明
ErrorRelatedResource	エラー関連のリソース詳細オブジェクト。
ErrorResponse	エラー応答。
ErrorResponseDetails	エラー応答の詳細。
GroupDetails	グループ固有の詳細。プリンシパルの種類が `Group`場合に適用されます。
GroupType	グループの種類。グループの種類は、時間の経過と同時に追加される場合があります。
ItemAccessDetail	読み取りと再共有などのアイテムのアクセス許可の詳細。
ItemAccessDetails	アイテムのユーザーアクセスの詳細。
ItemAccessDetailsResponse	特定のエンティティにアクセスできるユーザーの一覧。
ItemPermissions	アイテムのアクセス許可。アイテムの追加のアクセス許可は、時間の経過と同時に追加される場合があります。
ItemType	アイテムの種類。追加の項目の種類は、時間の経過と同時に追加される場合があります。
Principal	ID または Microsoft Entra グループを表します。
PrincipalType	プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。
ServicePrincipalDetails	サービスプリンシパル固有の詳細。プリンシパルの種類が `ServicePrincipal`場合に適用されます。
ServicePrincipalProfileDetails	サービスプリンシパルプロファイルの詳細。プリンシパルの種類が `ServicePrincipalProfile`場合に適用されます。
UserDetails	ユーザープリンシパル固有の詳細。プリンシパルの種類が `User`場合に適用されます。

ErrorRelatedResource

Object

エラー関連のリソース詳細オブジェクト。

名前	型	説明
resourceId	string	エラーに関係するリソース ID。
resourceType	string	エラーに関係するリソースの種類。

ErrorResponse

Object

エラー応答。

名前	型	説明
errorCode	string	エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message	string	エラーの人間が判読できる表現。
moreDetails	ErrorResponseDetails[]	その他のエラーの詳細の一覧。
relatedResource	ErrorRelatedResource	エラー関連のリソースの詳細。
requestId	string	エラーに関連付けられている要求の ID。

ErrorResponseDetails

Object

エラー応答の詳細。

名前	型	説明
errorCode	string	エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message	string	エラーの人間が判読できる表現。
relatedResource	ErrorRelatedResource	エラー関連のリソースの詳細。

GroupDetails

Object

グループ固有の詳細。プリンシパルの種類が Group場合に適用されます。

名前	型	説明
groupType	GroupType	グループの種類。グループの種類は、時間の経過と同時に追加される場合があります。

GroupType

列挙

グループの種類。グループの種類は、時間の経過と同時に追加される場合があります。

値	説明
Unknown	プリンシパルグループの種類が不明です。
SecurityGroup	プリンシパルはセキュリティグループです。
DistributionList	プリンシパルは配布リストです。

ItemAccessDetail

Object

読み取りと再共有などのアイテムのアクセス許可の詳細。

名前	型	説明
additionalPermissions	string[]	readAll や viewOutput などのワークロードのアクセス許可。
permissions	ItemPermissions[]	読み取りと再共有などのアイテムのアクセス許可。
type	ItemType	エンティティの種類です。

ItemAccessDetails

Object

アイテムのユーザーアクセスの詳細。

名前	型	説明
itemAccessDetails	ItemAccessDetail	ユーザーのアイテムのアクセス許可。
principal	Principal	エンティティにアクセスできるユーザーに関する情報。

ItemAccessDetailsResponse

Object

特定のエンティティにアクセスできるユーザーの一覧。

名前	型	説明
accessDetails	ItemAccessDetails[]	エンティティにアクセスできるユーザーの一覧。

ItemPermissions

列挙

アイテムのアクセス許可。アイテムの追加のアクセス許可は、時間の経過と同時に追加される場合があります。

値	説明
Read	ユーザーはアイテムに関するメタデータを読み取ることができます。
Write	ユーザーは、アイテムに対して書き込み操作を実行できます。
Reshare	ユーザーは、アイテムを他のユーザーと共有できます。
Explore	ユーザーは、他の項目で項目をビルドできます。
Execute	ユーザーは、アイテムジョブを実行および取り消すことができます。

ItemType

列挙

アイテムの種類。追加の項目の種類は、時間の経過と同時に追加される場合があります。

値	説明
Dashboard	PowerBI ダッシュボード。
Report	PowerBI レポート。
SemanticModel	PowerBI セマンティックモデル。
PaginatedReport	PowerBI のページ分割されたレポート。
Datamart	PowerBI データマート。
Lakehouse	レイクハウス。
Eventhouse	イベントハウス。
Environment	環境。
KQLDatabase	KQL データベース。
KQLQueryset	KQL クエリセット。
KQLDashboard	KQL ダッシュボード。
DataPipeline	データパイプライン。
Notebook	ノートブック。
SparkJobDefinition	Spark ジョブ定義。
MLExperiment	機械学習の実験。
MLModel	機械学習モデル。
Warehouse	倉庫。
Eventstream	イベントストリーム。
SQLEndpoint	SQL エンドポイント。
MirroredWarehouse	ミラー化された倉庫。
MirroredDatabase	ミラー化されたデータベース。
Reflex	反射。
GraphQLApi	GraphQL 項目の API。
MountedDataFactory	MountedDataFactory。
SQLDatabase	SQLDatabase。
CopyJob	コピージョブ。
VariableLibrary	VariableLibrary。
Dataflow	データフロー。
ApacheAirflowJob	ApacheAirflowJob。
WarehouseSnapshot	Warehouse スナップショット。
DigitalTwinBuilder	DigitalTwinBuilder。
DigitalTwinBuilderFlow	デジタルツインビルダーフロー。
MirroredAzureDatabricksCatalog	ミラー化された Azure databricks カタログ。
Map	マップ。
AnomalyDetector	Anomaly Detector。
UserDataFunction	ユーザーデータ関数。
GraphModel	GraphModel。
GraphQuerySet	Graph QuerySet。
SnowflakeDatabase	Snowflake アカウントから作成された Iceberg テーブルを格納する Snowflake データベース。
OperationsAgent	OperationsAgent。
CosmosDBDatabase	Cosmos DB データベース。
Ontology	オントロジ。
EventSchemaSet	EventSchemaSet。

Principal

Object

ID または Microsoft Entra グループを表します。

名前	型	説明
displayName	string	プリンシパルの表示名。
groupDetails	GroupDetails	グループ固有の詳細。プリンシパルの種類が `Group`場合に適用されます。
id	string (uuid)	プリンシパルの ID。
servicePrincipalDetails	ServicePrincipalDetails	サービスプリンシパル固有の詳細。プリンシパルの種類が `ServicePrincipal`場合に適用されます。
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	サービスプリンシパルプロファイルの詳細。プリンシパルの種類が `ServicePrincipalProfile`場合に適用されます。
type	PrincipalType	プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。
userDetails	UserDetails	ユーザープリンシパル固有の詳細。プリンシパルの種類が `User`場合に適用されます。

PrincipalType

列挙

プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。

値	説明
User	プリンシパルは Microsoft Entra ユーザープリンシパルです。
ServicePrincipal	プリンシパルは Microsoft Entra サービスプリンシパルです。
Group	プリンシパルはセキュリティグループです。
ServicePrincipalProfile	プリンシパルはサービスプリンシパルプロファイルです。
EntireTenant	プリンシパルは、すべてのテナントユーザーを表します。

ServicePrincipalDetails

Object

サービスプリンシパル固有の詳細。プリンシパルの種類が ServicePrincipal場合に適用されます。

名前	型	説明
aadAppId	string (uuid)	サービスプリンシパルの Microsoft Entra AppId。

ServicePrincipalProfileDetails

Object

サービスプリンシパルプロファイルの詳細。プリンシパルの種類が ServicePrincipalProfile場合に適用されます。

名前	型	説明
parentPrincipal	Principal	サービスプリンシパルプロファイルの親プリンシパル。

UserDetails

Object

ユーザープリンシパル固有の詳細。プリンシパルの種類が User場合に適用されます。

名前	型	説明
userPrincipalName	string	ユーザープリンシパル名。

次の方法で共有

Items - List Item Access Details

Permissions

必要な委任されたスコープ

Limitations

Microsoft Entra でサポートされている ID

Interface

URI パラメーター

応答

例

List of users for given item ID and type example

要求のサンプル

応答のサンプル

List of users for given item ID example

要求のサンプル

応答のサンプル

定義

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GroupDetails

GroupType

ItemAccessDetail

ItemAccessDetails

ItemAccessDetailsResponse

ItemPermissions

ItemType

Principal

PrincipalType

ServicePrincipalDetails

ServicePrincipalProfileDetails

UserDetails