Admin - WidelySharedArtifacts LinksSharedToWholeOrganization

Service:

Power BI REST APIs

API Version:

v1.0

Retorna uma lista de relatórios do Power BI que são compartilhados com toda a organização por meio de links.

Permissões

• O usuário deve ter direitos de administrador (como Office 365 Administrador Global ou Administrador de Serviços do Power BI) 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/widelySharedArtifacts/linksSharedToWholeOrganization

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/widelySharedArtifacts/linksSharedToWholeOrganization?continuationToken={continuationToken}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
continuationToken	query		string	Token necessário para obter a próxima parte do conjunto de resultados

Respostas

Nome	Tipo	Description
200 OK	ArtifactAccessResponse	OK

Exemplos

Example

Sample Request

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

Sample Response

Status code:

200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite",
      "shareType": "Link",
      "sharer": {
        "displayName": "John Nick",
        "emailAddress": "john@contoso.com",
        "identifier": "john@contoso.com",
        "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
        "principalType": "User"
      }
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/widelySharedArtifacts/linksSharedToWholeOrganization?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Definições

Nome	Description
ArtifactAccessEntry	Uma entrada de acesso do usuário para um item do Power BI
ArtifactAccessResponse	O wrapper de resposta OData para uma lista de itens do Power BI (como relatórios ou dashboards) que um usuário pode acessar
ArtifactType	O tipo de artefato
PrincipalType	O tipo de entidade de segurança
ServicePrincipalProfile	Um serviço do Power BI perfil principal. Relevante apenas para Power BI Embedded solução de multilocação.
User	Um usuário do Power BI

ArtifactAccessEntry

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

Nome	Tipo	Description
accessRight	string	O direito de acesso que o usuário tem para o item do Power BI
artifactId	string	A ID do item do Power BI
artifactType	ArtifactType	O tipo de item do Power BI
displayName	string	O nome de exibição do item do Power BI
shareType	string	O tipo de como o acesso é fornecido ao item do Power BI. Disponível apenas para APIs de artefatos amplamente compartilhados.
sharer	User	O usuário que compartilhou o item do Power BI. Disponível apenas para APIs de artefatos amplamente compartilhados.

ArtifactAccessResponse

O wrapper de resposta OData para uma lista de itens do Power BI (como relatórios ou dashboards) que um usuário pode acessar

Nome	Tipo	Description
artifactAccessEntities	ArtifactAccessEntry[]	A lista de itens do Power BI que um usuário pode acessar
continuationToken	string	O token para a próxima parte no conjunto de resultados
continuationUri	string	O URI da próxima parte no conjunto de resultados
odata.context	string

ArtifactType

O tipo de artefato

Nome	Tipo	Description
App	string	Aplicativos do Power BI
Capacity	string	Objeto Capacity
Dashboard	string	Painel do Power BI
Dataflow	string	Fluxo de dados do Power BI
Dataset	string	Conjunto de Dados do Power BI
Group	string	Objeto de workspace compartilhado V1
PaginatedReport	string	Relatório Paginado do Power BI
PersonalGroup	string	Meu objeto de workspace
Report	string	Relatório do Power BI
Workspace	string	Objeto de workspace compartilhado

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 multilocação.

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

User

Um usuário 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 de entidade de segurança
profile	ServicePrincipalProfile	Um serviço do Power BI perfil principal. Relevante apenas para Power BI Embedded solução de multilocação.
userType	string	Tipo do usuário.