Partager via


Admin - Datasets GetDatasetsInGroupAsAdmin

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

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

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