Datasets - Update Parameters In Group

Dienst:: Power BI REST APIs

API-Version:: v1.0

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

Hinweis

Wir empfehlen die Verwendung erweiterter Datasetmetadaten mit diesem API-Aufruf.

Von Bedeutung

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 Aktualisierungsdatenquellenvorgang abgeschlossen ist, und aktualisieren Sie dann das Dataset.

Erlaubnisse

Der Benutzer muss der Datasetbesitzer 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 das tabellarische Objektmodell verwenden.
DirectQuery-Verbindungen werden nur mit erweiterten Datasetmetadaten unterstützt.
Datasets mit Liveverbindungen von Azure Analysis Services 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 kann nicht leer sein oder doppelte Parameter enthalten.
Bei Parameternamen wird die Groß-/Kleinschreibung beachtet.
Der Parameter IsRequired muss über einen nicht leeren Wert verfügen.
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)	Die Arbeitsbereichs-ID

Anforderungstext

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

Antworten

Name	Typ	Beschreibung
200 OK		OKAY

Beispiele

Example

Beispielanforderung

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

Anforderungstext

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

Beispiel für eine Antwort

Statuscode:: 200

Definitionen

Name	Beschreibung
UpdateMashupParameterDetails	Die Aktualisierungsdetails für einen Power BI-Datasetparameter
UpdateMashupParametersRequest	Eine Aktualisierungsanforderung für einen Power BI-Datasetparameter

UpdateMashupParameterDetails

Objekt

Die Aktualisierungsdetails für einen Power BI-Datasetparameter

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

UpdateMashupParametersRequest