Datasets - Update Parameters In Group

Service:: Power BI REST APIs

Version d'API:: v1.0

Met à jour les valeurs des paramètres pour le jeu de données spécifié à partir de l’espace de travail spécifié.

Note

Nous vous recommandons d’utiliser des métadonnées de jeu de données améliorées avec cet appel d’API.

Important

Si vous utilisez des métadonnées de jeu de données améliorées, actualisez le jeu de données pour appliquer les nouvelles valeurs de paramètre.
Si vous n’utilisez pas de métadonnées de jeu de données améliorées, attendez 30 minutes pour que l’opération de sources de données de mise à jour se termine, puis actualisez le jeu de données.

Permissions

L’utilisateur doit être le propriétaire du jeu de données.
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

Dataset.ReadWrite.All

Limites

Les jeux de données créés ou modifiés à l’aide du point de terminaison XMLA public ne sont pas pris en charge. Pour apporter des modifications à ces jeux de données, l’administrateur doit utiliser la bibliothèque cliente Azure Analysis Services pour le modèle objet tabulaire.
Les connexions DirectQuery sont uniquement prises en charge avec les métadonnées de jeu de données améliorées.
Les jeux de données avec des connexions actives Azure Analysis Services ne sont pas pris en charge.
Maximum de 100 paramètres par requête.
Tous les paramètres spécifiés doivent exister dans le jeu de données.
Les valeurs de paramètres doivent être du type attendu.
La liste de paramètres ne peut pas être vide ou inclure des paramètres en double.
Les noms de paramètres respectent la casse.
Le paramètre IsRequired doit avoir une valeur non vide.
Les types de Any paramètres et Binary ne peuvent pas être mis à jour.

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/Default.UpdateParameters

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
datasetId	path	True	string
groupId	path	True	string (uuid)	ID de l’espace de travail

Corps de la demande

Nom	Obligatoire	Type	Description
updateDetails	True	UpdateMashupParameterDetails[]	Liste des paramètres de jeu de données à mettre à jour

Réponses

Nom	Type	Description
200 OK		Ok

Exemples

Example

Exemple de requête

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateParameters

Corps de la demande

{
  "updateDetails": [
    {
      "name": "DatabaseName",
      "newValue": "NewDB"
    },
    {
      "name": "MaxId",
      "newValue": "5678"
    }
  ]
}

Exemple de réponse

Code d’état:: 200

Définitions

Nom	Description
UpdateMashupParameterDetails	Détails de la mise à jour d’un paramètre de jeu de données Power BI
UpdateMashupParametersRequest	Demande de mise à jour pour un paramètre de jeu de données Power BI

UpdateMashupParameterDetails

Object

Détails de la mise à jour d’un paramètre de jeu de données Power BI

Nom	Type	Description
name	string	Nom du paramètre
newValue	string	Nouvelle valeur du paramètre

UpdateMashupParametersRequest