Admin - WorkspaceInfo GetScanResult

Service:

Power BI REST APIs

API Version:

v1.0

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 disposer de droits d’administrateur (par exemple, Administrateur général Microsoft 365 ou Administrateur de service Power BI) ou s’authentifier à l’aide d’un principal de service.

Lors de l’exécution sous l’authentification du principal de service, aucune autorisation d’administrateur requise pour Power BI ne doit être définie sur une application dans le Portail Azure.

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

Pertinent 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.

Limites

Maximum 500 demandes 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	L’ID d’analyse, qui est inclus dans la réponse des espaces de travail ou de l’appel d’API Administration - WorkspaceInfo PostWorkspaceInfo qui a déclenché l’analyse.

Réponses

Nom	Type	Description
200 OK	WorkspaceInfoResponse	Ok

Exemples

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

Définitions

Nom	Description
ASMashupExpression	Une source de table de jeu de données
Column	Colonne d’un 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 flux de données
DataflowUserAccessRight	Droit d’accès dont dispose un utilisateur pour le flux de données (niveau d’autorisation)
datamartState	État actuel du datamart
datamartStatus	Le datamart status
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 dont dispose l’utilisateur pour le jeu de données (niveau d’autorisation)
Datasource	Une source de données Power BI
DatasourceConnectionDetails	Détails de 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 un groupe.
DatasourceUsage	Utilisation d’une source de données
DefaultDatasetStorageFormat	Format de stockage du jeu de données par défaut dans le groupe
DependentDataflow	Un flux de données dépendant de Power BI
DependentDatamart	Un datamart dépendant de Power BI
DependentDataset	Un 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) d’un utilisateur sur l’espace de travail
Measure	Une mesure Power BI
PrincipalType	Type principal
ReportUser	Entrée de droit d’accès utilisateur Power BI pour un rapport
ReportUserAccessRight	Droit d’accès dont dispose l’utilisateur pour le rapport (niveau d’autorisation)
Role	Rôle dans la configuration RLS d’un jeu de données
RoleMember	Un membre de rôle
RoleTablePermission	Un filtre de rôle
Row	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 principal service Power BI. Concerne uniquement Power BI Embedded solution mutualisée.
Table	Table de jeu de données
WorkspaceInfo	Détails des informations sur l’espace de travail
WorkspaceInfoDashboard	Un tableau de bord Power BI retourné par les API WorkspaceInfo. L’API retourne un sous-ensemble de la liste suivante de propriétés de tableau de bord. Le sous-ensemble dépend 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.
WorkspaceInfoDataflow	Métadonnées d’un flux de données retournés par les API d’informations sur l’espace de travail. Vous trouverez ci-dessous la liste des propriétés qui peuvent être retournées pour un flux de données. Seul un sous-ensemble des propriétés sera 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 sur 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 de l’appelant et de la disponibilité des données dans la base de données Power BI.
WorkspaceInfoDataset	Un jeu de données Power BI retourné par les API WorkspaceInfo. L’API retourne un sous-ensemble de la liste suivante de propriétés de jeu de données. Le sous-ensemble dépend 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.
WorkspaceInfoReport	Un 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 de l’appelant et de la disponibilité des données dans la base de données Power BI.
WorkspaceInfoResponse	Réponse d’informations sur l’espace de travail
WorkspaceInfoTile	Vignette Power BI retournée par les API WorkspaceInfo

ASMashupExpression

Une source de table de jeu de données

Nom	Type	Description
expression	string	Expression source

Column

Colonne d’un jeu de données

Nom	Type	Description
dataCategory	string	facultatif. 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	facultatif. Format de la colonne tel que spécifié dans FORMAT_STRING.
isHidden	boolean	facultatif. Indique si la colonne est masquée. La valeur par défaut est false.
name	string	Nom de colonne
sortByColumn	string	facultatif. Nom de chaîne d’une colonne dans la même table à utiliser pour trier la colonne en cours.
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 d’affichage 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 principal
profile	ServicePrincipalProfile	Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.
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 d’accès au contenu dans le tableau de bord
Owner	string	Octroie l’accès en lecture, écriture et repartage au contenu du rapport
Read	string	Octroie l’accès en lecture au contenu du tableau de bord
ReadCopy	string	Octroie l’accès en lecture et copie au contenu du tableau de bord
ReadReshare	string	Octroie l’accès en lecture et repartage au contenu du tableau de bord
ReadWrite	string	Octroie l’accès en lecture et écriture au contenu du tableau de bord

