Datasets - Update Parameters In Group

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