Partager via


Admin - WorkspaceInfo GetScanResult

Obtient le résultat de l’analyse spécifiée.

Effectuez cet appel d’API uniquement après un appel d’API GetScanStatus réussi. Le résultat de l’analyse reste disponible pendant 24 heures.

Autorisations

L’utilisateur doit être un administrateur Fabric ou s’authentifier à l’aide d’un principal de service.

Lors de l’exécution sous l’authentification du principal de service, une application ne doit pas disposer d’autorisations requises par l’administrateur pour Power BI définie sur celui-ci dans le portail Azure.

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

Applicable uniquement lors de l’authentification via un jeton d’accès administrateur délégué standard. Ne doit pas être présent lorsque l’authentification via un principal de service est utilisée.

Limitations

Maximum de 500 requêtes par heure.

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

Paramètres URI

Nom Dans Obligatoire Type Description
scanId
path True

string

uuid

ID d’analyse, inclus dans la réponse des espaces de travail ou de l'Admin - WorkspaceInfo PostWorkspaceInfo appel d’API qui a déclenché l’analyse.

Réponses

Nom Type Description
200 OK

WorkspaceInfoResponse

D’ACCORD

Exemples

Example

Exemple de requête

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

Exemple de réponse

{
  "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"
    }
  ]
}

Définitions

Nom Description
ASMashupExpression

Source d’une table de jeux de données

Column

Colonne de jeu de données

DashboardUser

Entrée de droit d’accès utilisateur Power BI pour un tableau de bord

DashboardUserAccessRight

Droit d’accès dont dispose l’utilisateur pour le tableau de bord (niveau d’autorisation)

DataflowUser

Entrée de droit d’accès utilisateur Power BI pour un dataflow

DataflowUserAccessRight

Droit d’accès dont dispose un utilisateur pour le dataflow (niveau d’autorisation)

datamartState

État actuel du datamart

datamartStatus

État du datamart

datamartType

Type datamart

DatamartUser

Entrée de droit d’accès utilisateur Power BI pour un rapport

DatamartUserAccessRight

Droit d’accès dont dispose l’utilisateur pour le datamart (niveau d’autorisation)

DatasetUser

Entrée de droit d’accès utilisateur Power BI pour un jeu de données

DatasetUserAccessRight

Droit d’accès que l’utilisateur a pour le jeu de données (niveau d’autorisation)

Datasource

Source de données Power BI

DatasourceConnectionDetails

Détails de la connexion à la source de données Power BI. Consultez des exemples dans Obtenir des sources de données ou Obtenir des sources de données dans lede groupe.

DatasourceUsage

Utilisation de la source de données

DefaultDatasetStorageFormat

Format de stockage du jeu de données par défaut dans le groupe

DependentDataflow

Flux de données dépendant de Power BI

DependentDatamart

Un datamart dépendant de Power BI

DependentDataset

Jeu de données dépendant de Power BI

EndorsementDetails

Détails de l’approbation Power BI

Expression

Expression de jeu de données

GroupUser

Un utilisateur Power BI ayant accès à l’espace de travail

GroupUserAccessRight

Droit d’accès (niveau d’autorisation) qu’un utilisateur a sur l’espace de travail

Measure

Une mesure Power BI

PrincipalType

Type de principal

ReportUser

Entrée de droit d’accès utilisateur Power BI pour un rapport

ReportUserAccessRight

Droit d’accès dont l’utilisateur dispose pour le rapport (niveau d’autorisation)

Role

Rôle dans la configuration RLS d’un jeu de données

RoleMember

Membre de rôle

RoleTablePermission

Filtre de rôle

Row

Une ligne de données dans un jeu de données

SensitivityLabel

Informations d’étiquette de confidentialité pour un élément Power BI (par exemple, un rapport ou un tableau de bord)

ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

Table

Table de jeux de données

WorkspaceInfo

Détails des informations sur l’espace de travail

WorkspaceInfoDashboard

Tableau de bord Power BI retourné par les API WorkspaceInfo. L’API retourne un sous-ensemble de la liste suivante des propriétés du tableau de bord. Le sous-ensemble dépend de l’API appelée, des autorisations d’appelant et de la disponibilité des données dans la base de données Power BI.

