Freigeben über


Datasets - Update Parameters In Group

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

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

Sample Response

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