Datasets - Update Parameters In Group

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Updates die Parameterwerte für das angegebene Dataset aus dem angegebenen Arbeitsbereich.

Hinweis

Es wird empfohlen, erweiterte Datasetmetadaten mit diesem API-Aufruf zu verwenden.

Wichtig

Wenn Sie erweiterte Datasetmetadaten verwenden, aktualisieren Sie das Dataset, um die neuen Parameterwerte anzuwenden.
Wenn Sie keine erweiterten Datasetmetadaten verwenden, warten Sie 30 Minuten, bis der Vorgang zum Aktualisieren von Datenquellen abgeschlossen ist, und aktualisieren Sie dann das Dataset.

Berechtigungen

Der Benutzer muss der Besitzer des Datasets sein.
Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter Dienstprinzipalprofile in Power BI Embedded.

Erforderlicher Bereich

Dataset.ReadWrite.All

Einschränkungen

Datasets, die mit dem öffentlichen XMLA-Endpunkt erstellt oder geändert wurden, werden nicht unterstützt. Um Änderungen an diesen Datasets vorzunehmen, muss der Administrator die Azure Analysis Services Clientbibliothek für tabellarisches Objektmodell verwenden.
DirectQuery-Verbindungen werden nur mit erweiterten Datasetmetadaten unterstützt.
Datasets mit Azure Analysis Services Liveverbindungen werden nicht unterstützt.
Maximal 100 Parameter pro Anforderung.
Alle angegebenen Parameter müssen im Dataset vorhanden sein.
Parameterwerte sollten vom erwarteten Typ sein.
Die Parameterliste darf nicht leer sein oder doppelte Parameter enthalten.
Bei Parameternamen wird die Groß-/Kleinschreibung beachtet.
Der Parameter IsRequired muss einen nicht leeren Wert aufweisen.
Die Parametertypen Any und Binary können nicht aktualisiert werden.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
datasetId	path	True	string
groupId	path	True	string uuid	Arbeitsbereich-ID

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
updateDetails	True	UpdateMashupParameterDetails[]	Eine Liste der zu aktualisierenden Datasetparameter

Antworten

Name	Typ	Beschreibung
200 OK		OK

Beispiele

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

Definitionen

Name	Beschreibung
UpdateMashupParameterDetails	Die Updatedetails für einen Power BI-Datasetparameter
UpdateMashupParametersRequest	Eine Updateanforderung für einen Power BI-Datasetparameter

UpdateMashupParameterDetails

Die Updatedetails für einen Power BI-Datasetparameter

Name	Typ	Beschreibung
name	string	Der Parametername
newValue	string	Der neue Wert für den Parameter

UpdateMashupParametersRequest

Eine Updateanforderung für einen Power BI-Datasetparameter

Name	Typ	Beschreibung
updateDetails	UpdateMashupParameterDetails[]	Eine Liste der zu aktualisierenden Datasetparameter

Freigeben über