WorkspaceInfoDataflow

Métadonnées d’un flux de données retourné par les API d’informations de l’espace de travail. Vous trouverez ci-dessous une liste de propriétés qui peuvent être retournées pour un dataflow. Seul un sous-ensemble des propriétés est retourné en fonction de l’API appelée, des autorisations de l’appelant et de la disponibilité des données dans la base de données Power BI.

WorkspaceInfoDatamart

Un datamart Power BI retourné par les API d’informations de l’espace de travail. L’API retourne un sous-ensemble de la liste suivante de propriétés datamart. Le sous-ensemble dépend de l’API appelée, des autorisations d’appelant et de la disponibilité des données dans la base de données Power BI.

WorkspaceInfoDataset

Jeu de données Power BI retourné par les API WorkspaceInfo. L’API retourne un sous-ensemble de la liste suivante des propriétés du jeu de données. Le sous-ensemble dépend de l’API appelée, des autorisations d’appelant et de la disponibilité des données dans la base de données Power BI.

WorkspaceInfoReport

Rapport Power BI retourné par les API d’informations sur l’espace de travail. L’API retourne un sous-ensemble de la liste suivante de propriétés de rapport. Le sous-ensemble dépend de l’API appelée, des autorisations d’appelant et de la disponibilité des données dans la base de données Power BI.

WorkspaceInfoResponse

Réponse aux informations de l’espace de travail

WorkspaceInfoTile

Vignette Power BI retournée par les API WorkspaceInfo

ASMashupExpression

Source d’une table de jeux de données

Nom Type Description
expression

string

Expression source

Column

Colonne de jeu de données

Nom Type Description
dataCategory

string

Optionnel. Valeur de chaîne à utiliser pour la catégorie de données qui décrit les données de cette colonne.

dataType

string

Type de données de colonne

formatString

string

Optionnel. Format de la colonne comme spécifié dans FORMAT_STRING.

isHidden

boolean

Optionnel. Indique si la colonne est masquée. La valeur par défaut est false.

name

string

Nom de la colonne

sortByColumn

string

Optionnel. Nom de chaîne d’une colonne dans la même table à utiliser pour classer la colonne active.

summarizeBy

string

Optionnel. Fonction d’agrégation à utiliser pour résumer cette colonne.

DashboardUser

Entrée de droit d’accès utilisateur Power BI pour un tableau de bord

Nom Type Description
dashboardUserAccessRight

DashboardUserAccessRight

Droit d’accès dont dispose l’utilisateur pour le tableau de bord (niveau d’autorisation)

displayName

string

Nom complet du principal

emailAddress

string

Adresse e-mail de l’utilisateur

graphId

string

Identificateur du principal dans Microsoft Graph. Disponible uniquement pour les API d’administration.

identifier

string

Identificateur du principal

principalType

PrincipalType

Type de principal

profile

ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

userType

string

Type de l’utilisateur.

DashboardUserAccessRight

Droit d’accès dont dispose l’utilisateur pour le tableau de bord (niveau d’autorisation)

Nom Type Description
None

string

Aucune autorisation pour le contenu dans le tableau de bord

Owner

string

Accorde l’accès en lecture, écriture et partage à nouveau au contenu dans le rapport

Read

string

Octroie l’accès en lecture au contenu dans le tableau de bord

ReadCopy

string

Octroie l’accès en lecture et copie au contenu dans le tableau de bord

ReadReshare

string

Accorde l’accès en lecture et repartage au contenu dans le tableau de bord

ReadWrite

string

Octroie l’accès en lecture et écriture au contenu dans le tableau de bord

DataflowUser

Entrée de droit d’accès utilisateur Power BI pour un dataflow

Nom Type Description
DataflowUserAccessRight

DataflowUserAccessRight

Droit d’accès dont dispose un utilisateur pour le dataflow (niveau d’autorisation)

displayName

string

Nom complet du principal

emailAddress

string

Adresse e-mail de l’utilisateur

graphId

string

