Uso de las API de REST de Power BI

Las API rest de Power BI proporcionan puntos de conexión de servicio para insertar, administrar, gobernanza y recursos de usuario.

Con las API rest de Power BI, puede hacer lo siguiente:

  • Administración del contenido de Power BI

  • Realización de operaciones de administración

  • Inserción de contenido de Power BI

Nota:

  • Algunas de las API de Power BI hacen referencia a áreas de trabajo como grupos. Cualquier referencia a grupos significa que está trabajando con áreas de trabajo.

  • Al acceder a la API rest de Power BI, los centros de datos de las regiones que no sean la región principal del inquilino de Power BI pueden procesar los datos y el contenido de la solicitud y respuesta.

Ámbitos

Para usar las API rest de Power BI, debe registrar una aplicación de Azure Active Directory (Azure AD) en Azure. La aplicación de Azure AD establece permisos para los recursos REST de Power BI y permite el acceso a las API REST de Power BI. Para obtener información sobre cómo registrar una aplicación, consulte Registro de una aplicación de Azure AD para usarla con Power BI.

Después de registrar una aplicación de Azure AD, puede autenticarse en ella mediante Azure AD (v1.0; ADAL) o el Plataforma de identidad de Microsoft (v2.0; Puntos de conexión MSAL). Para obtener más información sobre cómo funcionan estos métodos de autenticación, consulte ¿Por qué actualizar a Plataforma de identidad de Microsoft (v2.0)?

Para obtener más información sobre los permisos de acceso de Power BI, vea Permisos y consentimiento en el punto de conexión de la Plataforma de identidad de Microsoft.

Uso de una entidad de servicio

Los ámbitos no son necesarios si usa una entidad de servicio. Una vez que habilite una entidad de servicio para usarla con Power BI, los permisos de AD de la aplicación ya no surten efecto. Cuando se usa una entidad de servicio, los permisos de la aplicación se administran a través del portal de administración de Power BI. Para obtener más información, consulte Habilitación de la configuración de administración de servicio Power BI.

Adición de ámbitos

Para agregar permisos a la aplicación de Azure AD, siga estos pasos:

  1. Abra la aplicación en Azure.

  2. En la izquierda, en Administrar, seleccione Permisos de API.

  3. Seleccione Agregar un permiso.

  4. En la ventana Solicitar permisos de API , seleccione Servicio Power BI.

  5. Seleccione Permisos delegados. Se muestra una lista de LAS API.

  6. Expanda la API a la que desea agregar permisos y seleccione los permisos a los que desea agregar.

  7. Seleccione Agregar permisos.

Eliminación de ámbitos

Para quitar permisos de la aplicación de Azure AD, siga estos pasos:

  1. Abra la aplicación en Azure.

  2. En la izquierda, en Administrar, seleccione Permisos de API.

  3. Seleccione el menú contextual (puntos suspensivos de permisos).

  4. Seleccione Quitar permiso.

Limitaciones

Power BI usa la limitación para mantener un rendimiento y una confiabilidad óptimos. Para evitar el uso excesivo de recursos de usuarios únicos, Power BI limita el número de llamadas API dentro de un período de tiempo por usuario.

Cuando un usuario envía una serie de solicitudes que superan un límite predeterminado durante un período de tiempo, Power BI limita las solicitudes adicionales de ese usuario durante un breve período.

Cuando las aplicaciones experimentan una limitación, Power BI devuelve un código de estado HTTP 429 (demasiadas solicitudes) con un encabezado HTTP Retry-After en la respuesta, lo que indica cuántos segundos debe esperar la aplicación que realiza la llamada antes de realizar una nueva solicitud.

Grupos de operaciones rest

En esta tabla se enumeran los grupos de operaciones de la API REST de Power BI.

Grupo de operaciones Descripción
Administrador Operaciones para trabajar con tareas administrativas.
Aplicaciones Operaciones para trabajar con aplicaciones.
Características disponibles Operaciones que devuelven las características disponibles.
Capacidades Operaciones para trabajar con capacidades.
Paneles Operaciones para trabajar con paneles.
Cuentas de almacenamiento de flujo de datos Operaciones para trabajar con cuentas de almacenamiento de flujo de datos.
Flujos de datos Operaciones para trabajar con flujos de datos.
Conjuntos de datos Operaciones para trabajar con conjuntos de datos.
Token de inserción Operaciones para trabajar con tokens de inserción.
Puertas de enlace Operaciones para trabajar con puertas de enlace.
Grupos Operaciones para trabajar con grupos.
Importaciones Operaciones para trabajar con importaciones.
Canalizaciones Operaciones para trabajar con canalizaciones de implementación.
Conjuntos de datos de inserción Operaciones para trabajar con conjuntos de datos de inserción.
Informes Operaciones para trabajar con informes.
Aplicaciones de plantilla Operaciones para trabajar con aplicaciones plantilla.
Usuarios Operaciones para trabajar con usuarios.

Pasos siguientes