Datasets - Update Parameters In Group

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