Datasets - Update Parameters

Serviço:: Power BI REST APIs

Versão da API:: v1.0

Atualiza os valores de parâmetros para o conjunto de dados especificado do 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 fontes de dados de atualização seja concluída e atualize o conjunto de dados.

Permissions

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 do 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 do 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 ou 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		OKEY

Exemplos

Example

Solicitação de exemplo

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateParameters

Corpo da solicitação

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

Resposta de exemplo

Código de status:: 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

Objeto

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