Admin - Datasets GetDatasetsAsAdmin
Devuelve una lista de conjuntos de datos para la organización.
Permisos
- El usuario debe ser un administrador de Fabric o autenticarse mediante una entidad de servicio.
- Se admiten permisos delegados.
Cuando se ejecuta en la autenticación prinicipal del servicio, una aplicación no debe tener las premisiones necesarias de consentimiento del administrador para Power BI establecidas en él en Azure Portal.
Ámbito requerido
Tenant.Read.All o Tenant.ReadWrite.All
Solo es relevante al autenticarse a través de un token de acceso de administrador delegado estándar. No debe estar presente cuando se usa la autenticación a través de una entidad de servicio.
Limitaciones
Máximo de 50 solicitudes por hora o 5 solicitudes por minuto, por inquilino.
GET https://api.powerbi.com/v1.0/myorg/admin/datasets
GET https://api.powerbi.com/v1.0/myorg/admin/datasets?$filter={$filter}&$top={$top}&$skip={$skip}
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
$filter
|
query |
string |
Devuelve un subconjunto de resultados basado en condición de parámetro de consulta de filtro Odata. |
|
$skip
|
query |
integer (int32) |
Omite los primeros n resultados |
|
$top
|
query |
integer (int32) |
Devuelve solo los primeros n resultados. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
De acuerdo |
Ejemplos
Example
Solicitud de ejemplo
GET https://api.powerbi.com/v1.0/myorg/admin/datasets
Respuesta de muestra
{
"value": [
{
"id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"name": "SalesMarketing",
"addRowsAPIEnabled": false,
"configuredBy": "john@contoso.com",
"isRefreshable": true,
"isEffectiveIdentityRequired": false,
"isEffectiveIdentityRolesRequired": false,
"isOnPremGatewayRequired": false,
"isInPlaceSharingEnabled": false,
"workspaceId": "5c968528-70b6-4588-809f-ce811ffa5c23"
}
]
}
Definiciones
Nombre | Description |
---|---|
Admin |
Un conjunto de datos de Power BI devuelto por las API de administración. La API devuelve un subconjunto de la siguiente lista de propiedades del conjunto de datos. El subconjunto depende de la API denominada, los permisos del autor de la llamada y la disponibilidad de los datos en la base de datos de Power BI. |
Admin |
Un contenedor de lista de odata del conjunto de datos |
Dataset |
Consulta de la configuración de escalabilidad horizontal de un conjunto de datos |
Dataset |
Una entrada adecuada de acceso de usuario de Power BI para un conjunto de datos |
Dataset |
Derecho de acceso que el usuario tiene 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 de cifrado del conjunto de datos |
Principal |
El tipo de entidad de seguridad |
Service |
Un perfil de entidad de servicio de Power BI. Solo es relevante para solución multiinquilino de Power BI Embedded. |
AdminDataset
Un conjunto de datos de Power BI devuelto por las API de administración. La API devuelve un subconjunto de la siguiente lista de propiedades del conjunto de datos. El subconjunto depende de la API denominada, 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 |
Propiedad en desuso que se debe omitir. |
Encryption |
Información de cifrado del conjunto de datos. Solo es aplicable cuando se especifica |
|
IsEffectiveIdentityRequired |
boolean |
Si el conjunto de datos requiere una identidad eficaz, que debe enviar en una llamada API de 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 |
Este campo devuelve |
addRowsAPIEnabled |
boolean |
Si el conjunto de datos permite agregar nuevas filas |
configuredBy |
string |
Propietario del conjunto de datos |
createReportEmbedURL |
string |
Dirección URL de inserción del informe de creación del conjunto de datos |
createdDate |
string (date-time) |
Fecha y hora de creación 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 |
qnaEmbedURL |
string |
Dirección URL de inserción del conjunto de datos Q&A |
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 el uso de Obtener usuarios del conjunto de datos como API de administrador o la API de PostWorkspaceInfo con el parámetro |
|
webUrl |
string |
Dirección URL web del conjunto de datos |
workspaceId |
string (uuid) |
Identificador del área de trabajo del conjunto de datos. Esta propiedad solo se devolverá en GetDatasetsAsAdmin. |
AdminDatasets
Un contenedor de lista de odata del conjunto de datos
Nombre | Tipo | Description |
---|---|---|
@odata.context |
string |
Contexto de OData |
value |
Conjuntos de datos |
DatasetQueryScaleOutSettings
Consulta de la configuración de escalabilidad 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 minimum: -1maximum: 64 |
Número máximo de réplicas de solo lectura para el conjunto de datos (de 0 a 64, -1 para el número automático de réplicas) |
DatasetUser
Una entrada adecuada de acceso de usuario de Power BI para un conjunto de datos
Nombre | Tipo | Description |
---|---|---|
datasetUserAccessRight |
Derecho de acceso que el usuario tiene 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 administración. |
identifier |
string |
Identificador de la entidad de seguridad |
principalType |
El tipo de entidad de seguridad |
|
profile |
Un perfil de entidad de servicio de Power BI. Solo es relevante para solución multiinquilino de Power BI Embedded. |
|
userType |
string |
Tipo del usuario. |
DatasetUserAccessRight
Derecho de acceso que el usuario tiene para el conjunto de datos (nivel de permiso)
Valor | Description |
---|---|
None |
Quita el permiso para el contenido del conjunto de datos. |
Read |
Concede acceso de lectura al contenido del conjunto de datos. |
ReadExplore |
Concede acceso de lectura y exploración al contenido del conjunto de datos |
ReadReshare |
Concede acceso de lectura y volver a compartir el contenido del conjunto de datos |
ReadReshareExplore |
Concede acceso de lectura, volver a compartir y explorar el acceso al contenido del conjunto de datos |
ReadWrite |
Concede acceso de lectura y escritura al contenido del conjunto de datos |
ReadWriteExplore |
Concede acceso de lectura, escritura y exploración al contenido del conjunto de datos |
ReadWriteReshare |
Concede acceso de lectura, escritura y volver a compartir el contenido del conjunto de datos |
ReadWriteReshareExplore |
Concede acceso de lectura, escritura, volver a compartir y explorar el acceso 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 de cifrado del conjunto de datos |
EncryptionStatus
Estado de cifrado del conjunto de datos
Valor | Description |
---|---|
InSyncWithWorkspace |
Se admite el cifrado y está sincronizado con la configuración de cifrado. |
NotInSyncWithWorkspace |
Se admite el cifrado, pero no está sincronizado con la configuración de cifrado. |
NotSupported |
El cifrado no se admite para este conjunto de datos |
Unknown |
El estado de cifrado es desconocido debido a daños en el conjunto de datos. |
PrincipalType
El tipo de entidad de seguridad
Valor | Description |
---|---|
App |
Tipo de entidad de servicio |
Group |
Tipo de entidad de seguridad de grupo |
None |
No hay ningún tipo de entidad de seguridad. Se usa para el acceso de nivel de organización completo. |
User |
Tipo de entidad de seguridad de usuario |
ServicePrincipalProfile
Un perfil de entidad de servicio de Power BI. Solo es relevante para solución multiinquilino de Power BI Embedded.
Nombre | Tipo | Description |
---|---|---|
displayName |
string |
El nombre del perfil de entidad de servicio |
id |
string (uuid) |
Identificador del perfil de la entidad de servicio |