Datasets - Update Parameters In Group

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
{
  "updateDetails": [
    {
      "name": "DatabaseName",
      "newValue": "NewDB"
    },
    {
      "name": "MaxId",
      "newValue": "5678"
    }
  ]
}

Sample Response

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