Items - List Item Access Details

Ссылка

Служба:: Admin

Версия API:: v1

Заметка

Этот API находится в предварительной версии.

Возвращает список пользователей (включая группы и субъекты-службы) и перечисляет свои роли рабочей области.

Разрешения

Вызывающий объект должен быть администратором Fabric или пройти проверку подлинности с помощью субъекта-службы.

Обязательные делегированные области

Tenant.Read.All или Tenant.ReadWrite.All

Ограничения

Максимум 200 запросов в час.

Поддерживаемые удостоверения Microsoft Entra

Этот API поддерживает удостоверения Microsoft , перечисленные в этом разделе.

Тождество	Поддержка
Пользователь	Да
субъекта-службы и управляемых удостоверений	Да

Интерфейс

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	Идентификатор элемента.
workspaceId	path	True	string uuid	Идентификатор рабочей области.
type	query		string	Тип элемента. При запросе для следующих типов этот параметр требуется: Сообщать Щиток SemanticModel Приложение Поток данных

Имя

Обязательно

Тип

Описание

itemId

path

True

string

uuid

Идентификатор элемента.

workspaceId

path

True

string

uuid

Идентификатор рабочей области.

type

query

string

Тип элемента. При запросе для следующих типов этот параметр требуется:

Сообщать
Щиток
SemanticModel
Приложение
Поток данных

Ответы

Имя	Тип	Описание
200 OK	ItemAccessDetailsResponse	Операция прошла успешно.
Other Status Codes	ErrorResponse	Распространенные коды ошибок: ItemNotFound — идентификатор элемента не существует. InvalidItemType — тип элемента недействителен.

Имя

Тип

Описание

200 OK

ItemAccessDetailsResponse

Операция прошла успешно.

Other Status Codes

ErrorResponse

Распространенные коды ошибок:

ItemNotFound — идентификатор элемента не существует.
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	Представляет удостоверение или группу Microsoft Entra.
PrincipalType	Тип субъекта. С течением времени могут добавляться дополнительные типы субъектов.
ServicePrincipalDetails	Сведения о субъекте-службе. Применимо, если тип субъекта `ServicePrincipal`.
ServicePrincipalProfileDetails	Сведения о профиле субъекта-службы. Применимо, если тип субъекта `ServicePrincipalProfile`.
UserDetails	Сведения о субъекте-пользователе. Применимо, если тип субъекта `User`.

ErrorRelatedResource

Object

Объект сведений об ошибках, связанных с ресурсом.

Имя	Тип	Описание
resourceId	string	Идентификатор ресурса, участвующий в ошибке.
resourceType	string	Тип ресурса, который участвует в ошибке.

ErrorResponse

Object

Ответ на ошибку.

Имя	Тип	Описание
errorCode	string	Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message	string	Удобочитаемое представление ошибки.
moreDetails	ErrorResponseDetails[]	Список дополнительных сведений об ошибке.
relatedResource	ErrorRelatedResource	Сведения об ошибках, связанных с ресурсом.
requestId	string	Идентификатор запроса, связанного с ошибкой.

ErrorResponseDetails

Object

Сведения об ответе на ошибку.

Имя	Тип	Описание
errorCode	string	Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message	string	Удобочитаемое представление ошибки.
relatedResource	ErrorRelatedResource	Сведения об ошибках, связанных с ресурсом.

GroupDetails

Object

Группировка конкретных сведений. Применимо, если тип субъекта Group.

Имя	Тип	Описание
groupType	GroupType	Тип группы. С течением времени могут добавляться дополнительные типы групп.

GroupType

Перечисление

Тип группы. С течением времени могут добавляться дополнительные типы групп.

Значение	Описание
DistributionList	Субъект — это список рассылки.
SecurityGroup	Субъект — это группа безопасности.
Unknown	Тип основной группы неизвестен.

ItemAccessDetail

Object

Сведения о разрешении элемента, такие как чтения и повторного использования.

Имя	Тип	Описание
additionalPermissions	string[]	Разрешения рабочей нагрузки, такие как readAll и viewOutput.
permissions	ItemPermissions[]	Разрешения элементов, такие как чтения и повторного использования.
type	ItemType	Тип сущности.

ItemAccessDetails

