Datasets - Update Parameters In Group

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

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

Nota

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

Importante

Se si usano metadati avanzati del set di dati, 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.

Autorizzazioni

L'utente deve essere il proprietario del set di dati.
Questa chiamata API può essere chiamata da un profilo 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 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 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 area di lavoro

Corpo della richiesta

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

Risposte

Nome	Tipo	Descrizione
200 OK		OK

Esempio

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

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

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

Richiesta di aggiornamento per un parametro del set di dati di Power BI

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

Condividi tramite