Datasets - Update Parameters

Ссылка

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

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

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

Примечание

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

Важно!

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

Разрешения

Пользователь должен быть владельцем набора данных.

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

Dataset.ReadWrite.All

Ограничения

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

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
datasetId	path	True	string	Идентификатор набора данных

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

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

Ответы

Имя	Тип	Описание
200 OK		ОК

Примеры

Example

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

POST https://api.powerbi.com/v1.0/myorg/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