Admin - WorkspaceInfo GetScanResult

Service:

Power BI REST APIs

API Version:

v1.0

Obtiene el resultado del examen para el examen especificado.

Realice esta llamada API solo después de una llamada API getScanStatus correcta. El resultado del examen permanecerá disponible durante 24 horas.

Permisos

El usuario debe tener derechos de administrador (como administrador global de Microsoft 365 o administrador del servicio Power BI) o autenticarse mediante una entidad de servicio.

Cuando se ejecuta en la autenticación de la entidad de servicio, una aplicación no debe tener ningún permiso necesario de consentimiento del administrador para Power BI establecido en él en el 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 500 solicitudes por hora.

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/scanResult/{scanId}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
scanId	path	True	string uuid	Identificador de examen, que se incluye en la respuesta de las áreas de trabajo o la llamada API Administración - WorkspaceInfo PostWorkspaceInfo que desencadenó el examen.

Respuestas

Nombre	Tipo	Description
200 OK	WorkspaceInfoResponse	Aceptar

Ejemplos

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/scanResult/e7d03602-4873-4760-b37e-1563ef5358e3

Sample Response

Status code:

200

{
  "workspaces": [
    {
      "id": "d507422c-8d6d-4361-ac7a-30074a8cd0a1",
      "name": "V2 shared",
      "type": "Workspace",
      "state": "Active",
      "isOnDedicatedCapacity": true,
      "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "defaultDatasetStorageFormat": "Small",
      "reports": [
        {
          "id": "c6d072d1-ed20-4b60-8329-16c4b934203b",
          "name": "CompositeModelParams-RLS",
          "datasetId": "132593c4-bf8d-4548-8f25-1ebb16a1613c",
          "createdDateTime": "2020-06-16T08:22:49.14",
          "modifiedDateTime": "2020-06-16T08:22:49.14",
          "modifiedBy": "john@contoso.com",
          "reportType": "PaginatedReport",
          "endorsementDetails": {
            "endorsement": "Certified",
            "certifiedBy": "john@contoso.com"
          },
          "sensitivityLabel": {
            "labelId": "85b38049-4259-43a2-8feb-244e222d96c0"
          },
          "users": [
            {
              "displayName": "John Nick",
              "emailAddress": "john@contoso.com",
              "appUserAccessRight": "ReadExplore",
              "identifier": "john@contoso.com",
              "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
              "principalType": "User"
            }
          ]
        }
      ],
      "dashboards": [
        {
          "id": "80814ece-9302-49e3-b6bc-bad2f7a86c1a",
          "displayName": "CompositeModelParamsDashboard",
          "isReadOnly": false,
          "tiles": [
            {
              "id": "e687cc21-5b32-48f5-8c5e-4b844f190579",
              "title": "CompositeModelParamsDashboard",
              "reportId": "c6d072d1-ed20-4b60-8329-16c4b934203b",
              "datasetId": "132593c4-bf8d-4548-8f25-1ebb16a1613c"
            }
          ],
          "sensitivityLabel": {
            "labelId": "d9b9581a-0594-4c39-81c5-91ddf40baeda"
          },
          "users": [
            {
              "displayName": "John Nick",
              "emailAddress": "john@contoso.com",
              "appUserAccessRight": "ReadExplore",
              "identifier": "john@contoso.com",
              "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
              "principalType": "User"
            }
          ]
        }
      ],
      "datasets": [
        {
          "id": "e7e8a355-e77b-4418-a7b8-ae5972fdaa03",
          "name": "ExportB",
          "tables": [
            {
              "name": "DW_Revenues",
              "columns": [
                {
                  "name": "RowNumber-2662979B-1795-4F74-8F37-6A1BA8059B61",
                  "dataType": "Int64",
                  "isHidden": true
                }
              ],
              "measures": [
                {
                  "name": "MyMeasure",
                  "expression": "CALCULATE(SELECTEDVALUE('DW_Revenues DW_RevenuesTestToBeDeleted'[Numbers])*10)",
                  "description": "My measure",
                  "isHidden": false
                }
              ],
              "isHidden": false,
              "description": "My table",
              "source": [
                {
                  "expression": "let\n    Source = Revenues,\n    Param = RevenuesParam\nin\n    Source"
                }
              ]
            }
          ],
          "relationships": [],
          "configuredBy": "john@contoso.com",
          "targetStorageMode": "Abf",
          "endorsementDetails": {
            "endorsement": "Certified",
            "certifiedBy": "john@contoso.com"
          },
          "expressions": [
            {
              "name": "Revenues",
              "description": "revenues",
              "expression": "let\n    Source = Sql.Database(\"sqlserver.database.windows.net\", \"DB\"),\n    RevenuesTable = Source{[Schema=\"DB_SCHEMA\",Item=\"DB_SCHEMA_ITEM\"]}[Data]\nin\n    RevenuesTable"
            },
            {
              "name": "RevenuesParam",
              "description": "revenues param",
              "expression": "\"revenues param value\" meta [IsParameterQuery=true, Type=\"Text\", IsParameterQueryRequired=true]"
            }
          ],
          "roles": [
            {
              "name": "Teams",
              "modelPermission": "Read",
              "members": [
                {
                  "memberName": "john@contoso.com",
                  "memberId": "ee96296b-fb71-4f65-a8af-c0ec5a7daced",
                  "memberType": "User",
                  "identityProvider": "AzureAD"
                },
                {
                  "memberName": "group@contoso.com",
                  "memberId": "0a1cdbc3-f82c-4001-8b96-be04ae9d25a3",
                  "memberType": "Group",
                  "identityProvider": "AzureAD"
                }
              ],
              "tablePermissions": [
                {
                  "name": "DW_Revenues DW_RevenuesTest",
                  "filterExpression": "[InTeams] = \"True\""
                }
              ]
            }
          ],
          "upstreamDataflows": [
            {
              "targetDataflowId": "a842dbb1-32ca-46b0-9648-498b2c2d5e38",
              "groupId": "b7416115-7421-42c0-b525-1505ce40d2f0"
            },
            {
              "targetDataflowId": "06898194-2eaf-4122-bacc-133db1f8585d",
              "groupId": "7263838d-80d7-4b8d-a1f6-50fc27e74a97"
            }
          ],
          "datasourceUsages": [
            {
              "datasourceInstanceId": "c79ad907-df19-43fe-a0f7-d9f365d67070"
            }
          ],
          "misconfiguredDatasourceUsages": [
            {
              "datasourceInstanceId": "80ec28bc-fe81-43ea-be52-a07a95cfbcab"
            }
          ],
          "sensitivityLabel": {
            "labelId": "bf3dc57d-d796-41c0-bbe9-a47f5ee3331e"
          },
          "users": [
            {
              "displayName": "John Nick",
              "emailAddress": "john@contoso.com",
              "appUserAccessRight": "ReadExplore",
              "identifier": "john@contoso.com",
              "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
              "principalType": "User"
            }
          ]
        }
      ],
      "dataflows": [
        {
          "objectId": "a842dbb1-32ca-46b0-9648-498b2c2d5e38",
          "name": "Azure SQL",
          "description": "Azure SQL dataflow",
          "configuredBy": "john@contoso.com",
          "modifiedBy": "john@contoso.com",
          "modifiedDateTime": "2020-06-16T08:27:47.783Z",
          "endorsementDetails": {
            "endorsement": "Certified",
            "certifiedBy": "john@contoso.com"
          },
          "datasourceUsages": [
            {
              "datasourceInstanceId": "c79ad907-df19-43fe-a0f7-d9f365d67070"
            }
          ],
          "misconfiguredDatasourceUsages": [
            {
              "datasourceInstanceId": "80ec28bc-fe81-43ea-be52-a07a95cfbcab"
            }
          ],
          "sensitivityLabel": {
            "labelId": "5c9f8c24-2a94-4fd2-a105-9a8b096c5af1"
          },
          "users": [
            {
              "displayName": "John Nick",
              "emailAddress": "john@contoso.com",
              "appUserAccessRight": "ReadExplore",
              "identifier": "john@contoso.com",
              "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
              "principalType": "User"
            }
          ]
        }
      ],
      "datamarts": [
        {
          "id": "9df8d63c-db5b-44c3-a8e3-9f8c8ec1eec2",
          "name": "MyDatamart",
          "description": "SQL datamart",
          "type": "Sql",
          "configuredBy": "john@contoso.com",
          "configuredById": "5c9f8c24-2a94-4fd2-a105-9a8b096cdsew",
          "modifiedBy": "john@contoso.com",
          "modifiedDateTime": "2020-06-16T08:27:47.783Z",
          "sensitivityLabel": {
            "labelId": "5c9f8c24-2a94-4fd2-a105-9a8b096c5af1"
          },
          "endorsementDetails": {
            "endorsement": "Certified",
            "certifiedBy": "john@contoso.com"
          },
          "UpstreamDataflows": [
            {
              "targetDataflowId": "5c9f8c24-2a94-34fd-a105-9a8b096c4555",
              "groupId": "5c9f8c24-4dsc-4fd2-a105-9a8b096c4fgt"
            }
          ],
          "datasourceUsages": [
            {
              "datasourceInstanceId": "c79ad907-df19-43fe-a0f7-d9f365d67070"
            }
          ],
          "Users": [
            {
              "displayName": "John Nick",
              "emailAddress": "john@contoso.com",
              "identifier": "john@contoso.com",
              "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
              "principalType": "User",
              "userType": "User",
              "profile": {
                "id": "45416453",
                "displayName": "John's profile"
              },
              "datamartUserAccessRight": "Read"
            }
          ]
        }
      ],
      "users": [
        {
          "displayName": "John Nick",
          "emailAddress": "john@contoso.com",
          "appUserAccessRight": "ReadExplore",
          "identifier": "john@contoso.com",
          "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
          "principalType": "User"
        }
      ]
    }
  ],
  "datasourceInstances": [
    {
      "datasourceType": "Sql",
      "connectionDetails": {
        "server": "qlserver.database.windows.net",
        "database": "dbo.largest_table"
      },
      "datasourceId": "c79ad907-df19-43fe-a0f7-d9f365d67070",
      "gatewayId": "e820592e-f8cf-4a6f-b1ed-566799d29565"
    }
  ],
  "misconfiguredDatasourceInstances": [
    {
      "datasourceType": "Sql",
      "connectionDetails": {
        "server": "sqlserver.database.windows.net",
        "database": "dbo.table"
      },
      "datasourceId": "80ec28bc-fe81-43ea-be52-a07a95cfbcab",
      "gatewayId": "505a19c1-4190-4e8e-a4f6-dd72722feced"
    }
  ]
}