Identificateur du principal dans Microsoft Graph. Disponible uniquement pour les API d’administration.

identifier

string

Identificateur du principal

principalType

PrincipalType

Type de principal

profile

ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

userType

string

Type de l’utilisateur.

DataflowUserAccessRight

Droit d’accès dont dispose un utilisateur pour le dataflow (niveau d’autorisation)

Nom Type Description
None

string

Supprime l’autorisation de contenu dans le flux de données

Owner

string

Accorde l’accès en lecture, écriture et partage à nouveau au contenu dans le flux de données

Read

string

Octroie l’accès en lecture au contenu dans le flux de données

ReadReshare

string

Accorde l’accès en lecture et repartage au contenu dans le flux de données

ReadWrite

string

Octroie l’accès en lecture et écriture au contenu dans le flux de données

datamartState

État actuel du datamart

Nom Type Description
Active

string

Le datamart est actif

Deleted

string

Le datamart a été supprimé

Evicted

string

Le datamart a été supprimé

Initialized

string

Le datamart a été initialisé

Invalid

string

Le datamart a un état non valide

Migrating

string

Datamart migre

datamartStatus

État du datamart

Nom Type Description
Available

string

Le datamart est disponible

Error

string

Le datamart a l’état d’erreur

InProgress

string

Le datamart est en cours

Invalid

string

Le datamart a un état non valide

NoCapacity

string

Le datamart n’a pas de capacité

OutOfRegion

string

Le datamart est hors région

SuspendedInCriticalPhase

string

Le datamart est suspendu en phase critique

datamartType

Type datamart

Nom Type Description
Dataverse

string

Le datamart est de type Dataverse

Datawarehouse

string

Datamart est de type Datawarehouse

Ignore

string

Le datamart n’a aucun type

Lakehouse

string

Le datamart est de type Lakehouse

Sql

string

Le datamart est de type Sql

Unset

string

Le type datamart n’a pas été défini

DatamartUser

Entrée de droit d’accès utilisateur Power BI pour un rapport

Nom Type Description
datamartUserAccessRight

DatamartUserAccessRight

Droit d’accès dont dispose l’utilisateur pour le datamart (niveau d’autorisation)

displayName

string

Nom complet du principal

emailAddress

string

Adresse e-mail de l’utilisateur

graphId

string

Identificateur du principal dans Microsoft Graph. Disponible uniquement pour les API d’administration.

identifier

string

Identificateur du principal

principalType

PrincipalType

Type de principal

profile

ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

userType

string

Type de l’utilisateur.

DatamartUserAccessRight

Droit d’accès dont dispose l’utilisateur pour le datamart (niveau d’autorisation)

Nom Type Description
Explore

string

Octroie l’exploration de l’accès au contenu dans datamart

None

string

Aucune autorisation pour le contenu dans datamart

Read

string

Octroie l’accès en lecture au contenu dans datamart

ReadExplore

string

Accorde la lecture et l’exploration de l’accès au contenu dans datamart

ReadReshare

string

Accorde l’accès en lecture et repartage au contenu dans datamart

ReadReshareExplore

string

Accorde la lecture et le partage et explore l’accès au contenu dans datamart

ReadWrite

string

Octroie un accès en lecture et en écriture au contenu dans datamart

ReadWriteExplore

string

Accorde la lecture et l’écriture et explore l’accès au contenu dans datamart

ReadWriteReshare

string

Accorde l’accès en lecture-écriture et en écriture au contenu dans datamart

ReadWriteReshareExplore

string

Accorde la lecture et l’écriture et le partage et explore l’accès au contenu dans datamart

Reshare

string

Octroie un accès partagé au contenu dans datamart

Write

string

Octroie l’accès en écriture au contenu dans datamart

DatasetUser

Entrée de droit d’accès utilisateur Power BI pour un jeu de données

Nom Type Description
datasetUserAccessRight

DatasetUserAccessRight

Droit d’accès que l’utilisateur a pour le jeu de données (niveau d’autorisation)

displayName

string

Nom complet du principal

emailAddress

string

Adresse e-mail de l’utilisateur

graphId

string

