Datasets - Update Parameters In Group

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

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

Примечание

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

Важно!

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

Разрешения

Пользователь должен быть владельцем набора данных.
Этот вызов 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

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

Определения

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

UpdateMashupParameterDetails

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

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

UpdateMashupParametersRequest

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

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

Поделиться через