Admin - Users GetUserArtifactAccessAsAdmin

Referencia

Service:: Power BI REST APIs

API Version:: v1.0

Devuelve una lista de elementos de Power BI (como informes o paneles) a los que tiene acceso el usuario especificado.

Permisos

El usuario debe tener derechos de administrador (como Office 365 administrador global o administrador del servicio Power BI) o autenticarse mediante una entidad de servicio.
Se admiten permisos delegados.

Ámbito requerido

Tenant.Read.All o Tenant.ReadWrite.All

Limitaciones

Máximo de 200 solicitudes por hora.

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess?continuationToken={continuationToken}&artifactTypes={artifactTypes}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
userId	path	True	string	Identificador de grafo o nombre principal de usuario (UPN) del usuario
artifactTypes	query		string	Lista separada por comas de tipos de artefactos.
continuationToken	query		string	Token necesario para obtener el siguiente fragmento del conjunto de resultados

Respuestas

Nombre	Tipo	Description
200 OK	ArtifactAccessResponse	Aceptar

Ejemplos

Example

Example with artifactTypes

Example with Guest User

Example with UPN

Example

Sample Request

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

Sample Response

Status code:: 200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with artifactTypes

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser@microsoft.com/artifactAccess?artifactTypes=Dataflow,Dashboard

Sample Response

Status code:: 200

{
  "artifactAccessEntities": [
    {
      "artifactId": "09ce06d1-e81b-fea0-1c6d-8fe3dd2f8e87",
      "displayName": "Test Dataflow",
      "artifactType": "Dataflow",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser%40microsoft.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with Guest User

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser_microsoft.com%23EXT%23@contoso.com/artifactAccess

Sample Response

Status code:: 200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser_microsoft.com%23EXT%23%40contoso.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with UPN

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser@microsoft.com/artifactAccess

Sample Response

Status code:: 200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser%40microsoft.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Definiciones

Nombre	Description
ArtifactAccessEntry	Una entrada de acceso de usuario para un elemento de Power BI
ArtifactAccessResponse	Contenedor de respuesta de OData para una lista de elementos de Power BI (como informes o paneles) a los que un usuario puede acceder
ArtifactType	Tipo de artefacto
PrincipalType	Tipo de entidad de seguridad
ServicePrincipalProfile	Un perfil principal de servicio Power BI. Solo es relevante para Power BI Embedded solución multiinquilino.
User	Un usuario de Power BI

ArtifactAccessEntry

Una entrada de acceso de usuario para un elemento de Power BI

Nombre	Tipo	Description
accessRight	string	Derecho de acceso que tiene el usuario para el elemento de Power BI
artifactId	string	Identificador de elemento de Power BI
artifactType	ArtifactType	Tipo de elemento de Power BI
displayName	string	Nombre para mostrar del elemento de Power BI
shareType	string	Tipo de cómo se asigna el acceso al elemento de Power BI. Solo está disponible para las API de artefactos ampliamente compartidos.
sharer	User	Usuario que compartió el elemento de Power BI. Solo está disponible para las API de artefactos ampliamente compartidos.

ArtifactAccessResponse

Contenedor de respuesta de OData para una lista de elementos de Power BI (como informes o paneles) a los que un usuario puede acceder

Nombre	Tipo	Description
artifactAccessEntities	ArtifactAccessEntry[]	Lista de elementos de Power BI a los que un usuario puede acceder
continuationToken	string	Token del siguiente fragmento del conjunto de resultados
continuationUri	string	El URI del siguiente fragmento del conjunto de resultados
odata.context	string

ArtifactType

Tipo de artefacto

Nombre	Tipo	Description
App	string	Aplicaciones de Power BI
Capacity	string	Capacity (objeto)
Dashboard	string	Panel de Power BI
Dataflow	string	Flujo de datos de Power BI
Dataset	string	Conjunto de datos de Power BI
Group	string	V1 objeto de área de trabajo compartida
PaginatedReport	string	Informe paginado de Power BI
PersonalGroup	string	Mi objeto de área de trabajo
Report	string	Informe de Power BI
Workspace	string	Objeto de área de trabajo compartida

PrincipalType

Tipo de entidad de seguridad

Nombre	Tipo	Description
App	string	Tipo de entidad de servicio
Group	string	Tipo de entidad de seguridad de grupo
None	string	No hay ningún tipo de entidad de seguridad. Use para el acceso de nivel de organización completo.
User	string	Tipo de entidad de seguridad de usuario

ServicePrincipalProfile

Un perfil principal de servicio Power BI. Solo es relevante para Power BI Embedded solución multiinquilino.

Nombre	Tipo	Description
displayName	string	El nombre del perfil de entidad de servicio
id	string	El identificador de perfil de la entidad de servicio

User

Un usuario de Power BI

Nombre	Tipo	Description
displayName	string	Nombre para mostrar de la entidad de seguridad
emailAddress	string	Dirección de correo electrónico del usuario
graphId	string	Identificador de la entidad de seguridad en Microsoft Graph. Solo está disponible para las API de administrador.
identifier	string	Identificador de la entidad de seguridad
principalType	PrincipalType	Tipo de entidad de seguridad
profile	ServicePrincipalProfile	Un perfil principal de servicio Power BI. Solo es relevante para Power BI Embedded solución multiinquilino.
userType	string	Tipo del usuario.

Admin - Users GetUserArtifactAccessAsAdmin

Permisos

Ámbito requerido

Limitaciones

Parámetros de identificador URI

Respuestas

Ejemplos

Example

Sample Request

Sample Response

Example with artifactTypes

Sample Request

Sample Response

Example with Guest User

Sample Request

Sample Response

Example with UPN

Sample Request

Sample Response

Definiciones

ArtifactAccessEntry

ArtifactAccessResponse

ArtifactType

PrincipalType

ServicePrincipalProfile

User

Recursos adicionales