Identificateur du principal dans Microsoft Graph. Disponible uniquement pour les API d’administration.

identifier

string

Identificateur du principal

principalType

PrincipalType

Type de principal

profile

ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

userType

string

Type de l’utilisateur.

DatasetUserAccessRight

Droit d’accès que l’utilisateur a pour le jeu de données (niveau d’autorisation)

Nom Type Description
None

string

Supprime l’autorisation du contenu dans le jeu de données

Read

string

Octroie l’accès en lecture au contenu dans le jeu de données

ReadExplore

string

Octroie l’accès en lecture et explorer au contenu du jeu de données

ReadReshare

string

Accorde l’accès en lecture et repartage au contenu du jeu de données

ReadReshareExplore

string

Accorde l’accès en lecture, repartage et exploration du contenu dans le jeu de données

ReadWrite

string

Octroie l’accès en lecture et écriture au contenu du jeu de données

ReadWriteExplore

string

Accorde l’accès en lecture, écriture et exploration au contenu du jeu de données

ReadWriteReshare

string

Accorde l’accès en lecture, écriture et partage à nouveau au contenu du jeu de données

ReadWriteReshareExplore

string

Accorde l’accès en lecture, écriture, partage et exploration du contenu dans le jeu de données

Datasource

Source de données Power BI

Nom Type Description
connectionDetails

DatasourceConnectionDetails

Détails de la connexion à la source de données

connectionString

string

(Déconseillé) Chaîne de connexion à la source de données. Disponible uniquement pour DirectQuery.

datasourceId

string

ID de source de données lié, qui est vide lorsqu’il n’est pas lié à une passerelle

datasourceType

string

Type de source de données

gatewayId

string

ID de passerelle lié, qui est vide lorsqu’il n’est pas lié à une passerelle. Lorsque vous utilisez un cluster de passerelle, l’ID de passerelle fait référence à la passerelle principale (première) du cluster et est similaire à l’ID de cluster de passerelle.

name

string

(Déconseillé) Nom de la source de données. Disponible uniquement pour DirectQuery.

DatasourceConnectionDetails

Détails de la connexion à la source de données Power BI. Consultez des exemples dans Obtenir des sources de données ou Obtenir des sources de données dans lede groupe.

Nom Type Description
account

string

Compte de connexion

classInfo

string

Informations sur la classe de connexion

database

string

Base de données de connexion

domain

string

Domaine de connexion

emailAddress

string

Adresse e-mail de connexion

kind

string

Type de connexion

loginServer

string

Le serveur de connexion de connexion

path

string

Chemin d’accès de connexion

server

string

Le serveur de connexion

url

string

URL de connexion

DatasourceUsage

Utilisation de la source de données

Nom Type Description
datasourceInstanceId

string

ID d’instance de source de données

DefaultDatasetStorageFormat

Format de stockage du jeu de données par défaut dans le groupe

Nom Type Description
Large

string

Format de stockage de jeux de données volumineux

Small

string

Format de stockage de petits jeux de données

DependentDataflow

Flux de données dépendant de Power BI

Nom Type Description
groupId

string

ID de groupe cible

targetDataflowId

string

ID de flux de données cible

DependentDatamart

Un datamart dépendant de Power BI

Nom Type Description
groupId

string

ID de groupe cible

targetDatamartId

string

ID de datamart cible

DependentDataset

Jeu de données dépendant de Power BI

Nom Type Description
groupId

string

ID de groupe cible

targetDatasetId

string

ID du jeu de données cible

EndorsementDetails

Détails de l’approbation Power BI

Nom Type Description
certifiedBy

string

Utilisateur qui a certifié l’élément Power BI (tel qu’un rapport ou un tableau de bord)

endorsement

string

État de l’approbation

Expression

Expression de jeu de données

Nom Type Description
description

string

Description de l’expression

expression

string

Valeur de l’expression

name

string

Nom de l’expression

GroupUser

Un utilisateur Power BI ayant accès à l’espace de travail

Nom Type Description
displayName

string

Nom complet du principal

emailAddress

string

Adresse e-mail de l’utilisateur

graphId

string

