Admin - Apps GetAppUsersAsAdmin

Serviço:: Power BI REST APIs

Versão da API:: v1.0

Retorna uma lista de usuários que têm acesso ao aplicativo especificado.

Permissions

O usuário deve ser um administrador do Fabric ou autenticar usando uma entidade de serviço.
Há suporte para permissões delegadas.

Ao executar em autenticação prinicipal de serviço, um aplicativo não deve ter as pré-requismissões necessárias de consentimento do administrador para o Power BI definidas 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.

Limitações

Máximo de 200 solicitações por hora.

GET https://api.powerbi.com/v1.0/myorg/admin/apps/{appId}/users

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
appId	path	True	string (uuid)	A ID do aplicativo

Respostas

Nome	Tipo	Description
200 OK	AppUsers	OKEY

Exemplos

Example

Solicitação de exemplo

GET https://api.powerbi.com/v1.0/myorg/admin/apps/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

Resposta de exemplo

Código de status:: 200

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "appUserAccessRight": "ReadExplore",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

Definições

Nome	Description
AppUser	Uma entrada certa de acesso de usuário do Power BI para um aplicativo
AppUserAccessRight	O direito de acesso que o usuário tem para o aplicativo
AppUsers	O wrapper de resposta OData para uma lista de usuários do Power BI com acesso a um aplicativo
PrincipalType	O tipo principal

AppUser

Objeto

Uma entrada certa de acesso de usuário do Power BI para um aplicativo

Nome	Tipo	Description
appUserAccessRight	AppUserAccessRight	O direito de acesso que o usuário tem para o aplicativo
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 somente para APIs de administrador.
identifier	string	Identificador da entidade de segurança
principalType	PrincipalType	O tipo principal

AppUserAccessRight

Enumeração

O direito de acesso que o usuário tem para o aplicativo

Valor	Description
None	Nenhuma permissão para conteúdo no aplicativo
Read	Concede acesso de leitura ao conteúdo no aplicativo
ReadWrite	Concede acesso de leitura e gravação ao conteúdo no aplicativo
ReadReshare	Concede acesso de leitura e compartilhamento ao conteúdo no aplicativo
ReadWriteReshare	Concede acesso de leitura, gravação e recompartilhamento ao conteúdo no aplicativo
ReadExplore	Concede acesso de leitura e exploração ao conteúdo no aplicativo
ReadCopy	Concede acesso de leitura e cópia ao conteúdo no aplicativo
ReadExploreCopy	Concede acesso de leitura, exploração e cópia ao conteúdo no aplicativo
ReadReshareExplore	Concede acesso de leitura, compartilhamento e exploração ao conteúdo no aplicativo
ReadReshareExploreCopy	Concede acesso de leitura, compartilhamento, exploração e cópia ao conteúdo no aplicativo
ReadWriteExplore	Concede acesso de leitura, gravação e exploração ao conteúdo no aplicativo
ReadWriteReshareExplore	Concede acesso de leitura, gravação, compartilhamento e exploração ao conteúdo no aplicativo
ReadWriteExploreCopy	Concede acesso de leitura, gravação, exploração e cópia ao conteúdo no aplicativo
ReadReshareCopy	Concede acesso de leitura, recompartilhamento e cópia ao conteúdo no aplicativo
All	Concede acesso de leitura, gravação, exploração, recompartilhamento e cópia ao conteúdo no aplicativo

AppUsers