Admin - Datasets GetDatasetsInGroupAsAdmin

Référence

Service:: Power BI REST APIs

API Version:: v1.0

Retourne une liste de jeux de données de l’espace de travail spécifié.

Autorisations

L’utilisateur doit disposer de droits d’administrateur (tels que Office 365 administrateur général ou administrateur de service Power BI) ou s’authentifier à l’aide d’un principal de service.
Les autorisations déléguées sont prises en charge.

Lors de l’exécution sous l’authentification prinicipal de service, une application ne doit pas avoir de prémissions requises de consentement administrateur pour Power BI définies sur elle 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 200 requêtes par heure.

GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/datasets

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/datasets?$filter={$filter}&$top={$top}&$skip={$skip}&$expand={$expand}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
groupId	path	True	string uuid	L’ID de l’espace de travail
$expand	query		string	Développe les entités associées inline
$filter	query		string	Filtre les résultats, en fonction d’une condition booléenne
$skip	query		integer int32	Ignore les n premiers résultats
$top	query		integer int32	Retourne uniquement les n premiers résultats

Réponses

Nom	Type	Description
200 OK	AdminDatasets	Ok

Exemples

Example

Example with expand on encryption

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "name": "SalesMarketing",
      "addRowsAPIEnabled": false,
      "configuredBy": "john@contoso.com",
      "isRefreshable": true,
      "isEffectiveIdentityRequired": false,
      "isEffectiveIdentityRolesRequired": false,
      "isOnPremGatewayRequired": false,
      "isInPlaceSharingEnabled": false
    }
  ]
}

Example with expand on encryption

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets?$expand=encryption

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "name": "SalesMarketing",
      "addRowsAPIEnabled": false,
      "configuredBy": "john@contoso.com",
      "isRefreshable": true,
      "isEffectiveIdentityRequired": false,
      "isEffectiveIdentityRolesRequired": false,
      "isOnPremGatewayRequired": false,
      "isInPlaceSharingEnabled": false,
      "encryption": {
        "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
        "encryptionStatus": "InSyncWithWorkspace"
      }
    }
  ]
}

Définitions

Nom	Description
AdminDataset	Jeu de données Power BI retourné par Administration API. L’API retourne un sous-ensemble de la liste suivante de propriétés du 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.
AdminDatasets	Wrapper de liste odata de jeu de données
DatasetQueryScaleOutSettings	Paramètres de scale-out de requête d’un jeu de données
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)
DependentDataflow	Un flux de données dépendant de Power BI
Encryption	Informations de chiffrement pour un jeu de données
EncryptionStatus	status de chiffrement de jeu de données
PrincipalType	Type principal
ServicePrincipalProfile	Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.

AdminDataset

Jeu de données Power BI retourné par Administration API. L’API retourne un sous-ensemble de la liste suivante de propriétés du 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
CreateReportEmbedURL	string	URL d’incorporation du jeu de données de création de rapport
CreatedDate	string	Date et heure de création du jeu de données
Encryption	Encryption	Informations de chiffrement de jeu de données. Applicable uniquement lorsque `$expand` est spécifié.
IsEffectiveIdentityRequired	boolean	Indique si le jeu de données nécessite une identité effective, que vous devez envoyer dans un appel d’API GenerateToken .
IsEffectiveIdentityRolesRequired	boolean	Indique si la sécurité au niveau des lignes est définie à l’intérieur du fichier .pbix Power BI. Si c’est le cas, vous devez spécifier un rôle.
IsInPlaceSharingEnabled	boolean	Si le jeu de données peut être partagé avec des utilisateurs externes à consommer dans leur propre locataire
IsOnPremGatewayRequired	boolean	Indique si le jeu de données nécessite une passerelle de données locale
IsRefreshable	boolean	Indique si le jeu de données peut être actualisé ou non. Un jeu de données actualisable Power BI est un jeu de données qui a été actualisé au moins une fois ou pour lequel une planification d’actualisation valide existe.
QnaEmbedURL	string	L’URL incorporée Q&A du jeu de données
addRowsAPIEnabled	boolean	Si le jeu de données autorise l’ajout de nouvelles lignes
configuredBy	string	Propriétaire du jeu de données
description	string	Description du jeu de données
id	string	ID du jeu de données
name	string	Nom du jeu de données
queryScaleOutSettings	DatasetQueryScaleOutSettings	Paramètres de scale-out de requête d’un 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
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 .
webUrl	string	URL web du jeu de données
workspaceId	string	ID d’espace de travail du jeu de données. Cette propriété sera retournée uniquement dans GetDatasetsAsAdmin.

AdminDatasets

Wrapper de liste odata de jeu de données

Nom	Type	Description
odata.context	string	Contexte OData
value	AdminDataset[]	Jeux de données

DatasetQueryScaleOutSettings

Paramètres de scale-out de requête d’un jeu de données

Nom	Type	Description
autoSyncReadOnlyReplicas	boolean	Indique si le jeu de données synchronise automatiquement les réplicas en lecture seule
maxReadOnlyReplicas	integer	Nombre maximal de réplicas en lecture seule pour le jeu de données (0-64, -1 pour le nombre automatique de réplicas)

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 sur le 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 dans le jeu de données
ReadReshare	string	Octroie l’accès en lecture et en partage au contenu dans le jeu de données
ReadReshareExplore	string	Octroie l’accès en lecture, partage 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, partage et exploration au contenu du jeu 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

Encryption

Informations de chiffrement pour un jeu de données

Nom	Type	Description
EncryptionStatus	EncryptionStatus	status de chiffrement de jeu de données

EncryptionStatus

status de chiffrement de jeu de données

Nom	Type	Description
InSyncWithWorkspace	string	Le chiffrement est pris en charge et est synchronisé avec les paramètres de chiffrement
NotInSyncWithWorkspace	string	Le chiffrement est pris en charge, mais n’est pas synchronisé avec les paramètres de chiffrement
NotSupported	string	Le chiffrement n’est pas pris en charge pour ce jeu de données
Unknown	string	Le status de chiffrement est inconnu en raison d’une altération du jeu de données

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

ServicePrincipalProfile

Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.

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

Admin - Datasets GetDatasetsInGroupAsAdmin

Autorisations

Étendue requise

Limites

Paramètres URI

Réponses

Exemples

Example

Sample Request

Sample Response

Example with expand on encryption

Sample Request

Sample Response

Définitions

AdminDataset

AdminDatasets

DatasetQueryScaleOutSettings

DatasetUser

DatasetUserAccessRight

DependentDataflow

Encryption

EncryptionStatus

PrincipalType

ServicePrincipalProfile

Ressources supplémentaires