Datasets - Update Parameters In Group

Reference

Service:: Power BI REST APIs

API Version:: v1.0

Aktualizace hodnoty parametrů pro zadanou datovou sadu ze zadaného pracovního prostoru.

Poznámka

S tímto voláním rozhraní API doporučujeme používat rozšířená metadata datové sady .

Důležité

Pokud používáte rozšířená metadata datové sady, aktualizujte datovou sadu, aby se použily nové hodnoty parametrů.
Pokud nepoužíváte rozšířená metadata datové sady, počkejte 30 minut, než se dokončí operace aktualizace zdrojů dat, a pak datovou sadu aktualizujte.

Oprávnění

Uživatel musí být vlastníkem datové sady.
Toto volání rozhraní API může volat profil instančního objektu. Další informace najdete v tématu Profily instančních objektů v Power BI Embedded.

Požadovaný obor

Dataset.ReadWrite.All

Omezení

Datové sady vytvořené nebo upravené pomocí veřejného koncového bodu XMLA se nepodporují. Aby správce tyto datové sady změnil, musí použít klientskou knihovnu Azure Analysis Services pro tabulkový objektový model.
Připojení DirectQuery se podporují jenom s rozšířenými metadaty datové sady.
Datové sady s Azure Analysis Services živými připojeními se nepodporují.
Maximálně 100 parametrů na požadavek.
V datové sadě musí existovat všechny zadané parametry.
Hodnoty parametrů by měly být očekávaného typu.
Seznam parametrů nemůže být prázdný ani obsahovat duplicitní parametry.
V názvech parametrů se rozlišují malá a velká písmena.
Parametr IsRequired musí mít neprázdnou hodnotu.
Typy parametrů Any se Binary nedají aktualizovat.

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/Default.UpdateParameters

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
datasetId	path	True	string
groupId	path	True	string uuid	ID pracovního prostoru

Text požadavku

Name	Vyžadováno	Typ	Description
updateDetails	True	UpdateMashupParameterDetails[]	Seznam parametrů datové sady, které se mají aktualizovat

Odpovědi

Name	Typ	Description
200 OK		OK

Příklady

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

Definice

Name	Description
UpdateMashupParameterDetails	Podrobnosti o aktualizaci parametru datové sady Power BI
UpdateMashupParametersRequest	Žádost o aktualizaci parametru datové sady Power BI

UpdateMashupParameterDetails

Podrobnosti o aktualizaci parametru datové sady Power BI

Name	Typ	Description
name	string	Název parametru
newValue	string	Nová hodnota parametru

UpdateMashupParametersRequest

Žádost o aktualizaci parametru datové sady Power BI

Name	Typ	Description
updateDetails	UpdateMashupParameterDetails[]	Seznam parametrů datové sady, které se mají aktualizovat

Sdílet prostřednictvím