Datasets - Get Parameters In Group

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Gibt eine Liste von Parametern für das angegebene Dataset aus dem angegebenen Arbeitsbereich zurück.

Berechtigungen

Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter Dienstprinzipalprofile in Power BI Embedded.

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/groups/{groupId}/datasets/{datasetId}/parameters

URI-Parameter

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

Antworten

Name	Typ	Beschreibung
200 OK	MashupParameters	OK

Beispiele

Example

Sample Request

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

Sample Response

Status code:: 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 von Power BI-Datasetparametern

MashupParameter

Ein Power BI-Datasetparameter

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

MashupParameters

Der OData-Antwortwrapper für eine Liste von Power BI-Datasetparametern

Name	Typ	Beschreibung
odata.context	string
value	MashupParameter[]	Eine Liste von Datasetparametern

Freigeben über