Admin - Dashboards GetDashboardsAsAdmin

Serviço:: Power BI REST APIs

Versão da API:: v1.0

Retorna uma lista de dashboards para a organização.

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 50 solicitações por hora ou 5 solicitações por minuto, por locatário.

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

Com parâmetros opcionais:

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}

Parâmetros de URI

Nome	Em	Tipo	Description
$expand	query	string	Aceita uma lista separada por vírgulas de tipos de dados, que será expandida embutida na resposta. `tiles`Dá suporte a .
$filter	query	string	Retorna um subconjunto de resultados com base na condição de parâmetro de consulta do filtro Odata .
$skip	query	integer (int32)	Ignora os primeiros n resultados
$top	query	integer (int32)	Retorna apenas os primeiros n resultados

Respostas

Nome	Tipo	Description
200 OK	AdminDashboards	OKEY

Exemplos

Example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 200

{
  "value": [
    {
      "id": "69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
      "displayName": "SalesMarketing",
      "embedUrl": "https://app.powerbi.com/dashboardEmbed?dashboardId=69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
      "isReadOnly": false,
      "workspaceId": "abfbdc89-2659-43c1-9142-93e8378eac96"
    }
  ]
}

Definições

Nome	Description
AdminDashboard	Um painel do Power BI retornado por APIs de administrador. A API retorna um subconjunto da lista a seguir de propriedades do painel. O subconjunto depende da API chamada, das permissões de chamador e da disponibilidade de dados no banco de dados do Power BI.
AdminDashboards	O wrapper de resposta OData para uma coleção de painéis do Power BI
AdminTile	Um bloco do Power BI retornado pelas APIs de Administrador.
DashboardUser	Uma entrada certa de acesso de usuário do Power BI para um dashboard
DashboardUserAccessRight	O direito de acesso que o usuário tem para o painel (nível de permissão)
PrincipalType	O tipo principal
ServicePrincipalProfile	Um perfil de entidade de serviço do Power BI. Relevante apenas para a solução de multilocação do Power BI Embedded.
Subscription	Uma assinatura de email para um item do Power BI (como um relatório ou um painel)
SubscriptionUser	Um usuário de assinatura de email do Power BI

AdminDashboard

Objeto

Um painel do Power BI retornado por APIs de administrador. A API retorna um subconjunto da lista a seguir de propriedades do painel. O subconjunto depende da API chamada, das permissões de chamador e da disponibilidade de dados no banco de dados do Power BI.

Nome	Tipo	Description
appId	string	A ID do aplicativo, retornada somente se o painel pertencer a um aplicativo
displayName	string	O nome de exibição do painel
embedUrl	string	A URL de inserção do painel
id	string (uuid)	A ID do painel
isReadOnly	boolean	Se o painel é somente leitura
subscriptions	Subscription[]	(Valor vazio) Os detalhes da assinatura de um item do Power BI (como um relatório ou um painel). Essa propriedade será removida da resposta de conteúdo em uma versão futura. Você pode recuperar informações de assinatura para um relatório do Power BI usando a chamada Obter Assinaturas de Relatório como API de Administrador.
tiles	AdminTile[]	Os blocos que pertencem ao painel
users	DashboardUser[]	(Valor vazio) Os detalhes de acesso do usuário do painel. Essa propriedade será removida da resposta de conteúdo em uma versão futura. Você pode recuperar informações do usuário em um painel do Power BI usando a chamada Obter Usuários do Painel como API de Administrador ou a chamada à API PostWorkspaceInfo com o `getArtifactUsers` parâmetro.
webUrl	string	A URL da Web do painel
workspaceId	string (uuid)	A ID do workspace (GUID) do painel. Essa propriedade será retornada somente em GetDashboardsAsAdmin.