Datasets - Update Direct Query Refresh Schedule In Group

Service:

Power BI REST APIs

API Version:

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

Sample Request

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

Request Body

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

Sample Response

Status code:

200

Set a frequency based schedule example

Sample Request

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

Request Body

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

Sample Response

Status code:

200

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

Sample Request

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

Request Body

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

Sample Response

Status code:

200

Определения

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

days

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

Имя	Тип	Описание
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

DirectQueryRefreshSchedule

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

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

DirectQueryRefreshScheduleRequest

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

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