Imports - Post Import In Group
Crea contenido en el área de trabajo especificada.
Nota
Contenido admitido:
- Archivos .pbix de Power BI
- Archivos JSON (.json)
- Archivos de Excel (.xlsx)
- SQL Server archivos de lenguaje de definición de informe (.rdl)
- Para importar un archivo, especifique el tipo de contenido multipart/form-data en los encabezados de solicitud y codifique el archivo como datos del formulario en el cuerpo de la solicitud.
- Para importar un archivo .rdl, incluya la extensión de archivo en el nombre especificado por
datasetDisplayName
, como se describe en parámetros de URI. - Para importar un archivo .xlsx de OneDrive para la Empresa, incluya el tipo de contenido application/json en los encabezados de solicitud. Incluya ImportInfo con
filePath
establecido en la ruta de acceso del archivo .xlsx en el cuerpo de la solicitud. - Para importar archivos .pbix de Power BI de gran tamaño entre 1 GB y 10 GB, consulte Create ubicación de carga temporal en grupo y el script de PowerShell Para importar archivos grandes. Esto solo se admite para áreas de trabajo de capacidad Premium.
- Para crear un flujo de datos a partir de un archivo de model.json, establezca
datasetDisplayName
en model.json, como se describe en parámetros de URI.
Permisos
Un perfil de entidad de servicio puede llamar a esta llamada API. Para obtener más información, consulte: Perfiles de entidad de servicio en Power BI Embedded.
Ámbito requerido
Dataset.ReadWrite.All
Limitaciones
- No se admiten flujos de datos con la entidad de servicio.
- No se admite la importación de un archivo .pbix de Power BI desde OneDrive.
- No se admite la importación de un archivo que tenga una etiqueta de confidencialidad protegida para las entidades de servicio.
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/imports?datasetDisplayName={datasetDisplayName}
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/imports?datasetDisplayName={datasetDisplayName}&nameConflict={nameConflict}&skipReport={skipReport}&overrideReportLabel={overrideReportLabel}&overrideModelLabel={overrideModelLabel}&subfolderObjectId={subfolderObjectId}
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
group
|
path | True |
string uuid |
Identificador del área de trabajo |
dataset
|
query | True |
string |
El nombre para mostrar del conjunto de datos debe incluir la extensión de archivo. No se admite al importar desde OneDrive para la Empresa. Para importar o crear flujos de datos, este parámetro debe codificarse de forma rígida para model.json. |
name
|
query |
Especifica qué hacer si ya existe un conjunto de datos con el mismo nombre. El valor predeterminado es |
||
override
|
query |
boolean |
Determina si se invalida la etiqueta existente en un modelo al volver a publicar un archivo .pbix de Power BI. El valor predeterminado del servicio es |
|
override
|
query |
boolean |
Si se invalida la etiqueta existente en un informe al volver a publicar un archivo .pbix de Power BI. El valor predeterminado del servicio es |
|
skip
|
query |
boolean |
Si se va a omitir la importación de informes. Si se especifica, el valor debe ser |
|
subfolder
|
query |
string uuid |
Identificador de subcarpeta para importar el archivo a la subcarpeta. |
Cuerpo de la solicitud
Media Types: "application/json", "multipart/form-data"
Nombre | Tipo | Description |
---|---|---|
connectionType |
Tipo de conexión de importación para un archivo de OneDrive para la Empresa |
|
filePath |
string |
Ruta de acceso del archivo de OneDrive para la Empresa Excel (.xlsx) que se va a importar, que puede ser absoluto o relativo. No se admiten archivos .pbix de Power BI. |
fileUrl |
string |
La dirección URL de la firma de acceso compartido del almacenamiento de blobs temporal que se usa para importar archivos .pbix de Power BI grandes entre 1 GB y 10 GB de tamaño. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar |
|
202 Accepted |
Aceptado |
Ejemplos
Import dataflow model. |
Post import example |
Post import skip report example |
Import dataflow model.json example
Sample Request
POST https://api.powerbi.com/v1.0/myorg/groups/cfafbeb1-8037-4d0c-896e-a46fb27ff229/imports?datasetDisplayName=model.json&nameConflict=Abort&skipReport=True
{
"value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data name=model.json; filename=model.json Content-Type: application/json [Contents of Model JSON Encoded] --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}
Sample Response
{
"id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}
Post import example
Sample Request
POST https://api.powerbi.com/v1.0/myorg/groups/cfafbeb1-8037-4d0c-896e-a46fb27ff229/imports?datasetDisplayName=MyReport&nameConflict=Ignore
{
"value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}
Sample Response
{
"id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}
Post import skip report example
Sample Request
POST https://api.powerbi.com/v1.0/myorg/groups/cfafbeb1-8037-4d0c-896e-a46fb27ff229/imports?datasetDisplayName=MyReport&nameConflict=Ignore&skipReport=True&overrideReportLabel=True&overrideModelLabel=True
{
"value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}
Sample Response
{
"id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}
Definiciones
Nombre | Description |
---|---|
connection |
Tipo de conexión de importación para un archivo OneDrive para la Empresa |
Dataset |
Un conjunto de datos de Power BI. La API devuelve un subconjunto de la siguiente lista de propiedades del conjunto de datos. El subconjunto depende de la API llamada, los permisos del autor de la llamada y la disponibilidad de los datos en la base de datos de Power BI. |
Dataset |
Consulta de la configuración de escalado horizontal de un conjunto de datos |
Dataset |
Una entrada de derecho de acceso de usuario de Power BI para un conjunto de datos |
Dataset |
Derecho de acceso que tiene el usuario para el conjunto de datos (nivel de permiso) |
Dependent |
Un flujo de datos dependiente de Power BI |
Encryption |
Información de cifrado de un conjunto de datos |
Encryption |
Estado del cifrado del conjunto de datos |
Import |
El objeto import |
Import |
Especifica qué hacer si ya existe un conjunto de datos con el mismo nombre. El valor predeterminado es |
Import |
Información sobre la importación |
Principal |
Tipo de entidad de seguridad |
Report |
Un informe de Power BI. La API devuelve un subconjunto de la siguiente lista de propiedades de informe. El subconjunto depende de la API llamada, los permisos del autor de la llamada y la disponibilidad de datos en la base de datos de Power BI. |
Report |
Entrada correcta de acceso de usuario de Power BI para un informe |
Report |
El derecho de acceso que tiene el usuario para el informe (nivel de permiso) |
Service |
Un perfil principal de servicio Power BI. Solo es relevante para Power BI Embedded solución multiinquilino. |
Subscription |
Una suscripción de correo electrónico para un elemento de Power BI (por ejemplo, un informe o un panel) |
Subscription |
Un usuario de suscripción de correo electrónico de Power BI |
connectionType
Tipo de conexión de importación para un archivo OneDrive para la Empresa
Nombre | Tipo | Description |
---|---|---|
connect |
string |
|
import |
string |
Dataset
Un conjunto de datos de Power BI. La API devuelve un subconjunto de la siguiente lista de propiedades del conjunto de datos. El subconjunto depende de la API llamada, los permisos del autor de la llamada y la disponibilidad de los datos en la base de datos de Power BI.
Nombre | Tipo | Description |
---|---|---|
ContentProviderType |
string |
Tipo de proveedor de contenido para el conjunto de datos |
CreateReportEmbedURL |
string |
Dirección URL de inserción del informe de creación del conjunto de datos |
CreatedDate |
string |
Fecha y hora de creación del conjunto de datos |
Encryption |
Información de cifrado del conjunto de datos. Solo se aplica cuando |
|
IsEffectiveIdentityRequired |
boolean |
Si el conjunto de datos requiere una identidad eficaz, que debe enviar en una llamada a la API GenerateToken . |
IsEffectiveIdentityRolesRequired |
boolean |
Si la seguridad de nivel de fila se define dentro del archivo .pbix de Power BI. Si es así, debe especificar un rol. |
IsInPlaceSharingEnabled |
boolean |
Si el conjunto de datos se puede compartir con usuarios externos que se van a consumir en su propio inquilino |
IsOnPremGatewayRequired |
boolean |
Si el conjunto de datos requiere una puerta de enlace de datos local |
IsRefreshable |
boolean |
Si el conjunto de datos es actualizable o no. Un conjunto de datos actualizable de Power BI es un conjunto de datos que se ha actualizado al menos una vez o para el que existe una programación de actualización válida. |
QnaEmbedURL |
string |
Dirección URL de inserción de Q&del conjunto de datos |
addRowsAPIEnabled |
boolean |
Si el conjunto de datos permite agregar nuevas filas |
configuredBy |
string |
Propietario del conjunto de datos |
description |
string |
Descripción del conjunto de datos |
id |
string |
Identificador del conjunto de datos |
name |
string |
Nombre del conjunto de datos |
queryScaleOutSettings |
Consulta de la configuración de escalabilidad horizontal de un conjunto de datos |
|
targetStorageMode |
string |
Modo de almacenamiento del conjunto de datos |
upstreamDataflows |
La lista de todos los flujos de datos de este elemento depende de |
|
users |
(Valor vacío) Detalles de acceso del usuario del conjunto de datos. Esta propiedad se quitará de la respuesta de carga en una próxima versión. Puede recuperar información de usuario en un elemento de Power BI (por ejemplo, un informe o un panel) mediante la API Obtener usuarios del conjunto de datos como Administración API o postWorkspaceInfo API con el |
|
webUrl |
string |
Dirección URL web del conjunto de datos |
DatasetQueryScaleOutSettings
Consulta de la configuración de escalado horizontal de un conjunto de datos
Nombre | Tipo | Description |
---|---|---|
autoSyncReadOnlyReplicas |
boolean |
Si el conjunto de datos sincroniza automáticamente las réplicas de solo lectura |
maxReadOnlyReplicas |
integer |
Número máximo de réplicas de solo lectura para el conjunto de datos (0-64, -1 para el número automático de réplicas) |
DatasetUser
Una entrada de derecho de acceso de usuario de Power BI para un conjunto de datos
Nombre | Tipo | Description |
---|---|---|
datasetUserAccessRight |
Derecho de acceso que tiene el usuario para el conjunto de datos (nivel de permiso) |
|
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 |
Tipo de entidad de seguridad |
|
profile |
Un perfil principal de servicio Power BI. Solo es relevante para Power BI Embedded solución multiinquilino. |
|
userType |
string |
Tipo del usuario. |
DatasetUserAccessRight
Derecho de acceso que tiene el usuario para el conjunto de datos (nivel de permiso)
Nombre | Tipo | Description |
---|---|---|
None |
string |
Quita el permiso para el contenido del conjunto de datos. |
Read |
string |
Concede acceso de lectura al contenido del conjunto de datos. |
ReadExplore |
string |
Concede acceso de lectura y exploración al contenido del conjunto de datos. |
ReadReshare |
string |
Concede acceso de lectura y recompartición al contenido del conjunto de datos |
ReadReshareExplore |
string |
Concede acceso de lectura, volver a compartir y explorar el contenido del conjunto de datos. |
ReadWrite |
string |
Concede acceso de lectura y escritura al contenido del conjunto de datos. |
ReadWriteExplore |
string |
Concede acceso de lectura, escritura y exploración al contenido del conjunto de datos. |
ReadWriteReshare |
string |
Concede acceso de lectura, escritura y recompartición al contenido del conjunto de datos. |
ReadWriteReshareExplore |
string |
Concede acceso de lectura, escritura, recursos compartidos y exploración al contenido del conjunto de datos. |
DependentDataflow
Un flujo de datos dependiente de Power BI
Nombre | Tipo | Description |
---|---|---|
groupId |
string |
Identificador del grupo de destino |
targetDataflowId |
string |
Identificador del flujo de datos de destino |
Encryption
Información de cifrado de un conjunto de datos
Nombre | Tipo | Description |
---|---|---|
EncryptionStatus |
Estado del cifrado del conjunto de datos |
EncryptionStatus
Estado del cifrado del conjunto de datos
Nombre | Tipo | Description |
---|---|---|
InSyncWithWorkspace |
string |
Se admite el cifrado y está sincronizado con la configuración de cifrado. |
NotInSyncWithWorkspace |
string |
Se admite el cifrado, pero no está sincronizado con la configuración de cifrado. |
NotSupported |
string |
No se admite el cifrado para este conjunto de datos. |
Unknown |
string |
El estado de cifrado es desconocido debido a daños en el conjunto de datos. |
Import
El objeto import
Nombre | Tipo | Description |
---|---|---|
createdDateTime |
string |
Importar fecha y hora de creación |
datasets |
Dataset[] |
Conjuntos de datos asociados a esta importación |
id |
string |
Identificador de importación |
importState |
enum:
|
Estado de carga de importación |
name |
string |
Nombre de importación |
reports |
Report[] |
Los informes asociados a esta importación |
updatedDateTime |
string |
Importar la fecha y hora de la última actualización |
ImportConflictHandlerMode
Especifica qué hacer si ya existe un conjunto de datos con el mismo nombre. El valor predeterminado es Ignore
. En el caso de los archivos RDL, Abort
y Overwrite
son las únicas opciones admitidas. En el caso de los archivos de model.json de flujo de datos y Abort
GenerateUniqueName
son las únicas opciones admitidas.
Nombre | Tipo | Description |
---|---|---|
Abort |
string |
Si el conjunto de datos o el flujo de datos con el mismo nombre ya existe, se cancelará la operación de importación. |
CreateOrOverwrite |
string |
Si ya existe un conjunto de datos con el mismo nombre, la operación de importación reemplazará el conjunto de datos existente por el nuevo. Se producirá un error en la operación de importación si hay más de un conjunto de datos existente con el mismo nombre. |
GenerateUniqueName |
string |
Si ya existe un flujo de datos con el mismo nombre, la operación de importación generará un nuevo nombre único para el nuevo flujo de datos. |
Ignore |
string |
Si ya existe un conjunto de datos con el mismo nombre, la operación de importación creará un nuevo conjunto de datos con el mismo nombre. |
Overwrite |
string |
Si ya existe un conjunto de datos con el mismo nombre, la operación de importación reemplazará el conjunto de datos existente por el nuevo. Se producirá un error en la operación de importación si no hay ningún conflicto o si hay más de un conjunto de datos existente con el mismo nombre. |
ImportInfo
Información sobre la importación
Nombre | Tipo | Description |
---|---|---|
connectionType |
Tipo de conexión de importación para un archivo OneDrive para la Empresa |
|
filePath |
string |
Ruta de acceso del archivo de OneDrive para la Empresa Excel (.xlsx) que se va a importar, que puede ser absoluto o relativo. No se admiten archivos .pbix de Power BI. |
fileUrl |
string |
Dirección URL de firma de acceso compartido del almacenamiento de blobs temporal que se usa para importar archivos .pbix de Power BI grandes entre 1 GB y 10 GB de tamaño. |
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 |
Report
Un informe de Power BI. La API devuelve un subconjunto de la siguiente lista de propiedades de informe. El subconjunto depende de la API llamada, los permisos del autor de la llamada y la disponibilidad de datos en la base de datos de Power BI.
Nombre | Tipo | Description |
---|---|---|
appId |
string |
El identificador de la aplicación, que se devuelve solo si el informe pertenece a una aplicación |
datasetId |
string |
El identificador del conjunto de datos del informe |
description |
string |
Descripción del informe |
embedUrl |
string |
Dirección URL de inserción del informe |
id |
string |
Identificador del informe |
isOwnedByMe |
boolean |
Determine si el usuario actual crea el informe. |
name |
string |
Nombre del informe |
originalReportId |
string |
Identificador de informe real cuando el área de trabajo se publica como una aplicación. |
reportType |
enum:
|
Tipo de informe |
subscriptions |
(Valor vacío) Los detalles de la suscripción de un elemento de Power BI (por ejemplo, un informe o un panel). Esta propiedad se quitará de la respuesta de carga en una próxima versión. Puede recuperar información de suscripción para un informe de Power BI mediante la llamada a la API Obtener suscripciones de informes como Administración. |
|
users |
(Valor vacío) Detalles de acceso del usuario para un informe de Power BI. Esta propiedad se quitará de la respuesta de carga en una próxima versión. Puede recuperar información de usuario en un informe de Power BI mediante la llamada a la API Obtener usuarios de informes como Administración o la llamada API de PostWorkspaceInfo con el |
|
webUrl |
string |
Dirección URL web del informe |
ReportUser
Entrada correcta de acceso de usuario de Power BI para un informe
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 |
El tipo de entidad de seguridad |
|
profile |
Un perfil principal de servicio Power BI. Solo es relevante para Power BI Embedded solución multiinquilino. |
|
reportUserAccessRight |
Derecho de acceso que el usuario tiene para el informe (nivel de permiso) |
|
userType |
string |
Tipo del usuario. |
ReportUserAccessRight
El derecho de acceso que tiene el usuario para el informe (nivel de permiso)
Nombre | Tipo | Description |
---|---|---|
None |
string |
Sin permiso para el contenido del informe |
Owner |
string |
Concede acceso de lectura, escritura y recompartición al contenido del informe |
Read |
string |
Concede acceso de lectura al contenido del informe |
ReadCopy |
string |
Concede acceso de lectura y copia al contenido del informe |
ReadReshare |
string |
Concede acceso de lectura y recompartición al contenido del informe |
ReadWrite |
string |
Concede acceso de lectura y escritura al contenido del informe |
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 |
Subscription
Una suscripción de correo electrónico para un elemento de Power BI (por ejemplo, un informe o un panel)
Nombre | Tipo | Description |
---|---|---|
artifactDisplayName |
string |
Nombre del elemento de Power BI suscrito (por ejemplo, un informe o un panel) |
artifactId |
string |
Identificador del elemento de Power BI suscrito (por ejemplo, un informe o un panel) |
artifactType |
string |
Tipo de elemento de Power BI (por ejemplo, |
attachmentFormat |
string |
Formato del informe adjunto en la suscripción de correo electrónico |
endDate |
string |
Fecha y hora de finalización de la suscripción de correo electrónico |
frequency |
string |
Frecuencia de la suscripción de correo electrónico |
id |
string |
Identificador de suscripción |
isEnabled |
boolean |
Si la suscripción de correo electrónico está habilitada |
linkToContent |
boolean |
Si existe un vínculo de suscripción en la suscripción de correo electrónico |
previewImage |
boolean |
Si existe una captura de pantalla del informe en la suscripción de correo electrónico |
startDate |
string |
Fecha y hora de inicio de la suscripción de correo electrónico |
subArtifactDisplayName |
string |
Nombre de página del elemento de Power BI suscrito, si es un informe. |
title |
string |
El nombre de la aplicación |
users |
Los detalles de cada suscriptor de correo electrónico. Cuando se usa la llamada API Obtener suscripciones de usuario como Administración, el valor devuelto es una matriz vacía (null). Esta propiedad se quitará de la respuesta de carga en una próxima versión. Puede recuperar información de suscripción en un informe o panel de Power BI mediante obtener suscripciones de informe como Administración u Obtener suscripciones de panel como llamadas API de Administración. |
SubscriptionUser
Un usuario de suscripción de correo electrónico 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 |
Tipo de entidad de seguridad |
|
profile |
Un perfil principal de servicio Power BI. Solo es relevante para Power BI Embedded solución multiinquilino. |
|
userType |
string |
Tipo del usuario. |