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

Datasets - Update Refresh Schedule In Group

  • Ссылка
Служба:
Power BI REST APIs
Версия API:
v1.0

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

Запрос, отключающий расписание обновления, не должен содержать других изменений.

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

Разрешения

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

Dataset.ReadWrite.All

Ограничения

Ограничение на количество интервалов времени в день зависит от того, используется ли емкость Premium или Общая. 

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

Параметры URI

Имя В Обязательно Тип Описание
datasetId
 path True

string

Идентификатор набора данных
groupId
 path True

string

uuid

идентификатор рабочей области;

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

Имя Обязательно Тип Описание
value True

RefreshSchedule

Объект , содержащий сведения о расписании обновления.

Ответы

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

ОК

Примеры

Change the days and times of a refresh schedule example
Change the notification option of a refresh schedule example
Disable a scheduled refresh example
Update the times of a refresh schedule example

Change the days and times of a refresh schedule example

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

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
Текст запроса
{
  "value": {
    "days": [
      "Sunday",
      "Tuesday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "07:00",
      "11:30",
      "16:00",
      "23:30"
    ],
    "localTimeZoneId": "UTC"
  }
}

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

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

Change the notification option of a refresh schedule example

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

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
Текст запроса
{
  "value": {
    "notifyOption": "NoNotification"
  }
}

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

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

Disable a scheduled refresh example

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

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
Текст запроса
{
  "value": {
    "enabled": false
  }
}

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

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

Update the times of a refresh schedule example

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

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshSchedule
Текст запроса
{
  "value": {
    "times": [
      "08:00",
      "16:00"
    ]
  }
}

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

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

Определения

Имя Описание
days

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

Расписание обновления Power BI для импортированной модели
RefreshScheduleRequest

Запрос на обновление расписания Power BI
ScheduleNotifyOption

Параметр уведомления о завершении запланированного обновления. Субъекты-службы поддерживают NoNotification только значение .

days

Enumeration

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

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

RefreshSchedule

Object

Расписание обновления Power BI для импортированной модели

Имя Тип Описание
days

days[]

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

boolean

Включено ли обновление
localTimeZoneId

string

Идентификатор используемого часового пояса. Дополнительные сведения см. в разделе Сведения о часовом поясе.
notifyOption

ScheduleNotifyOption

Параметр уведомления о завершении запланированного обновления. Субъекты-службы поддерживают NoNotification только значение .
times

string[]

Время суток для выполнения обновления

RefreshScheduleRequest

Object

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

Имя Тип Описание
value

RefreshSchedule

Объект , содержащий сведения о расписании обновления.

ScheduleNotifyOption

Enumeration

Параметр уведомления о завершении запланированного обновления. Субъекты-службы поддерживают NoNotification только значение .

Значение Описание
MailOnFailure

При сбое обновления будет отправлено почтовое уведомление
NoNotification

Уведомления не отправляются