Datasets - Get Parameters

Dienst:

Power BI REST APIs

API-Version:

v1.0

Gibt eine Liste von Parametern für das angegebene Semantikmodell zurück. Das Semantikmodell kann sich im Arbeitsbereich "Mein Arbeitsbereich" oder in einem anderen Arbeitsbereich befinden, vorausgesetzt, der Aufrufer verfügt über die erforderlichen Berechtigungen.

Erforderlicher Bereich

Dataset.Read.All oder Dataset.ReadWrite.All

Einschränkungen

• Datasets mit SQL-, Oracle-, Teradata- und SAP HANA DirectQuery-Verbindungen werden nicht unterstützt.
• Datasets, die mit dem öffentlichen XMLA-Endpunkt erstellt oder geändert wurden, werden nicht unterstützt.
  
  

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/parameters

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
datasetId	path	True	string	Die Dataset-ID

Antworten

Name	Typ	Beschreibung
200 OK	MashupParameters	OKAY

Beispiele

Example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/parameters

Beispiel für eine Antwort

Statuscode:

200

{
  "value": [
    {
      "name": "ServerName",
      "type": "Text",
      "isRequired": true,
      "currentValue": "MyTest.database.windows.net"
    },
    {
      "name": "DatabaseName",
      "type": "Text",
      "isRequired": true,
      "currentValue": "MyTestDB"
    },
    {
      "name": "FromDate",
      "type": "DateTime",
      "isRequired": true,
      "currentValue": "2/8/2002 12:00:00 AM"
    },
    {
      "name": "FilterBlanks",
      "type": "Logical",
      "isRequired": true,
      "currentValue": "TRUE"
    },
    {
      "name": "MaxId",
      "type": "Number",
      "isRequired": true,
      "currentValue": "77"
    },
    {
      "name": "AnyParam",
      "type": "Any",
      "isRequired": true,
      "currentValue": "uu63"
    }
  ]
}

Definitionen

Name	Beschreibung
MashupParameter	Ein Power BI-Datasetparameter
MashupParameters	Der OData-Antwortwrapper für eine Liste der Power BI-Datasetparameter

MashupParameter

Objekt

Ein Power BI-Datasetparameter

Name	Typ	Beschreibung
currentValue	string	Der aktuelle Wert des Parameters
isRequired	boolean	Gibt an, ob der Datasetparameter erforderlich ist.
name	string	Der Parametername
suggestedValues	string[]	Eine Liste der vorgeschlagenen Parameterwerte
type	string	Der Parametertyp

MashupParameters

Objekt

Der OData-Antwortwrapper für eine Liste der Power BI-Datasetparameter

Name	Typ	Beschreibung
@odata.context	string
value	MashupParameter[]	Eine Liste der Datasetparameter