Datasets - Update Parameters In Group

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