Reports - Bind To Gateway

Service:: Power BI REST APIs

Version d'API:: v1.0

Lie la source de données spécifiée du rapport paginé de Mon espace de travail à la passerelle spécifiée, éventuellement avec un ID de source de données donné. Si vous ne fournissez pas d’ID de source de données spécifique, la source de données sera liée à la première source de données correspondante dans la passerelle.

Autorisations

Cet appel d’API peut être appelé par un profil de principal de service.

Étendues déléguées requises

Report.ReadWrite.All ou Report.Read.All

Limites

Prend uniquement en charge la passerelle de données locale

POST https://api.powerbi.com/v1.0/myorg/reports/{reportId}/Default.BindToGateway

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
reportId	path	True	string (uuid)	ID de rapport

Corps de la demande

Nom	Obligatoire	Type	Description
bindDetails	True	RdlBindDetail[]	Liste des détails de liaison
gatewayObjectId	True	string (uuid)	ID de passerelle. Lorsque vous utilisez 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.

Réponses

Nom	Type	Description
200 OK		D’ACCORD

Exemples

Example

Exemple de requête

POST https://api.powerbi.com/v1.0/myorg/reports/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.BindToGateway

Corps de la demande

{
  "gatewayObjectId": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "bindDetails": [
    {
      "dataSourceName": "DataSource1",
      "dataSourceObjectId": "dc2f2dac-e5e2-4c37-af76-2a0bc10f16cb"
    },
    {
      "dataSourceName": "DataSource2",
      "dataSourceObjectId": "3bfe5d33-ab7d-4d24-b0b5-e2bb8eb01cf5"
    }
  ]
}

Exemple de réponse

Code d’état:: 200

Définitions

Nom	Description
RdlBindDetail	BindDetail pour chaque source de données dans un rapport paginé
RdlBindToGatewayRequest	Le rapport paginé lie la source de données à la demande de passerelle

RdlBindDetail

Object

BindDetail pour chaque source de données dans un rapport paginé

Nom	Type	Description
dataSourceName	string	Nom de la source de données dans le rapport paginé
dataSourceObjectId	string (uuid)	Identificateur unique de la source de données dans la passerelle

RdlBindToGatewayRequest