Datasets - Update Parameters In Group

Служба:: Power BI REST APIs

Версия API:: v1.0

Обновляет значения параметров для указанного набора данных из указанной рабочей области.

Замечание

Мы рекомендуем использовать расширенные метаданные набора данных с этим вызовом API.

Это важно

Если вы используете расширенные метаданные набора данных, обновите набор данных, чтобы применить новые значения параметров.
Если вы не используете расширенные метаданные набора данных, подождите 30 минут, пока операция обновления источников данных завершится, а затем обновите набор данных.

Permissions

Пользователь должен быть владельцем набора данных.
Этот вызов API может вызываться профилем субъекта-службы. Дополнительные сведения см. в разделе "Профили субъектов-служб" в Power BI Embedded.

Требуемая область

Dataset.ReadWrite.All

Ограничения

Наборы данных, созданные или измененные с помощью общедоступной конечной точки XMLA , не поддерживаются. Чтобы внести изменения в эти наборы данных, администратор должен использовать клиентская библиотека Служб Azure Analysis Services для табличной объектной модели.
Подключения DirectQuery поддерживаются только с расширенными метаданными набора данных.
Наборы данных с динамическими подключениями к Службам Azure Analysis Services не поддерживаются.
Не более 100 параметров на запрос.
Все указанные параметры должны существовать в наборе данных.
Значения параметров должны иметь ожидаемый тип.
Список параметров не может быть пустым или включать повторяющиеся параметры.
Имена параметров чувствительны к регистру.
Параметр IsRequired должен иметь непустое значение.
Типы Any параметров и Binary не могут быть обновлены.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
datasetId	path	True	string
groupId	path	True	string (uuid)	Идентификатор рабочей области

Текст запроса

Имя	Обязательно	Тип	Описание
updateDetails	True	UpdateMashupParameterDetails[]	Список параметров набора данных для обновления

Ответы

Имя	Тип	Описание
200 OK		ХОРОШО

Примеры

Example

Образец запроса

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

Текст запроса

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

Пример ответа

Код состояния:: 200

Определения

Имя	Описание
UpdateMashupParameterDetails	Сведения об обновлении параметра набора данных Power BI
UpdateMashupParametersRequest	Запрос на обновление параметра набора данных Power BI

UpdateMashupParameterDetails

Object

Сведения об обновлении параметра набора данных Power BI

Имя	Тип	Описание
name	string	Имя параметра
newValue	string	Новое значение параметра

UpdateMashupParametersRequest