Datasets - Update Direct Query Refresh Schedule In Group

Служба:

Power BI REST APIs

Версия API:

v1.0

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

Запрос должен содержать набор дней и времени или допустимую частоту, но не оба типа. Если выбрать набор дней без указания времени, Power BI будет использовать по умолчанию один раз в день. При установке частоты параметры дней и времени будут автоматически перезаписаны.

Разрешения

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

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

Dataset.ReadWrite.All

PATCH https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/directQueryRefreshSchedule

Параметры URI

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

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

Имя	Обязательно	Тип	Описание
value	True	DirectQueryRefreshSchedule	Объект , содержащий сведения о расписании обновления для DirectQuery или LiveConnection.

Ответы

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

Примеры

Set a days and times based schedule example

Set a frequency based schedule example

Update the times of an existing days and times based schedule example

Set a days and times based schedule example

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

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

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

{
  "value": {
    "days": [
      "Sunday",
      "Tuesday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "07:00",
      "11:30",
      "16:00",
      "23:30"
    ],
    "localTimeZoneId": "UTC"
  }
}

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

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

200

Set a frequency based schedule example

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

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

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

{
  "value": {
    "frequency": 30
  }
}

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

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

200

Update the times of an existing days and times based schedule example

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

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

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

{
  "value": {
    "times": [
      "07:00",
      "16:30",
      "23:30"
    ]
  }
}

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

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

200

Определения

Имя	Описание
days	Дни, в которые выполняется обновление
DirectQueryRefreshSchedule	Расписание обновления Power BI для DirectQuery или LiveConnection, указывающее частоту или сочетание дней и времени.
DirectQueryRefreshScheduleRequest	Запрос расписания обновления Power BI для DirectQuery или LiveConnection

days

Enumeration

Дни, в которые выполняется обновление

Значение	Описание
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

DirectQueryRefreshSchedule

Object

Расписание обновления Power BI для DirectQuery или LiveConnection, указывающее частоту или сочетание дней и времени.

Имя	Тип	Описание
days	days[]	Дни, в которые выполняется обновление
frequency	integer	Интервал в минутах между последовательными обновлениями. Поддерживаемые значения: 15, 30, 60, 120 и 180.
localTimeZoneId	string	Идентификатор используемого часового пояса. Дополнительные сведения см. в разделе Сведения о часовом поясе.
times	string[]	Время суток для выполнения обновления

DirectQueryRefreshScheduleRequest

Object

Запрос расписания обновления Power BI для DirectQuery или LiveConnection

Имя	Тип	Описание
value	DirectQueryRefreshSchedule	Объект , содержащий сведения о расписании обновления для DirectQuery или LiveConnection.