Datasets - Update Parameters

Service:

Power BI REST APIs

API Version:

v1.0

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

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

Uprawnienia

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 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 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ć typu oczekiwanego.
• Lista parametrów nie może być pusta ani zawierać zduplikowanych parametrów.
• Nazwy parametrów są uwzględniane w wielkości 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

Sample Request

POST https://api.powerbi.com/v1.0/myorg/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