Datasets - Update Parameters
Mises à jour les valeurs de paramètres du jeu de données spécifié à partir de Mon espace de travail.
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.
É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
etBinary
ne peuvent pas être mis à jour.
POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.UpdateParameters
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
dataset
|
path | True |
string |
ID du jeu de données |
Corps de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
updateDetails | True |
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/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateParameters
{
"updateDetails": [
{
"name": "DatabaseName",
"newValue": "NewDB"
},
{
"name": "MaxId",
"newValue": "5678"
}
]
}
Sample Response
Définitions
Nom | Description |
---|---|
Update |
Détails de la mise à jour d’un paramètre de jeu de données Power BI |
Update |
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 |
Liste des paramètres de jeu de données à mettre à jour |