Partager via

Reports - Clone Report In Group

  • Référence
Service:
Power BI REST APIs
Version d'API:
v1.0

Clone le rapport spécifié à partir de l’espace de travail spécifié.

  • Si le jeu de données d’un rapport cloné réside dans deux espaces de travail différents ou dans Mon espace de travail, un jeu de données partagé est créé dans l’espace de travail du rapport.
  • Lorsqu’ils sont clonés, les rapports avec une connexion active perdront cette connexion et au lieu de cela ont une liaison directe au jeu de données cible.

Autorisations

  • L’utilisateur doit disposer de tous les éléments suivants, sauf si une exigence ne s’applique pas :

    • l’autorisation Écrire sur le rapport spécifié.
    • l’autorisation Générer sur le jeu de données cible, requise si le paramètre targetModelId est utilisé.

  • Cet appel d’API peut être appelé par un profil de principal de service. Pour plus d’informations, consultez : profils de principal de service dans Power BI Embedded.

Étendue requise

Content.Create 

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/reports/{reportId}/Clone

Paramètres URI

Nom Dans Obligatoire Type Description
groupId
 path True

string (uuid)

Identifiant de l’espace de travail
reportId
 path True

string (uuid)

ID de rapport

Corps de la demande

Nom Obligatoire Type Description
name True

string

Nouveau nom du rapport
targetModelId

string

Optionnel. Paramètre permettant de spécifier l’ID de jeu de données associé à la cible. S’il n’est pas fourni, le nouveau rapport est associé au même jeu de données que le rapport source.
targetWorkspaceId

string (uuid)

Optionnel. Paramètre permettant de spécifier l’ID de l’espace de travail cible. Un GUID vide (00000000-0000-0000-0000-000000000000) indique Mon espace de travail. Si ce paramètre n’est pas fourni, le nouveau rapport est cloné dans le même espace de travail que le rapport source.

Réponses

Nom Type Description
200 OK

Report

D’ACCORD

Exemples

Example

Exemple de requête

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Clone
Corps de la demande
{
  "name": "New Report Name",
  "targetModelId": "8e4d5880-81d6-4804-ab97-054665050799",
  "targetWorkspaceId": "2f42a406-a075-4a15-bbf2-97ef958c94cb"
}

Exemple de réponse

Code d’état:
200

Définitions

Nom Description
CloneReportRequest

Demande de rapport de clonage Power BI
PrincipalType

Type de principal
Report

Rapport Power BI. 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.
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)
ServicePrincipalProfile

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

Un abonnement par e-mail pour un élément Power BI (tel qu’un rapport ou un tableau de bord)
SubscriptionUser

Un utilisateur d’abonnement de messagerie Power BI

CloneReportRequest

Object

Demande de rapport de clonage Power BI

Nom Type Description
name

string

Nouveau nom du rapport
targetModelId

string

Optionnel. Paramètre permettant de spécifier l’ID de jeu de données associé à la cible. S’il n’est pas fourni, le nouveau rapport est associé au même jeu de données que le rapport source.
targetWorkspaceId

string (uuid)

Optionnel. Paramètre permettant de spécifier l’ID de l’espace de travail cible. Un GUID vide (00000000-0000-0000-0000-000000000000) indique Mon espace de travail. Si ce paramètre n’est pas fourni, le nouveau rapport est cloné dans le même espace de travail que le rapport source.

PrincipalType

Énumération

Type de principal

Valeur Description
App

Type de principal de service
Group

Type de principal de groupe
None

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

Type de principal de l’utilisateur

Report

Object

Rapport Power BI. 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
datasetId

string

ID de jeu de données du rapport
description

string

Description du rapport
embedUrl

string

URL incorporée du rapport
id

string (uuid)

ID de rapport
isOwnedByMe

boolean

Indique si l’utilisateur actuel a la possibilité de modifier ou de créer une copie du rapport.
name

string

Nom du rapport. Les rapports d’application commencent par le préfixe [Application].
originalReportId

string (uuid)

ID de rapport réel lorsque l’espace de travail est publié en tant qu’application.
reportType enum:
  • PaginatedReport
  • PowerBIReport

Type de rapport
subscriptions

Subscription[]

(Valeur vide) Détails de l’abonnement pour un élément Power BI (tel qu’un rapport ou un 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 d’abonnement pour un rapport Power BI à l’aide de l'Obtenir des abonnements de rapport en tant qu’appel d’API d’administrateur.
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.
webUrl

string

URL web du rapport

ReportUser

Object

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

Énumération

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

Valeur Description
None

Aucune autorisation pour le contenu dans le rapport
Owner

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

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

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

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

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

ServicePrincipalProfile

Object

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 (uuid)

ID de profil du principal de service

Subscription

Object

Un abonnement par e-mail pour un élément Power BI (tel qu’un rapport ou un tableau de bord)

Nom Type Description
artifactDisplayName

string

Nom de l’élément Power BI abonné (tel qu’un rapport ou un tableau de bord)
artifactId

string (uuid)

ID de l’élément Power BI abonné (tel qu’un rapport ou un tableau de bord)
artifactType

string

Type d’élément Power BI (par exemple, un Report, Dashboardou Dataset)
attachmentFormat

string

Format du rapport joint dans l’abonnement par e-mail
endDate

string (date-time)

Date et heure de fin de l’abonnement par e-mail
frequency

string

Fréquence de l’abonnement par e-mail
id

string (uuid)

ID d’abonnement
isEnabled

boolean

Indique si l’abonnement par e-mail est activé
linkToContent

boolean

Indique si un lien d’abonnement existe dans l’abonnement par e-mail
previewImage

boolean

Indique si une capture d’écran du rapport existe dans l’abonnement par e-mail
startDate

string (date-time)

Date et heure de début de l’abonnement par e-mail
subArtifactDisplayName

string

Nom de la page de l’élément Power BI abonné, s’il s’agit d’un rapport.
title

string

Nom de l’application
users

SubscriptionUser[]

Détails de chaque abonné à l’e-mail. Lorsque vous utilisez l'Obtenir des abonnements utilisateur en tant qu’appel d’API administrateur, la valeur retournée est un tableau vide (null). Cette propriété sera supprimée de la réponse de charge utile dans une prochaine version. Vous pouvez récupérer des informations d’abonnement sur un rapport Ou un tableau de bord Power BI à l’aide de l'Obtenir des abonnements de rapport en tant qu’administrateur ou Obtenir des abonnements de tableau de bord en tant qu’appels d’API d’administrateur.

SubscriptionUser

Object

Un utilisateur d’abonnement de messagerie Power BI

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

string

Type de l’utilisateur.