Dataflows - Update Refresh Schedule

Service:

Power BI REST APIs

API Version:

v1.0

지정된 데이터 흐름에 대한 새로 고침 일정을 만들거나 업데이트합니다.

사용 권한

이 API 호출은 서비스 주체 프로필에서 호출할 수 있습니다. 자세한 내용은 Power BI Embedded 서비스 주체 프로필을 참조하세요.

필수 범위

Dataflow.ReadWrite.All

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
dataflowId	path	True	string uuid	데이터 흐름 ID
groupId	path	True	string uuid	작업 영역 ID

요청 본문

Name	필수	형식	Description
value	True	RefreshSchedule	새로 고침 일정의 세부 정보를 포함하는 개체

응답

Name	형식	Description
200 OK		확인

예제

Daily refresh schedule example

Disable refresh schedule example

Update refresh schedule times example

Daily refresh schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule

Request Body

{
  "value": {
    "days": [
      "Sunday",
      "Monday",
      "Tuesday",
      "Wednesday",
      "Thursday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "10:00",
      "16:00"
    ],
    "enabled": true,
    "localTimeZoneId": "UTC",
    "notifyOption": "NoNotification"
  }
}

Sample Response

Status code:

200

Disable refresh schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule

Request Body

{
  "value": {
    "enabled": false
  }
}

Sample Response

Status code:

200

Update refresh schedule times example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows/928228ba-008d-4fd9-864a-92d2752ee5ce/refreshSchedule

Request Body

{
  "value": {
    "times": [
      "10:30",
      "16:30"
    ],
    "enabled": true,
    "localTimeZoneId": "UTC"
  }
}

Sample Response

Status code:

200

정의

Name	Description
days	새로 고침을 실행할 일
RefreshSchedule	가져온 모델에 대한 Power BI 새로 고침 일정
RefreshScheduleRequest	Power BI 새로 고침 일정 요청
ScheduleNotifyOption	예약된 새로 고침 종료 시 알림 옵션입니다. 서비스 주체는 값만 지원합니다 NoNotification .

days

새로 고침을 실행할 일

Name	형식	Description
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

RefreshSchedule

가져온 모델에 대한 Power BI 새로 고침 일정

Name	형식	Description
NotifyOption	ScheduleNotifyOption	예약된 새로 고침 종료 시 알림 옵션입니다. 서비스 주체는 값만 지원합니다 NoNotification .
days	days[]	새로 고침을 실행할 일
enabled	boolean	새로 고침을 사용할 수 있는지 여부
localTimeZoneId	string	사용할 표준 시간대의 ID입니다. 자세한 내용은 표준 시간대 정보를 참조하세요.
times	string[]	새로 고침을 실행하는 하루 중 시간

RefreshScheduleRequest

Power BI 새로 고침 일정 요청

Name	형식	Description
value	RefreshSchedule	새로 고침 일정의 세부 정보를 포함하는 개체

ScheduleNotifyOption

예약된 새로 고침 종료 시 알림 옵션입니다. 서비스 주체는 값만 지원합니다 NoNotification .

Name	형식	Description
MailOnFailure	string	새로 고침 실패 시 메일 알림이 전송됩니다.
NoNotification	string	알림이 전송되지 않습니다.