Identificateur du principal dans Microsoft Graph. Disponible uniquement pour les API d’administration.

groupUserAccessRight

GroupUserAccessRight

Droit d’accès (niveau d’autorisation) qu’un utilisateur a sur l’espace de travail

identifier

string

Identificateur du principal

principalType

PrincipalType

Type de principal

profile

ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

userType

string

Type de l’utilisateur.

GroupUserAccessRight

Droit d’accès (niveau d’autorisation) qu’un utilisateur a sur l’espace de travail

Nom Type Description
Admin

string

Droits d’administrateur sur le contenu de l’espace de travail

Contributor

string

Accès en lecture et exploration (ReadExplore) au contenu de l’espace de travail

Member

string

Lire, repartager et explorer (ReadReshareExplore) des droits d’accès au contenu de l’espace de travail

None

string

Aucun accès au contenu de l’espace de travail

Viewer

string

Accès en lecture seule (lecture) au contenu de l’espace de travail

Measure

Une mesure Power BI

Nom Type Description
description

string

Optionnel. Description de la mesure.

expression

string

Expression DAX valide

formatString

string

Optionnel. Chaîne décrivant la façon dont la valeur doit être mise en forme lorsqu’elle est affichée comme spécifié dans FORMAT_STRING.

isHidden

boolean

Optionnel. Indique si la mesure est masquée.

name

string

Nom de la mesure

PrincipalType

Type de principal

Nom Type Description
App

string

Type de principal de service

Group

string

Type de principal de groupe

None

string

Aucun type de principal. Utiliser pour l’ensemble de l’accès au niveau de l’organisation.

User

string

Type de principal de l’utilisateur

ReportUser

Entrée de droit d’accès utilisateur Power BI pour un rapport

Nom Type Description
displayName

string

Nom complet du principal

emailAddress

string

Adresse e-mail de l’utilisateur

graphId

string

Identificateur du principal dans Microsoft Graph. Disponible uniquement pour les API d’administration.

identifier

string

Identificateur du principal

principalType

PrincipalType

Type de principal

profile

ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

reportUserAccessRight

ReportUserAccessRight

Droit d’accès dont l’utilisateur dispose pour le rapport (niveau d’autorisation)

userType

string

Type de l’utilisateur.

ReportUserAccessRight

Droit d’accès dont l’utilisateur dispose pour le rapport (niveau d’autorisation)

Nom Type Description
None

string

Aucune autorisation pour le contenu dans le rapport

Owner

string

Accorde l’accès en lecture, écriture et partage à nouveau au contenu dans le rapport

Read

string

Octroie l’accès en lecture au contenu dans le rapport

ReadCopy

string

Octroie l’accès en lecture et copie au contenu dans le rapport

ReadReshare

string

Accorde l’accès en lecture et repartage au contenu dans le rapport

ReadWrite

string

Octroie l’accès en lecture et écriture au contenu dans le rapport

Role

Rôle dans la configuration RLS d’un jeu de données

Nom Type Description
members

RoleMember

Tableau répertoriant les membres du rôle

modelPermission

string

Autorisations dont dispose le rôle sur le jeu de données. Par exemple, Lecture

name

string

Nom du rôle

tablePermissions

RoleTablePermission

Tableau qui répertorie tous les filtres définis pour le rôle

RoleMember

Membre de rôle

Nom Type Description
identityProvider

string

Fournisseur d’identité de membre de rôle

memberId

string

GUID du membre de rôle attribué par le fournisseur d’identité

memberName

string

Nom du membre de rôle

memberType

string

Type de membre de rôle (utilisateur ou groupe)

RoleTablePermission

Filtre de rôle

Nom Type Description
filterExpression

string

Expression qui filtre la table spécifiée dans le filtre

name

string

Nom de la table spécifiée dans le filtre

Row

Une ligne de données dans un jeu de données

Nom Type Description
id

string

ID de ligne unique

SensitivityLabel

Informations d’étiquette de confidentialité pour un élément Power BI (par exemple, un rapport ou un tableau de bord)

Nom Type Description
labelId

string

ID d’étiquette de confidentialité

ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour solution multilocataire Power BI Embedded.