Definiciones

Nombre	Description
ASMashupExpression	Origen de una tabla de conjunto de datos
Column	Una columna de conjunto de datos
DashboardUser	Una entrada correcta de acceso de usuario de Power BI para un panel
DashboardUserAccessRight	El derecho de acceso que tiene el usuario para el panel (nivel de permiso)
DataflowUser	Una entrada correcta de acceso de usuario de Power BI para un flujo de datos
DataflowUserAccessRight	Derecho de acceso que tiene un usuario para el flujo de datos (nivel de permiso)
datamartState	Estado actual de datamart
datamartStatus	Estado de datamart
datamartType	Tipo datamart
DatamartUser	Entrada correcta de acceso de usuario de Power BI para un informe
DatamartUserAccessRight	El derecho de acceso que tiene el usuario para datamart (nivel de permiso)
DatasetUser	Una entrada correcta de acceso de usuario de Power BI para un conjunto de datos
DatasetUserAccessRight	Derecho de acceso que tiene el usuario para el conjunto de datos (nivel de permiso)
Datasource	Un origen de datos de Power BI
DatasourceConnectionDetails	Detalles de conexión del origen de datos de Power BI. Vea ejemplos en Obtener orígenes de datos o Obtener orígenes de datos en grupo.
DatasourceUsage	Uso del origen de datos
DefaultDatasetStorageFormat	El formato de almacenamiento del conjunto de datos predeterminado en el grupo
DependentDataflow	Un flujo de datos dependiente de Power BI
DependentDatamart	Un datamart dependiente de Power BI
DependentDataset	Un conjunto de datos dependiente de Power BI
EndorsementDetails	Detalles de aprobación de Power BI
Expression	Expresión de conjunto de datos
GroupUser	Un usuario de Power BI con acceso al área de trabajo
GroupUserAccessRight	Derecho de acceso (nivel de permiso) que un usuario tiene en el área de trabajo
Measure	Una medida de Power BI
PrincipalType	El tipo de entidad de seguridad
ReportUser	Entrada correcta de acceso de usuario de Power BI para un informe
ReportUserAccessRight	El derecho de acceso que tiene el usuario para el informe (nivel de permiso)
Role	Un rol en la configuración de RLS de un conjunto de datos
RoleMember	Un miembro de rol
RoleTablePermission	Un filtro de roles
Row	Fila de datos de un conjunto de datos
SensitivityLabel	Información de etiqueta de confidencialidad para un elemento de Power BI (por ejemplo, un informe o un panel)
ServicePrincipalProfile	Un perfil principal de servicio Power BI. Solo es relevante para Power BI Embedded solución multiinquilino.
Table	Una tabla de conjunto de datos
WorkspaceInfo	Detalles de la información del área de trabajo
WorkspaceInfoDashboard	Un panel de Power BI devuelto por workspaceInfo API. La API devuelve un subconjunto de la siguiente lista de propiedades del panel. 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.
WorkspaceInfoDataflow	Metadatos de un flujo de datos devuelto por las API de información del área de trabajo. A continuación se muestra una lista de propiedades que se pueden devolver para un flujo de datos. Solo se devolverá un subconjunto de las propiedades en función 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.
WorkspaceInfoDatamart	Datamart de Power BI devuelto por las API de información del área de trabajo. La API devuelve un subconjunto de la siguiente lista de propiedades datamart. 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.
WorkspaceInfoDataset	Un conjunto de datos de Power BI devuelto por workspaceInfo API. 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.
WorkspaceInfoReport	Un informe de Power BI devuelto por las API de información del área de trabajo. La API devuelve un subconjunto de la siguiente lista de propiedades de informe. 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.
WorkspaceInfoResponse	Respuesta de información del área de trabajo
WorkspaceInfoTile	Un icono de Power BI devuelto por workspaceInfo API

