Admin - Apps GetAppUsersAsAdmin
返回有权访问指定应用的用户的列表。
权限
- 用户必须具有管理员权限 (,例如Office 365全局管理员或 Power BI 服务管理员) 或使用服务主体进行身份验证。
- 支持委派权限。
在服务原始身份验证下运行时,应用不得在Azure 门户中为其设置任何管理员同意所需的 Power BI 授权。
必需范围
Tenant.Read.All 或 Tenant.ReadWrite.All
仅当通过标准委派管理员访问令牌进行身份验证时才相关。 使用通过服务主体进行身份验证时,不得存在。
限制
每小时最多 200 个请求。
GET https://api.powerbi.com/v1.0/myorg/admin/apps/{appId}/users
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
app
|
path | True |
string uuid |
应用 ID |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
OK |
示例
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/apps/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
Sample Response
{
"value": [
{
"displayName": "John Nick",
"emailAddress": "john@contoso.com",
"appUserAccessRight": "ReadExplore",
"identifier": "john@contoso.com",
"graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
"principalType": "User"
}
]
}
定义
名称 | 说明 |
---|---|
App |
应用的 Power BI 用户访问权限条目 |
App |
用户对应用的访问权限 |
App |
具有应用访问权限的 Power BI 用户列表的 OData 响应包装器 |
Principal |
主体类型 |
AppUser
应用的 Power BI 用户访问权限条目
名称 | 类型 | 说明 |
---|---|---|
appUserAccessRight |
用户对应用的访问权限 |
|
displayName |
string |
主体的显示名称 |
emailAddress |
string |
用户的电子邮件地址 |
graphId |
string |
Microsoft Graph 中主体的标识符。 仅适用于管理员 API。 |
identifier |
string |
主体的标识符 |
principalType |
主体类型 |
AppUserAccessRight
用户对应用的访问权限
名称 | 类型 | 说明 |
---|---|---|
All |
string |
授予对应用中内容的读取、写入、浏览、重新共享和复制访问权限 |
None |
string |
对应用中的内容没有权限 |
Read |
string |
授予对应用中内容的读取访问权限 |
ReadCopy |
string |
授予对应用中内容的读取和复制访问权限 |
ReadExplore |
string |
授予对应用中内容的读取和浏览访问权限 |
ReadExploreCopy |
string |
授予对应用中内容的读取、浏览和复制访问权限 |
ReadReshare |
string |
授予对应用中内容的读取和重新共享访问权限 |
ReadReshareCopy |
string |
授予对应用中内容的读取、重新共享和复制访问权限 |
ReadReshareExplore |
string |
授予对应用中内容的读取、重新共享和浏览访问权限 |
ReadReshareExploreCopy |
string |
授予对应用中内容的读取、重新共享、浏览和复制访问权限 |
ReadWrite |
string |
授予对应用中内容的读取和写入访问权限 |
ReadWriteExplore |
string |
授予对应用中内容的读取、写入和浏览访问权限 |
ReadWriteExploreCopy |
string |
授予对应用中内容的读取、写入、浏览和复制访问权限 |
ReadWriteReshare |
string |
授予对应用中内容的读取、写入和重新共享访问权限 |
ReadWriteReshareExplore |
string |
授予对应用中内容的读取、写入、重新共享和浏览访问权限 |
AppUsers
具有应用访问权限的 Power BI 用户列表的 OData 响应包装器
名称 | 类型 | 说明 |
---|---|---|
odata.context |
string |
|
value |
App |
有权访问应用的用户列表 |
PrincipalType
主体类型
名称 | 类型 | 说明 |
---|---|---|
App |
string |
服务主体类型 |
Group |
string |
组主体类型 |
None |
string |
无主体类型。 用于整个组织级别的访问。 |
User |
string |
用户主体类型 |