Partager via

Reports - Clone Report In Group

  • Référence
Service:
Power BI REST APIs
API Version:
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.
  • En cas de clonage, les rapports avec une connexion active perdent cette connexion et 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 :

    • Autorisation d’écriture sur le rapport spécifié.
    • Autorisation de génération sur le jeu de données cible, requise si le targetModelId paramètre 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

L’ID de l’espace de travail
reportId
 path True

string

uuid

ID de rapport

Corps de la demande

Nom Obligatoire Type Description
name True

string

Nom du nouveau rapport
targetModelId

string

facultatif. Paramètre permettant de spécifier l’ID de jeu de données associé 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

facultatif. 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 sera cloné dans le même espace de travail que le rapport source.

Réponses

Nom Type Description
200 OK

Report

Ok

Exemples

Example

Sample Request

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

Sample Response

Status code:
200

Définitions

Nom Description
CloneReportRequest

Demande de rapport de clonage Power BI
PrincipalType

Type principal
Report

Un 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 de l’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 dispose l’utilisateur pour le rapport (niveau d’autorisation)
ServicePrincipalProfile

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

Un abonnement de messagerie 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

Demande de rapport de clonage Power BI

Nom Type Description
name

string

Nom du nouveau rapport
targetModelId

string

facultatif. Paramètre permettant de spécifier l’ID de jeu de données associé 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

facultatif. 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 sera cloné dans le même espace de travail que le rapport source.

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

Report

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

string

ID de jeu de données du rapport
description

string

Description du rapport
embedUrl

string

URL d’incorporation du rapport
id

string

ID de rapport
isOwnedByMe

boolean

Déterminez si le rapport est créé par l’utilisateur actuel.
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
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 version à venir. Vous pouvez récupérer des informations d’abonnement pour un rapport Power BI à l’aide de l’option Obtenir des abonnements de rapport en tant qu’appel d’API Administration.
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 version à venir. Vous pouvez récupérer les informations utilisateur d’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 .
webUrl

string

URL web du rapport

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

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

Subscription

Un abonnement de messagerie 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é (par exemple, un rapport ou un tableau de bord)
artifactId

string

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 Report, Dashboardou Dataset)
attachmentFormat

string

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

string

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

string

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

string

ID d’abonnement
isEnabled

boolean

Si l’abonnement de messagerie est activé
linkToContent

boolean

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

boolean

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

string

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

string

Nom de 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. Lors de l’utilisation de l’appel d’API Get User Subscriptions As Administration, la valeur retournée est un tableau vide (null). Cette propriété sera supprimée de la réponse de charge utile dans une version à venir. Vous pouvez récupérer des informations d’abonnement sur un rapport ou un tableau de bord Power BI à l’aide des appels d’API Get Report Subscriptions As Administration ou Get Dashboard Subscriptions As Administration.

SubscriptionUser

Un utilisateur d’abonnement de messagerie Power BI

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

string

Type de l’utilisateur.