Datasets - Update Parameters In Group

Service:

Power BI REST APIs

API Version:

v1.0

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

Observação

É recomendável usar metadados aprimorados do conjunto de dados 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.
• Essa chamada à API pode ser chamada por um perfil de entidade de serviço. Para obter mais informações, consulte: Perfis de entidade de serviço no Power BI Embedded.

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 Azure Analysis Services conexões dinâmicas.
• 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/groups/{groupId}/datasets/{datasetId}/Default.UpdateParameters

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
datasetId	path	True	string
groupId	path	True	string uuid	A ID do workspace

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/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

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