DataflowUser

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

Nom	Type	Description
DataflowUserAccessRight	DataflowUserAccessRight	Droit d’accès d’un utilisateur au flux de données (niveau d’autorisation)
displayName	string	Nom d’affichage 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 principal
profile	ServicePrincipalProfile	Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.
userType	string	Type de l’utilisateur.

DataflowUserAccessRight

Droit d’accès dont dispose un utilisateur pour le flux de données (niveau d’autorisation)

Nom	Type	Description
None	string	Supprime l’autorisation d’accès au contenu dans le flux de données
Owner	string	Octroie l’accès en lecture, écriture et repartage 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	Octroie l’accès en lecture et repartage au contenu dans le flux de données
ReadWrite	string	Octroie l’accès en lecture et en é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	L’état du datamart n’est pas valide
Migrating	string	Le datamart est en cours de migration

datamartStatus

Le datamart status

Nom	Type	Description
Available	string	Le datamart est disponible
Error	string	Le datamart a des status d’erreur
InProgress	string	Le datamart est en cours
Invalid	string	Le datamart a des status non valides
NoCapacity	string	Le datamart n’a pas de capacité
OutOfRegion	string	Le datamart est hors région
SuspendedInCriticalPhase	string	Le datamart est suspendu dans la phase critique

datamartType

Type datamart

Nom	Type	Description
Dataverse	string	Le datamart est de type Dataverse
Datawarehouse	string	Le datamart est de type Datawarehouse
Ignore	string	Le datamart n’a pas de 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 d’affichage 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 principal
profile	ServicePrincipalProfile	Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.
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	Les octrois explorent l’accès au contenu dans datamart
None	string	Aucune autorisation d’accès au contenu dans datamart
Read	string	Octroie l’accès en lecture au contenu dans le datamart
ReadExplore	string	Octroie l’accès en lecture et en exploration au contenu dans le datamart
ReadReshare	string	Octroie l’accès en lecture et repartage au contenu dans le datamart
ReadReshareExplore	string	Octroie l’accès en lecture et repartage et exploration du contenu dans datamart
ReadWrite	string	Octroie l’accès en lecture et en écriture au contenu dans le datamart
ReadWriteExplore	string	Octroie l’accès en lecture et en écriture et exploration au contenu dans le datamart
ReadWriteReshare	string	Octroie l’accès en lecture et en écriture et repartage au contenu dans le datamart
ReadWriteReshareExplore	string	Octroie l’accès en lecture et en écriture, ainsi qu’au partage et à l’exploration du contenu dans datamart
Reshare	string	Octroie l’accès de repartage au contenu dans le 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 dont dispose l’utilisateur pour le jeu de données (niveau d’autorisation)
displayName	string	Nom d’affichage 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 principal
profile	ServicePrincipalProfile	Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.
userType	string	Type de l’utilisateur.

DatasetUserAccessRight

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

Nom	Type	Description
None	string	Supprime l’autorisation d’accès au 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 lecture et exploration au contenu du jeu de données
ReadReshare	string	Octroie l’accès en lecture et repartage au contenu du jeu de données
ReadReshareExplore	string	Octroie l’accès en lecture, repartage et exploration au contenu du jeu de données
ReadWrite	string	Octroie l’accès en lecture et en écriture au contenu du jeu de données
ReadWriteExplore	string	Octroie l’accès en lecture, écriture et exploration au contenu du jeu de données
ReadWriteReshare	string	Octroie l’accès en lecture, écriture et repartage au contenu du jeu de données
ReadWriteReshareExplore	string	Octroie l’accès en lecture, écriture, repartage et exploration au contenu du jeu de données

Datasource

Une 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é) Source de données chaîne de connexion. 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. Lors de l’utilisation d’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 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 un 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	Serveur de connexion
path	string	Chemin de connexion
server	string	Serveur de connexion
url	string	URL de connexion