Object

Сведения о доступе пользователей для элемента.

Имя	Тип	Описание
itemAccessDetails	ItemAccessDetail	Разрешения элемента для пользователя.
principal	Principal	Сведения о пользователе, который имеет доступ к сущности.

ItemAccessDetailsResponse

Object

Список пользователей с доступом к определенной сущности.

Имя	Тип	Описание
accessDetails	ItemAccessDetails[]	Список пользователей с доступом к сущности.

ItemPermissions

Перечисление

Разрешения элемента. С течением времени могут добавляться дополнительные разрешения элементов.

Значение	Описание
Execute	Пользователь может выполнять и отменять задания элементов.
Explore	Пользователь может создавать элементы на других элементах.
Read	Пользователь может считывать метаданные об элементе.
Reshare	Пользователь может предоставлять общий доступ к элементу другим пользователям.
Write	Пользователь может выполнять операции записи для элемента.

ItemType

Перечисление

Тип элемента. С течением времени могут добавляться дополнительные типы элементов.

Значение	Описание
Dashboard	Панель мониторинга PowerBI.
DataPipeline	Конвейер данных.
Datamart	Datamart PowerBI.
Environment	Среда.
Eventhouse	Хранилище событий.
Eventstream	Поток событий.
GraphQLApi	API для элемента GraphQL.
KQLDashboard	Панель мониторинга KQL.
KQLDatabase	База данных KQL.
KQLQueryset	Набор запросов KQL.
Lakehouse	Озеро.
MLExperiment	Эксперимент машинного обучения.
MLModel	Модель машинного обучения.
MirroredDatabase	Зеркальная база данных.
MirroredWarehouse	Зеркальный склад.
MountedDataFactory	ПодключеннаяdataFactory.
Notebook	Записная книжка.
PaginatedReport	Отчет с разбивкой на страницы PowerBI.
Reflex	Рефлекс.
Report	Отчет PowerBI.
SQLDatabase	База данных SQLDatabase.
SQLEndpoint	Конечная точка SQL.
SemanticModel	Семантическая модель PowerBI.
SparkJobDefinition	Определение задания Spark.
Warehouse	Склад.

Principal

Object

Представляет удостоверение или группу Microsoft Entra.

Имя	Тип	Описание
displayName	string	Отображаемое имя субъекта.
groupDetails	GroupDetails	Группировка конкретных сведений. Применимо, если тип субъекта `Group`.
id	string uuid	Идентификатор субъекта.
servicePrincipalDetails	ServicePrincipalDetails	Сведения о субъекте-службе. Применимо, если тип субъекта `ServicePrincipal`.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Сведения о профиле субъекта-службы. Применимо, если тип субъекта `ServicePrincipalProfile`.
type	PrincipalType	Тип субъекта. С течением времени могут добавляться дополнительные типы субъектов.
userDetails	UserDetails	Сведения о субъекте-пользователе. Применимо, если тип субъекта `User`.

PrincipalType

Перечисление

Тип субъекта. С течением времени могут добавляться дополнительные типы субъектов.

Значение	Описание
Group	Субъект — это группа безопасности.
ServicePrincipal	Субъект является субъектом-службой Microsoft Entra.
ServicePrincipalProfile	Субъект — это профиль субъекта-службы.
User	Субъект является субъектом-пользователем Microsoft Entra.

ServicePrincipalDetails

Object

Сведения о субъекте-службе. Применимо, если тип субъекта ServicePrincipal.

Имя	Тип	Описание
aadAppId	string uuid	Microsoft Entra AppId субъекта-службы.

ServicePrincipalProfileDetails

Object

Сведения о профиле субъекта-службы. Применимо, если тип субъекта ServicePrincipalProfile.

Имя	Тип	Описание
parentPrincipal	Principal	Родительский субъект профиля субъекта-службы.

UserDetails

Object

Сведения о субъекте-пользователе. Применимо, если тип субъекта User.

Имя	Тип	Описание
userPrincipalName	string	Имя участника-пользователя.

Поделиться через

Items - List Item Access Details

Разрешения

Обязательные делегированные области

Ограничения

Поддерживаемые удостоверения Microsoft Entra

Интерфейс

Параметры 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

Дополнительные ресурсы