ASMashupExpression

Origen de una tabla de conjunto de datos

Nombre	Tipo	Description
expression	string	Expresión de origen

Column

Una columna de conjunto de datos

Nombre	Tipo	Description
dataCategory	string	Opcional. Valor de cadena que se va a usar para la categoría de datos que describe los datos de esta columna.
dataType	string	Tipo de datos de columna
formatString	string	Opcional. Formato de la columna tal y como se especifica en FORMAT_STRING.
isHidden	boolean	Opcional. Indica si la columna está oculta. De manera predeterminada, es false.
name	string	Nombre de columna
sortByColumn	string	Opcional. Nombre de cadena de una columna de la misma tabla que se va a usar para ordenar la columna actual.
summarizeBy	string	Opcional. Función de agregado que se va a usar para resumir esta columna.

DashboardUser

Una entrada correcta de acceso de usuario de Power BI para un panel

Nombre	Tipo	Description
dashboardUserAccessRight	DashboardUserAccessRight	Derecho de acceso que tiene el usuario para el panel (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	PrincipalType	El 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.

DashboardUserAccessRight

El derecho de acceso que tiene el usuario para el panel (nivel de permiso)

Nombre	Tipo	Description
None	string	Sin permiso para el contenido en el panel
Owner	string	Concede acceso de lectura, escritura y recompartición al contenido del informe
Read	string	Concede acceso de lectura al contenido en el panel
ReadCopy	string	Concede acceso de lectura y copia al contenido en el panel
ReadReshare	string	Concede acceso de lectura y recompartición al contenido en el panel
ReadWrite	string	Concede acceso de lectura y escritura al contenido en el panel

DataflowUser

Una entrada correcta de acceso de usuario de Power BI para un flujo de datos

Nombre	Tipo	Description
DataflowUserAccessRight	DataflowUserAccessRight	Derecho de acceso que un usuario tiene para el flujo 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	PrincipalType	El 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.

DataflowUserAccessRight

Derecho de acceso que tiene un usuario para el flujo de datos (nivel de permiso)

Nombre	Tipo	Description
None	string	Quita el permiso para el contenido en el flujo de datos.
Owner	string	Concede acceso de lectura, escritura y recompartición al contenido del flujo de datos.
Read	string	Concede acceso de lectura al contenido en el flujo de datos.
ReadReshare	string	Concede acceso de lectura y recompartición al contenido en el flujo de datos
ReadWrite	string	Concede acceso de lectura y escritura al contenido en el flujo de datos.

datamartState

Estado actual de datamart

Nombre	Tipo	Description
Active	string	Datamart está activo
Deleted	string	Datamart se eliminó
Evicted	string	El datamart fue expulsado
Initialized	string	Datamart se inicializó.
Invalid	string	Datamart tiene un estado no válido
Migrating	string	Datamart está migrando

datamartStatus

Estado de datamart

Nombre	Tipo	Description
Available	string	Datamart está disponible
Error	string	Datamart tiene el estado de error
InProgress	string	Datamart está en curso
Invalid	string	Datamart tiene un estado no válido
NoCapacity	string	Datamart no tiene capacidad
OutOfRegion	string	Datamart está fuera de la región
SuspendedInCriticalPhase	string	Datamart se suspende en fase crítica.

datamartType

Tipo datamart

Nombre	Tipo	Description
Dataverse	string	Datamart es del tipo Dataverse.
Datawarehouse	string	Datamart es de tipo Datawarehouse
Ignore	string	Datamart no tiene ningún tipo
Lakehouse	string	El datamart es de tipo Lakehouse.
Sql	string	Datamart es de tipo Sql.
Unset	string	El tipo datamart no se estableció

DatamartUser

Entrada correcta de acceso de usuario de Power BI para un informe

Nombre	Tipo	Description
datamartUserAccessRight	DatamartUserAccessRight	Derecho de acceso que el usuario tiene para datamart (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	PrincipalType	El 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.

DatamartUserAccessRight

El derecho de acceso que tiene el usuario para datamart (nivel de permiso)

Nombre	Tipo	Description
Explore	string	Concede acceso a exploración del contenido en datamart
None	string	Sin permiso para el contenido en datamart
Read	string	Concede acceso de lectura al contenido en datamart
ReadExplore	string	Concede acceso de lectura y exploración al contenido en datamart
ReadReshare	string	Concede acceso de lectura y recompartición al contenido en datamart
ReadReshareExplore	string	Concede acceso de lectura y recompartición y exploración del contenido en datamart
ReadWrite	string	Concede acceso de lectura y escritura al contenido en datamart
ReadWriteExplore	string	Concede acceso de lectura y escritura y exploración al contenido en datamart
ReadWriteReshare	string	Concede acceso de lectura y escritura y recompartición al contenido de datamart
ReadWriteReshareExplore	string	Concede acceso de lectura y escritura y recompartición y exploración del contenido en datamart
Reshare	string	Concede acceso de recompartición al contenido de datamart
Write	string	Concede acceso de escritura al contenido en datamart

DatasetUser

Una entrada correcta de acceso de usuario de Power BI para un conjunto de datos

Nombre	Tipo	Description
datasetUserAccessRight	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 administrador.
identifier	string	Identificador de la entidad de seguridad
principalType	PrincipalType	El 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.

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.

Datasource

Un origen de datos de Power BI

Nombre	Tipo	Description
connectionDetails	DatasourceConnectionDetails	Detalles de conexión del origen de datos
connectionString	string	(En desuso) El origen de datos cadena de conexión. Solo está disponible para DirectQuery.
datasourceId	string	Identificador de origen de datos enlazado, que está vacío cuando no está enlazado a una puerta de enlace.
datasourceType	string	Tipo de origen de datos
gatewayId	string	Identificador de puerta de enlace enlazado, que está vacío cuando no está enlazado a una puerta de enlace. Cuando se usa un clúster de puerta de enlace, el identificador de puerta de enlace hace referencia a la puerta de enlace principal (primera) del clúster y es similar al identificador del clúster de puerta de enlace.
name	string	(En desuso) Nombre del origen de datos. Solo está disponible para DirectQuery.

DatasourceConnectionDetails

Detalles de conexión del origen de datos de Power BI. Vea ejemplos en Obtener orígenes de datos o Obtener orígenes de datos en grupo.

Nombre	Tipo	Description
account	string	La cuenta de conexión
classInfo	string	Información de la clase de conexión
database	string	La base de datos de conexión
domain	string	El dominio de conexión
emailAddress	string	La dirección de correo electrónico de conexión
kind	string	El tipo de conexión
loginServer	string	El servidor de inicio de sesión de conexión
path	string	Ruta de acceso de conexión
server	string	El servidor de conexión
url	string	Dirección URL de conexión

DatasourceUsage

Uso del origen de datos

Nombre	Tipo	Description
datasourceInstanceId	string	Identificador de instancia del origen de datos

DefaultDatasetStorageFormat

El formato de almacenamiento del conjunto de datos predeterminado en el grupo

Nombre	Tipo	Description
Large	string	Formato de almacenamiento de conjunto de datos de gran tamaño
Small	string	Formato de almacenamiento de conjunto de datos pequeño

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

DependentDatamart

Un datamart dependiente de Power BI

Nombre	Tipo	Description
groupId	string	Identificador del grupo de destino
targetDatamartId	string	Identificador de datamart de destino

DependentDataset

Un conjunto de datos dependiente de Power BI

Nombre	Tipo	Description
groupId	string	Identificador del grupo de destino
targetDatasetId	string	Identificador del conjunto de datos de destino

EndorsementDetails

Detalles de aprobación de Power BI

Nombre	Tipo	Description
certifiedBy	string	Usuario que certificó el elemento de Power BI (por ejemplo, un informe o un panel)
endorsement	string	Estado de aprobación

Expression

Expresión de conjunto de datos

Nombre	Tipo	Description
description	string	Descripción de la expresión
expression	ASMashupExpression	Un origen de tabla de conjunto de datos
name	string	Nombre de la expresión

GroupUser

Un usuario de Power BI con acceso al área de trabajo

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.
groupUserAccessRight	GroupUserAccessRight	Derecho de acceso (nivel de permiso) que un usuario tiene en el área de trabajo
identifier	string	Identificador de la entidad de seguridad
principalType	PrincipalType	El 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.

GroupUserAccessRight

Derecho de acceso (nivel de permiso) que un usuario tiene en el área de trabajo

Nombre	Tipo	Description
Admin	string	Derechos de administrador para el contenido del área de trabajo
Contributor	string	Acceso de lectura y exploración (ReadExplore) al contenido del área de trabajo
Member	string	Derechos de acceso leer, volver a compartir y explorar (ReadReshareExplore) al contenido del área de trabajo
None	string	Sin acceso al contenido del área de trabajo
Viewer	string	Acceso de solo lectura (lectura) al contenido del área de trabajo

Measure

Una medida de Power BI

Nombre	Tipo	Description
description	string	Opcional. Descripción de la medida.
expression	string	Expresión DAX válida
formatString	string	Opcional. Cadena que describe cómo se debe dar formato al valor cuando se muestra como se especifica en FORMAT_STRING.
isHidden	boolean	Opcional. Indica si la medida está oculta.
name	string	El nombre de la medida

PrincipalType

El 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. Se usa para el acceso de nivel de organización completo.
User	string	Tipo de entidad de seguridad de usuario

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	PrincipalType	El tipo de entidad de seguridad
profile	ServicePrincipalProfile	Un perfil principal de servicio Power BI. Solo es relevante para Power BI Embedded solución multiinquilino.
reportUserAccessRight	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

Role

Un rol en la configuración de RLS de un conjunto de datos

Nombre	Tipo	Description
members	RoleMember	Matriz que enumera los miembros del rol
modelPermission	string	Permisos que el rol tiene en el conjunto de datos. Por ejemplo, Read
name	string	El nombre del rol
tablePermissions	RoleTablePermission	Matriz que enumera todos los filtros definidos para el rol

RoleMember

Un miembro de rol

Nombre	Tipo	Description
identityProvider	string	El proveedor de identidades del miembro de rol
memberId	string	GUID del miembro de rol asignado por el proveedor de identidades
memberName	string	Nombre del miembro de rol
memberType	string	Tipo de miembro de rol (usuario o grupo)

RoleTablePermission

Un filtro de roles

Nombre	Tipo	Description
filterExpression	string	Expresión que filtra la tabla especificada en el filtro.
name	string	Nombre de la tabla especificada en el filtro

Row

Fila de datos de un conjunto de datos

Nombre	Tipo	Description
id	string	Identificador de fila único

SensitivityLabel

Información de etiqueta de confidencialidad para un elemento de Power BI (por ejemplo, un informe o un panel)

Nombre	Tipo	Description
labelId	string	Identificador de etiqueta de confidencialidad

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

Table

Una tabla de conjunto de datos

Nombre	Tipo	Description
columns	Column[]	Esquema de columna de esta tabla
description	string	Descripción de la tabla
isHidden	boolean	Opcional. Si esta tabla de conjunto de datos está oculta.
measures	Measure[]	Las medidas de esta tabla
name	string	El nombre de la tabla
rows	Row[]	Filas de datos dentro de esta tabla
source	ASMashupExpression[]	Origen de la tabla

WorkspaceInfo

Detalles de la información del área de trabajo

Nombre	Tipo	Description
capacityId	string	Identificador de capacidad del área de trabajo
dashboards	WorkspaceInfoDashboard[]	Paneles asociados a esta área de trabajo. La lista de propiedades del panel devueltas varía según las distintas llamadas API, por lo que es posible que no vea todas las propiedades del panel en una respuesta de API.
dataRetrievalState	string	Estado de recuperación de datos del área de trabajo
dataflows	WorkspaceInfoDataflow[]	Flujos de datos asociados a esta área de trabajo. La lista de propiedades de flujo de datos devueltas varía según las distintas llamadas API, por lo que es posible que no vea todas las propiedades de flujo de datos en una respuesta de API.
datamarts	WorkspaceInfoDatamart[]	Los datamarts asociados a esta área de trabajo. La lista de propiedades de datamart devueltas varía para las distintas llamadas API, por lo que es posible que no vea todas las propiedades de datamart en una respuesta de API.
datasets	WorkspaceInfoDataset[]	Conjuntos de datos asociados a esta área de trabajo. La lista de propiedades de conjunto de datos devueltas varía para las distintas llamadas API, por lo que es posible que no vea todas las propiedades del conjunto de datos en una respuesta de API.
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	Formato de almacenamiento del conjunto de datos predeterminado en el área de trabajo. Solo se devuelve cuando isOnDedicatedCapacity es true
description	string	Descripción del área de trabajo
id	string	Identificador del objeto del área de trabajo
isOnDedicatedCapacity	boolean	Si el área de trabajo está asignada a una capacidad dedicada
name	string	El nombre del área de trabajo
reports	WorkspaceInfoReport[]	Los informes asociados a esta área de trabajo. La lista de propiedades de informe devueltas varía según las distintas llamadas API, por lo que es posible que no vea todas las propiedades del informe en una respuesta de API.
state	string	El estado del área de trabajo
type	string	Tipo de área de trabajo
users	GroupUser[]	Los usuarios con acceso al área de trabajo. La lista solo se devuelve cuando se solicita explícitamente. Para recuperar una lista de usuarios de un área de trabajo clásica, use la Graph API de Azure Active Directory.

WorkspaceInfoDashboard

Un panel de Power BI devuelto por workspaceInfo API. La API devuelve un subconjunto de la siguiente lista de propiedades del panel. 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
appId	string	El identificador de aplicación, devuelto solo si el panel pertenece a una aplicación
dataClassification	string	Etiqueta de clasificación de datos de un elemento de Power BI (por ejemplo, un informe o un panel)
displayName	string	Nombre para mostrar del panel
id	string	El identificador del panel
isReadOnly	boolean	Si el panel es de solo lectura
sensitivityLabel	SensitivityLabel	Etiqueta de confidencialidad
tiles	WorkspaceInfoTile[]	Iconos que pertenecen al panel
users	DashboardUser[]	(Valor vacío) Detalles de acceso del usuario del panel. Esta propiedad se quitará de la respuesta de carga en una próxima versión. Puede recuperar información de usuario en un panel de Power BI mediante la llamada a la API Obtener usuarios del panel como Administración o la llamada API PostWorkspaceInfo con el getArtifactUsers parámetro .

WorkspaceInfoDataflow

Metadatos de un flujo de datos devuelto por las API de información del área de trabajo. A continuación se muestra una lista de propiedades que se pueden devolver para un flujo de datos. Solo se devolverá un subconjunto de las propiedades en función 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
configuredBy	string	Propietario del flujo de datos
datasourceUsages	DatasourceUsage[]	Usos del origen de datos
description	string	Descripción del flujo de datos
endorsementDetails	EndorsementDetails	Detalles de aprobación
misconfiguredDatasourceUsages	DatasourceUsage[]	Usos mal configurados del origen de datos
modelUrl	string	Dirección URL del archivo de definición de flujo de datos (model.json)
modifiedBy	string	El usuario que modificó el flujo de datos
modifiedDateTime	string	Fecha y hora en que se modificó por última vez el flujo de datos
name	string	Nombre del flujo de datos
objectId	string	Identificador del flujo de datos
sensitivityLabel	SensitivityLabel	Etiqueta de confidencialidad
upstreamDataflows	DependentDataflow[]	La lista de todos los flujos de datos de este elemento depende de
upstreamDatamarts	DependentDatamart[]	La lista de todos los datamarts de este elemento depende de
users	DataflowUser[]	(Valor vacío) Detalles de acceso del usuario del flujo 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 flujo de datos de Power BI mediante la llamada a la API Obtener usuarios de flujo de datos como Administración llamada API o la llamada a la API PostWorkspaceInfo con el getArtifactUser parámetro .

WorkspaceInfoDatamart

Datamart de Power BI devuelto por las API de información del área de trabajo. La API devuelve un subconjunto de la siguiente lista de propiedades datamart. 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
configuredBy	string	Nombre del propietario de datamart
configuredById	string	El identificador del propietario de datamart
datasourceUsages	DatasourceUsage[]	Usos del origen de datos
description	string	Descripción de datamart
endorsementDetails	EndorsementDetails	Detalles de aprobación de datamart
id	string	Identificador de datamart
modifiedBy	string	Último usuario que modificó datamart
modifiedById	string	Identificador del último usuario que modificó datamart.
modifiedDateTime	string	Fecha y hora en que se modificó por última vez el datamart
name	string	Nombre de datamart
sensitivityLabel	SensitivityLabel	Etiqueta de confidencialidad de datamart
state	datamartState	Estado actual de datamart
status	datamartStatus	Estado de datamart
suspendedBatchId	string	datamart suspended batch id
type	datamartType	Tipo datamart
upstreamDataflows	DependentDataflow[]	La lista de todos los flujos de datos de este elemento depende de
upstreamDatamarts	DependentDatamart[]	La lista de todos los datamarts de este elemento depende de
users	DatamartUser[]	Detalles de acceso del usuario para un datamart de Power BI.

WorkspaceInfoDataset

Un conjunto de datos de Power BI devuelto por workspaceInfo API. 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	Tipo de proveedor de contenido para el conjunto de datos
CreatedDate	string	Fecha y hora de creación del conjunto de datos
configuredBy	string	Propietario del conjunto de datos
datasourceUsages	DatasourceUsage[]	Usos del origen de datos
description	string	Descripción del conjunto de datos
endorsementDetails	EndorsementDetails	Detalles de aprobación
expressions	Expression[]	Expresiones de conjunto de datos
id	string	El identificador del conjunto de datos
misconfiguredDatasourceUsages	DatasourceUsage[]	Usos mal configurados del origen de datos
name	string	Nombre del conjunto de datos
roles	Role[]	Roles de conjunto de datos
schemaMayNotBeUpToDate	boolean	Si es posible que el esquema del conjunto de datos no esté actualizado
schemaRetrievalError	string	Error de recuperación del esquema del conjunto de datos
sensitivityLabel	SensitivityLabel	Etiqueta de confidencialidad
tables	Table[]	Tablas del conjunto de datos
targetStorageMode	string	Modo de almacenamiento del conjunto de datos
upstreamDataflows	DependentDataflow[]	La lista de todos los flujos de datos de los que depende este elemento
upstreamDatamarts	DependentDatamart[]	La lista de todos los datamarts de este elemento depende de
upstreamDatasets	DependentDataset[]	Conjuntos de datos ascendentes
users	DatasetUser[]	(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 getArtifactUsers parámetro .

WorkspaceInfoReport

Un informe de Power BI devuelto por las API de información del área de trabajo. La API devuelve un subconjunto de la siguiente lista de propiedades de informe. 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
appId	string	El identificador de la aplicación, devuelto solo si el informe pertenece a una aplicación
createdBy	string	Propietario del informe. Solo está disponible para los informes creados después de junio de 2019.
createdById	string	Identificador del propietario del informe. Solo está disponible para los informes creados después de junio de 2019.
createdDateTime	string	Fecha y hora de creación del informe
datasetId	string	El identificador del conjunto de datos del informe
datasetWorkspaceId	string	Identificador del área de trabajo del conjunto de datos relacionado, que solo se devuelve si el conjunto de datos relacionado pertenece a un área de trabajo diferente.
description	string	Descripción del informe
endorsementDetails	EndorsementDetails	Detalles de aprobación
id	string	El identificador del informe
modifiedBy	string	El último usuario que modificó el informe
modifiedById	string	Identificador del último usuario que modificó el informe.
modifiedDateTime	string	Fecha y hora en que se modificó por última vez 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: PaginatedReport PowerBIReport	Tipo de informe
sensitivityLabel	SensitivityLabel	Etiqueta de confidencialidad
users	ReportUser[]	(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 API Obtener usuarios de informes como Administración o la llamada API PostWorkspaceInfo con el getArtifactUsers parámetro .

WorkspaceInfoResponse

Respuesta de información del área de trabajo

Nombre	Tipo	Description
datasourceInstances	Datasource[]	Las instancias de origen de datos asociadas a este examen
misconfiguredDatasourceInstances	Datasource[]	Las instancias mal configuradas del origen de datos asociadas a este examen
workspaces	WorkspaceInfo[]	La información del área de trabajo asociada a este examen

WorkspaceInfoTile

Un icono de Power BI devuelto por workspaceInfo API

Nombre	Tipo	Description
datasetId	string	Id. del conjunto de datos. Solo está disponible para los iconos creados a partir de un informe o mediante un conjunto de datos, como los iconos de Q&A.
datasetWorkspaceId	string	Identificador del área de trabajo del conjunto de datos relacionado, que solo se devuelve si el conjunto de datos relacionado pertenece a un área de trabajo diferente.
id	string	Identificador del icono
reportId	string	Identificador del informe. Solo está disponible para los iconos creados a partir de un informe.
title	string	Nombre para mostrar del icono