Datasets - Update Parameters

Referência

Service:: Power BI REST APIs

API Version:: v1.0

Atualizações os valores de parâmetros para o conjunto de dados especificado de Meu workspace.

Observação

É recomendável usar metadados de conjunto de dados aprimorados com essa chamada à API.

Importante

Se você estiver usando metadados aprimorados do conjunto de dados, atualize o conjunto de dados para aplicar os novos valores de parâmetro.
Se você não estiver usando metadados aprimorados do conjunto de dados, aguarde 30 minutos para que a operação de atualização de fontes de dados seja concluída e atualize o conjunto de dados.

Permissões

O usuário deve ser o proprietário do conjunto de dados.

Escopo necessário

Dataset.ReadWrite.All

Limitações

Não há suporte para conjuntos de dados criados ou modificados usando o ponto de extremidade XMLA público. Para fazer alterações nesses conjuntos de dados, o administrador deve usar a biblioteca de clientes Azure Analysis Services para o Modelo de Objeto Tabular.
As conexões directQuery só têm suporte com metadados aprimorados do conjunto de dados.
Não há suporte para conjuntos de dados com conexões dinâmicas Azure Analysis Services.
Máximo de 100 parâmetros por solicitação.
Todos os parâmetros especificados devem existir no conjunto de dados.
Os valores de parâmetros devem ser do tipo esperado.
A lista de parâmetros não pode estar vazia nem incluir parâmetros duplicados.
Os nomes de parâmetros diferenciam maiúsculas de minúsculas.
O parâmetro IsRequired deve ter um valor não vazio.
Os tipos Any de parâmetro e Binary não podem ser atualizados.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
datasetId	path	True	string	A ID do conjunto de dados

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
updateDetails	True	UpdateMashupParameterDetails[]	Uma lista de parâmetros de conjunto de dados a serem atualizados

Respostas

Nome	Tipo	Description
200 OK		OK

Exemplos

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

Definições

Nome	Description
UpdateMashupParameterDetails	Os detalhes da atualização de um parâmetro de conjunto de dados do Power BI
UpdateMashupParametersRequest	Uma solicitação de atualização para um parâmetro de conjunto de dados do Power BI

UpdateMashupParameterDetails

Os detalhes da atualização de um parâmetro de conjunto de dados do Power BI

Nome	Tipo	Description
name	string	O nome do parâmetro
newValue	string	O novo valor para o parâmetro

UpdateMashupParametersRequest

Uma solicitação de atualização para um parâmetro de conjunto de dados do Power BI

Nome	Tipo	Description
updateDetails	UpdateMashupParameterDetails[]	Uma lista de parâmetros de conjunto de dados a serem atualizados

Compartilhar via