Partilhar via

Admin - Users GetUserSubscriptionsAsAdmin

Serviço:
Power BI REST APIs
Versão da API:
v1.0

Retorna uma lista de assinaturas para o usuário especificado. Essa é uma chamada à API de visualização.

Permissões

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

Escopo necessário

Tenant.Read.All ou Tenant.ReadWrite.All

Limitações

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

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/subscriptions
Com parâmetros opcionais: 
GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/subscriptions?continuationToken={continuationToken}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
userId
 path True

string

A ID do grafo ou o UPN (nome de entidade de usuário) do usuário
continuationToken
 query

string

Token necessário para obter a próxima parte do conjunto de resultados

Respostas

Nome Tipo Description
200 OK

SubscriptionsByUserResponse

OKEY

Exemplos

Example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
200 
{
  "subscriptionEntities": [
    {
      "id": "9225d0bc-9f5e-4819-a637-799c0c4fh3f1",
      "title": "Team Scorecard-test",
      "artifactId": "0b50f0bf-b22b-4685-83b9-b6d17f7f4e46",
      "artifactDisplayName": "Customer Profitability Sample",
      "subArtifactDisplayName": "Team Scorecard",
      "artifactType": "Report",
      "isEnabled": false,
      "frequency": "Daily",
      "startDate": "8/10/2021 12:00:00 AM",
      "endDate": "8/10/2022 12:00:00 AM",
      "linkToContent": false,
      "previewImage": true,
      "attachmentFormat": "PNG",
      "users": []
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/subscriptions?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Definições

Nome Description
PrincipalType

O tipo principal
ServicePrincipalProfile

Um perfil de entidade de serviço do Power BI. Relevante apenas para solução de vários locatários do Power BI Embedded.
Subscription

Uma assinatura de email para um item do Power BI (como um relatório ou um painel)
SubscriptionsByUserResponse

Wrapper de resposta OData para assinaturas do Power BI para usuário
SubscriptionUser

Um usuário de assinatura de email do Power BI

PrincipalType

Enumeração

O tipo principal

Valor Description
None

Nenhum tipo de entidade de segurança. Use todo o acesso ao nível da organização.
User

Tipo de entidade de usuário
Group

Tipo de entidade de grupo
App

Tipo de entidade de serviço

ServicePrincipalProfile

Objeto

Um perfil de entidade de serviço do Power BI. Relevante apenas para solução de vários locatários do Power BI Embedded.

Nome Tipo Description
displayName

string

O nome do perfil da entidade de serviço
id

string (uuid)

A ID do perfil da entidade de serviço

Subscription

Objeto

Uma assinatura de email para um item do Power BI (como um relatório ou um painel)

Nome Tipo Description
artifactDisplayName

string

O nome do item do Power BI assinado (como um relatório ou um painel)
artifactId

string (uuid)

A ID do item do Power BI assinado (como um relatório ou um painel)
artifactType

string

O tipo de item do Power BI (por exemplo, um Report, Dashboardou Dataset)
attachmentFormat

string

Formato do relatório anexado na assinatura de email
endDate

string (date-time)

A data e a hora de término da assinatura de email
frequency

string

A frequência da assinatura de email
id

string (uuid)

A ID da assinatura
isEnabled

boolean

Se a assinatura de email está habilitada
linkToContent

boolean

Se existe um link de assinatura na assinatura de email
previewImage

boolean

Se existe uma captura de tela do relatório na assinatura de email
startDate

string (date-time)

A data e a hora de início da assinatura de email
subArtifactDisplayName

string

O nome da página do item do Power BI assinado, se for um relatório.
title

string

O nome do aplicativo
users

SubscriptionUser[]

Os detalhes de cada assinante de email. Ao usar o obter assinaturas de usuário como administrador chamada à API, o valor retornado é uma matriz vazia (nula). Essa propriedade será removida da resposta de conteúdo em uma versão futura. Você pode recuperar informações de assinatura em um relatório ou dashboard do Power BI usando o Obter Assinaturas de Relatório como Administrador ou Obter Assinaturas do Painel como Administrador chamadas à API.

SubscriptionsByUserResponse

Objeto

Wrapper de resposta OData para assinaturas do Power BI para usuário

Nome Tipo Description
@odata.context

string

continuationToken

string

Token para obter a próxima parte do conjunto de resultados
continuationUri

string

O URI para a próxima parte no conjunto de resultados
subscriptionEntities

Subscription[]

As assinaturas do usuário

SubscriptionUser

Objeto

Um usuário de assinatura de email do Power BI

Nome Tipo Description
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
profile

ServicePrincipalProfile

Um perfil de entidade de serviço do Power BI. Relevante apenas para solução de vários locatários do Power BI Embedded.
userType

string

Tipo do usuário.