Datasets - Update Parameters

Usługa:: Power BI REST APIs

Wersja interfejsu API:: v1.0

Aktualizuje wartości parametrów dla określonego zestawu danych z obszaru Mój obszar roboczy.

Uwaga / Notatka

Zalecamy używanie rozszerzonych metadanych zestawu danych z tym wywołaniem interfejsu API.

Ważne

Jeśli używasz rozszerzonych metadanych zestawu danych, odśwież zestaw danych, aby zastosować nowe wartości parametrów.
Jeśli nie używasz rozszerzonych metadanych zestawu danych, poczekaj 30 minut na ukończenie operacji aktualizacji źródeł danych, a następnie odśwież zestaw danych.

Permissions

Użytkownik musi być właścicielem zestawu danych.

Wymagany zakres

Dataset.ReadWrite.All

Ograniczenia

Zestawy danych utworzone lub zmodyfikowane przy użyciu publicznego punktu końcowego XMLA nie są obsługiwane. Aby wprowadzić zmiany w tych zestawach danych, administrator musi użyć biblioteki klienta usług Azure Analysis Services dla modelu obiektów tabelarycznych.
Połączenia trybu DirectQuery są obsługiwane tylko w przypadku rozszerzonych metadanych zestawu danych.
Zestawy danych z połączeniami na żywo usług Azure Analysis Services nie są obsługiwane.
Maksymalnie 100 parametrów na żądanie.
Wszystkie określone parametry muszą istnieć w zestawie danych.
Wartości parametrów powinny być oczekiwanego typu.
Lista parametrów nie może być pusta ani zawierać zduplikowanych parametrów.
W nazwach parametrów jest rozróżniana wielkość liter.
Parametr IsRequired musi mieć wartość niepustą.
Typy parametrów Any i Binary nie można ich zaktualizować.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
datasetId	path	True	string	Identyfikator zestawu danych

Treść żądania

Nazwa	Wymagane	Typ	Opis
updateDetails	True	UpdateMashupParameterDetails[]	Lista parametrów zestawu danych do zaktualizowania

Odpowiedzi

Nazwa	Typ	Opis
200 OK		OK

Przykłady

Example

Przykładowe żądanie

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

Treść żądania

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

Przykładowa odpowiedź

Kod stanu:: 200

Definicje

Nazwa	Opis
UpdateMashupParameterDetails	Szczegóły aktualizacji parametru zestawu danych usługi Power BI
UpdateMashupParametersRequest	Żądanie aktualizacji parametru zestawu danych usługi Power BI

UpdateMashupParameterDetails

Objekt

Szczegóły aktualizacji parametru zestawu danych usługi Power BI

Nazwa	Typ	Opis
name	string	Nazwa parametru
newValue	string	Nowa wartość parametru

UpdateMashupParametersRequest