Datasets - Update Parameters In Group

Référence

Service:: Power BI REST APIs

API Version:: v1.0

Mises à jour les valeurs de paramètres du jeu de données spécifié à partir de l’espace de travail spécifié.

Notes

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 que l’opération de mise à jour des sources de données se termine, puis actualisez le jeu de données.

Autorisations

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 de client Azure Analysis Services pour le modèle objet tabulaire.
Les connexions DirectQuery sont uniquement prises en charge avec des métadonnées de jeu de données améliorées.
Les jeux de données avec Azure Analysis Services connexions actives ne sont pas pris en charge.
Maximum de 100 paramètres par demande.
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 paramètres Any 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	L’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

Sample Request

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

Request Body

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

Sample Response

Status code:: 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

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 pour le paramètre

UpdateMashupParametersRequest

Demande de mise à jour pour un paramètre de jeu de données Power BI

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