DatasourceUsage

Utilisation d’une source de données

Nom	Type	Description
datasourceInstanceId	string	ID de instance de la 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 des grands jeux de données
Small	string	Format de stockage de petits jeux de données

DependentDataflow

Un flux de données dépendant de Power BI

Nom	Type	Description
groupId	string	ID du 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 du groupe cible
targetDatamartId	string	ID de datamart cible

DependentDataset

Un jeu de données dépendant de Power BI

Nom	Type	Description
groupId	string	ID du groupe cible
targetDatasetId	string	ID du jeu de données cible

EndorsementDetails

Détails de l’approbation Power BI

Nom	Type	Description
certifiedBy	string	L’utilisateur qui a certifié l’élément Power BI (tel qu’un rapport ou un tableau de bord)
endorsement	string	Le status d’approbation

Expression

Expression de jeu de données

Nom	Type	Description
description	string	Description de l’expression
expression	ASMashupExpression	Une source de table de jeu de données
name	string	Nom de l’expression

GroupUser

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

Nom	Type	Description
displayName	string	Nom d’affichage 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) d’un utilisateur sur l’espace de travail
identifier	string	Identificateur du principal
principalType	PrincipalType	Type principal
profile	ServicePrincipalProfile	Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.
userType	string	Type de l’utilisateur.

GroupUserAccessRight

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

Nom	Type	Description
Admin	string	Droits d’administrateur sur le contenu de l’espace de travail
Contributor	string	Lire et explorer l’accès (ReadExplore) au contenu de l’espace de travail
Member	string	Lire, partager et explorer (ReadReshareExplore) les 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 au contenu de l’espace de travail

Measure

Une mesure Power BI

Nom	Type	Description
description	string	facultatif. Description de la mesure.
expression	string	Expression DAX valide
formatString	string	facultatif. Chaîne décrivant comment la valeur doit être mise en forme lorsqu’elle est affichée comme spécifié dans FORMAT_STRING.
isHidden	boolean	facultatif. Indique si la mesure est masquée.
name	string	Nom de la mesure

PrincipalType

Type principal

Nom	Type	Description
App	string	Type de principal de service
Group	string	Type de principal de groupe
None	string	Aucun type principal. Utilisez pour un accès de niveau organization entier.
User	string	Type de principal d’utilisateur

ReportUser

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

Nom	Type	Description
displayName	string	Nom d’affichage 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 principal
profile	ServicePrincipalProfile	Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.
reportUserAccessRight	ReportUserAccessRight	Droit d’accès dont dispose l’utilisateur pour le rapport (niveau d’autorisation)
userType	string	Type de l’utilisateur.

ReportUserAccessRight

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

Nom	Type	Description
None	string	Aucune autorisation d’accès au contenu dans le rapport
Owner	string	Octroie l’accès en lecture, écriture et repartage au contenu du rapport
Read	string	Octroie l’accès en lecture au contenu du rapport
ReadCopy	string	Octroie l’accès en lecture et copie au contenu du rapport
ReadReshare	string	Octroie l’accès en lecture et repartage au contenu du rapport
ReadWrite	string	Octroie l’accès en lecture et en écriture au contenu du 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, En lecture
name	string	Nom du rôle
tablePermissions	RoleTablePermission	Tableau qui répertorie tous les filtres définis pour le rôle

RoleMember

Un membre de rôle

Nom	Type	Description
identityProvider	string	Fournisseur d’identité 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

Un 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

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 principal service Power BI. Concerne uniquement Power BI Embedded solution mutualisée.

Nom	Type	Description
displayName	string	Nom du profil de principal de service
id	string	ID de profil du principal de service

Table

Table de jeu de données

Nom	Type	Description
columns	Column[]	Schéma de colonne pour cette table
description	string	Description de la table
isHidden	boolean	facultatif. Indique si cette table de jeu de données est masquée.
measures	Measure[]	Mesures de cette table
name	string	Le 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 risquez de ne pas voir 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, de sorte que vous risquez de ne pas voir toutes les propriétés de flux de données dans une réponse d’API.
datamarts	WorkspaceInfoDatamart[]	Datamarts associés à cet espace de travail. La liste des propriétés de datamart retournées varie selon les appels d’API. Il est donc possible que vous ne voyiez pas toutes les propriétés de 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. Il est donc possible que vous ne voyiez pas toutes les propriétés du jeu de données dans une réponse d’API.
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	Format de stockage du 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, de sorte que vous risquez de 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 la liste des utilisateurs d’un espace de travail classique, utilisez le API Graph Azure Active Directory.

