Datasets - Update Parameters

Služba:: Power BI REST APIs

Verze rozhraní API:: v1.0

Aktualizuje hodnoty parametrů pro zadanou datovou sadu z pracovního prostoru.

Poznámka:

U tohoto volání 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 a použijte 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.

Povolení

Uživatel musí být vlastníkem datové sady.

Požadovaný obor

Dataset.ReadWrite.All

Omezení

Datové sady vytvořené nebo upravené pomocí veřejného koncového bodu XMLA se nepodporují. Pokud chcete tyto datové sady změnit, musí správce použít klientskou knihovnu služby Azure Analysis Services pro tabulkový objektový model.
Připojení DirectQuery jsou podporována pouze s rozšířenými metadaty datové sady.
Datové sady s živými připojeními azure Analysis Services se nepodporují.
Maximálně 100 parametrů na požadavek.
Všechny zadané parametry musí existovat v datové sadě.
Hodnoty parametrů by měly být očekávaného typu.
Seznam parametrů nemůže být prázdný nebo nesmí 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 a Binary nelze je aktualizovat.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
datasetId	path	True	string	ID datové sady

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

Ukázkový požadavek

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateParameters

Text požadavku

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

Ukázková odpověď

Stavový kód:: 200

Definice

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

UpdateMashupParameterDetails

Objekt

Podrobnosti o aktualizaci parametru datové sady Power BI

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

UpdateMashupParametersRequest