Uso de las API 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
Realizar operaciones de administración
Insertar 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 pueden procesar el contenido y los datos de la solicitud y la respuesta en regiones distintas de la región principal del inquilino de Power BI.
Á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 la plataforma de identidad de Microsoft (v2.0; Puntos de conexión de MSAL. Para obtener más información sobre cómo funcionan estos métodos de autenticación, consulte ¿Por qué actualizar a la plataforma de identidad de Microsoft (v2.0)?
Para obtener más información sobre los permisos de acceso de Power BI, consulte 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 de . Una vez que habilite una entidad de servicio que se usará con Power BI, los permisos de AD de la aplicación ya no surten efecto. Al usar 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 del servicio Power BI.
Adición de ámbitos
Para agregar permisos a la aplicación de Azure AD, siga estos pasos:
Abra la aplicación en Azure.
A la izquierda, en Administrar, seleccione permisos de API.
Seleccione Agregar un permiso.
En la ventana Solicitar permisos de API, seleccione servicio Power BI.
Seleccione permisos delegados. Se muestra una lista de API.
Expanda la API a la que desea agregar permisos y seleccione los permisos a los que desea agregar.
Seleccione Agregar permisos.
Quitar ámbitos
Para quitar los permisos de la aplicación de Azure AD, siga estos pasos:
Abra la aplicación en Azure.
A la izquierda, en Administrar, seleccione permisos de API.
Seleccione el de menú contextual (puntos suspensivos de permisos).
Seleccione Quitar permiso.
Regulación
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.
Descarga en regiones geográficas
Las operaciones que implican la descarga de archivos en una región diferente de la región en la que se ejecutó la llamada, pueden tardar más de lo esperado.
Grupos de operaciones REST
En esta tabla se enumeran los grupos de operaciones de la API REST de Power BI.
Nota
Para administrar capacidades de de Power BI Embedded, use las API REST de Azure Resource Manager insertadas de .
| Grupo de operaciones | Descripción |
|---|---|
| de administrador de | Operaciones para trabajar con tareas administrativas. |
| Apps | Operaciones para trabajar con aplicaciones. |
| características disponibles | Operaciones que devuelven características disponibles. |
| capacidades de | 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 de | Operaciones para trabajar con flujos de datos. |
| conjuntos de datos de | Operaciones para trabajar con conjuntos de datos. |
| de token de inserción de | Operaciones para trabajar con tokens de inserción. |
| puertas de enlace de | Operaciones para trabajar con puertas de enlace. |
| grupos | Operaciones para trabajar con grupos. |
| imports | Operaciones para trabajar con importaciones. |
| canalizaciones de | Operaciones para trabajar con canalizaciones de implementación. |
| inserción de conjuntos de datos | Operaciones para trabajar con conjuntos de datos de inserción. |
| informes | Operaciones para trabajar con informes. |
| aplicaciones de plantilla de | Operaciones para trabajar con aplicaciones de plantilla. |
| usuarios de | Operaciones para trabajar con usuarios. |