Nom Type Description
displayName

string

Nom du profil du principal de service

id

string

ID de profil du principal de service

Table

Table de jeux de données

Nom Type Description
columns

Column[]

Schéma de colonne pour cette table

description

string

Description du tableau

isHidden

boolean

Optionnel. Indique si cette table de jeu de données est masquée.

measures

Measure[]

Mesures contenues dans ce tableau

name

string

Nom de la table

rows

Row[]

Lignes de données de cette table

source

ASMashupExpression[]

Source de la table

WorkspaceInfo

Détails des informations sur l’espace de travail

Nom Type Description
capacityId

string

ID de capacité de l’espace de travail

dashboards

WorkspaceInfoDashboard[]

Tableaux de bord associés à cet espace de travail. La liste des propriétés de tableau de bord retournées varie selon les appels d’API, de sorte que vous ne voyez peut-être pas toutes les propriétés du tableau de bord dans une réponse d’API.

dataRetrievalState

string

État de récupération des données de l’espace de travail

dataflows

WorkspaceInfoDataflow[]

Flux de données associés à cet espace de travail. La liste des propriétés de flux de données retournées varie selon les appels d’API différents. Vous pouvez donc ne pas voir toutes les propriétés de flux de données dans une réponse d’API.

datamarts

WorkspaceInfoDatamart[]

Les datamarts associés à cet espace de travail. La liste des propriétés datamart retournées varie selon les appels d’API différents. Vous risquez donc de ne pas voir toutes les propriétés datamart dans une réponse d’API.

datasets

WorkspaceInfoDataset[]

Jeux de données associés à cet espace de travail. La liste des propriétés de jeu de données retournées varie selon les appels d’API différents. Vous pouvez donc ne pas voir toutes les propriétés du jeu de données dans une réponse d’API.

defaultDatasetStorageFormat

DefaultDatasetStorageFormat

Format de stockage de jeu de données par défaut dans l’espace de travail. Retourné uniquement lorsque isOnDedicatedCapacity est true

description

string

Description de l’espace de travail

id

string

ID d’objet de l’espace de travail

isOnDedicatedCapacity

boolean

Indique si l’espace de travail est affecté à une capacité dédiée

name

string

Nom de l’espace de travail

reports

WorkspaceInfoReport[]

Rapports associés à cet espace de travail. La liste des propriétés de rapport retournées varie selon les appels d’API différents. Vous pouvez donc ne pas voir toutes les propriétés de rapport dans une réponse d’API.

state

string

État de l’espace de travail

type

string

Type d’espace de travail

users

GroupUser[]

Utilisateurs ayant accès à l’espace de travail. La liste est retournée uniquement lorsqu’elle est explicitement demandée. Pour récupérer une liste d’utilisateurs pour un espace de travail classique, utilisez l’API Graph Azure Active Directory.

WorkspaceInfoDashboard

Tableau de bord Power BI retourné par les API WorkspaceInfo. L’API retourne un sous-ensemble de la liste suivante des propriétés du tableau de bord. Le sous-ensemble dépend de l’API appelée, des autorisations d’appelant et de la disponibilité des données dans la base de données Power BI.

Nom Type Description
appId

string

ID d’application, retourné uniquement si le tableau de bord appartient à une application

dataClassification

string

Balise de classification des données d’un élément Power BI (par exemple, un rapport ou un tableau de bord)

displayName

string

Nom complet du tableau de bord

id

string

ID du tableau de bord

isReadOnly

boolean

Indique si le tableau de bord est en lecture seule

sensitivityLabel

SensitivityLabel

Étiquette de confidentialité

tiles

WorkspaceInfoTile[]

Vignettes appartenant au tableau de bord

users

DashboardUser[]

(Valeur vide) Détails de l’accès de l’utilisateur au tableau de bord. Cette propriété sera supprimée de la réponse de charge utile dans une prochaine version. Vous pouvez récupérer des informations utilisateur sur un tableau de bord Power BI à l’aide de l'Obtenir des utilisateurs de tableau de bord en tant qu’appel d’API administrateur, ou l’appel d’API PostWorkspaceInfo avec le paramètre getArtifactUsers.

