Admin - Capacities GetCapacityUsersAsAdmin
Retorna uma lista de usuários que têm acesso ao workspace especificado.
Permissões
- O usuário deve ter direitos de administrador (como Office 365 Administrador Global ou Administrador de Serviços do Power BI).
- Há suporte para permissões delegadas.
Ao executar em autenticação prinicipal de serviço, um aplicativo não deve ter nenhuma pré-solicitação de consentimento de administrador necessária para o Power BI definida nele no portal do Azure.
Escopo necessário
Tenant.Read.All ou Tenant.ReadWrite.All
Relevante somente ao autenticar por meio de um token de acesso de administrador delegado padrão. Não deve estar presente quando a autenticação por meio de uma entidade de serviço é usada.
GET https://api.powerbi.com/v1.0/myorg/admin/capacities/{capacityId}/users
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
capacity
|
path | True |
string uuid |
A ID da capacidade |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OK |
Definições
Nome | Description |
---|---|
Capacity |
Uma entrada correta de acesso de usuário do Power BI para uma capacidade |
capacity |
O direito de acesso que o usuário tem na capacidade |
Capacity |
O wrapper de resposta OData para uma lista de usuários do Power BI com acesso a uma capacidade |
Principal |
O tipo de entidade de segurança |
Service |
Um serviço do Power BI perfil principal. Relevante apenas para Power BI Embedded solução de várias locações. |
CapacityUser
Uma entrada correta de acesso de usuário do Power BI para uma capacidade
Nome | Tipo | Description |
---|---|---|
capacityUserAccessRight |
O direito de acesso que o usuário tem na capacidade |
|
displayName |
string |
Nome de exibição da entidade de segurança |
emailAddress |
string |
Endereço de email do usuário |
graphId |
string |
Identificador da entidade de segurança no Microsoft Graph. Disponível apenas para APIs de administrador. |
identifier |
string |
Identificador da entidade de segurança |
principalType |
O tipo de entidade de segurança |
|
profile |
Um serviço do Power BI perfil principal. Relevante apenas para Power BI Embedded solução de várias locações. |
|
userType |
string |
Tipo do usuário. |
capacityUserAccessRight
O direito de acesso que o usuário tem na capacidade
Nome | Tipo | Description |
---|---|---|
Admin |
string |
O usuário tem direitos de administrador sobre a capacidade |
Assign |
string |
O usuário tem direitos de colaborador e pode atribuir workspaces à capacidade |
None |
string |
O usuário não tem acesso à capacidade |
CapacityUsers
O wrapper de resposta OData para uma lista de usuários do Power BI com acesso a uma capacidade
Nome | Tipo | Description |
---|---|---|
odata.context |
string |
|
value |
A lista de usuários com acesso a uma capacidade |
PrincipalType
O tipo de entidade de segurança
Nome | Tipo | Description |
---|---|---|
App |
string |
Tipo de entidade de serviço |
Group |
string |
Tipo de entidade de grupo |
None |
string |
Nenhum tipo de entidade de segurança. Use para acesso em nível de organização inteiro. |
User |
string |
Tipo de entidade de usuário |
ServicePrincipalProfile
Um serviço do Power BI perfil principal. Relevante apenas para Power BI Embedded solução de várias locações.
Nome | Tipo | Description |
---|---|---|
displayName |
string |
O nome do perfil da entidade de serviço |
id |
string |
A ID do perfil da entidade de serviço |