Datasets - Update Parameters In Group

Servizio:: Power BI REST APIs

Versione API:: v1.0

Aggiorna i valori dei parametri per il set di dati specificato dall'area di lavoro specificata.

Annotazioni

È consigliabile usare metadati del set di dati avanzati con questa chiamata API.

Importante

Se si usano metadati del set di dati avanzati, aggiornare il set di dati per applicare i nuovi valori dei parametri.
Se non si usano metadati del set di dati avanzati, attendere 30 minuti per il completamento dell'operazione di aggiornamento delle origini dati e quindi aggiornare il set di dati.

Permissions

L'utente deve essere il proprietario del set di dati.
Questa chiamata API può essere chiamata da un profilo dell'entità servizio. Per altre informazioni, vedere Profili entità servizio in Power BI Embedded.

Ambito obbligatorio

Dataset.ReadWrite.All

Limitazioni

I set di dati creati o modificati usando l'endpoint XMLA pubblico non sono supportati. Per apportare modifiche a tali set di dati, l'amministratore deve usare la libreria client di Azure Analysis Services per il modello a oggetti tabulare.
Le connessioni DirectQuery sono supportate solo con metadati del set di dati avanzati.
I set di dati con connessioni dinamiche di Azure Analysis Services non sono supportati.
Massimo 100 parametri per richiesta.
Tutti i parametri specificati devono esistere nel set di dati.
I valori dei parametri devono essere del tipo previsto.
L'elenco di parametri non può essere vuoto o includere parametri duplicati.
I nomi dei parametri fanno distinzione tra maiuscole e minuscole.
Il parametro IsRequired deve avere un valore non vuoto.
I tipi di Any parametro e Binary non possono essere aggiornati.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
datasetId	path	True	string
groupId	path	True	string (uuid)	ID dell'area di lavoro

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
updateDetails	True	UpdateMashupParameterDetails[]	Elenco dei parametri del set di dati da aggiornare

Risposte

Nome	Tipo	Descrizione
200 OK		Va bene

Esempio

Example

Esempio di richiesta

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateParameters

Corpo della richiesta

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

Risposta di esempio

Codice di stato:: 200

Definizioni

Nome	Descrizione
UpdateMashupParameterDetails	Dettagli dell'aggiornamento per un parametro del set di dati di Power BI
UpdateMashupParametersRequest	Richiesta di aggiornamento per un parametro del set di dati di Power BI

UpdateMashupParameterDetails

Object

Dettagli dell'aggiornamento per un parametro del set di dati di Power BI

Nome	Tipo	Descrizione
name	string	Nome del parametro
newValue	string	Nuovo valore per il parametro

UpdateMashupParametersRequest