WorkspaceInfoDataflow

Métadonnées d’un flux de données retourné par les API d’informations de l’espace de travail. Vous trouverez ci-dessous une liste de propriétés qui peuvent être retournées pour un dataflow. Seul un sous-ensemble des propriétés est retourné en fonction de l’API appelée, des autorisations de l’appelant et de la disponibilité des données dans la base de données Power BI.

Nom Type Description
configuredBy

string

Propriétaire du flux de données

datasourceUsages

DatasourceUsage[]

Utilisations de la source de données

description

string

Description du flux de données

endorsementDetails

EndorsementDetails

Détails de l’approbation

misconfiguredDatasourceUsages

DatasourceUsage[]

Utilisations incorrectes de la source de données

modelUrl

string

URL du fichier de définition de flux de données (model.json)

name

string

Nom du dataflow

objectId

string

ID de flux de données

sensitivityLabel

SensitivityLabel

Étiquette de confidentialité

upstreamDataflows

DependentDataflow[]

La liste de tous les flux de données dont dépend cet élément

upstreamDatamarts

DependentDatamart[]

La liste de tous les datamarts de cet élément dépend de

users

DataflowUser[]

(Valeur vide) Détails de l’accès de l’utilisateur du flux de données. Cette propriété sera supprimée de la réponse de charge utile dans une prochaine version. Vous pouvez récupérer des informations utilisateur sur un dataflow Power BI à l’aide de l'Obtenir des utilisateurs de dataflow en tant qu’appel d’API administrateur, ou l’appel d’API PostWorkspaceInfo avec le paramètre getArtifactUser.

WorkspaceInfoDatamart

Un datamart Power BI retourné par les API d’informations de l’espace de travail. L’API retourne un sous-ensemble de la liste suivante de propriétés datamart. Le sous-ensemble dépend de l’API appelée, des autorisations d’appelant et de la disponibilité des données dans la base de données Power BI.

Nom Type Description
configuredBy

string

Nom du propriétaire datamart

configuredById

string

ID du propriétaire datamart

datasourceUsages

DatasourceUsage[]

Utilisations de la source de données

description

string

Description de datamart

endorsementDetails

EndorsementDetails

Détails de l’approbation datamart

id

string

ID de datamart

modifiedBy

string

Dernier utilisateur qui a modifié le datamart

modifiedById

string

ID du dernier utilisateur qui a modifié le datamart

modifiedDateTime

string

Date et heure de la dernière modification du datamart

name

string

Nom de datamart

sensitivityLabel

SensitivityLabel

Étiquette de confidentialité datamart

state

datamartState

État actuel du datamart

status

datamartStatus

État du datamart

suspendedBatchId

string

datamart suspended batch id

type

datamartType

Type datamart

upstreamDataflows

DependentDataflow[]

La liste de tous les flux de données dont dépend cet élément

upstreamDatamarts

DependentDatamart[]

La liste de tous les datamarts de cet élément dépend de

users

DatamartUser[]

Les détails de l’accès utilisateur pour un datamart Power BI.

WorkspaceInfoDataset

Jeu de données Power BI retourné par les API WorkspaceInfo. L’API retourne un sous-ensemble de la liste suivante des propriétés du jeu de données. Le sous-ensemble dépend de l’API appelée, des autorisations d’appelant et de la disponibilité des données dans la base de données Power BI.

Nom Type Description
ContentProviderType

string

Type de fournisseur de contenu pour le jeu de données

configuredBy

string

Propriétaire du jeu de données

createdDate

string

Date et heure de création du jeu de données

datasourceUsages

DatasourceUsage[]

Utilisations de la source de données

description

string

Description du jeu de données

endorsementDetails

EndorsementDetails

Détails de l’approbation

expressions

Expression[]

Expressions de jeu de données

id

string

ID du jeu de données

misconfiguredDatasourceUsages

DatasourceUsage[]

Utilisations incorrectes de la source de données

name

string

Nom du jeu de données

roles

Role[]

Rôles de jeu de données

schemaMayNotBeUpToDate

boolean

