Datasets - Update Parameters In Group

  • Odwołanie
Service:
Power BI REST APIs
API Version:
v1.0

Aktualizacje wartości parametrów dla określonego zestawu danych z określonego obszaru roboczego.

Uwaga

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 aktualizowania źródeł danych, a następnie odśwież zestaw danych.

Uprawnienia

  • Użytkownik musi być właścicielem zestawu danych.
  • To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi. Aby uzyskać więcej informacji, zobacz: Profile jednostki usługi w Power BI Embedded.

Zakres wymagany

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 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 Azure Analysis Services połączeniami na żywo 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ć niepustą wartość.
  • Typy parametrów Any i Binary nie można ich zaktualizować. 

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
datasetId
 path True

string

groupId
 path True

string

uuid

Identyfikator obszaru roboczego

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

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

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

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

Nazwa Typ Opis
name

string

Nazwa parametru
newValue

string

Nowa wartość parametru

UpdateMashupParametersRequest

Żądanie aktualizacji parametru zestawu danych usługi Power BI

Nazwa Typ Opis
updateDetails

UpdateMashupParameterDetails[]

Lista parametrów zestawu danych do zaktualizowania