WorkspaceInfoDashboard

Un tableau de bord Power BI retourné par les API WorkspaceInfo. L’API retourne un sous-ensemble de la liste suivante de propriétés de tableau de bord. Le sous-ensemble dépend 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
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 qui appartiennent au tableau de bord
users	DashboardUser[]	(Valeur vide) Détails de l’accès 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’appel d’API Obtenir des utilisateurs du tableau de bord en tant qu’appel d’API Administration, ou de l’appel d’API PostWorkspaceInfo avec le getArtifactUsers paramètre .

WorkspaceInfoDataflow

Métadonnées d’un flux de données retournés par les API d’informations sur l’espace de travail. Vous trouverez ci-dessous la liste des propriétés qui peuvent être retournées pour un flux de données. Seul un sous-ensemble des propriétés sera 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)
modifiedBy	string	L’utilisateur qui a modifié le flux de données
modifiedDateTime	string	Date et heure de la dernière modification du flux de données
name	string	Nom du flux de données
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[]	Liste de tous les datamarts dont dépend cet élément
users	DataflowUser[]	(Valeur vide) Détails de l’accès de l’utilisateur au flux de données. Cette propriété sera supprimée de la réponse de charge utile dans une version à venir. Vous pouvez récupérer des informations utilisateur sur un flux de données Power BI à l’aide de l’appel d’API Get Dataflow Users as Administration, ou de l’appel d’API PostWorkspaceInfo avec le getArtifactUser paramètre.

WorkspaceInfoDatamart

Un datamart 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 datamart. Le sous-ensemble dépend 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	Nom du propriétaire du datamart
configuredById	string	ID du propriétaire du datamart
datasourceUsages	DatasourceUsage[]	Utilisations de la source de données
description	string	Description du datamart
endorsementDetails	EndorsementDetails	Détails de l’approbation datamart
id	string	The datamart ID
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 du datamart
sensitivityLabel	SensitivityLabel	Étiquette de confidentialité datamart
state	datamartState	État actuel du datamart
status	datamartStatus	Le datamart status
suspendedBatchId	string	id de lot suspendu datamart
type	datamartType	Type datamart
upstreamDataflows	DependentDataflow[]	La liste de tous les flux de données dont dépend cet élément
upstreamDatamarts	DependentDatamart[]	Liste de tous les datamarts dont dépend cet élément
users	DatamartUser[]	Détails d’accès utilisateur pour un datamart Power BI.

WorkspaceInfoDataset

Un jeu de données Power BI retourné par les API WorkspaceInfo. L’API retourne un sous-ensemble de la liste suivante de propriétés de jeu de données. Le sous-ensemble dépend 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
ContentProviderType	string	Type de fournisseur de contenu pour le jeu de données
CreatedDate	string	Date et heure de création du jeu de données
configuredBy	string	Propriétaire 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	Si le schéma du jeu de données n’est peut-être pas à 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 jeu 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[]	Liste de tous les datamarts dont dépend cet élément
upstreamDatasets	DependentDataset[]	Jeux de données 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 version à venir. 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 de l’API Get Dataset Users as Administration ou de l’API PostWorkspaceInfo avec le getArtifactUsers paramètre .

WorkspaceInfoReport

Un 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 de l’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 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 du 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) Détails d’accès utilisateur pour 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’appel d’API Get Report Users as Administration, ou de l’appel d’API PostWorkspaceInfo avec le getArtifactUsers paramètre .

WorkspaceInfoResponse

Réponse d’informations sur l’espace de travail

Nom	Type	Description
datasourceInstances	Datasource[]	Instances de source de données associées à cette analyse
misconfiguredDatasourceInstances	Datasource[]	Instances de source de données mal configurées associées à cette analyse
workspaces	WorkspaceInfo[]	Les informations de l’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 d’affichage de la vignette