Indique si le schéma du jeu de données peut ne pas être à jour

schemaRetrievalError

string

Erreur de récupération du schéma de jeu de données

sensitivityLabel

SensitivityLabel

Étiquette de confidentialité

tables

Table[]

Tables de jeux de données

targetStorageMode

string

Mode de stockage du jeu de données

upstreamDataflows

DependentDataflow[]

La liste de tous les flux de données dont dépend cet élément

upstreamDatamarts

DependentDatamart[]

La liste de tous les datamarts de cet élément dépend de

upstreamDatasets

DependentDataset[]

Jeux de données en amont

users

DatasetUser[]

(Valeur vide) Détails de l’accès de l’utilisateur au jeu de données. Cette propriété sera supprimée de la réponse de charge utile dans une prochaine version. Vous pouvez récupérer des informations utilisateur sur un élément Power BI (tel qu’un rapport ou un tableau de bord) à l’aide du Obtenir des utilisateurs de jeu de données en tant qu’API d’administration, ou de l’API PostWorkspaceInfo avec le paramètre getArtifactUsers.

WorkspaceInfoReport

Rapport Power BI retourné par les API d’informations sur l’espace de travail. L’API retourne un sous-ensemble de la liste suivante de propriétés de rapport. Le sous-ensemble dépend de l’API appelée, des autorisations d’appelant et de la disponibilité des données dans la base de données Power BI.

Nom Type Description
appId

string

ID de l’application, retourné uniquement si le rapport appartient à une application

createdBy

string

Propriétaire du rapport. Disponible uniquement pour les rapports créés après juin 2019.

createdById

string

ID du propriétaire du rapport. Disponible uniquement pour les rapports créés après juin 2019.

createdDateTime

string

Date et heure de création du rapport

datasetId

string

ID de jeu de données du rapport

datasetWorkspaceId

string

ID d’espace de travail du jeu de données associé, retourné uniquement si le jeu de données associé appartient à un autre espace de travail

description

string

Description du rapport

endorsementDetails

EndorsementDetails

Détails de l’approbation

id

string

ID de rapport

isOwnedByMe

boolean

Déterminez si le rapport est créé par l’utilisateur actuel.

modifiedBy

string

Dernier utilisateur qui a modifié le rapport

modifiedById

string

ID du dernier utilisateur qui a modifié le rapport

modifiedDateTime

string

Date et heure de la dernière modification du rapport

name

string

Nom du rapport

originalReportId

string

ID de rapport réel lorsque l’espace de travail est publié en tant qu’application.

reportType enum:
  • PaginatedReport
  • PowerBIReport

Type de rapport

sensitivityLabel

SensitivityLabel

Étiquette de confidentialité

users

ReportUser[]

(Valeur vide) Les détails de l’accès utilisateur à un rapport Power BI. Cette propriété sera supprimée de la réponse de charge utile dans une prochaine version. Vous pouvez récupérer des informations utilisateur sur un rapport Power BI à l’aide de l'Obtenir des utilisateurs de rapport en tant qu’appel d’API administrateur, ou de l’appel d’API PostWorkspaceInfo avec le paramètre getArtifactUsers.

WorkspaceInfoResponse

Réponse aux informations de l’espace de travail

Nom Type Description
datasourceInstances

Datasource[]

Instances de source de données associées à cette analyse

misconfiguredDatasourceInstances

Datasource[]

Instances mal configurées de la source de données associées à cette analyse

workspaces

WorkspaceInfo[]

Informations d’espace de travail associées à cette analyse

WorkspaceInfoTile

Vignette Power BI retournée par les API WorkspaceInfo

Nom Type Description
datasetId

string

ID du jeu de données. Disponible uniquement pour les vignettes créées à partir d’un rapport ou à l’aide d’un jeu de données, comme les vignettes Q&A.

datasetWorkspaceId

string

ID d’espace de travail du jeu de données associé, retourné uniquement si le jeu de données associé appartient à un autre espace de travail

id

string

ID de vignette

reportId

string

ID de rapport. Disponible uniquement pour les vignettes créées à partir d’un rapport.

title

string

Nom complet de la vignette