Admin - WidelySharedArtifacts LinksSharedToWholeOrganization

服务:: Power BI REST APIs

API 版本:: v1.0

返回通过链接与整个组织共享的 Power BI 报表列表。

权限

用户必须是 Fabric 管理员或使用服务主体进行身份验证。
支持委派的权限。

所需范围

Tenant.Read.All 或 Tenant.ReadWrite.All

局限性

每小时最多 200 个请求。

GET https://api.powerbi.com/v1.0/myorg/admin/widelySharedArtifacts/linksSharedToWholeOrganization

具有可选参数:

GET https://api.powerbi.com/v1.0/myorg/admin/widelySharedArtifacts/linksSharedToWholeOrganization?continuationToken={continuationToken}

URI 参数

名称	在	必需	类型	说明
continuationToken	query		string	获取结果集的下一个区块所需的令牌

响应

名称	类型	说明
200 OK	ArtifactAccessResponse	还行

示例

Example

示例请求

GET https://api.powerbi.com/v1.0/myorg/admin/widelySharedArtifacts/linksSharedToWholeOrganization

示例响应

状态代码:: 200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite",
      "shareType": "Link",
      "sharer": {
        "displayName": "John Nick",
        "emailAddress": "john@contoso.com",
        "identifier": "john@contoso.com",
        "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
        "principalType": "User"
      }
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/widelySharedArtifacts/linksSharedToWholeOrganization?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

定义

名称	说明
ArtifactAccessEntry	Power BI 项的用户访问条目
ArtifactAccessResponse	用户可以访问的 Power BI 项列表（例如报表或仪表板）的 OData 响应包装器
ArtifactType	项目类型
PrincipalType	主体类型
ServicePrincipalProfile	Power BI 服务主体配置文件。仅适用于 Power BI Embedded 多租户解决方案。
User	Power BI 用户

ArtifactAccessEntry

Object

Power BI 项的用户访问条目

名称	类型	说明
accessRight	string	用户对 Power BI 项拥有的访问权限
artifactId	string	Power BI 项 ID
artifactType	ArtifactType	Power BI 项的类型
displayName	string	Power BI 项的显示名称
shareType	string	如何向 Power BI 项授予访问权限的类型。仅适用于广泛共享的项目 API。
sharer	User	共享 Power BI 项的用户。仅适用于广泛共享的项目 API。

ArtifactAccessResponse

Object

用户可以访问的 Power BI 项列表（例如报表或仪表板）的 OData 响应包装器

名称	类型	说明
@odata.context	string
artifactAccessEntities	ArtifactAccessEntry[]	用户可以访问的 Power BI 项列表
continuationToken	string	结果集中下一个区块的令牌
continuationUri	string	结果集中下一个区块的 URI

ArtifactType

枚举

项目类型

值	说明
Report	Power BI 报表
PaginatedReport	Power BI 分页报表
Dashboard	Power BI 仪表板
Dataset	Power BI 数据集
Dataflow	Power BI 数据流
PersonalGroup	我的工作区对象
Group	V1 共享工作区对象
Workspace	共享工作区对象
Capacity	Capacity 对象
App	Power BI 应用

PrincipalType

枚举

主体类型

值	说明
None	无主体类型。用于整个组织级别的访问。
User	用户主体类型
Group	组主体类型
App	服务主体类型

ServicePrincipalProfile

Object

Power BI 服务主体配置文件。仅适用于 Power BI Embedded 多租户解决方案。

名称	类型	说明
displayName	string	服务主体配置文件名称
id	string (uuid)	服务主体配置文件 ID

User

Object

Power BI 用户

名称	类型	说明
displayName	string	主体的显示名称
emailAddress	string	用户的电子邮件地址
graphId	string	Microsoft Graph 中主体的标识符。仅适用于管理员 API。
identifier	string	主体的标识符
principalType	PrincipalType	主体类型
profile	ServicePrincipalProfile	Power BI 服务主体配置文件。仅适用于 Power BI Embedded 多租户解决方案。
userType	string	用户的类型。